JP1 Version 13　JP1/Automatic Job Management System 3 コマンドリファレンス

3021-3-L49-20

前書き

対象製品

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

輸出時の注意

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

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

商標類

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

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

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

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

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

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

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

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

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

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

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

LICENSE ISSUES

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

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

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

See below for the actual license texts.

OpenSSL License

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

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

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

*

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

* modification, are permitted provided that the following conditions

* are met:

*

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

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

*

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

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

* the documentation and/or other materials provided with the

* distribution.

*

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

* software must display the following acknowledgment:

* "This product includes software developed by the OpenSSL Project

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

*

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

* endorse or promote products derived from this software without

* prior written permission. For written permission, please contact

* openssl-core@openssl.org.

*

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

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

* permission of the OpenSSL Project.

*

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

* acknowledgment:

* "This product includes software developed by the OpenSSL Project

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

*

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

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

* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR

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

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

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

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

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

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

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

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

* OF THE POSSIBILITY OF SUCH DAMAGE.

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

*

* This product includes cryptographic software written by Eric Young

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

* Hudson (tjh@cryptsoft.com).

*

*/

Original SSLeay License

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

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

* All rights reserved.

*

* This package is an SSL implementation written

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

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

*

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

* the following conditions are aheared to. The following conditions

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

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

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

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

*

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

* the code are not to be removed.

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

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

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

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

*

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

* modification, are permitted provided that the following conditions

* are met:

* 1. Redistributions of source code must retain the copyright

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

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

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

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

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

* must display the following acknowledgement:

* "This product includes cryptographic software written by

* Eric Young (eay@cryptsoft.com)"

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

* being used are not cryptographic related :-).

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

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

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

*

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

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

* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE

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

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

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

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

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

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

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

* SUCH DAMAGE.

*

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

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

* copied and put under another distribution licence

* [including the GNU Public Licence.]

*/

This product includes the OpenSSL library.

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

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

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

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

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

This product includes software developed by Andy Clark.

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

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

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

表記

製品名

Excel

Microsoft(R) Excel

Microsoft(R) Office Excel

Exchange Server

Microsoft(R) Exchange 2000 Enterprise Server

Microsoft(R) Exchange 2000 Server

Microsoft(R) Exchange Server

Internet Explorer

Windows(R) Internet Explorer(R)

Microsoft Edge

Microsoft(R) Edge

Microsoft SQL Server

Microsoft(R) SQL Server

Microsoft(R) SQL Server Enterprise Edition

MSMQ

Microsoft(R) Message Queue Server

Outlook

Outlook 2016

Microsoft(R) Office Outlook(R) 2016

Outlook 2019

Microsoft(R) Office Outlook(R) 2019

Outlook 2021

Microsoft(R) Office Outlook(R) 2021

Outlook Express

Microsoft(R) Outlook(R) Express

Windows 10

Windows(R) 10 Enterprise

Windows(R) 10 Pro

Windows(R) 10 Home

Windows 11

Windows(R) 11 Enterprise

Windows(R) 11 Pro

Windows(R) 11 Home

Windows Server 2016

Microsoft(R) Windows Server(R) 2016 Datacenter

Microsoft(R) Windows Server(R) 2016 Standard

Windows Server 2019

Microsoft(R) Windows Server(R) 2019 Datacenter

Microsoft(R) Windows Server(R) 2019 Standard

Windows Server 2022

Microsoft(R) Windows Server(R) 2022 Datacenter

Microsoft(R) Windows Server(R) 2022 Standard

Windows Server 2025

Microsoft(R) Windows Server(R) 2025 Datacenter

Microsoft(R) Windows Server(R) 2025 Standard

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

発行

2025年9月 3021-3-L49-20

著作権

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

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

奥付

マニュアル発行元

株式会社 日立製作所

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

変更内容

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

はじめに

このマニュアルは，JP1/Automatic Job Management System 3（以降，JP1/AJS3と省略します）で使用するコマンドの文法，情報定義ファイルの詳細，およびAPIの利用方法と文法を説明したものです。

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

マニュアルの構成

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

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

第1編 コマンド編

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

第2編 情報定義ファイル編

各種の情報定義ファイルの作成方法について説明しています。

第3編 API編

JP1/AJS3を操作するためのAPIについて説明しています。

第1編　コマンド編

1　コマンドの概要

この章では，コマンドを使ってJP1/AJS3を運用する方法を説明します。

JP1/AJS3のコマンドの記述形式および文法規則は，WindowsとUNIXとで共通です（ただし，使用できるコマンド，指定できるオプションが，Windowsで実行する場合とUNIXで実行する場合とで異なることもあります）。

Windowsの場合，コマンドプロンプトからコマンドを実行します。また，JP1/Scriptを使用して，JP1/AJS3のコマンド用スクリプトファイルを作成することもできます。JP1/Scriptで作成したスクリプトファイルを使用すると，スクリプト処理の開始時刻を指定したり，システムの起動時にスクリプトを自動的に実行させたりできます。JP1/Scriptについては，マニュアル「JP1/Script（Windows(R)用）」を参照してください。

UNIXの場合，制御端末からコマンドを実行します。

1.1　コマンドの記述形式

ここでは，コマンドの記述形式として，コマンドの指定方法と，コマンドの文法の説明に使用する記号について説明します。

1.1.1　コマンドの指定方法

コマンドの指定形式を次に示します。

(1)を「オプション」と呼びます。(2)を「引数」と呼びます。

次に，引数の指定方法を説明します。

最初にオプションを指定し，次にユニット名などの任意名を指定します。オプションの前に任意名を指定すると，システムは指定内容をすべて任意名として処理します。

オプションを複数指定する場合，指定順序は任意です。

一つのオプションに対し，値を複数指定する場合は，値間を「,（コンマ）」で区切ります。

値のないオプションは連続して指定できます。

（例）

「-a-b-c」を，「-abc」と指定できます。

値のない2バイトのオプションは，連続して指定できません。

（例）

「-a-ab」を，「-aab」と指定したり，「-cd -cf」を，「-cdcf」と指定したりすることはできません。

オプションを連続して指定する場合，最後のオプションには値を指定できます。

（例）

「-abc xyz」の「xyz」は，オプションcの値になります。

値を持たないオプションに値を指定した場合，システムはその値以降をすべて任意名として処理します。

期待しないオプションを指定した場合，エラーになります。

任意名にユニット名を指定する場合の注意事項については，「1.1.2 ユニット名の指定方法」を参照してください。

任意名に総称名を指定する場合の注意事項については，「1.1.4 総称名の指定方法」を参照してください。

最初の任意名（上記のコマンド指定例の場合，「任意名X」）に「-」で始まる文字列を指定したい場合は，「--△₁任意名X」と指定します（システムは，--△₁以降を任意名として処理します）。なお，二番目以降の任意名には，--△₁の指定は不要です。

（例）

二つの任意名（「-jobA」および「-jobB」）を続けて指定する場合は，「-- -jobA -jobB」と指定します。

任意名には正規表現が使用できます。

期待する数以上の任意名を指定した場合，エラーになります。

引数に指定する文字は，大文字・小文字が区別されます。大文字・小文字の使い分けに注意してください。

1.1.2　ユニット名の指定方法

コマンド引数の任意名としてユニット名を指定する方法について説明します。

ユニット名の指定形式を次に示します。

論理ホスト名を指定できるコマンドの場合（他ホストのユニットにリモートアクセスする場合）

[[論理ホスト名:][スケジューラーサービス名]:]ユニット名[:@実行ID]

論理ホスト名を指定できないコマンドの場合（自ホストのユニットにローカルアクセスする場合）

[[スケジューラーサービス名]:]ユニット名[:@実行ID]

次に，各項目について説明します。

論理ホスト名

論理ホスト名を指定できるコマンドと，指定できないコマンドがあります。詳細については，各コマンドの説明を参照してください。

自ホスト内に複数の論理ホスト名を持つ場合，スケジューラーサービス名と環境変数JP1_HOSTNAMEの指定によって該当する論理ホスト名が特定されます。したがって，論理ホスト名を指定する必要はありません。指定した場合，自ホスト内であってもTCP/IPプロトコルによる通信が発生するため，認証の設定が必要になります。

論理ホスト名を省略した場合，指定したスケジューラーサービス名の先頭に環境変数AJSMANAGERHOSTの内容が補われます。

環境変数AJSMANAGERHOSTを設定していない場合，自ホスト内として扱われ，環境変数JP1_HOSTNAMEに指定した論理ホスト名のサービスとします。

環境変数JP1_HOSTNAMEを指定していない場合，物理ホストのJP1/AJS3サービスが仮定されます。

スケジューラーサービス名

スケジューラーサービス名を指定した場合，-Fオプションおよび環境変数AJSCONFは無視されます。

スケジューラーサービス名を省略した場合，-Fオプションに指定した値が仮定されます。-Fオプションを省略した場合，環境変数AJSCONFの値が仮定されます。環境変数AJSCONFを設定していない場合は，デフォルトのスケジューラーサービス名が仮定されます。

ユニット名

ユニット名には，ジョブグループ名，ジョブネット名，ジョブ名を指定します。これらは完全名で指定することもできます。

完全名は，先頭が「/」で，ルートジョブグループからそのユニットまでの名称を「/」で区切って指定したものです。ユニットの完全名は，JP1/AJS3の中で一意に管理されています。

ユニット名を完全名で指定しなかった場合，指定した名称の先頭に環境変数AJSPATHの内容が補われます。環境変数AJSPATHを設定していない場合は，指定した名称の先頭に「/」が補われます。

前製品（JP1/AJS）からの移行のために使用できる記号文字

" & ' * < > ? [ ¥ ] ^‘ {｜} ~

をユニット名に使用している場合は，ユニット名全体を「"（ダブルクォーテーションマーク）」で囲み，記号文字の前に「¥」文字を置いてキャストする必要があります（例：ajsprintコマンドで，ユニット/net[1]を指定する場合：ajsprint "/net¥[1¥]"）。

なお，これらの記号は前製品（JP1/AJS）からの移行時のために用意されているため，その他の用途では使用しないでください。

実行ID

実行IDを指定できるコマンドと，指定できないコマンドがあります。詳細については，各コマンドの説明を参照してください。

実行IDは，ジョブネットを登録するとき，最上位ジョブネットの実行予定の一つに対して一つ割り振られる番号のことで，JP1/AJS3 - Viewやajsshowコマンドで確認できます。実行IDを指定できるコマンドで，実行IDの指定を省略すると，各コマンドが操作の対象とする世代を自動的に判定します。ジョブネットの世代の自動判定については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　4.2 ジョブネットの世代管理」を参照してください。

1.1.3　プランニンググループ使用時のコマンドでのユニット名の指定方法

プランニンググループの下にあるユニットを次に示すコマンドで操作する場合，ルートジョブネット名を省略しても，コマンド実行時に世代があるユニットが操作対象として自動的に選択されます。したがって，プランニンググループに対してコマンドを実行すれば，ルートジョブネット名を省略しても，運用中のルートジョブネットや下位にあるジョブに対して操作できます。

ajschgstat

ajsintrpt

ajskill

ajsplan

ajsrerun

ajsshow

操作対象となるユニットが自動的に選択されるかどうかは，上記のコマンドの-Xオプションで指定した値，または環境変数AJSAUTOJUDGEで設定した値で判定されます。その他のコマンドでは，環境変数AJSAUTOJUDGEの設定にかかわらず，プランニンググループの下にあるルートジョブネット名は省略できません。操作したいユニットを完全名で指定します。

各コマンドの詳細については，「1.5 コマンド一覧」を参照してください。環境変数AJSAUTOJUDGEの詳細については，「1.4 環境変数一覧」を参照してください。

自動選択の設定が有効かどうかは，次の規則に従って判定されます。

コマンドの-Xオプションに指定した値が優先されるため，-Xオプションに指定がある場合，その指定値で判定する。

「-X yes」の場合

自動選択の設定が有効です。プランニンググループの下のルートジョブネット名を省略してユニット名を指定できます。運用中のユニットが自動的に選択されて，該当するユニットに対して操作します。

「-X no」の場合

自動選択の設定が有効ではありません。プランニンググループの下のルートジョブネット名を省略できません。操作したいユニット名の完全名を指定します。

「-X auto」の場合

プランニンググループの下のルートジョブネット名を完全名で指定します。この場合，指定したユニットが操作対象になります。ただし，プランニンググループの下のルートジョブネット名を省略して指定したパス名と，同じ名称のユニットがある場合，省略したものとして扱われ，運用中のユニットが自動選択されて，該当するユニットに対して操作します。

-Xオプションに指定がない場合，環境変数AJSAUTOJUDGEの設定値で判定する。

AJSAUTOJUDGEが「YES」の場合

自動選択の設定が有効です。プランニンググループの下のルートジョブネット名を省略してユニット名を指定できます。運用中のユニットが自動的に選択されて，該当するユニットに対して操作します。

AJSAUTOJUDGEが「NO」の場合

自動選択の設定が有効ではありません。プランニンググループの下のルートジョブネット名を省略できません。操作したいユニット名の完全名を指定します。

AJSAUTOJUDGEが「AUTO」の場合

プランニンググループの下のルートジョブネット名を完全名で指定します。この場合，指定したユニットが操作対象になります。ただし，プランニンググループの下のルートジョブネット名を省略して指定したパス名と，同じ名称のユニットがある場合，省略したものとして扱われ，運用中のユニットが自動選択されて，該当するユニットに対して操作します。

値を設定しない場合

自動選択の設定が有効です。プランニンググループの下のルートジョブネット名を省略してユニット名を指定できます。運用中のユニットが自動的に選択されて，該当するユニットに対して操作します。ただし，ジョブネット名を省略したパターンのユニット名が見つからない場合は，ユニットの完全名で指定したと仮定され，該当するユニットに対して操作します。該当するユニットがない場合，エラーになります。

ジョブグループの下位にあるユニットに対しては，-Xオプションで値を指定したり，環境変数AJSAUTOJUDGEで値を設定したりしても，ルートジョブネット名は省略できません。

コマンドをリモート実行する場合の環境変数AJSAUTOJUDGEの値は，JP1/AJS3を起動したときの値に従います。

コマンドでプランニンググループの下位にあるユニットを操作する場合のユニット構成の例を次の図に示します。

図1‒1　コマンド操作時のプランニンググループのユニット構成例

上記のユニット構成で，オプションの指定，または環境変数の設定によってどのユニットが操作対象になるかを，ajsplanコマンドを例にして次に示します。

「-X yes」の場合

コマンドの実行例：ajsplan -h -X yes /プランニンググループ

操作対象ユニット：プランニンググループ/ジョブネット1-3

コマンドの実行例：ajsplan -h -X yes /プランニンググループ/ジョブ1

操作対象ユニット：プランニンググループ/ジョブネット1-3/ジョブ1

「-X no」の場合

コマンドの実行例：ajsplan -h -X no /プランニンググループ/ジョブネット1-3/ジョブ1

操作対象ユニット：プランニンググループ/ジョブネット1-3/ジョブ1

「-X auto」の場合

コマンドの実行例：ajsplan -h -X auto /プランニンググループ

操作対象ユニット：プランニンググループ/ジョブネット1-3

コマンドの実行例：ajsplan -h -X auto /プランニンググループ/ジョブネット1-1

操作対象ユニット：プランニンググループ/ジョブネット1-1

コマンドの実行例：ajsplan -h -X auto /プランニンググループ/ジョブ1

操作対象ユニット：プランニンググループ/ジョブネット1-3/ジョブ1

AJSAUTOJUDGEが「YES」の場合

コマンドの実行例：ajsplan -h /プランニンググループ

操作対象ユニット：プランニンググループ/ジョブネット1-3

コマンドの実行例：ajsplan -h /プランニンググループ/ジョブ1

操作対象ユニット：プランニンググループ/ジョブネット1-3/ジョブ1

AJSAUTOJUDGEが「NO」の場合

コマンドの実行例：ajsplan -h /プランニンググループ/ジョブネット1-3/ジョブ1

操作対象ユニット：プランニンググループ/ジョブネット1-3/ジョブ1

AJSAUTOJUDGEが「AUTO」の場合

コマンドの実行例：ajsplan -h /プランニンググループ

操作対象ユニット：プランニンググループ/ジョブネット1-3

コマンドの実行例：ajsplan -h /プランニンググループ/ジョブネット1-1

操作対象ユニット：プランニンググループ/ジョブネット1-1

コマンドの実行例：ajsplan -h /プランニンググループ/ジョブ1

操作対象ユニット：プランニンググループ/ジョブネット1-3/ジョブ1

AJSAUTOJUDGEに値を設定しない場合

コマンドの実行例：ajsplan -h /プランニンググループ

操作対象ユニット：プランニンググループ/ジョブネット1-3

コマンドの実行例：ajsplan -h /プランニンググループ/ジョブネット1-1

操作対象ユニット：プランニンググループ/ジョブネット1-1

コマンドの実行例：ajsplan -h /プランニンググループ/ジョブ1

操作対象ユニット：プランニンググループ/ジョブネット1-3/ジョブ1

プランニンググループの下のルートジョブネット名（プランニンググループ/ジョブネット1-2）と，ルートジョブネットの下のユニット名（プランニンググループ/ジョブネット1-2/ジョブネット1-2）で同じ名称のユニットがある場合，ルートジョブネット名を省略したユニット名しか指定できません。運用中のユニットが自動的に選択されて，該当するユニットに対して操作します。

プランニンググループの下のルートジョブネット名（プランニンググループ/ジョブネット1-2）に対して操作したい場合，-Xオプションに「no」を指定するか，または環境変数AJSAUTOJUDGEに「NO」を設定して，ユニットの完全名で指定してください。

1.1.4　総称名の指定方法

任意名を指定する場合に，総称名を表す記号（「*」「?」「[」「]」）を指定できる場合があります。

例えば，ジョブネット（/net1）中にジョブ（job1，job2，job3，job4）が定義されている場合，ジョブネット（/net1）中のすべてのジョブを操作対象にしたいときは，「/net1/*」，「/net1/job?」「/net1/job[1234]」のように指定できます。

1.1.5　IPv6アドレスの指定方法

コマンドの引数としてIPv6アドレスを指定する場合，指定できるIPv6アドレスには，次の条件があります。

使用できる文字は英数字および「:（半角コロン）」

なお，英字の大文字・小文字は区別しません。

指定できる文字数は，3バイト以上39バイト以下

また，IPv6アドレスの指定方法として，次に示すルールがあります。

「:（半角コロン）」で区切られた16ビット単位の文字列（ブロック）の先頭が「0」で始まる場合，「0」を省略できる。

（例）次の二つのIPv6アドレスは同一のものとして処理されます。

2001:db80:1234:5678:9abc:def1:2345:0001

2001:db80:1234:5678:9abc:def1:2345:1

16ビットすべてが「0」の場合，ブロックごと省略できる。すべてが「0」のブロックが複数連続する場合，ブロックをまとめて省略できる。

（例）次の二つのIPv6アドレスは同一のものとして処理されます。

2001:db80:0000:0000:0000:0000:0000:9abc

2001:db80::9abc

IPv6アドレスを角括弧（[　]）で囲む表記方法は，JP1/AJS3では使用できない。

使用できる例：2001:db80::afff:1

使用できない例：[2001:db80::afff:1]

IPv6アドレスにプレフィックスを指定する表記方法は，JP1/AJS3では使用できない。

使用できる例：2001:db80::afff:1

使用できない例：2001:db80::afff:1/32

1.1.6　コマンドの文法の説明に使用する記号

コマンドの文法の説明に使用する記号を次の表に示します。

表1‒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を採用する」ことを示します。

1.1.7　コマンドのリモート実行

JP1/AJS3 - Managerホストから，ほかのJP1/AJS3 - Managerホストに対してコマンドをリモート実行できます。

コマンドのリモート実行機能を使用すると，実行先の論理ホストのスケジューラーサービスに対して，ユニットの操作やスケジューラーサービスの現在の運用環境を出力できます。

リモート実行したコマンドの標準出力，標準エラー出力およびコマンドの戻り値は，コマンド投入元に反映されます。ただし，出力されるメッセージは，実行先のホストの，JP1/AJS3を起動時の言語種別に依存します。

リモート実行できるコマンドと，リモート実行の方法を次の表に示します。

表1‒2　リモート実行できるコマンドとリモート実行の方法

コマンド名

リモート実行の方法

ジョブ名，ジョブネット名，またはジョブグループ名に論理ホスト名を付加

環境変数AJSMANAGERHOSTに論理ホスト名を指定※1

オプションに論理ホスト名を指定

ajschange

○

○

−

ajschgjob

○

○

−

ajschgnet

○

○

−

ajsentry

○

○

−

ajsintrpt

○

○

−

ajskill

○

○

−

ajsleave

○

○

−

ajsplan

○

○

−

ajsplanout

○

○

−

ajsprint

○

○

−

ajsrerun

○

○

−

ajsshow

○

○

−

ajsstatus

−

○

○※2

ajssuspend

○

○

−

（凡例）

○：指定できる。

−：指定できない。

注

コマンド実行時に使用される環境変数については，「1.4.1 JP1/AJS3のコマンド実行時に使用される環境変数」の表1-5を参照してください。

注※1

環境変数AJSMANAGERHOSTは，JP1/AJS3の起動時には設定しないでください。

注※2

-hオプションで指定します。

コマンドをリモート実行するには，コマンド実行先のJP1/AJS3を起動してください。また，JP1/Baseのユーザー管理機能を使用して，ユーザー認証やユーザーマッピングなどを設定してください。

JP1/Baseのユーザー管理機能の設定については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　3. セットアップ」（Windowsの場合）またはマニュアル「JP1/Automatic Job Management System 3 構築ガイド　13. セットアップ」（UNIXの場合）を参照してください。

1.1.8　コマンド実行時の環境変数

論理ホストのJP1/AJS3サービスに対するコマンドを実行する場合は，環境変数JP1_HOSTNAMEに論理ホスト名を指定してください。

ジョブネットやジョブを操作するコマンドでは，ユニットのアクセス権限を，コマンド実行時のOSユーザー名で判断します。OSユーザー名とJP1ユーザー名が異なる場合は，環境変数JP1_USERNAMEにJP1ユーザー名を設定してください。

コマンド実行時に使用される環境変数については，「1.4.1 JP1/AJS3のコマンド実行時に使用される環境変数」の表1-5を参照してください。

1.2　コマンド使用時の注意事項

コマンドを実行する際の注意事項を次に示します。

1.2.1　コマンド共通の注意事項

JP1/AJS3サービスの文字コードと異なる文字コードでコマンドを実行すると，統合トレースログにそれぞれの文字コードでメッセージが出力されるため，文字コードが混在して文字化けが発生するおそれがあります。

システムで使用している文字コードがEUCの場合，コマンド実行結果として表示される文字列に日本語が含まれていると実行結果の表示がずれることがあります。

UNIX上のJP1/AJS3 - Managerで，「/opt/jp1/hcclibcnf/regdir/HKEY_LOCAL_MACHINE.dat」ファイルに参照権限のないユーザーはコマンドを実行できません。このファイルに参照権限がない場合にコマンドを実行すると，エラーメッセージ「KAVS1007-E ホスト名が解決できません（論理ホスト名）」が出力されます。

コマンドの引数にファイル名を指定する場合は，ファイルの内容を環境設定パラメーターAJSCHARCODEに指定した文字コードに合わせる必要があります。

1.2.2　スケジューラーサービスに関するコマンドの注意事項

ジョブネットの登録解除処理（JP1/AJS3 - Viewからの操作も含む）は，保存世代数に応じて大量なデータベースの更新処理が発生するため，処理に時間が掛かることがあります。ほかの処理に影響を与えないようにするため，次のことに注意してください。

実行登録解除処理は多重実行しない。

業務量が少ない時間帯に実行登録解除を行う。

コマンド実行時に設定が必要な環境変数を設定する。

設定が必要な環境変数の詳細については，「1.1.8 コマンド実行時の環境変数」を参照してください。

1.2.3　システムリソースを大量に消費するコマンド，または処理同士が競合するコマンドに関する注意事項

システムリソースを大量に消費したり処理同士が競合したりする，性能単価の高いコマンド（JP1/AJS3 - ViewおよびJP1/AJS3 - Web Consoleからの操作も含みます）を使用する際は，次の運用を推奨します。

ジョブまたはジョブネットの実行に関する操作

ジョブまたはジョブネットの実行に関する操作を連続的に行うと，サービスへの負荷が高くなり，運用に影響を与えるおそれがあります。ジョブまたはジョブネットの実行に関する操作は連続して行わずに，2〜3秒の間隔を空けて実行してください。

該当するコマンド：ajsleave，ajsrerun，ajsplan，ajsintrptなど。

配下のユニット数の影響を受ける操作

操作によっては配下のユニット数に比例して処理対象となる情報数が多くなるため，運用に影響を与えるおそれがあります。配下のユニット数が500個を超える場合は業務量が少ない時間帯に実行してください。

該当するコマンド：ajsleave，ajsrerun，ajsplanなど。

総称名指定や-Rオプションの指定による大量のユニットに対する操作

総称名指定や-Rオプションの指定でコマンドを実行すると，処理対象となる情報数が多くなるため，運用に影響を与えるおそれがあります。総称名指定や-Rオプションを指定する場合，-E，-L，または-Tオプションを一緒に併用して，操作対象のユニットを絞り込んでください。JP1/AJS3 - Viewでは，一度に選択するユニットの数を少なくして操作してください。

JP1/AJS3 - Web Consoleでは，複数ユニットを選択して操作できないため，該当しません。

該当するコマンド：ajsleave，ajsrerun，ajsplan，ajsintrptなど。

世代数の多いジョブネットの操作

世代数の多いジョブネットの操作を行うと，処理対象となる情報数が多くなるため，運用に影響を与えるおそれがあります。世代数の多いジョブネットの操作は，業務量が少ない時間帯に実行してください。また，オプションの指定によって操作の対象となる期間や世代を絞り込んでください。

該当するコマンド：ajsleave，ajsrerun，ajsplan，ajsintrptなど。

該当する操作一覧については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　1.3.2 JP1/AJS3の運用に影響を与えるおそれがある操作一覧」を参照してください。

1.2.4　コマンドを実行するコンソールでの操作に関する注意事項

OSには，コンソールで実行しているプロセスを一時停止させる機能があります。この機能を使用すると，タイミングによっては一時停止したプロセスが確保している資源が解放されなくなり，他プロセスが待ち状態になったり，通信相手のプロセスがタイムアウトしたり，該当するコマンドが休眠して終了しなくなるなどの問題が発生します。コマンドを実行中に，次のような操作を行わないでください。

Windowsの場合

コマンドプロンプトで「簡易編集モード」を有効にしている場合，コマンドプロンプト画面上でマウスをクリックすると，タイトルバーに「選択」と表示されて画面出力が停止します。この操作を行うと，解除するまでコマンドの実行が停止されるため，「簡易編集モード」を使用しないことを推奨します。

コマンド実行中の出力を［Ctrl］+［S］キーで停止しないでください。解除するまでコマンドの実行が停止されます。

UNIXの場合

コマンド実行中に，SIGTSTPシグナルでプロセスを一時停止させないでください。このシグナルは，標準で［Ctrl］+［Z］キーに割り当てられています。この操作をして該当するコマンドが資源を確保したままになった場合，JP1/AJS3サービスやほかのコマンドが資源を確保できなくなり，待ち状態になるおそれがあります。

1.2.5　文字コードUTF-8を使用している場合の注意事項

文字コードUTF-8を使用している場合，日本語などのマルチバイト文字は，その他の文字コードを使用する場合よりも多くのバイト数で表現されます。そのため，次のコマンドの実行時，表示させる情報に日本語が含まれている場合は出力カラムがずれて表示されます。

該当するコマンド

ajsshow，ajsrelease，jpqagtshow，jpqqueshow，jpqresshow，jpqendjobshow，jpqjobshow，jpqdbcond，jpqreguser，ajsagtshow，ajsplanout

文字コードUTF-8を使用している場合，コマンド実行時に日本語などのマルチバイト文字を指定する際，その他の文字コードを使用する場合よりも使用できる文字数が少なくなることがあります。

文字コードUTF-8を使用しているホストから次のコマンドをリモート実行する際，実行先ホストのDB種別（AJSCHARCODE）もUTF-8である場合は，環境変数AJSCONVERTUTF8に「no」を指定する必要があります。

該当するコマンド

ajschange，ajschgjob，ajschgnet，ajsentry，ajsintrpt，ajskill，ajsleave，ajsplan，ajsprint，ajsrerun，ajsshow，ajsstatus，ajssuspend，ajsplanout

環境変数AJSCONVERTUTF8を指定しない，または「yes」を指定してコマンドをリモート実行した場合，表示結果に文字化けが発生したり，ユニットに対する処理が正しく行われなかったりします。

環境変数AJSCONVERTUTF8については，「1.4.1 JP1/AJS3のコマンド実行時に使用される環境変数」の表1-5を参照してください。

文字コードUTF-8を使用していて，環境設定パラメーターDEFLENTYPEに「sjis」が設定されている場合，次の項目で指定できる文字数はシフトJIS環境と同じ文字数になります。

ユニット詳細定義のユニット名

ユニット詳細定義のコメント

スケジュール設定の排他ジョブネット名

ただし，ユニットの最大ネスト数（最大階層数）は10になります（デフォルトは30）。

1.2.6　Windowsでコマンドを使用する場合の注意事項

Windowsでコマンドを使用する場合は，次のことに注意してください。

コマンドの引数には，JIS 2004で追加された第3水準漢字，第4水準漢字を使用しないでください。これらの文字を使用した場合，正常に動作しないおそれがあります。

Administrators権限が必要なコマンドを実行する際には，コマンドプロンプトを管理者として起動する必要があります。ただし，UAC機能が無効の場合は，コマンドプロンプトを管理者として起動する必要はありません。

1.2.7　Solaris 11でコマンドを使用する場合の注意事項

Solaris 11でjajs_spmd，ajsagtadd，ajsagtalt，ajsagtdelおよびjpqで始まる名称のコマンドを実行する場合は，次に示す設定例を参考にして，環境変数JP1_HCCNETSOCKを必ず設定してください。

# JP1_HCCNETSOCK=JP1_AJS
# export JP1_HCCNETSOCK

ただし，次のコマンドは除きます。

jpqimport

jpqexport

jpqregguestuser

jpqreguser

jpqdbcond

1.2.8　HP-UX，AIX，Linuxでコマンドを使用する場合の注意事項

HP-UX，AIX，またはLinuxでJP1/AJS3を使用している場合，次に示すコマンドは使用できません。

ajscnvdbexport

ajscnvdbimport

jp1ajs2_setup_cluster

1.3　他プログラムとの連携

コマンドを使用してJP1/OJE for VOS3ホスト，AS/400（JP1/OJE for Midrange Computer）ホストにジョブをサブミットしたり，ジョブの実行状態を監視したりできます。

コマンドの指定方法に関しては，連携しない場合と比較して異なるところはありません。ただし，ジョブ名やユーザー名などを指定するときの制限値があります。制限値の詳細および注意事項を連携プログラムごとに説明します。

1.3.1　JP1/OJE for VOS3と連携する場合

制限値

JP1/OJE for VOS3システムに対して使用できるコマンドは次のとおりです。

jpqendjobshow，jpqjobcan，jpqjobget，jpqjobshow，jpqjobsub，jpqqueshow，ajsdefine（ユニット定義ファイルの，QUEUEジョブの定義情報）

コマンドの制限値を次に示します。

表1‒3　JP1/OJE for VOS3と連携する場合の制限値一覧

定義項目

制限値

マネージャーホスト名

JP1/OJE for VOS3のホスト名：255バイト以内の文字列。

キュー名

32バイト以内の文字列。

日本語は指定できない。英字の大文字・小文字は区別される。

ジョブ名

63バイト以内の文字列。

日本語は指定できない。

省略時，JCL中のJOB文に記述されたジョブ名が仮定される。

ユーザー名

32バイト以内の文字列。

日本語は指定できない。

実行優先順位

指定できない（実行優先順位を指定しても，JP1/OJE for VOS3側で無視される。JP1/OJE for VOS3では，JCLに指定された実行優先順位に従ってジョブが実行される）。

実行ファイル名

省略できない。54バイト以内の文字列。

ジョブが格納されているデータセット名を指定する。区分データセットまたはLIMEデータセットの場合は，メンバー名も指定する。日本語は指定できない。

パラメーター

1,023バイト以内の文字列。

実行するプログラムに渡す引数を指示しても無視される。ただし，JCLの一部を置換するための文字列は指定できる（指定方法については，マニュアル「VOS3 オープンジョブウェイ支援 JP1/Open Job Entry」を参照のこと）。

置換するための文字列以外の部分が，101バイト以上の文字列を指定すると，パラメーターエラーになる。

転送先ファイル名

54バイト以内の文字列。

ファイルを転送するデータセット名を指定する。

データセット名，およびファイル内では，日本語は指定できない。

注意事項

JP1/OJE for VOS3との連携を開始する前に，jpqreguserコマンドを使って，ジョブのサブミット元ホストにユーザー情報（コマンドを実行するときの，ログインユーザーに対応するVOS3ユーザー）を登録しておく必要があります。

jpqreguserコマンドについては，「2. セットアップコマンド　jpqreguser」を参照してください。

1.3.2　AS/400（JP1/OJE for Midrange Computer）と連携する場合

制限値

AS/400システムに対して使用できるコマンドは次のとおりです。

jpqendjobshow，jpqjobcan，jpqjobget，jpqjobshow，jpqjobsub，jpqqueshow，ajsdefine（ユニット定義ファイルの，QUEUEジョブの定義情報）

コマンドの制限値を，次の表に示します。

表1‒4　AS/400（JP1/OJE for Midrange Computer）と連携する場合の制限値一覧

定義項目

制限値

マネージャーホスト名

AS/400システムのホスト名：15バイト以内の文字列。

キュー名

AS/400システムのジョブ待ち行列名：10バイト以内の文字列。

ジョブ名

AS/400システムのジョブ名：10バイト以内の文字列。

省略した場合，「NONAME」が仮定される。

ユーザー名

32バイト以内の文字列。

日本語は指定できない。

実行優先順位

AS/400システム上でのジョブの優先順位を指定する。指定できる値は，1，3，および5。

優先度が最も高いのは5。省略した場合，1が仮定される。2を指定した場合1，4を指定した場合5がそれぞれ指定されたものとする。

実行ファイル名

AS/400システム上の実行ファイルを，「ライブラリー名/ファイル名」または「ライブラリー名/ファイル名.メンバ名」の形式で，それぞれの項目を10バイト以内の文字列で指定する。

パラメーター

実行するAS/400システムの実行ファイルへ渡すパラメーターを32バイト以内で指定する。複数のパラメーターを指定する場合は，「,（コンマ）」で区切って指定する。

転送元ファイル名

JP1/AJS3 - Managerにあるファイルを511バイト以内の文字列で指定する。ファイル名はフルパス名で指定する。テキスト形式のファイルだけ転送できる。各行は80文字以内。

転送先ファイル名

AS/400システム上の転送先を，「ライブラリー名/ファイル名.メンバ名」の形式で指定する。この場合，AS/400システム上にすでにあるファイルを指定する必要がある。ライブラリー名を省略して「ファイル名.メンバ名」の形式で指定した場合，AS/400システムの構成定義ファイルのDFT_PTHで指定されるライブラリー名が仮定される。

その他の詳細については，マニュアル「JP1/Open Job Entry for Midrange Computer」を参照してください。

1.4　環境変数一覧

JP1/AJS3のコマンド実行時に使用される環境変数と，JP1/AJS3から実行されるジョブ実行時に設定される環境変数を示します。

1.4.1　JP1/AJS3のコマンド実行時に使用される環境変数

コマンド実行時に使用される環境変数を次の表に示します。

表1‒5　コマンド実行時に使用される環境変数の一覧

環境変数名

内容

参照契機

AJSMANAGERHOST

操作先ホストの論理ホスト名

ユニットを操作するコマンド，およびajsstatusコマンドをリモート実行するとき，ユニット名指定時に論理ホスト名が省略された場合。※1

JP1_HOSTNAME

自ホストの論理ホスト名

JP1/AJS3が自ホストの論理ホスト名を参照する場合。

または，コマンド実行時に操作対象の論理ホストを参照する場合（コマンドのオプションとして，論理ホスト名を指定しなかった場合）。※2

AJSCONF

スケジューラーサービス名

オブジェクト名指定時に，スケジューラーサービス名が省略され，かつ，-Fオプションのスケジューラーサービス名が省略された場合。

AJSPATH

AJSパス名

ユニットを操作するコマンド※1に，ユニット名が完全名で指定されなかった場合（ジョブグループ名として利用します）。

JP1_USERNAME

JP1ユーザー名

ユニットを操作するコマンド※1，または実行エージェントの運用に使用するコマンドでユーザーのアクセス権限取得時に，OSのユーザー名と異なるJP1ユーザー名を利用する場合。

LANG

言語種別

出力するテキストの言語種別を切り分ける場合。

Windowsの場合はホストの設定に依存するため，利用されません。

ユニットを操作するコマンド※1を実行する場合，コマンドの実行対象ユニットが定義されているスケジューラーサービスの環境設定パラメーターAJSCHARCODEの設定と同じ言語種別を設定してください。

ただし，中国語を使用する場合は，JP1/AJS3がサポートするGB18030コードのLANGを指定してください。

TZ

タイムゾーン

スケジュールを計算する場合や，日時を表示する場合。※3

AJSAUTOJUDGE

プランニンググループの下にあるユニットの中から操作対象を自動選択する機能の指定

次に示すコマンドで，-Xオプションを省略した場合。※4

ajschgstatコマンド

ajsintrptコマンド

ajskillコマンド

ajsplanコマンド

ajsrerunコマンド

ajsshowコマンド

AJSDISPSUBUNITTYPE

ジョブグループ種別の表示・非表示

ajsrestoreコマンドで，退避ボックスの中に退避したユニットの一覧を標準出力ファイルに出力する場合。※5

AJSCONVERTUTF8

文字コード変換

コマンドのリモート実行時に実行先ホストの環境変数LANGがja_JP.UTF-8，ja_JP.utf8，JA_JP，またはJA_JP.UTF-8の場合で，JP1/AJS3 - Managerの通信処理で文字コード変換を行わないとき。※6

LC_ALL

言語種別

コマンドの引数や処理対象のユニット名などにマルチバイト文字が指定されている場合。

Windowsの場合はホストの設定に依存するため，利用されません。

この環境変数は設定不要です。設定が必要な場合は，環境変数LANGと同じ値を設定してください。環境変数LANGと異なる値を設定すると，マルチバイト文字を扱うJP1/AJS3の処理が誤動作するおそれがあります。

注※1

「ユニットを操作するコマンド」については，表1-10を参照してください。また，環境変数AJSMANAGERHOSTは，JP1/AJS3の起動時には設定しないでください。

注※2

環境変数はJP1_HOSTNAMEが設定されているかどうかで使用されるユーザーマッピングが異なります。

環境変数JP1_HOSTNAMEが設定されている場合，環境変数JP1_HOSTNAMEに設定された論理ホストに定義されているユーザーマッピングが使用されます。

環境変数JP1_HOSTNAMEが設定されていない場合，物理ホストに定義されているユーザーマッピングが使用されます。

論理ホストを参照する場合は，必ず環境変数JP1_HOSTNAMEを設定する必要があります。

物理ホストを参照する場合は，環境変数JP1_HOSTNAMEを設定しないでください。設定した場合，コマンドが失敗することがあります。

注※3

Windowsの場合，コマンド実行時のタイムゾーンをシステムのタイムゾーンと合わせてください。

注※4

環境変数AJSAUTOJUDGEの指定値に従って，プランニンググループの下にあるユニットの中から操作対象を選択します。

環境変数AJSAUTOJUDGEで指定する値を次に示します。

YES

自動的に選択して操作する場合に指定します。

コマンドに指定するユニット名は，プランニンググループの下のルートジョブネット名を省略して指定します。

NO

自動的に選択して操作しない場合に指定します。

指定したユニットに対して操作します。プランニンググループの下のルートジョブネット名を省略して指定することはできません。

AUTOまたは値の設定なし

ユニット名の指定方法に従って，自動的に選択して操作するかしないかを決定する場合に指定します。

自動的に選択して操作する場合

プランニンググループの下のルートジョブネット名を省略してユニット名を指定します。

自動的に選択して操作しない場合

プランニンググループの下のルートジョブネット名を省略しないでユニット名を指定します。この場合，指定したユニットが操作対象になります。ただし，プランニンググループの下のルートジョブネット名を省略して指定したパス名と，同じ名称のユニットがある場合，省略したものとして扱われ，操作対象のユニットが自動選択されます。

注※5

環境変数AJSDISPSUBUNITTYPEの指定値に従って，標準出力ファイルに出力する形式を決定します。

環境変数AJSDISPSUBUNITTYPEで指定する値を次に示します。

YES

ジョブグループ種別を出力します。

（出力形式）

退避ファイル名：退避元ユニット名：退避ユニット名：退避ユニット種別（ジョブグループ種別）

（例）

0001:/group1:group2:g(p)

NOまたは値の設定なし

ジョブグループ種別を出力しません。

（出力形式）

退避ファイル名：退避元ユニット名：退避ユニット名：退避ユニット種別

（例）

0001:/group1:p_group1:g

なお，ユニットの種別とジョブグループの種別については，「3. 通常の運用で使用するコマンド　ajsprint」の表3-15を参照してください。

注※6

コマンドのリモート実行先の環境変数LANGがja_JP.UTF-8，ja_JP.utf8，JA_JP，またはJA_JP.UTF-8の場合に，環境変数AJSCONVERTUTF8の指定値に従って，JP1/AJS3 - Managerの通信処理で文字コード変換を行うかどうかを指定します。

環境変数AJSCONVERTUTF8で指定する値を次に示します。

yesまたは値の指定なし

JP1/AJS3 - Managerの通信処理で文字コード変換を行う場合に指定します。

no

JP1/AJS3 - Managerの通信処理で文字コード変換を行わない場合に指定します。

コマンド投入元とリモート実行先の文字コードがUTF-8同士の場合は，「no」を指定してください。

1.4.2　JP1/AJS3から実行されるジョブ実行時に設定される環境変数

ジョブ実行時に設定される環境変数を次の表に示します。

表1‒6　ジョブ実行時に設定される環境変数の一覧

環境変数名

意味

AJSENV

スケジュールに従ってジョブが起動されたことを識別できるようになります。

通常は，YESが設定されます。

AJSPRE_ST

先行ジョブまたは先行ジョブネットの終了状態を表す文字が設定されます。

指定される文字を次に示します。

n：正常終了

w：警告終了

a：異常終了

先行ジョブや先行ジョブネットが複数ある場合は，異常のレベルの高いものが設定されます。先行ジョブや先行ジョブネットがない場合はn（正常終了）が設定されます。再実行時の開始ジョブの場合も，開始ジョブの先行ジョブやジョブネットの状態が設定されます。再実行によって先行ジョブやジョブネットの状態が正常終了や警告終了に変更されると，変更された値が設定されます。

AJSPRE_RC

先行ジョブの戻り値（−2,147,483,648〜2,147,483,647の値）が設定されます。先行ジョブが複数ある場合は，すべての戻り値の論理和が設定されます。先行ジョブがない場合は0が設定されます。再実行時の開始ジョブの場合は，前回実行したときの戻り値が設定されます。

AJSNETNAME※1

ルートジョブネット名（899バイト以内の文字列）が設定されます。

AJSJOBNAME※1

ジョブ名（930バイト以内の文字列）が設定されます。

AJSHOST※1

ジョブの実行を依頼したマネージャーホスト名（255バイト以内の文字列）が設定されます。

AJS_AJSCONF※1

ジョブの実行を依頼したマネージャーホストのスケジューラーサービス名（30バイト以内の文字列）が設定されます。

AJSEXDATE※1

ルートジョブネットの実行開始予定日（yyyy/mm/ddの形式）が設定されます。ジョブネットの実行が遅延したり，翌日に再実行したりした場合でも，当初の実行予定日が設定されます。

AJSEXECID※1

ジョブの実行ID（10バイト以内の文字列）が設定されます。

AJSEXECPID※1

起動条件監視中世代の実行ID（10バイト以内の文字列）が設定されます。

なお，起動条件監視をしていない場合は値なしになります。

JP1_HOSTNAME※1

論理ホストの場合だけ論理ホスト名が設定されます。※2

JP1JobName※1

実行ファイル名，またはジョブ名（63バイト以内の文字列）が設定されます。QUEUEジョブまたはjpqjobsubコマンドでジョブ名を指定している場合はそのジョブ名が設定され，PCジョブ，UNIXジョブ，QUEUEジョブ，アクションジョブでジョブ名を指定していない場合は，実行ファイル名が設定されます。

実行ファイル名は，パス情報を除いたファイル名部分の先頭から63バイト分までの文字列が設定されます。

JP1JobID※1

ジョブ番号（1〜999,999の値）が設定されます。キューレスジョブの場合，内部で使用するID（10バイト以内の文字列）が設定されます。

JP1UserName※1

ジョブをサブミットしたユーザー名（63バイト以内の文字列）が設定されます。

JP1_USERNAME※1

ジョブをサブミットしたユーザー名（63バイト以内の文字列）が設定されます。

JP1UNCName※1

ジョブを実行しているエージェントホスト名（255バイト以内の文字列）が設定されます。

JP1NBQSQueueName※1

ジョブの登録先であるマネージャーホスト名（255バイト以内の文字列）とキュー名（63バイト以内の文字列）が「¥¥マネージャーホスト名¥キュー名」の形式で設定されます。

ジョブ詳細定義の［実行エージェント］に実行エージェント名（255バイト以内の文字列）を指定した場合は，キュー名の代わりに実行エージェント名が「¥¥マネージャーホスト名¥実行エージェント名」の形式で設定されます。

また，ジョブ詳細定義の［実行エージェント］に実行エージェントグループ名（255バイト以内の文字列）を指定した場合は，キュー名の代わりに実行エージェントグループ名が「¥¥マネージャーホスト名¥実行エージェントグループ名」の形式で設定されます。

ただし，キューレスジョブの場合は設定されません。

JP1NBQSClientName（Windows限定）※1

ジョブを投入したクライアントコンピュータ名（15バイト以内の文字列）が設定されます。ただし，キューレスジョブの場合は設定されません。

JP1Priority※1

ジョブの実行優先順位（UNIX版では1〜5の値，Windows版では32，64，128のどれかの値（64（低），32（中），128（高）））が設定されます。

HOME（UNIX限定）

ジョブに指定した実行ユーザーの，パスワードファイルに定義されているログインディレクトリが設定されます。実行ユーザーが指定されていない場合は，実行ユーザーとして，ジョブネットを登録したJP1ユーザーに対応するOSユーザーが設定されます。

SHELL（UNIX限定）

ジョブを実行するための実行シェルが設定されます。実行シェルは，次に示す優先順位に従って決定されます。ジョブの登録方法によって設定されるシェルが異なるため注意が必要です。

優先順位がいちばん高いのは1です。

ジョブネットから実行するジョブで［コマンド文］を指定していない場合

ジョブに指定したスクリプトファイルの先頭行に書かれているシェル

実行ユーザーのパスワードファイルに定義されているログインシェル

/bin/sh

ジョブネットから実行するジョブで［コマンド文］を指定している場合※3

ジョブに指定した［コマンド文］の先頭行に書かれているシェル

実行ユーザーのパスワードファイルに定義されているログインシェル

/bin/sh

jpqjobsubコマンドでジョブを実行する場合

ジョブに指定したスクリプトファイルの先頭行に書かれているシェル

jpqjobsubコマンドの-shlオプションに指定したシェルパス名

実行ユーザーのパスワードファイルに定義されているログインシェル

/bin/sh

LANG（UNIX限定）

JP1/AJS3起動時の環境変数LANGの値が設定されます。※5，※6

なお，Windows版JP1/AJS3は，通常，ユーザー環境変数を読み込みません。しかし，クラスタをセットアップすると，フェールオーバークラスタの仕様によってユーザー環境変数を読み込みます。

LOGNAME（UNIX限定）

ジョブに指定された実行ユーザーのユーザー名が設定されます。実行ユーザーが指定されていない場合は，実行ユーザーとして，ジョブネットを登録したJP1ユーザーに対応するOSユーザーが設定されます。

MAIL（UNIX限定）※1

「/usr/mail/実行ユーザー名（ジョブに指定された実行ユーザー，またはジョブネットを登録したJP1ユーザーに対応するOSユーザー）」が設定されます。

PATH（UNIX限定）※1

「/bin:/usr/bin」だけを設定します。※4，※5

AJSQLManagerName（Windows限定）※1

キューレスジョブの場合だけ，ジョブの実行を依頼したマネージャーホスト名（255バイト以内の文字列）が設定されます。

注

記載されている環境変数は，ジョブ定義時に環境変数として使用することはできません。また，環境変数ファイルとして指定するファイル内で使用することもできません。

AIXの場合は，/etc/environmentの情報は引き継がれません。

大文字・小文字にかかわらず，「JP1」，「AJS」，および「AJS2」から始まる環境変数は使用しないでください。フレキシブルジョブの場合は，大文字・小文字にかかわらず，「JP1」，「AJS」，「AJS2」，および「AS_」から始まる環境変数は使用しないでください。

環境変数TZはジョブ実行時には設定されません。

「AJS」で始まる環境変数は，ジョブネットからジョブを登録した場合だけ設定されます。サブミットジョブには設定されません。

注※1

フレキシブルジョブの場合は設定されません。

注※2

UNIXの場合

ジョブの詳細定義の［実行先サービス］に［標準］を指定した場合

jajs_spmdコマンドの-hオプションに指定した論理ホスト名が設定されます。

-hオプションを省略した場合は，環境変数JP1_HOSTNAMEの値が設定されていれば，論理ホストとして値が引き継がれます。物理ホストの場合は，何も設定されません。

ジョブの詳細定義の［実行先サービス］に［キューレス］を指定した場合

ジョブの実行先ホストが論理ホストであれば，ジョブの詳細定義の［実行エージェント］に指定された値を設定します。ジョブの実行先ホストが物理ホストであれば，何も設定されません。

Windowsの場合

ジョブの詳細定義の［実行先サービス］に［標準］を指定した場合

論理ホストの場合は，JP1/AJS3サービス起動時に環境変数JP1_HOSTNAMEに論理ホスト名を設定します。物理ホストの場合は，何も設定されません。

ジョブの詳細定義の［実行先サービス］に［キューレス］を指定した場合

ジョブの実行先ホストが論理ホストであれば，ジョブの詳細定義の［実行エージェント］に指定された値を設定します。ジョブの実行先ホストが物理ホストであれば，何も設定されません。

注※3

［コマンド文］を指定している場合，［スクリプトファイル名］に指定したスクリプトファイルの先頭行にシェルが記述されていても有効になりません。

注※4

JP1/AJS3からジョブを起動した場合，JP1/AJS3が明示的に環境変数PATHに「/bin：/usr/bin」を設定しています。それ以外の値を設定したい場合はジョブ定義時に指定したコマンドやスクリプトファイルでの定義，またはローカルログインスクリプトでの定義で設定するようにしてください。

注※5

実行先サービスが［キューレス］のジョブの場合は，キューレスエージェントサービス起動時の環境変数の値が設定されます。

注※6

フレキシブルジョブの場合は，JP1/AJS3 Autonomous Agentサービス起動時の環境変数の値が設定されます。

環境変数には，JP1/AJS3で設定されるもの（表1-6の環境変数，ジョブ定義時に指定した環境変数，ジョブ定義時に環境変数ファイルとして指定したファイル内の環境変数）のほかに，ジョブ定義時に指定したコマンド文やスクリプトファイル，ローカルログインスクリプト，システムログインスクリプトにも設定できます。

なお，環境変数TZのように，ジョブ実行時に設定されない環境変数を設定したい場合は，次に示すどれかに設定してください。これらの中で同じ環境変数があった場合，次に示す優先順位に従って有効になります（優先順位がいちばん高いのは1です）。

Windowsの場合

環境変数※1に指定した環境変数

環境変数ファイル※2に指定した環境変数

システム環境変数

UNIXの場合

ジョブ定義時に指定したコマンドやスクリプトファイルでの定義

ローカルログインスクリプトでの定義

システムログインスクリプトでの定義

環境変数※1に指定した環境変数

環境変数ファイル※2に指定した環境変数

キューレスエージェントサービス起動時の環境変数※3

注※1

JP1/AJS3 - Viewの画面の環境変数に指定した変数，またはjpqjobsubコマンドの-envオプションに指定した変数

注※2

JP1/AJS3 - Viewの画面の環境変数ファイルに指定した変数，またはjpqjobsubコマンドの-evオプションに指定した変数ファイル

注※3

実行先サービスが［キューレス］のジョブの場合だけ該当します。

注意事項

Windowsの場合，ジョブの実行時にシステム環境変数が有効になりますが，ユーザー環境変数は有効になりません。ただし，JP1/AJS3サービスの起動アカウントをシステムアカウントからユーザーアカウントに変更した場合，ジョブ実行時にJP1/AJS3サービスの起動アカウントのユーザー環境変数が有効になります。

また，クラスタシステムをセットアップした論理ホストでは，システム起動時にフェールオーバークラスタ※がユーザー環境変数を読み込みます。フェールオーバークラスタから起動した論理ホストのJP1/AJS3サービスでは，ユーザー環境変数が有効になり，ジョブ実行時にもユーザー環境変数が使用されます。

なお，JP1/AJS3サービス起動時に読み込まれる環境変数には，システム環境変数のほかにOSが起動するときに設定する環境変数も含まれます。

注※

フェールオーバークラスタ以外のクラスタソフトについては仕様を確認してください。

1.5　コマンド一覧

この節では，コマンドを使用目的別に次に示すグループに分けて一覧表に記載します。

セットアップ時に使用するコマンド

環境のカスタマイズに使用するコマンド

JP1/AJS3を制御するコマンド

ユニットを操作するコマンド

実行エージェントの運用に使用するコマンド

ジョブの実行に使用するコマンド

組み込みDBを操作するコマンド

障害時に使用するコマンド

特別な運用で使用するコマンド

各コマンドの詳細説明は，次の節以降にアルファベット順に記載しています。Windowsの場合だけ使用できるコマンド，UNIXの場合だけ使用できるコマンドがあります。注意してください。

1.5.1　セットアップ時に使用するコマンド

JP1/AJS3のセットアップ時に使用するコマンドの一覧を次の表に示します。

セットアップ時に使用するコマンドの詳細については，「2. セットアップコマンド」を参照してください。

表1‒7　セットアップ時に使用するコマンドの一覧

機能

コマンド名

Windows

UNIX

必要な実行権限

提供している製品

スケジューラーサービスが使用するデータベースをセットアップする。

サスペンド機能をセットアップする。

ajssetup

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

メール配信機能を設定する。

jpomailrecv

−

○

なし

M,A

VOS3ユーザーのユーザー情報を登録する。

jpqreguser※1

○

○

なし

（Windowsの場合，-aオプション指定時以外はAdministrators）

M,A

JP1ユーザーとして仮定したユーザーの情報を登録する。

jpqregguestuser※1

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

JP1/IMと連携するためのアダプターコマンド設定ファイルを作成または削除する。

ajs_adapter_setup

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

組み込みDB環境をセットアップする。

ajsembdbsetup

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

組み込みDB環境を構築する。

ajsembdbbuild

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

組み込みDBをアンセットアップする。

ajsembdbunset

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

構成定義に登録されている，組み込みDBを操作するコマンドに必要な情報を表示する。

ajsembdbidlist

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

定義内容の事前チェック機能の実行環境をセットアップする。

ajschksetup

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M,A

JP1/AJS3の環境設定パラメーターを定義する。

jajs_config

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M,A

JP1/AJS3をセットアップする。

jajs_setup

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

JP1/AJS3の論理ホストに対応した動作環境をセットアップする。

jajs_setup_cluster

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M,A

JP1/AJS2からJP1/AJS3にバージョンアップインストールしたあとに，JP1/AJS3を標準構成にセットアップする。

jajs_migrate

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

JP1/AJS2 Version 8以前の環境のデータベースからスケジューラーサービスのデータをバイナリファイルで出力する。

ajscnvdbexport

○

△1

Windows：

Administrators

UNIX：

スーパーユーザー

M

データベース退避データをスケジューラーデータベースへ格納する。

ajscnvdbimport

○

△1

Windows：

Administrators

UNIX：

スーパーユーザー

M

JP1/AJS3の標準データベース（組み込みDB）をインストールする。

ajsembdbinstl

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

JP1/AJS3の標準データベース（組み込みDB）をアンインストールする。

ajsembdbuninstl

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

ディザスター・リカバリー運用設定情報をエクスポートする。

jajs_rpenvexport

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

ディザスター・リカバリー運用設定情報をインポートする。

jajs_rpenvimport

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

ディザスター・リカバリー環境をセットアップする。

jajs_rpsite

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

JP1/AJS3 Autonomous Agentサービス，JP1/AJS3 Autonomous Agent Messengerサービスをセットアップする。

ajsatsetup

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M,A※2

Web Consoleサーバをセットアップする。

ajswebsetup

○

△2

Windows：

Administrators

UNIX：

スーパーユーザー

W

JP1/AJS3 System Control Managerサービス，JP1/AJS3 System Control Agentサービスをセットアップする。

ajssysctlsetup

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M,A

（凡例）

○：提供している。

△1：Solaris版だけ提供している。

△2：Linux版だけ提供している。

−：提供していない。

M：JP1/AJS3 - Manager

A：JP1/AJS3 - Agent

W：JP1/AJS3 - Web Console

注

Windowsのホストで，Administrators権限が必要なコマンドを実行する場合は，コマンドプロンプトを管理者として起動する必要があります。ただし，UAC機能が無効の場合は，コマンドプロンプトを管理者として起動する必要はありません。

注※1

JP1/Baseを前提とするJP1シリーズの製品の稼働中には，このコマンドを実行しないでください。

注※2

JP1/AJS3 - Agent Minimal Editionでは，このコマンドは使用できません。

1.5.2　環境のカスタマイズに使用するコマンド

JP1/AJS3の環境を運用に合わせてカスタマイズするときに使用するコマンドの一覧を次の表に示します。

表1‒8　環境のカスタマイズに使用するコマンドの一覧

機能

コマンド名

Windows

UNIX

必要な実行権限

提供している製品

トレースログファイルのサイズを変更したり，参照したりする。

ajstrsetsz

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

イベントジョブおよびカスタムイベントジョブを実行する場合に，イベント・アクションエージェントプロセスが記憶する要求元マネージャーホスト名を変更する。

jpoagoec

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M,A

ジョブ実行環境のデータベースを圧縮する。

jpqdbcond

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

JP1/AJS3 Check Managerサービス，またはJP1/AJS3 Check Agentサービスのトレースログファイルサイズを変更する。

ajschktrsetsz

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M,A

イベント・アクション制御マネージャーが保持する情報を削除する。

jpomanevreset

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

イベント・アクション制御マネージャーの内部ログを解析し，マネージャーへのデータ送信頻度が高いエージェントと起動条件の情報を表示する。

jpomanevshow

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

（凡例）

○：提供している。

M：JP1/AJS3 - Manager

A：JP1/AJS3 - Agent

注

Windowsのホストで，Administrators権限が必要なコマンドを実行する場合は，コマンドプロンプトを管理者として起動する必要があります。ただし，UAC機能が無効の場合は，コマンドプロンプトを管理者として起動する必要はありません。

1.5.3　JP1/AJS3を制御するコマンド

JP1/AJS3を制御するために使用するコマンドの一覧を次の表に示します。

表1‒9　JP1/AJS3を制御するコマンドの一覧

機能

コマンド名

Windows

UNIX

必要な実行権限

提供している製品

システム起動時に，JP1/AJS3を自動起動する。

jajs_start

−

○

UNIX：

スーパーユーザー

M,A

システム停止時に，JP1/AJS3を自動停止する。

jajs_stop

−

○

UNIX：

スーパーユーザー

M,A

論理ホスト環境で，JP1/AJS3を起動する。

jajs_start.cluster

−

○

UNIX：

スーパーユーザー

M,A

論理ホスト環境で起動しているJP1/AJS3を停止する。

jajs_stop.cluster

−

○

UNIX：

スーパーユーザー

M,A

JP1/AJS3のプロセスを起動する。

jajs_spmd

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M,A

JP1/AJS3のプロセスを終了する。

jajs_spmd_stop

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M,A

ホストサービス管理機能（jajs_hstd）の詳細プロセスを個別に起動する。

jajs_hstd

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

ホストサービス管理機能（jajs_hstd）の詳細プロセスを個別に終了する。

jajs_hstd_stop

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

スケジューラーサービスを起動する。

ajsstart

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

スケジューラーサービスを終了する。

ajsstop

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

スケジューラーサービスの運用環境を一時的に変更する。

ajsalter

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

スケジューラーサービスの運用環境を標準出力ファイルに出力する。

ajsstatus

○

○

なし

M

スケジューラーログから，指定した条件に合うログレコードを抽出し，出力する。

ajslogprint

○

○

なし

M

クラスタで運用している場合に，起動中のJP1/AJS3のプロセスを強制終了する。

jajs_killall.cluster

−

○

UNIX：

スーパーユーザー

M,A

JP1/AJS3の状態（各コンポーネントが起動しているか，終了しているか）を確認する。

jajs_spmd_status

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M,A

JP1/AJS3の稼働情報および稼働中に有効な環境設定パラメーター情報を出力する。

jajs_status

○

○

なし

M

JP1/AJS3の稼働状況レポートを出力する。

ajsreport

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

JP1/AJS3 - Viewを起動する。

ajs

○

−

なし

V

JP1/AJS3 Check Managerサービス，またはJP1/AJS3 Check Agentサービスを起動する。

ajschkstart

−

○

UNIX：

スーパーユーザー

M,A

JP1/AJS3 Check Managerサービス，またはJP1/AJS3 Check Agentサービスを停止する。

ajschkstop

−

○

UNIX：

スーパーユーザー

M,A

運用プロファイルの設定を変更する。

ajsprofalter

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

運用プロファイルの設定を確認する。

ajsprofstatus

○

○

なし

M

Outlookを使用しない場合でメールを送信する場合に，メール送信プロファイルを作成・変更・削除する。

jpomailprof

○

−

Windows：

Administrators

M,A

接続許可設定ファイルの内容の有効化，および有効な接続許可ホストの一覧を出力する。

jajs_pmtcon

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M,A

設定されているAJS管理者の情報を出力する。

jajsshowadminusr

−

○

UNIX：

スーパーユーザー

M,A

JP1/AJS3 Autonomous Agent Messengerサービスを起動する。

ajsatmstart

−

○

UNIX：

スーパーユーザー

M,A

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

ajsatmstop

−

○

UNIX：

スーパーユーザー

M,A

JP1/AJS3 Autonomous Agentサービスを起動する。

ajsatstart

−

○

UNIX：

スーパーユーザー

M,A

JP1/AJS3 Autonomous Agentサービス，JP1/AJS3 Autonomous Agent Messengerサービスの状態を出力する。

ajsatstatus

−

○

なし

M,A

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

ajsatstop

−

○

UNIX：

スーパーユーザー

M,A

環境設定ファイルに指定できるタイムゾーンIDを列挙する。

ajswebtz

−

△

なし

W

環境設定ファイルに指定できるタイムゾーンIDを列挙する。

ajswebtz.bat

○

−

なし

W

JP1/AJS3 HTTP ServerサービスとJP1/AJS3 Web Application Serverサービスを起動する。

jajs_web

−

△

UNIX：

スーパーユーザー

W

JP1/AJS3 HTTP ServerサービスとJP1/AJS3 Web Application Serverサービスを停止する。

jajs_web_stop

−

△

UNIX：

スーパーユーザー

W

JP1/AJS3 System Control ManagerサービスとJP1/AJS3 System Control Agentサービスを起動する。

ajssysctlstart

−

○

UNIX：

スーパーユーザー

M,A

JP1/AJS3 System Control ManagerサービスとJP1/AJS3 System Control Agentサービスの情報を取得する。

ajssysctlstatus

○

○

なし

M,A

JP1/AJS3 System Control ManagerサービスとJP1/AJS3 System Control Agentサービスを停止する。

ajssysctlstop

−

○

UNIX：

スーパーユーザー

M,A

（凡例）

○：提供している。

△：Linux版だけ提供している。

−：提供していない。

M：JP1/AJS3 - Manager

A：JP1/AJS3 - Agent

V：JP1/AJS3 - View

W：JP1/AJS3 - Web Console

注

Windowsのホストで，Administrators権限が必要なコマンドを実行する場合は，コマンドプロンプトを管理者として起動する必要があります。ただし，UAC機能が無効の場合は，コマンドプロンプトを管理者として起動する必要はありません。

1.5.4　ユニットを操作するコマンド

ユニットを操作するために使用するコマンドの一覧を次の表に示します。

なお，表中のコマンドの実行権限は，操作対象のユニットの属性として指定されたJP1資源グループ名に対して，コマンドを実行するユーザーが持つJP1権限レベルによって決まります。ただし，操作対象のユニットにJP1資源グループ名の指定がない場合や，コマンドを実行するユーザーがAdministrators権限（Windowsの場合），またはスーパーユーザー権限（UNIXの場合）を持つ場合は，表中の実行権限が必要とは限りません。実行権限については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　6.4 設定するアクセス権限の検討」を参照してください。

注意事項

「必要な実行権限」の欄に複数の実行権限が記載されている場合は，それらの中の一つの実行権限を持っていれば，そのコマンドを実行できます。

表1‒10　ユニットを操作するコマンドの一覧

機能

コマンド名

Windows

UNIX

必要な実行権限

提供している製品

ユニットを定義する。

ajsdefine

○

○

定義先

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

対象ユニットとその下のユニット（定義済みユニットの強制変更時）

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

M

ユニットの定義内容を変更する。

ajschange

○

○

変更先

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

属性変更時

JP1_AJS_Admin

ユニットの所有者権限

M

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

ajschgnet

○

○

変更先

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

M

ジョブの定義内容を変更する。

ajschgjob

○

○

変更先

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

M

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

ajscopy

○

○

コピー先・移動先

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

コピー対象ユニットとその下のユニット

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

JP1_AJS_Operator

JP1_AJS_Guest

移動対象ユニットとその下のユニット

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

M

ユニットを削除する。

ajsdelete

○

○

削除対象ユニットとその下のユニット

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

M

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

ajsname

○

○

出力対象ユニット

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

JP1_AJS_Operator

JP1_AJS_Guest

M

スケジューラーサービスの運用環境情報を標準出力ファイルに出力する。

ajsgtroot

○

○

なし

M

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

ajsprint

○

○

出力対象ユニットとその下のユニット

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

JP1_AJS_Operator

JP1_AJS_Guest

M

ユニットを退避する。

ajsbackup

○

○

退避対象ユニットとその下のユニット

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

JP1_AJS_Operator

JP1_AJS_Guest

M

退避ボックスや退避ファイルを削除する。

ajsbkudel

○

○

なし

M

ユニットを回復する。

ajsrestore

○

○

回復先

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

対象ユニットとその下のユニット（定義済みユニットの強制変更時）

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

M

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

ajsrgexport

○

○

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

JP1_AJS_Operator

JP1_AJS_Guest

M

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

ajsrgimport

○

○

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Operator

M

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

ajscalendar

○

○

変更先

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

M

複数のカレンダー情報を組み合わせて計算し，カレンダー情報ファイル形式で標準出力ファイルに出力する。

ajscalutil

○

○

ジョブグループ名を指定する場合：

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

JP1_AJS_Operator

JP1_AJS_Guest

ジョブグループ名を指定しない場合：

なし

M

特定期間について，ジョブネットの実行スケジュールを作成し，予定情報パラメーターの形式で標準出力ファイルに出力する。

ajsschedule

○

○

出力対象ユニットとその下のユニット

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

JP1_AJS_Operator

JP1_AJS_Guest

M

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

ajsentry

○

○

操作対象ユニットとその下のユニット

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Operator

M

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

ajsleave

○

○

操作対象ユニットとその下のユニット

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Operator

M

ルートジョブネットをサスペンドする。また，ルートジョブネットのサスペンド状態を解除する。

ajssuspend

○

○

操作対象ユニットとその下のユニット

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Operator

M

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

ajsshow

○

○

出力対象ユニットとその下のユニット

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

JP1_AJS_Operator

JP1_AJS_Guest

M

マネージャーで実行中のイベントジョブおよびカスタムイベントジョブの一覧を標準出力ファイルに出力する。

jpomanjobshow

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

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

ajsplan

○

○

操作対象ユニットとその下のユニット

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Operator

M

ジョブの状態を変更する。

ajschgstat

○

○

操作対象ユニット

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Operator

M

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

ajsintrpt

○

○

操作対象ユニットとその下のユニット

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Operator

M

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

ajskill

○

○

操作対象ユニットとその下のユニット

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Operator

M

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

ajsrerun

○

○

操作対象ユニットとその下のユニット

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Operator

M

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

ajsexport※

○

○

エクスポート対象ユニットとその下のユニット

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

JP1_AJS_Operator

JP1_AJS_Guest

M

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

ajsimport※

○

○

インポート先

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

M

定義内容の事前チェックの実行開始，実行状態表示を行う。

ajschkdef

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

リリース登録，リリース中止，およびリリース情報を出力する。

ajsrelease

○

○

リリース登録およびリリース中止の場合：

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_EditorおよびJP1_AJS_Operator

リリース情報の出力の場合：

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

JP1_AJS_Operator

JP1_AJS_Guest

M

ルートジョブネットおよびルートジョブネット配下のユニットの一時変更情報を標準出力ファイルに出力する。

ajsplanout

○

○

ルートジョブネット

JP1_AJS_Admin

JP1_AJS_Manager

JP1_AJS_Editor

JP1_AJS_Operator

JP1_AJS_Guest

M

（凡例）

○：提供している。

M：JP1/AJS3 - Manager

A：JP1/AJS3 - Agent

注

Windowsのホストで，Administrators権限が必要なコマンドを実行する場合は，コマンドプロンプトを管理者として起動する必要があります。ただし，UAC機能が無効の場合は，コマンドプロンプトを管理者として起動する必要はありません。

注※

このコマンドは，JP1/NETM/DMと連携してユニットを配布するために，JP1/AJS3が提供するパッケージング機能用のコマンドです。パッケージング機能用のバッチファイル，またはシェルスクリプトだけで使用できます。

1.5.5　実行エージェントの運用に使用するコマンド

実行エージェントの運用に使用するコマンドを次の表に示します。

表1‒11　実行エージェントの運用に使用するコマンドの一覧

機能

コマンド名

Windows

UNIX

必要な実行権限

提供している製品

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

ajsagtadd

○

○

JP1_JPQ_Admin

M

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

ajsagtdel

○

○

JP1_JPQ_Admin

M

実行エージェントのジョブ実行状態などの情報を標準出力に出力する。また，実行エージェントで実行中またはキューイング中のジョブ数の一覧を標準出力に出力する。

ajsagtshow

○

○

JP1_JPQ_Admin

JP1_JPQ_Operator

JP1_JPQ_User

または，

Windows：

Administrators

UNIX：

スーパーユーザー

M

実行エージェントの設定またはジョブの受付配信制限の状態を変更する。

ajsagtalt

○

○

JP1_JPQ_Admin

JP1_JPQ_Operator

M

実行エージェントの通信状態確認の開始，終了および実行エージェントの状態を標準出力に出力する。

ajsagtcheck

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

実行エージェントの定義情報をCSV形式で標準出力ファイルに出力する。

ajsagtprint

○

○

JP1_JPQ_Admin

JP1_JPQ_Operator

JP1_JPQ_User

または，

Windows：

Administrators

UNIX：

スーパーユーザー

M

実行エージェントで実行中のイベントジョブおよびカスタムイベントジョブの一覧を標準出力ファイルに出力する。

jpoagtjobshow

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M,A

一斉配信エージェントまたは一斉配信先の宛先エージェントとして設定されているかどうかなどの情報を標準出力に出力する。

ajsfxbcstatus

○

○

なし

M,A

実行エージェント稼働状況ログに記録したジョブ実行状態をCSV形式で標準出力に出力する。

ajsagtreport

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

（凡例）

○：提供している。

M：JP1/AJS3 - Manager

A：JP1/AJS3 - Agent

注

Windowsのホストで，Administrators権限が必要なコマンドを実行する場合は，コマンドプロンプトを管理者として起動する必要があります。ただし，UAC機能が無効の場合は，コマンドプロンプトを管理者として起動する必要はありません。

1.5.6　ジョブの実行に使用するコマンド

ジョブネットとしてではなく，ジョブ単体で実行する際に使用するコマンドを次の表に示します。

コマンドの実行に際しては，コマンドを実行するOSユーザーをJP1ユーザーとして認証サーバに登録しておく必要があります。コマンドの実行に必要な実行権限をコマンドごとに示します。必要に応じて，JP1ユーザーに実行権限を与えてください。実行権限については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　6.4 設定するアクセス権限の検討」を参照してください。

注意事項

「必要な実行権限」の欄に複数の実行権限が記載されている場合は，それらの中の一つの実行権限を持っていれば，そのコマンドを実行できます。

表1‒12　ジョブの実行に使用するコマンドの一覧

機能

コマンド名

Windows

UNIX

必要な実行権限

提供している製品

引数として指定されたプログラムを実行し，実行したプログラムの終了コードを一時ファイルに退避する。

jp1exec

○

−

なし

M,A

jp1execコマンドで退避した終了コードを返却する。

jp1exit

○

−

なし

M,A

（凡例）

○：提供している。

−：提供していない。

M：JP1/AJS3 - Manager

A：JP1/AJS3 - Agent

注

Windowsのホストで，Administrators権限が必要なコマンドを実行する場合は，コマンドプロンプトを管理者として起動する必要があります。ただし，UAC機能が無効の場合は，コマンドプロンプトを管理者として起動する必要はありません。

1.5.7　組み込みDBを操作するコマンド

組み込みDBを操作するコマンドを次の表に示します。

表1‒13　組み込みDBを操作するコマンドの一覧

機能

コマンド名

Windows

UNIX

必要な実行権限

提供している製品

組み込みDBのバックアップを取得する。

ajsembdbbackup

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

組み込みDBを監視する。

ajsembdbstatus

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

組み込みDBのシステムログを操作する。

ajsembdboplog

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

バックアップ強化機能が有効な場合に，JP1/AJS3の運用中に組み込みDBのバックアップを取得する。

jajs_dbbackup

○

○

Windows：

Administrators

UNIX：

スーパーユーザー，AJS管理者

M

バックアップ強化機能が有効な場合に，JP1/AJS3の運用中に取得したバックアップデータを使って組み込みDBをリストアする。

jajs_dbrestore

○

○

Windows：

Administrators

UNIX：

スーパーユーザー，AJS管理者

M

組み込みDBをバックアップ，またはバックアップとアンロードログファイルを使ってリストアする。

ajsembdbrstr

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

組み込みDBのデータのアンロード，リロードを行う。

ajsembdbrorg

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

組み込みDBのメンテナンスを行う。

ajsembdbreclaim

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

組み込みDBのデータベース領域を拡張する。

ajsembdbaddarea

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

組み込みDBのシステムファイルを拡張する。

ajsembdbaddlog

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

組み込みDBを停止する。

ajsembdbstop

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

組み込みDBを開始する。

ajsembdbstart

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

組み込みDBの操作コマンドの実行を中断する。

ajsembdbcancel

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

（凡例）

○：提供している。

M：JP1/AJS3 - Manager

注

Windowsのホストで，Administrators権限が必要なコマンドを実行する場合は，コマンドプロンプトを管理者として起動する必要があります。ただし，UAC機能が無効の場合は，コマンドプロンプトを管理者として起動する必要はありません。

1.5.8　外部DBを操作するコマンド

外部DBを操作するコマンドを次の表に示します。

表1‒14　外部DBを操作するコマンドの一覧

機能

コマンド名

Windows

UNIX

必要な実行権限

提供している製品

外部DB使用時に，JP1/AJS3 - Managerと接続している外部DBとの接続情報を表示，JP1/AJS3 - Managerと外部DBのデータベースとの接続関係を設定，およびジョブの実行抑止起動状態を解除する。

jajs_extdb

○

△

Windows：

Administrators

UNIX：

スーパーユーザー

M

（凡例）

○：提供している。

△：Linux版だけ提供している。

M：JP1/AJS3 - Manager

1.5.9　障害時に使用するコマンド

障害時に使用するコマンドを次の表に示します。

表1‒15　障害時に使用するコマンドの一覧

機能

コマンド名

Windows

UNIX

必要な実行権限

提供している製品

コアダンプ解析に必要な情報を採取する。

ajs2collectcore

−

○

UNIX：

スーパーユーザー

M,A

障害時に採取が必要な資料を採取する。

jajs_logまたは_04

−

○

UNIX：

スーパーユーザー

M,A,W

jajs_log.batまたは_04.bat

○

−

Windows：

Administrators

M,A,V,W

（凡例）

○：提供している。

−：提供していない。

M：JP1/AJS3 - Manager

A：JP1/AJS3 - Agent

V：JP1/AJS3 - View

W：JP1/AJS3 - Web Console

1.5.10　特別な運用で使用するコマンド

旧バージョン互換機能やオプション機能を使用する場合など，特別な運用で使用するコマンドを次の表に示します。

(1)　QUEUEジョブ，サブミットジョブ実行環境で使用するコマンド

QUEUEジョブ，サブミットジョブ実行環境で使用するコマンドを次に示します。

jpqexportコマンド，jpqimportコマンド，およびjajs_maintainコマンド以外のコマンドを実行する場合は，コマンドを実行するOSユーザーをJP1ユーザーとしてあらかじめ認証サーバに登録しておく必要があります。また，JP1ユーザーには，コマンドの実行に必要な実行権限を付与してください。実行権限については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　6.4 設定するアクセス権限の検討」を参照してください。

表1‒16　特別な運用で使用するコマンドの一覧（QUEUEジョブ，サブミットジョブ実行環境で使用するコマンド）

機能

コマンド名

Windows

UNIX

必要な実行権限

提供している製品

現時点でのジョブ実行環境をファイルに出力する。

jpqexport

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

サブミットジョブ実行環境構成定義ファイル（jpqsetup.conf）を使用して，サブミットジョブ用の実行環境（実行エージェント，キュー，および排他実行リソース）を一括定義する。

jpqimport

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

JP1/AJS3をメンテナンスする。

jajs_maintain

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

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

jpqjobsub

○

○

サブミットジョブ要求先

JP1_JPQ_Admin

JP1_JPQ_Operator

JP1_JPQ_User

M,A

ジョブの実行を中止，または強制終了する。

jpqjobcan

○

○

ジョブキャンセル要求先

JP1_JPQ_Admin

JP1_JPQ_Operator

JP1_JPQ_User※1

ただし，-emオプション指定時は次の権限が必要（上記の権限は不要）

Windows：

Administrators※2

UNIX：

スーパーユーザー

M,A

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

jpqjobalt

○

○

ジョブ保留・保留解除要求先

JP1_JPQ_Admin

JP1_JPQ_Operator

JP1_JPQ_User※1

M,A

ジョブを移動する。

jpqjobmove

○

○

ジョブ移動要求先

JP1_JPQ_Admin

JP1_JPQ_Operator

JP1_JPQ_User※1

M,A

特定のジョブのジョブ情報を標準出力に出力する。

jpqjobget

○

○

ジョブ情報取得要求先

JP1_JPQ_Admin

JP1_JPQ_Operator

JP1_JPQ_User※1

M,A

未終了ジョブ情報の一覧を標準出力に出力する。

jpqjobshow

○

○

ジョブ情報取得要求先

JP1_JPQ_Admin

JP1_JPQ_Operator

JP1_JPQ_User※1

M,A

終了ジョブ情報の一覧を標準出力に出力する。

jpqendjobshow

○

○

ジョブ情報取得要求先

JP1_JPQ_Admin

JP1_JPQ_Operator

JP1_JPQ_User※1

M,A

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

jpqjobdel

○

○

ジョブ削除要求先

JP1_JPQ_Admin

JP1_JPQ_Operator

M,A

キューを開く。

jpqqueopen

○

○

キューオープン要求先

JP1_JPQ_Admin

JP1_JPQ_Operator

ただし，-emオプション指定時は次の権限が必要（上記の権限は不要）

Windows：

Administrators※2

UNIX：

スーパーユーザー

M,A

キューを閉じる。

jpqqueclose

○

○

キュークローズ要求先

JP1_JPQ_Admin

JP1_JPQ_Operator

ただし，-emオプション指定時は次の権限が必要（上記の権限は不要）

Windows：

Administrators※2

UNIX：

スーパーユーザー

M,A

キュー情報を標準出力に出力する。

jpqqueshow

○

○

キュー情報取得要求先

JP1_JPQ_Admin

JP1_JPQ_Operator

JP1_JPQ_User

ただし，-emオプション指定時は次の権限が必要（上記の権限は不要）

Windows：

Administrators※2

UNIX：

スーパーユーザー

M,A

キューを追加する。

jpqqueadd

○

○

キュー追加要求先

JP1_JPQ_Admin

M

キューを削除する。

jpqquedel

○

○

キュー削除要求先

JP1_JPQ_Admin

M

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

jpqquealt

○

○

キュー定義変更要求先

JP1_JPQ_Admin

ただし，-emオプション指定時は次の権限が必要（上記の権限は不要）

Windows：

Administrators※2

UNIX：

スーパーユーザー

M

キューにエージェントホストを接続する。また，キューに接続するエージェントホストの優先順位を設定する。

jpqagtlink

○

○

エージェント接続要求先

JP1_JPQ_Admin

ただし，-emオプション指定時は次の権限が必要（上記の権限は不要）

Windows：

Administrators※2

UNIX：

スーパーユーザー

M

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

jpqagtunlink

○

○

エージェント接続解除要求先

JP1_JPQ_Admin

M

エージェントホスト情報を標準出力に出力する。

jpqagtshow

○

○

エージェント情報取得要求先

JP1_JPQ_Admin

ただし，-emオプション指定時は次の権限が必要（上記の権限は不要）

Windows：

Administrators※2

UNIX：

スーパーユーザー

M,A

マネージャーホストにエージェントホストを登録する。同時に，エージェントホストが接続するデフォルトキューを作成する。

jpqagtadd

○

○

エージェント追加要求先

JP1_JPQ_Admin

M

マネージャーホストからエージェントホストを削除する。同時に，エージェントホストが接続していたデフォルトキューを削除する。

jpqagtdel

○

○

エージェント削除要求先

JP1_JPQ_Admin

M

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

jpqagtalt

○

○

ジョブ実行多重度変更要求先

JP1_JPQ_Admin

ただし，-emオプション指定時は次の権限が必要（上記の権限は不要）

Windows：

Administrators※2

UNIX：

スーパーユーザー

M,A

排他実行リソース情報を標準出力ファイルに出力する。

jpqresshow

○

○

排他実行リソース情報取得要求先

JP1_JPQ_Admin

JP1_JPQ_Operator

JP1_JPQ_User

M

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

jpqresadd

○

○

排他実行リソース追加要求先

JP1_JPQ_Admin

M

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

jpqresdel

○

○

排他実行リソース削除要求先

JP1_JPQ_Admin

M

（凡例）

○：提供している。

M：JP1/AJS3 - Manager

A：JP1/AJS3 - Agent

注※1

JP1_JPQ_User権限の場合，操作または参照できるのは，ユーザー自身がサブミットしたジョブだけです。

注※2

Windowsのホストで，Administrators権限が必要なコマンドを実行する場合は，コマンドプロンプトを管理者として起動する必要があります。ただし，UAC機能が無効の場合は，コマンドプロンプトを管理者として起動する必要はありません。

(2)　キューレスジョブを使用する場合のコマンド

キューレスジョブ使用時に使用するコマンドを次に示します。

表1‒17　特別な運用で使用するコマンドの一覧（キューレスジョブ使用時に使用するコマンド）

機能

コマンド名

Windows

UNIX

必要な実行権限

提供している製品

キューレスジョブ実行環境をセットアップする。

ajsqlsetup

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M,A

キューレスエージェントサービスの運用環境を一時変更する。

ajsqlalter

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M,A

キューレスエージェントサービスに論理ホストをアタッチする。

ajsqlattach

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M,A

キューレスエージェントサービスから論理ホストをデタッチする。

ajsqldetach

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M,A

キューレスファイル転送サービスを起動する。

ajsqlftpstart

−

○

UNIX：

スーパーユーザー

M

キューレスファイル転送サービスを停止する。

ajsqlftpstop

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

キューレスエージェントサービスを起動する。

ajsqlstart

−

○

UNIX：

スーパーユーザー

M,A

キューレスエージェントサービスを停止する。

ajsqlstop

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M,A

キューレスエージェントサービスの詳細情報を出力する。

ajsqlstatus

○

○

なし

M,A

キューレストレースログファイルのサイズを変更する。

ajsqltrsetsz

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M,A

キューレスジョブ実行内部ログファイルのファイルサイズを変更する。

ajsqlexecsetsz

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M,A

（凡例）

○：提供している。

−：提供していない。

M：JP1/AJS3 - Manager

A：JP1/AJS3 - Agent

注

JP1/AJS3 - Agent Minimal Editionの場合，これらのコマンドは使用できません。

(3)　運用テストで使用するコマンド

運用テスト時に使用するコマンドを次に示します。

表1‒18　特別な運用で使用するコマンドの一覧（運用テストで使用するコマンド）

機能

コマンド名

Windows

UNIX

必要な実行権限

提供している製品

スケジューラーサービスのローカル日時を変更したり，参照したりする。

ajslocaldate

○

○

Windows：

Administrators

UNIX：

スーパーユーザー

M

（凡例）

○：提供している。

M：JP1/AJS3 - Manager

1.6　コマンド実行の前提条件

各コマンドを実行する際に起動しておく必要があるサービスを一覧表に示します。

表1‒19　コマンド実行時に起動しておく必要があるサービス

コマンド名

JP1/AJS3※1

スケジューラーサービス

HP NNM※2

Qa

Qf

CHm

CHa

At

Atm

Scm

Sca

ajs

−

−

−

−

−

−

−

−

−

−

−

ajs2collectcore

（UNIX限定）

−

−

−

−

−

−

−

−

−

−

−

ajsagtadd

○

−

−

−

−

−

−

−

−

−

−

ajsagtalt

○

−

−

−

−

−

−

−

−

−

−

ajsagtcheck

○

−

−

−

−

−

−

−

−

−

−

ajsagtdel

○

−

−

−

−

−

−

−

−

−

−

ajsagtprint

○

−

−

−

−

−

−

−

−

−

−

ajsagtreport

○

−

−

−

−

−

−

−

−

−

−

ajsagtshow

○

−

−

−

−

−

−

−

−

−

−

ajs_adapter_setup※3

−

−

−

−

−

−

−

−

−

−

−

ajsalter

○

○※6

−

−

−

−

−

−

−

−

−

ajsatmstart

（Linux限定）

−

−

−

−

−

−

−

−

−

−

−

ajsatmstop

（Linux限定）

−

−

−

−

−

−

−

−

○

−

−

ajsatsetup

−

−

−

−

−

−

−

−

−

−

−

ajsatstart

（Linux限定）

−

−

−

−

−

−

−

−

−

−

−

ajsatstatus

（Linux限定）

−

−

−

−

−

−

−

−

−

−

−

ajsatstop

（Linux限定）

−

−

−

−

−

−

−

○

−

−

−

ajsbackup

−

−

−

−

−

−

−

−

−

−

−

ajsbkudel

−

−

−

−

−

−

−

−

−

−

−

ajscalendar

○

−

−

−

−

−

−

−

−

−

−

ajscalutil

○※7

−

−

−

−

−

−

−

−

−

−

ajschange

○

−

−

−

−

−

−

−

−

−

−

ajschgjob

○

−

−

−

−

−

−

−

−

−

−

ajschgnet

○

−

−

−

−

−

−

−

−

−

−

ajschgstat

○

○

−

−

−

−

−

−

−

−

−

ajschkdef

○

−

−

−

−

○

○

−

−

−

−

ajschksetup※3

−

−

−

−

−

−

−

−

−

−

−

ajschkstart

（UNIX限定）

−

−

−

−

−

−

−

−

−

−

−

ajschkstop

（UNIX限定）

−

−

−

−

−

○

○

−

−

−

−

ajschktrsetsz

−

−

−

−

−

−

−

−

−

−

−

ajscnvdbexport※3

−

−

−

−

−

−

−

−

−

−

−

ajscnvdbimport※3

−

−

−

−

−

−

−

−

−

−

−

ajscopy

○

−

−

−

−

−

−

−

−

−

−

ajsdefine

○

−

−

−

−

−

−

−

−

−

−

ajsdelete

○

−

−

−

−

−

−

−

−

−

−

ajsembdbaddarea

−

−

−

−

−

−

−

−

−

−

−

ajsembdbaddlog

−

−

−

−

−

−

−

−

−

−

−

ajsembdbbackup※5

−

−

−

−

−

−

−

−

−

−

−

ajsembdbbuild※3

−

−

−

−

−

−

−

−

−

−

−

ajsembdbcancel

−

−

−

−

−

−

−

−

−

−

−

ajsembdbidlist※3

−

−

−

−

−

−

−

−

−

−

−

ajsembdbinstl※3

−

−

−

−

−

−

−

−

−

−

−

ajsembdboplog

−

−

−

−

−

−

−

−

−

−

−

ajsembdbreclaim

−

−

−

−

−

−

−

−

−

−

−

ajsembdbrorg

−

−

−

−

−

−

−

−

−

−

−

ajsembdbrstr※5

−

−

−

−

−

−

−

−

−

−

−

ajsembdbsetup※3

−

−

−

−

−

−

−

−

−

−

−

ajsembdbstart

−

−

−

−

−

−

−

−

−

−

−

ajsembdbstatus

−

−

−

−

−

−

−

−

−

−

−

ajsembdbstop

−

−

−

−

−

−

−

−

−

−

−

ajsembdbuninstl※3

−

−

−

−

−

−

−

−

−

−

−

ajsembdbunset※3

−

−

−

−

−

−

−

−

−

−

−

ajsentry

○

○

−

−

−

−

−

−

−

−

−

ajsexport

○

−

−

−

−

−

−

−

−

−

−

ajsfxbcstatus

−

−

−

−

−

−

−

−

−

−

−

ajsgtroot

−

−

−

−

−

−

−

−

−

−

−

ajsimport

○

−

−

−

−

−

−

−

−

−

−

ajsintrpt

○

○

−

−

−

−

−

−

−

−

−

ajskill

○

○

−

−

−

−

−

−

−

−

−

ajsleave

○

○

−

−

−

−

−

−

−

−

−

ajslocaldate※4

−

−

−

−

−

−

−

−

−

−

−

ajslogprint

−

−

−

−

−

−

−

−

−

−

−

ajsname

○

−

−

−

−

−

−

−

−

−

−

ajsplan

○

○

−

−

−

−

−

−

−

−

−

ajsplanout

○

−

−

−

−

−

−

−

−

−

−

ajsprint

○

−

−

−

−

−

−

−

−

−

−

ajsprofalter

○

−

−

−

−

−

−

−

−

−

−

ajsprofstatus

○

−

−

−

−

−

−

−

−

−

−

ajsqlalter※4

−

−

−

○

−

−

−

−

−

−

−

ajsqlattach※4

−

−

−

○

−

−

−

−

−

−

−

ajsqldetach※4

−

−

−

○

−

−

−

−

−

−

−

ajsqlexecsetsz※4

−

−

−

−

−

−

−

−

−

−

−

ajsqlftpstart※4

（UNIX限定）

−

−

−

−

−

−

−

−

−

−

−

ajsqlftpstop※4

−

−

−

−

○

−

−

−

−

−

−

ajsqlsetup※4

−

−

−

−

−

−

−

−

−

−

−

ajsqlstart※4

（UNIX限定）

−

−

−

−

−

−

−

−

−

−

−

ajsqlstatus※4

−

−

−

−

−

−

−

−

−

−

−

ajsqlstop※4

−

−

−

○

−

−

−

−

−

−

−

ajsqltrsetsz※4

−

−

−

−

−

−

−

−

−

−

−

ajsrelease

○

○※8

−

−

−

−

−

−

−

−

−

ajsreport

−

−

−

−

−

−

−

−

−

−

−

ajsrerun

○

○

−

−

−

−

−

−

−

−

−

ajsrestore

○

−

−

−

−

−

−

−

−

−

−

ajsrgexport

○

−

−

−

−

−

−

−

−

−

−

ajsrgimport

○

○

−

−

−

−

−

−

−

−

−

ajsschedule

○

−

−

−

−

−

−

−

−

−

−

ajssetup※3

−

−

−

−

−

−

−

−

−

−

−

ajsshow

○

−

−

−

−

−

−

−

−

−

−

ajsstart

○

−

−

−

−

−

−

−

−

−

−

ajsstatus

○

−

−

−

−

−

−

−

−

−

−

ajsstop

○

○

−

−

−

−

−

−

−

−

−

ajssuspend

○

○

−

−

−

−

−

−

−

−

−

ajssysctlsetup※3

−

−

−

−

−

−

−

−

−

−

−

ajssysctlstart

（UNIX限定）

−

−

−

−

−

−

−

−

−

−

−

ajssysctlstatus

−

−

−

−

−

−

−

−

−

−

−

ajssysctlstop

（UNIX限定）

−

−

−

−

−

−

−

−

−

○

○

ajstrsetsz

−

−

−

−

−

−

−

−

−

−

−

ajswebsetup

−

−

−

−

−

−

−

−

−

−

−

ajswebtz

（Linux限定）

−

−

−

−

−

−

−

−

−

−

−

ajswebtz.bat

（Windows限定）

−

−

−

−

−

−

−

−

−

−

−

jajs_config※3

−

−

−

−

−

−

−

−

−

−

−

jajs_dbbackup

○

−

−

−

−

−

−

−

−

−

−

jajs_dbrestore

−

−

−

−

−

−

−

−

−

−

−

jajs_hstd

○

−

−

−

−

−

−

−

−

−

−

jajs_hstd_stop

○

−

−

−

−

−

−

−

−

−

−

jajs_killall.cluster

（UNIX限定）

−

−

−

−

−

−

−

−

−

−

−

jajs_logまたは_04

（UNIX限定）

−

−

−

−

−

−

−

−

−

−

−

jajs_log.batまたは_04.bat

（Windows限定）

−

−

−

−

−

−

−

−

−

−

−

jajs_maintain※4

−

−

−

−

−

−

−

−

−

−

−

jajs_migrate※3

−

−

−

−

−

−

−

−

−

−

−

jajs_pmtcon※9

○

−

−

○

−

−

−

−

−

−

−

jajs_rpenvexport※3

−

−

−

−

−

−

−

−

−

−

−

jajs_rpenvimport※3

−

−

−

−

−

−

−

−

−

−

−

jajs_rpsite※3

−

−

−

−

−

−

−

−

−

−

−

jajs_setup※3

−

−

−

−

−

−

−

−

−

−

−

jajs_setup_cluster※3

−

−

−

−

−

−

−

−

−

−

−

jajs_spmd

○※10

−

−

−

−

−

−

−

−

−

−

jajs_spmd_status

−

−

−

−

−

−

−

−

−

−

−

jajs_spmd_stop

○

−

−

−

−

−

−

−

−

−

−

jajs_start

（UNIX限定）

−

−

−

−

−

−

−

−

−

−

−

jajs_start.cluster

（UNIX限定）

−

−

−

−

−

−

−

−

−

−

−

jajs_status

○

−

−

−

−

−

−

−

−

−

−

jajs_stop

（UNIX限定）

○

−

−

−

−

−

−

−

−

−

−

jajs_stop.cluster

（UNIX限定）

○

−

−

−

−

−

−

−

−

−

−

jajs_web

（Linux限定）

−

−

−

−

−

−

−

−

−

−

−

jajs_web_stop

（Linux限定）

−

−

−

−

−

−

−

−

−

−

−

jajsacfg※4

−

−

−

−

−

−

−

−

−

−

−

jajsmcfg※4

−

−

−

−

−

−

−

−

−

−

−

jp1ajs2_setup_cluster※3

（UNIX限定）

−

−

−

−

−

−

−

−

−

−

−

jp1exec

（Windows限定）

−

−

−

−

−

−

−

−

−

−

−

jp1exit

（Windows限定）

−

−

−

−

−

−

−

−

−

−

−

jpoagoec

−

−

−

−

−

−

−

−

−

−

−

jpoagtjobshow

○

−

−

−

−

−

−

−

−

−

−

jpomailprof

（Windows限定）

−

−

−

−

−

−

−

−

−

−

−

jpomailrecv※3

（UNIX限定）

○

−

−

−

−

−

−

−

−

−

−

jpomanevreset※11

○

−

−

−

−

−

−

−

−

−

−

jpomanevshow

○

−

−

−

−

−

−

−

−

−

−

jpomanjobshow

○

−

−

−

−

−

−

−

−

−

−

jpqagtadd※4

○

−

−

−

−

−

−

−

−

−

−

jpqagtalt※4

○

−

−

−

−

−

−

−

−

−

−

jpqagtdel※4

○

−

−

−

−

−

−

−

−

−

−

jpqagtlink※4

○

−

−

−

−

−

−

−

−

−

−

jpqagtshow※4

○

−

−

−

−

−

−

−

−

−

−

jpqagtunlink※4

○

−

−

−

−

−

−

−

−

−

−

jpqdbcond

−

−

−

−

−

−

−

−

−

−

−

jpqendjobshow※4

○

−

−

−

−

−

−

−

−

−

−

jpqexport※4

−

−

−

−

−

−

−

−

−

−

−

jpqimport※4

−

−

−

−

−

−

−

−

−

−

−

jpqjobalt※4

○

−

−

−

−

−

−

−

−

−

−

jpqjobcan※4

○

−

−

−

−

−

−

−

−

−

−

jpqjobdel※4

○

−

−

−

−

−

−

−

−

−

−

jpqjobget※4

○

−

−

−

−

−

−

−

−

−

−

jpqjobmove※4

○

−

−

−

−

−

−

−

−

−

−

jpqjobshow※4

○

−

−

−

−

−

−

−

−

−

−

jpqjobsub※4

○

−

−

−

−

−

−

−

−

−

−

jpqqueadd※4

○

−

−

−

−

−

−

−

−

−

−

jpqquealt※4

○

−

−

−

−

−

−

−

−

−

−

jpqqueclose※4

○

−

−

−

−

−

−

−

−

−

−

jpqquedel※4

○

−

−

−

−

−

−

−

−

−

−

jpqqueopen※4

○

−

−

−

−

−

−

−

−

−

−

jpqregguestuser※3

○

−

−

−

−

−

−

−

−

−

−

jpqqueshow※4

○

−

−

−

−

−

−

−

−

−

−

jpqreguser※3

−

−

−

−

−

−

−

−

−

−

−

jpqresadd※4

○

−

−

−

−

−

−

−

−

−

−

jpqresdel※4

○

−

−

−

−

−

−

−

−

−

−

jpqresshow※4

○

−

−

−

−

−

−

−

−

−

−

（凡例）

Qa：キューレスエージェントサービス

Qf：キューレスファイル転送サービス

CHm：JP1/AJS3 Check Manager

CHa：JP1/AJS3 Check Agent

At：JP1/AJS3 Autonomous Agentサービス

Atm：JP1/AJS3 Autonomous Agent Messengerサービス

Scm：JP1/AJS3 System Control Managerサービス

Sca：JP1/AJS3 System Control Agentサービス

○：起動しておく必要がある。

−：起動しておく必要がない。

注※1

クラスタ構成の場合，JP1/AJS3を起動する代わりに，「JP1/AJS3_論理ホスト」を起動しておく必要があります。

注※2

HP NNMのサービス名称については，HP NNMのドキュメントを参照してください。

注※3

コマンドの詳細については，「2. セットアップコマンド」を参照してください。

注※4

コマンドの詳細については，「4. 特別な運用で使用するコマンド」を参照してください。

注※5

組み込みDBのサービスを起動しておく必要があります。

注※6

次の場合に起動しておく必要があります。

スケジューラーサービス単位のスケジューラーログファイルを交代する場合

ジョブネットおよびジョブの実行を抑止，または抑止解除する場合

ホスト単位のスケジューラーログファイルの交代をする場合は起動不要です。

注※7

ジョブグループを指定する場合，JP1/AJS3サービスを起動しておく必要があります。

注※8

リリース登録またはリリース中止の場合起動しておく必要があります。

注※9

JP1/AJS3サービスまたはキューレスエージェントサービスのどちらかが起動している必要があります。

注※10

JP1/AJS3の機能を構成するプロセスを個別に起動する場合，JP1/AJS3サービスを起動しておく必要があります。

注※11

jpomanevresetコマンドは，JP1/AJS3ホストサービスが起動していて，かつ対象とするスケジューラーサービスが停止している場合だけ実行できます。対象とするスケジューラーサービスが起動している状態で実行した場合，またはJP1/AJS3サービス全体が停止している状態で実行した場合は，エラーになります。

2　セットアップコマンド

この章では，JP1/AJS3のセットアップ時に使用するコマンドを説明します。

ajs_adapter_setup

形式

ajs_adapter_setup
     {-i|-u}

機能

JP1/IMと連携するためのアダプターコマンド設定ファイル（Adapter_HITACHI_JP1_AJS2.conf）を作成または削除します。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-i

アダプターコマンド設定ファイルをアダプターコマンド設定ファイル格納先に作成します。このオプションを設定すると，JP1/IMがJP1/AJS3の定義情報を収集できるようになります。

-u

アダプターコマンド設定ファイルをアダプターコマンド設定ファイル格納先から削除します。

アダプターコマンド設定ファイル格納先

Windowsの場合

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

UNIXの場合

/opt/jp1base/plugin/conf/

注意事項

JP1/Baseがインストールされていない（アダプターコマンド設定ファイルの作成先のパスがない）場合，-iオプションでアダプターコマンド設定ファイルの作成を実行してもアダプターコマンド設定ファイルの作成は行われません。

オプションを省略した場合，-iが仮定されます。

クラスタでJP1/IMと連携してJP1/AJS3の定義情報を収集する場合，実行系と待機系の両方のシステムでこのコマンドを実行してください。

戻り値

0

正常終了。

0以外の値

異常終了。

ajsatsetup

形式

ajsatsetup
{-a [-p 一斉配信エージェントのIPアドレスまたはホスト名]|-m|-g|-u}

形式1（中継エージェントとしてセットアップ）

ajsatsetup -m

形式2（宛先エージェントとしてセットアップ）

ajsatsetup -a

形式3（一斉配信エージェントとしてセットアップ）

ajsatsetup -g

形式4（一斉配信先の宛先エージェントとしてセットアップ）

ajsatsetup -a -p 一斉配信エージェントのIPアドレスまたはホスト名

形式5（セットアップされている機能をすべてアンセットアップ）

ajsatsetup -u

機能

フレキシブルジョブ実行環境のセットアップおよびアンセットアップを行います。また，一斉実行機能をセットアップします。なお，JP1/AJS3 - Agent Minimal Editionでは，このコマンドは使用できません。

このコマンドによって設定される情報を次に示します。

サービスの登録

次のサービスを登録します。

登録するサービス名

-mオプション

-aオプション

（-pオプション指定時も含む）

-gオプション

JP1/AJS3 Autonomous Agentサービス

−

○

○

JP1/AJS3 Autonomous Agent Messengerサービス

○

○

○

通信ポートの設定

次の通信ポートをservicesファイルに登録します。

通信ポート（サービス名：ポート番号/プロトコル）

-mオプション

-aオプション

-gオプション

その他オプションなし

-pオプション

jp1ajs2atmsg：22251/tcp

○

○

○

○

jp1ajs2atmsg：22251/udp

−

−

○

○

（凡例）

○：設定する。

−：設定しない。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

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

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

UNIXの場合

/opt/jp1ajs2/bin/

引数

-m

フレキシブルジョブの要求元機能をセットアップします。

中継エージェントを使用しない場合はJP1/AJS3 - Managerで，中継エージェントを使用する場合は中継エージェントで指定します。

-a，-u，-gオプションとは同時に指定できません。

-a

フレキシブルジョブの要求先機能をセットアップします。

宛先エージェントで指定します。

-m，-u，-gオプションとは同時に指定できません。

-p 一斉配信エージェントのIPアドレスまたはホスト名

一斉配信先の宛先エージェントとしてセットアップします。

生存通知の送信先である一斉配信エージェントのIPアドレスまたはホスト名を指定します。指定できる文字数は，1〜128（単位：バイト）です。

-aオプションを指定している場合だけ指定できます。

このオプションに，名前解決できないホスト名や不正なフォーマットのIPアドレスを指定した場合，このコマンドは，メッセージKAVS8143-E またはKAVS8114-Eを出力して異常終了します。

-u

フレキシブルジョブ実行環境をアンセットアップします。一斉実行機能もアンセットアップします。また，JP1/AJS3 Autonomous Agentサービス，およびJP1/AJS3 Autonomous Agent Messengerサービスを削除します。ただし，servicesファイルの通信ポート（jp1ajs2atmsg：22251）の登録は削除しません。

-m，-a，-gオプションとは同時に指定できません。

-g

一斉配信エージェントとしてセットアップします。

-m，-a，-uオプションとは同時に指定できません。

注意事項

このコマンドはJP1/AJS3 Autonomous AgentサービスおよびJP1/AJS3 Autonomous Agent Messengerサービスが停止している状態で実行してください。サービスが起動しているとコマンドが異常終了するおそれがあります。

このコマンドを複数の異なる端末から同時に実行しないでください。

バックグラウンドで一斉実行機能の内部処理が実行されている場合に，次のオプションを指定してこのコマンドを実行すると，バックグラウンドの内部処理が完了するまで一時的にコマンドの処理が中断されます。そのため，処理に時間が掛かることがあります。

-a -pオプション

-gオプション

-uオプション

-a -pオプションには，「localhost」は指定できません。自ホストが一斉配信エージェントの場合，-a -pオプションには自ホストのIPアドレスまたは自ホスト名を指定してください。

戻り値

0

正常終了。

0以外の値

異常終了。

ajschksetup

形式

JP1/AJS3 - Managerの場合

ajschksetup
     [{[-m][-a]|[-u]}]

JP1/AJS3 - Agentの場合

ajschksetup
     [{[-a]|[-u]}]

機能

定義内容の事前チェック機能の実行環境を設定します。このコマンドによって設定される情報を次に示します。

サービスの登録

定義内容の事前チェック機能の実行で使用する次のサービスを登録します。

登録するサービス名

JP1/AJS3 - Manager

JP1/AJS3 - Agent

JP1/AJS3 Check Managerサービス

○

−

JP1/AJS3 Check Agentサービス

○

○

通信ポートの設定

定義内容の事前チェック機能の実行で使用する次の通信ポートをservicesファイルに登録します。

通信ポート（サービス名：ポート番号）

JP1/AJS3 - Manager

JP1/AJS3 - Agent

定義内容の事前チェック機能の実行（JP1/AJS3 Check Manager：23138）

○

−

定義内容の事前チェック機能の実行（JP1/AJS3 Check Agent：23139）

○

○

共通定義情報の設定

定義内容の事前チェック機能の実行で使用する共通定義情報を設定します。

設定情報

JP1/AJS3 - Manager

JP1/AJS3 - Agent

定義キー

環境設定パラメーター

[JP1_DEFAULT¥JP1AJS2¥CHECK]

"AJSCHK_CHECKFILE"=※

○

−

"AJSCHK_LOGDIR"=※

○

○

"AJSCHK_LOGSIZE"=dword:00001000

○

○

"AJSCHK_TRACELOGFILE"=※

○

○

"AJSCHK_CHARCODE"="none"

○

○

（凡例）

○：設定できる。

−：設定できない。

注※

値は，使用している環境によって異なります。環境設定パラメーターの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.7 JP1/AJS3定義内容の事前チェック機能の設定」を参照してください。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

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

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

UNIXの場合

/opt/jp1ajs2/bin/

引数

-m

JP1/AJS3 - Managerの定義内容の事前チェック機能をセットアップします。

JP1/AJS3 - Managerの場合だけ指定できます。JP1/AJS3 - Agentでは指定できません。

-uオプションとは同時に指定できません。

-a

JP1/AJS3 - Agentの定義内容の事前チェック機能をセットアップします。

-uオプションとは同時に指定できません。

-u

定義内容の事前チェック機能の設定を削除します。

Windowsの場合，管理ツールのサービス一覧からJP1/AJS3 Check Managerサービス，およびJP1/AJS3 Check Agentサービスを削除します。

-m，-aオプションとは同時に指定できません。

注意事項

Windows環境で-uオプションを指定してサービスを削除する場合，JP1/AJS3 Check Managerサービス，およびJP1/AJS3 Check Agentサービスが停止している状態で実行してください。

設定の種別を示すオプション（-m，-a，-u）を省略した場合，次のオプションが仮定されます。

JP1/AJS3 - Managerの場合：-m，-a

JP1/AJS3 - Agentの場合：-a

Windowsのマシンでこのコマンドを実行する際には，コマンドプロンプトを管理者として起動する必要があります。なお，UAC機能が無効の場合は，コマンドプロンプトを管理者として起動する必要はありません。

戻り値

0

正常終了。

0以外の値

異常終了。

使用例

JP1/AJS3 - Managerで，JP1/AJS3 Check ManagerサービスおよびJP1/AJS3 Check Agentサービスをセットアップします。

ajschksetup -m -a

ajscnvdbexport

形式

ajscnvdbexport
     [-mh 論理ホスト名]
     -F スケジューラーサービス名
     -b データベース退避ファイル格納ディレクトリ

機能

JP1/AJS2 Version 8以前の環境のスケジューラーデータベースから，指定したスケジューラーサービスのデータをバイナリファイルで出力します。

JP1/AJS2 Version 8以前の環境の，スケジューラーサービスのデータベースにアクセスできる状態の場合に実行できます。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

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

UNIXの場合

/opt/jp1ajs2/tools/

引数

-mh 論理ホスト名

論理ホスト名を指定します。指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，環境変数JP1_HOSTNAMEの設定があれば，環境変数値が仮定されます。環境変数JP1_HOSTNAMEの指定がない場合は，「JP1_DEFAULT」が仮定されます。

-F スケジューラーサービス名

処理対象とするスケジューラーサービスのサービス名を指定します。指定できる文字数は，1〜30（単位：バイト）です。

-b データベース退避ファイル格納ディレクトリ

データベース退避ファイルを格納するディレクトリを絶対パスで指定します。指定できる文字数は，1〜234（単位：バイト）です。

存在しないディレクトリは指定しないでください。

このコマンドを実行すると，次のディレクトリに，テーブルごとの退避ファイル「テーブル識別名.bk」が生成されます。

退避ファイル格納ディレクトリ¥論理ホスト名¥スケジューラーサービス名

注意事項

このコマンドは，JP1/AJS2 V8以前からの移行処理で使用するコマンドです。JP1/AJS3 V9でセットアップされたスケジューラーサービスを対象とした場合は，エラーになります。

このコマンドは，移行前の組み込みDBに対して操作するため，移行前のスケジューラーデータベースに組み込みDBを使用している場合は，次の環境変数に設定を追加してからコマンドを実行してください。

HP-UXの場合

SHLIB_PATH=移行前の組み込みDBのインストール先ディレクトリ/client/lib

SolarisまたはLinuxの場合

LD_LIBRARY_PATH=移行前の組み込みDBのインストール先ディレクトリ/client/lib

AIXの場合

LIBPATH=移行前の組み込みDBのインストール先ディレクトリ/client/lib

設定されていない場合は，メッセージKAVS0990-Eを出力してコマンドが異常終了します。

JP1/AJS2 Version 8以前の環境の，スケジューラーサービスのデータベースに組み込みDBまたはHiRDBを使用している場合は，事前に組み込みDBまたはHiRDBを起動しておく必要があります。

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

JP1/AJS2 Version 8以前の環境の，スケジューラーサービスのデータベースに組み込みDBまたはHiRDBを使用している場合は，このコマンドを実行する環境上に設定されている組み込みDBおよびHiRDBのクライアント環境定義を無効にしておいてください。

戻り値

0

正常終了。

4〜124で4の倍数値

異常終了。

ajscnvdbimport

形式

ajscnvdbimport
     [-mh 論理ホスト名]
     -F スケジューラーサービス名
     -b データベース退避ファイル格納ディレクトリ

機能

ajscnvdbexportコマンドで退避したデータベース退避データを，指定するスケジューラーデータベースへ格納します。

指定したスケジューラーサービスにすでにデータがある場合は，既存のデータを削除してからデータを格納します。

スケジューラーサービスのデータベースにアクセスできる状態の場合に実行できます。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

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

UNIXの場合

/opt/jp1ajs2/tools/

引数

-mh 論理ホスト名

論理ホスト名を指定します。指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，環境変数JP1_HOSTNAMEの設定があれば，環境変数が仮定されます。環境変数JP1_HOSTNAMEの指定がない場合は，「JP1_DEFAULT」が仮定されます。

-F スケジューラーサービス名

処理対象とするスケジューラーサービスのサービス名を指定します。指定できる文字数は，1〜30（単位：バイト）です。

-b データベース退避ファイル格納ディレクトリ

データベース退避ファイルを格納するディレクトリを絶対パスで指定します。指定できる文字数は，1〜234（単位：バイト）です。

ajscnvdbexportコマンドの-bオプションに指定した値を指定してください。

注意事項

このコマンドは，JP1/AJS2 V8以前からの移行処理で使用するコマンドです。

移行作業以外では使用しないでください。誤って実行した場合，既存のデータベースを破壊してしまいます。

戻り値

0

正常終了。

4〜124で4の倍数値

異常終了。

ajsembdbbuild

形式

ajsembdbbuild
     [-l|-m|-s]
     {
      {-d データ領域ディレクトリ
        [,システム領域ディレクトリ1
         [,システム領域ディレクトリ2]]
      } [-lh 論理ホスト名] |
      {{-r|-f}
       {-d データ領域ディレクトリ
         [,システム領域ディレクトリ1
          [,システム領域ディレクトリ2]]
       }
       -ld 作業領域ディレクトリ
       -mh 論理ホスト名
       -eh 実行系物理ホスト名
      }
     }
     [-p ポート番号]
     [-i 組み込みDB運用ディレクトリ]
     [-bs -bl アンロードログファイル作成ディレクトリ |
      -br -bl アンロードログファイル作成ディレクトリ ]
     [-rs]
     [-c]
     [-lc 文字コード種別]
     [-id セットアップ識別子]
     [-ext_db]
     [-ext_log]
     [-conf 組み込みDB設定ファイル名]
     [-b]

形式1（物理ホストの標準的なセットアップ）

ajsembdbbuild
     [-l|-m|-s]
     -d データ領域ディレクトリ
       [,システム領域ディレクトリ1]
     [-lh 論理ホスト名]
     [-p ポート番号]
     [-i 組み込みDB運用ディレクトリ]
     [-rs]
     [-c]
     [-lc 文字コード種別]
     [-id セットアップ識別子]
     [-ext_db]
     [-ext_log]
     [-conf 組み込みDB設定ファイル名]

形式2（物理ホストでバックアップとアンロードログファイルで運用するセットアップ）

ajsembdbbuild
     [-l|-m|-s]
     -d データ領域ディレクトリ
       ,システム領域ディレクトリ1
         [,システム領域ディレクトリ2]
     [-lh 論理ホスト名]
     [-p ポート番号]
     [-i 組み込みDB運用ディレクトリ]
     {-bs -bl アンロードログファイル作成ディレクトリ|
      -br -bl アンロードログファイル作成ディレクトリ}
     [-rs]
     [-c]
     [-lc 文字コード種別]
     [-id セットアップ識別子]
     [-ext_db]
     [-ext_log]
     [-conf 組み込みDB設定ファイル名]

形式3（論理ホストの標準的なセットアップ）

ajsembdbbuild
     [-l|-m|-s]
     {-r|-f}
     -d データ領域ディレクトリ
       [,システム領域ディレクトリ1]
     -ld 作業領域ディレクトリ
     -mh 論理ホスト名
     -eh 実行系物理ホスト名
     [-p ポート番号]
     -i 組み込みDB運用ディレクトリ
     [-rs]
     [-c]
     [-lc 文字コード種別]
     [-id セットアップ識別子]
     [-ext_db]
     [-ext_log]
     [-conf 組み込みDB設定ファイル名]

形式4（論理ホストでバックアップとアンロードログファイルで運用するセットアップ）

ajsembdbbuild
     [-l|-m|-s]
     {-r|-f}
     -d データ領域ディレクトリ
       ,システム領域ディレクトリ1
         [,システム領域ディレクトリ2]
     -ld 作業領域ディレクトリ
     -mh 論理ホスト名
     -eh 実行系物理ホスト名
     [-p ポート番号]
     -i 組み込みDB運用ディレクトリ
     {-bs -bl アンロードログファイル作成ディレクトリ |
      -br -bl アンロードログファイル作成ディレクトリ}
     [-rs]
     [-c]
     [-lc 文字コード種別]
     [-id セットアップ識別子]
     [-ext_db]
     [-ext_log]
     [-conf 組み込みDB設定ファイル名]

形式5（実行系で作成した組み込みDB設定ファイルを使用して，待機系の組み込みDBを構築するセットアップ）

ajsembdbbuild
     -conf 組み込みDB設定ファイル名

形式6（物理ホストでバックアップ強化機能を有効にするセットアップ）

ajsembdbbuild
     [-l|-m|-s]
     -d データ領域ディレクトリ
       [,システム領域ディレクトリ]
     [-p ポート番号]
     [-i 組み込みDB運用ディレクトリ]
     [-id セットアップ識別子]
     [-ext_db]
     [-ext_log]
     [-conf 組み込みDB設定ファイル名]
     -b

形式7（論理ホストでバックアップ強化機能を有効にするセットアップ）

ajsembdbbuild
     [-l|-m|-s]
     -d データ領域ディレクトリ
       [,システム領域ディレクトリ1]
     -ld 作業領域ディレクトリ
     -mh 論理ホスト名
     -eh 実行系物理ホスト名
     [-p ポート番号]
     [-i 組み込みDB運用ディレクトリ]
     [-id セットアップ識別子]
     [-ext_db]
     [-ext_log]
     [-conf 組み込みDB設定ファイル名]
     -b

機能

JP1/AJS3用に組み込みDBの環境を構築し，組み込みDBを起動します。

クラスタ構成時の環境構築の場合は，実行系ホストおよび待機系ホストの両方で実行します。

使用するディスクおよび該当するホストの名前を解決したIPアドレスを有効にする必要があります。ただし，待機系でコマンドを実行する場合は，有効にする必要はありません。

Windowsの場合は，構築する組み込みDBの「JP1/AJS3 Database _JFn（nは0〜9，A〜Zの文字のどれか）」サービスが「開始」の状態である必要があります。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

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

UNIXの場合

/opt/jp1ajs2/tools/

引数

-l|-m|-s

データベースモデルを次の3種類の中から選択します。

-l

次のような大規模システム用のモデルです。

環境設定パラメーターDEFLENTYPEに「byte」が設定されている場合

総ユニット数：48,000〜240,000程度

1日に実行されるジョブ数・ジョブネット総数：30,000〜120,000

ディスク容量の目安：20,700メガバイト※

環境設定パラメーターDEFLENTYPEに「sjis」が設定されている場合

総ユニット数：38,400〜192,000程度

1日に実行されるジョブ数・ジョブネット総数：24,000〜96,000

ディスク容量の目安：20,700メガバイト※

-m

次のような中規模システム用のモデルです。

環境設定パラメーターDEFLENTYPEに「byte」が設定されている場合

総ユニット数：5,000〜48,000程度

1日に実行されるジョブ数・ジョブネット総数：5,000〜30,000

ディスク容量の目安：4,200メガバイト※

環境設定パラメーターDEFLENTYPEに「sjis」が設定されている場合

総ユニット数：4,000〜38,400程度

1日に実行されるジョブ数・ジョブネット総数：4,000〜24,000

ディスク容量の目安：4,200メガバイト※

-s

次のような小規模システム用のモデルです。

環境設定パラメーターDEFLENTYPEに「byte」が設定されている場合

総ユニット数：〜5,000程度

1日に実行されるジョブ数・ジョブネット総数：〜5,000

ディスク容量の目安：520メガバイト※

環境設定パラメーターDEFLENTYPEに「sjis」が設定されている場合

総ユニット数：〜4,000程度

1日に実行されるジョブ数・ジョブネット総数：〜4,000

ディスク容量の目安：520メガバイト※

デフォルトは-l（大規模モデル）です。

注※

バックアップ強化機能を有効にする場合は，ディスク容量の目安に500メガバイトを加算してください。

-d データ領域ディレクトリ [,システム領域ディレクトリ1 [,システム領域ディレクトリ2]]

組み込みDBのデータ領域およびシステム領域に使用するディレクトリ名称を指定します。

データ領域ディレクトリ

組み込みDBのデータ領域格納ディレクトリを指定します。ここで指定したディレクトリに組み込みDBのデータ領域を確保して，JP1/AJS3スケジューラーデータベースの実体を格納します。

後述のシステム領域ディレクトリ1を指定しない場合は，組み込みDBのシステム領域も確保してシステムファイルを同時に格納します。

システム領域ディレクトリ1

システムログ運用を行う（-bsオプションを指定する）場合は，システム領域ディレクトリ1も同時に指定してください。ここで指定したディレクトリに組み込みDBのシステム領域を確保して，システムファイルを格納します。

システム領域ディレクトリ2

システムログ運用を行いさらにシステムファイルを二重化する（-brオプションを指定する）場合は，システム領域ディレクトリ2も同時に指定してください。この指定によってシステムファイルが二重化されます。

各ディレクトリは，信頼性向上の観点からそれぞれ別ボリュームのディレクトリに設定することを推奨します。

クラスタ構成（-rまたは-fオプションを指定する）のときの環境構築の場合は，共有ディスク上のディレクトリを指定してください。

各ディレクトリ名称は絶対パス50バイト以内とし，空白文字を含む場合はパス全体を「""」で囲んでください。

なお，複数のディレクトリを指定する場合は-dオプションの値全体を「""」で囲み，個々のディレクトリ名称は「""」で囲まないでください。

ほかの組み込みDBで使用しているディレクトリを指定しないでください。

-lh 論理ホスト名

指定する必要はありません。

非クラスタ環境で論理ホストを運用する場合は，-mhオプション，-ehオプション，-ldオプション，および-rオプションを指定してください。

-r

クラスタ構成の実行系ホストの環境，またはクラスタ構成ではない論理ホストを構築する場合に指定します。同時に，論理ホスト名（-mhオプション）と作業領域ディレクトリ（-ldオプション）の指定が必要となります。

組み込みDBのデータ領域およびシステム領域を格納するための共有ディスクは，実行系ホスト側にマウントされている必要があります。また，論理ホストにアクセスできる状態になっている必要があります。

-f

クラスタ構成時に待機系ホストの環境を構築する場合に指定します。同時に，論理ホスト名（-mhオプション）と作業領域ディレクトリ（-ldオプション）の指定が必要となります。

組み込みDBの設定だけを行い，データ領域の作成や組み込みDBの起動は行いません。ただし，組み込みDBのデータ領域およびシステム領域（-dオプション）の指定内容は，実行系ホストの環境構築時と同一の内容を指定してください。

-ld 作業領域ディレクトリ

論理ホスト（-rまたは-fオプションを指定する）の環境構築の場合に指定します。組み込みDBが使用する作業用の領域として，物理ホスト上のディレクトリ名称を指定します。共有ディスク上のディレクトリは指定しないでください。

ディレクトリ名称は絶対パス50バイト以内とし，空白文字を含む場合はパス全体を「""」で囲んでください。

指定するディレクトリのファイルシステム上には，40メガバイトの空き容量を確保してください。

ほかの組み込みDBで使用しているディレクトリを指定しないでください。

-mh 論理ホスト名

論理ホスト（-rまたは-fオプションを指定する）の環境構築の場合に指定します。論理ホスト名を指定してください。指定できる文字数は，1〜32（単位：バイト）です。

-eh 実行系物理ホスト名

論理ホスト（-rまたは-fオプションを指定する）の環境構築の場合に指定します。実行系ホストのオペレーティングシステムがTCP/IPホスト名として認識しているホスト名（hostnameコマンドで出力されるホスト名）を指定してください。指定できる文字数は，1〜63（単位：バイト）です。

待機系ホストの環境構築（-fオプションを指定する）でも，このオプションには実行系の物理ホスト名を指定することに注意してください。

-p ポート番号

組み込みDBで使用するポート番号を5001〜65535の間で指定します。

システム内で使用されていないポート番号を指定する必要があります。特にほかのJP1製品で組み込みDBを使用している場合は，重複しないように注意してください。

なお，Windowsでは，すでに使用されているポート番号を指定した場合，次のような問題が発生するおそれがあります。

JP1/AJS3が異常終了する，または正常に動作できなくなる

重複したポート番号を使用しているプログラムが異常終了する，または正常に動作できなくなる

省略した場合は「22220」が仮定されます。

-i 組み込みDB運用ディレクトリ

組み込みDBの運用ディレクトリとなるディレクトリの名称を指定します。

組み込みDBのインストール先ディレクトリは，次のコマンドを実行して確認してください。

ajsembdbidlist -v

ajsembdbidlistコマンドの詳細については，「2. セットアップコマンド　ajsembdbidlist」を参照してください。

ディレクトリ名称は絶対パスで指定し，空白文字を含む場合はパス全体を「""」で囲んでください。

クラスタ構成（-rまたは-fオプションを指定する）の環境構築の場合に，共有ディスク上のディレクトリを指定しないでください。

UNIXの場合はこのオプションを省略できます。省略した場合は/opt/jp1ajs2/embdb/_JF0が仮定されます。

ほかの組み込みDBで使用しているディレクトリを指定しないでください。

-bs

システムログ運用を行い，システムファイルを二重化しない場合に指定します。

-blオプションを同時に指定していない場合はエラーとなります。

-br

システムログ運用を行い，システムファイルを二重化する場合に指定します。

-blオプションを同時に指定していない場合はエラーとなります。

-bl アンロードログファイル作成ディレクトリ

アンロードログファイルを作成するディレクトリを指定してください。-bsまたは-brオプションを同時に指定していない場合はエラーとなります。

また，-bオプションと同時に指定した場合はエラーとなります。

ディレクトリ名称は絶対パス50バイト以内とし，空白文字を含む場合はパス全体を「""」で囲んでください。

ほかの組み込みDBで使用しているディレクトリを指定しないでください。

組み込みDBのアンロードログファイルを取得する運用方法については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　付録F.1(1) アンロードログ運用」を参照してください。

-rs

このオプションは，指定する必要はありません。指定した場合は，組み込みDBを構築しないで処理を終了します。

-c

JP1/AJS3をバージョンアップした場合に指定します。組み込みDBで使用する設定ファイルを最新のものに更新します。新規インストール，および設定ファイルを更新したくない場合は指定しないでください。

一度設定ファイルを更新した場合，古い設定ファイルは上書きされてしまうので注意が必要です。

JP1/AJS2 Version 8以前からバージョンアップ後の初回実行時には，必ず指定してください。

-lc 文字コード種別（UNIX限定）

このオプションは指定不要になりました。

このオプションで指定していた文字コードは無視され，JP1/AJS3 - Managerによって自動で文字コードが設定されます。

-id セットアップ識別子

組み込みDBを識別するセットアップ識別子を「_JFn」（nは0〜9またはA〜Zのどれか）の4文字で指定します。

ajsembdbidlistコマンドの-idオプションに指定したセットアップ識別子を指定してください。

このオプションを省略した場合は，_JF0が仮定されます。また，このオプションは，-rsオプションを指定した場合，無視されます。

登録済みのセットアップ識別子および組み込みDB運用ディレクトリは，ajsembdbidlistコマンドで確認できます。ajsembdbidlistコマンドの詳細については，「2. セットアップコマンド　ajsembdbidlist」を参照してください。

-ext_db

データベース領域の自動増分を適用する場合に指定します。

なお，自動増分機能が適用されているかどうかは，次のコマンドで確認できます。

データ領域：

pddbst -k phys -f -r AJS2DATA

pddbst -k phys -f -r AJS2DATA2※

インデクス領域：

pddbst -k phys -f -r AJS2INDX

pddbst -k phys -f -r AJS2INDX2※

注※

バックアップ強化機能を使用していない場合は確認不要です。

出力結果のAuto Extend Useの値を確認します。

　USE：自動増分機能が適用されています。

　NOUSE：自動増分機能が適用されていません。

pddbstコマンドを実行する場合は，実行するコマンドプロンプトで事前に環境変数を設定する必要があります。設定する環境変数については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　9.2.3(2) スクリプトを使用してデータベースを再編成する」の，設定が必要な環境変数を示した表を参照してください。

-ext_log

システムログの自動増分を適用する場合に指定します。

なお，自動増分機能が適用されているかどうかは，次のコマンドで確認できます。

ajsembdbstatus -l -id セットアップ識別子

ajsembdbstatusコマンドの詳細については，「3. 通常の運用で使用するコマンド　ajsembdbstatus」を参照してください。

-conf 組み込みDB設定ファイル名

組み込みDB設定ファイルを指定します。指定した組み込みDB設定ファイルの出力時に構築した組み込みDBと同じ設定で，組み込みDBが構築されます。

ほかのオプションと同時に指定した場合，組み込みDB設定ファイルより，指定したオプションが優先されます。

このオプションを指定した場合，-d，-ld，-mh，-eh，-r，-f，-bオプションを省略できます。

論理ホストを構築した際に出力された組み込みDB設定ファイルを指定し，-rまたは-fオプションを省略した場合，-fオプションが仮定されます。

組み込みDB設定ファイルの内容が不正であった場合，メッセージKAVS2130-Eが出力され，コマンドは異常終了します。

異なる文字コードの環境で出力された組み込みDB設定ファイルを使用する場合，文字コードを変換してください。

このオプションを指定する場合，引数に指定した組み込みDB設定ファイルが出力された際に構築した組み込みDBの環境と，ディレクトリ構成を合わせる必要があります。そのため，組み込みDB設定ファイルが出力された際に組み込みDBの環境を構築したajsembdbbuildコマンドの-d，-ld，-blオプションに指定したディレクトリを事前に作成してください。

組み込みDB設定ファイルは，次の場所に出力されます。

Windowsの場合

組み込みDB運用ディレクトリ¥conf¥ajsdbst¥ajsembdbセットアップ識別子.conf

UNIXの場合

組み込みDB運用ディレクトリ/conf/ajsdbst/ajsembdbセットアップ識別子.conf

-b

バックアップ強化機能が有効な組み込みDBを構築する場合に指定します。省略すると，バックアップ強化機能が無効な組み込みDBを構築します。

-blオプションと同時に指定した場合はエラーとなります。

このオプションを指定した場合は，ajsembdbsetupコマンドにも-bオプションを指定してください。ajsembdbsetupコマンドについては，「2. セットアップコマンド　ajsembdbsetup」を参照してください。

注意事項

組み込みDB環境の再構築を行う場合，ajsembdbunsetコマンドを実行して組み込みDB環境の情報を初期化したあとに実施してください。また，組み込みDB環境を削除する場合もajsembdbunsetコマンドを実行してください。

なお，ajsembdbunsetコマンドを実行すると，スケジューラーサービスが組み込みDBにアクセスしていても強制的に組み込みDB環境の情報を初期化してしまうので実行時には注意が必要です。

ajsembdbunsetコマンドについては，「2. セットアップコマンド　ajsembdbunset」を参照してください。

ajsembdbbuildコマンドは，スクリプトで実装されています。このため，オプションに不当に長い文字列や不正な文字列や値を指定すると，予期しないエラーが発生することがあります。オプション指定値は，DBMSおよびJP1/AJS3で規定されている範囲内の文字列または数値を指定してください。

ajsembdbbuildコマンドを実行するときは，OSのファイルシステムの設定で，扱えるファイルの最大サイズを，2ギガバイトより大きな値，または無制限に設定してください。

特に，AIXでは，デフォルトのファイルサイズ制限が1ギガバイトになっているため，注意してください。

-blオプションに指定したディレクトリ名称に誤りがある場合でも，組み込みDBのシステムは起動完了になる場合があります。-blオプションを指定した場合はWindowsイベントログまたはsyslogを参照して，組み込みDBのエラーメッセージKFPS01150-Eが出力されていないか確認してください。

組み込みDB運用ディレクトリなどのパス名称には，全角文字および特殊記号を使用しないでください。

ajsembdbbuildコマンドが，メッセージ「KAVS2124-E Failed in construction of EmbedDB server.」，またはメッセージ「KAVS2122-E A temporary file already exists.」を出力して終了した場合，ajsembdbunsetコマンドに-iオプションを指定して環境を削除してから，ajsembdbbuildコマンドを再実行してください。

ajsembdbbuildコマンドを同時に複数実行しないでください。同時に複数実行した場合，次に示す現象が起こるおそれがあります。

不当なメッセージを出力したり，本来出力するはずのメッセージを出力しなかったりするなど，メッセージ出力が不正になる。

ajsembdbbuildコマンドが，不当にエラーになる。

構成定義情報が不正になり，JP1/AJS3が運用できなくなる。

このコマンドを実行する前に，組み込みDB環境を構築するホストのホスト名を，hostsファイルまたはDNSに登録してください。クラスタ環境の場合は，実行系の物理ホスト名および論理ホスト名ともにhostsファイルまたはDNSに登録してください。

組み込みDB環境を構築するホストのホスト名をjp1hosts定義ファイルまたはjp1hosts2定義ファイルに登録しても，組み込みDBで使用するホスト名として有効になりません。

組み込みDB環境を構築するホストのホスト名には，エイリアス名を使用しないでください。

組み込みDB環境を構築するホストは，物理ホスト名を1〜63バイト，論理ホスト名を1〜32バイトで設定してください。

エラー発生時の対処

ajsembdbbuildコマンド実行時に問題が発生した場合は終了コード，エラーメッセージ，終了メッセージの順で標準出力および標準エラー出力に出力されます。次の表に従って問題を対処し，再度実行してください。

コード

メッセージID

原因

対処方法

1

KFPX29601

-dオプションの指定が誤っている。

-dオプションに指定した引数を見直してください。

3

KFPX29603

指定されたディレクトリは組み込みDB運用ディレクトリではない。

-iオプションに組み込みDBの運用ディレクトリを指定してください。

4

KFPX29604

組み込みDBの運用ディレクトリが指定されていない。

5

KFPX29605

ポート番号が重複している。

-pオプションに指定するポート番号が，ほかで使用しているポート番号と重複しないように指定してください。

6

KFPX29606

システム共通定義に誤りがある。

システム共通定義などの設定ファイルを手動で変更した際に発生します。問題点を修正してください。

絶対パスが50バイトを超えるディレクトリ名称を指定していた場合は，50バイト以内で指定してください。

7

KFPX29607

ファイルが存在しない。

ajsembdbbuildコマンドを実行する環境を見直してください。-ldオプションに指定した引数を見直してください。

8

KFPX29608

ファイルのオープンに失敗。

9

KFPX29609

ファイルの読み取りに失敗。

10

KFPX29610

ファイルの生成に失敗。

11

KFPX29611

ディレクトリの作成に失敗。

-d，-bl，-ldオプションに指定した引数を見直してください。AJS管理者で運用している場合は，AJS管理者に対して権限があるか見直してください。

12

KFPX29612

表・システム領域不足。

ajsembdbbuildコマンドを実行する環境を見直してください。-ldオプションに指定した引数を見直してください。

13

KFPX29613

14

KFPX29614

15

KFPX29615

16

KFPX29616

表・システム領域作成時エラー。

ajsembdbbuildコマンドを実行する環境を見直してください。-blオプションに指定した引数を見直してください。

OSのファイルシステムの設定で，扱えるファイルの最大サイズが2ギガバイト以下に設定されている場合は，2ギガバイトより大きな値，または無制限に設定し直してください。

17

KFPX29617

システム領域初期化エラー。

ajsembdbbuildコマンドを実行する環境を見直してください。-blオプションに指定した引数を見直してください。

18

KFPX29618

組み込みDB起動・表領域初期化エラー。

ajsembdbbuildコマンドを実行する環境を見直してください。指定したホスト名から名前解決したIPアドレスで通信できる状態になっているか確認してください。-blオプションに指定した引数を見直してください。組み込みDBが必要とするシステムリソースが不足しています。マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　3.2.5 カーネルパラメーターを見積もる」を参照して確認してください。

19

KFPX29619

組み込みDBの内部エラー。

組み込みDBの運用ディレクトリに指定したディレクトリを退避し，システム管理者に連絡してください。

20

KFPX29620

一時ファイル作成エラー。

ajsembdbbuildコマンドを実行する環境を見直してください。-blオプションに指定した引数を見直してください。

21

KFPX29621

ファイルの書式が不正。

システム共通定義などの設定ファイルを手動で変更した際に発生します。問題点を修正してください。

22

KFPX29622

システム領域の指定が不正。

23

KFPX29623

組み込みDBの内部エラー。

組み込みDBの運用ディレクトリに指定したディレクトリを退避し，システム管理者に連絡してください。

24

KFPX29624

KFPS00031

組み込みDB環境構築済みである。

ajsembdbunsetコマンドを実行し，組み込みDB環境を削除してからセットアップしてください。

25

KFPX29625

メモリー不足。

十分なメモリーを確保した上で再セットアップしてください。

26

KFPX29626

組み込みDBの内部エラー。

組み込みDBの運用ディレクトリに指定したディレクトリを退避し，システム管理者に連絡してください。

27

KFPX29627

−

KFPS00031

組み込みDB環境構築済みである。

ajsembdbunsetコマンドを実行し，前回の組み込みDB環境を削除してください。

−

KFPS05089

-iオプションに指定したディレクトリが存在しない。

組み込みDB運用ディレクトリを指定してください。

−

Bad directory specified in -i option

-iオプションに指定した組み込みDBの運用ディレクトリが不正です。

-iオプションに正しい組み込みDBの運用ディレクトリを指定してください。

−

There is an error in the specification of the setup identifier.

セットアップ識別子の指定が間違っています。

または，すでに登録されているセットアップ識別子を指定しています。

セットアップ識別子の指定を確認して再実行してください。セットアップ識別子は，「_JFn」（nは0〜9またはA〜Zのどれか）の4文字で指定します。

登録済みのセットアップ識別子は，ajsembdbidlistコマンドで確認できます。

−

Failed to register the configuration definition.

構成定義の登録に失敗しました。

ajsembdbunsetコマンドを実行して組み込みDB環境を削除してください。そのあと，ajsembdbbuildコマンドの実行権限を確認して，再度実行してください。

−

KAVS2130-E

組み込みDB設定ファイルに誤りがあります。または，-confオプションに指定したファイルに権限がありません。

正しいファイルを指定し，コマンドを再実行してください。AJS管理者で運用している場合は，AJS管理者に対して権限があるか見直してください。

（凡例）

−：コードなし

戻り値

0

正常終了。

0以外の値

異常終了。

ajsembdbidlist

形式

ajsembdbidlist
     [-v | -a | -e]

機能

構成定義に登録されている，組み込みDBを操作するコマンドに必要な情報を表示します。

表示される情報は次のとおりです。

セットアップ識別子と組み込みDB運用ディレクトリの関連づけ

スケジューラーサービスと組み込みDB運用ディレクトリの関連づけ

エージェント管理データベースが格納されている組み込みDBセットアップ識別子の関連づけ

組み込みDBのバージョン

組み込みDBのインストールモード

なお，このコマンドは，JP1/AJS3および組み込みDBの稼働状態に関係なく実行できます。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

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

UNIXの場合

/opt/jp1ajs2/tools/

引数

-v

組み込みDBのバージョンを表示する場合に指定します。

-a

エージェント管理データベースがどの組み込みDBに格納されているかを表示する場合に指定します。

-e

インストールされている組み込みDBの動作を確認する場合に指定します。

使用例1

構成定義に登録されている次の情報を表示します。

セットアップ識別子と組み込みDB運用ディレクトリの関連づけ

スケジューラーサービスと組み込みDB運用ディレクトリの関連づけ

ajsembdbidlist

使用例2

構成定義に登録されている次の情報を表示します。

セットアップ識別子と組み込みDBのインストール先ディレクトリの関連づけ

セットアップ識別子と組み込みDBのバージョンの関連づけ

ajsembdbidlist -v

使用例3

構成定義に登録されている次の情報を表示します。

セットアップ識別子と組み込みDB運用ディレクトリの関連づけ

スケジューラーサービスと組み込みDB運用ディレクトリの関連づけ

エージェント管理データベースが格納されている組み込みDBセットアップ識別子の関連づけ

ajsembdbidlist -a

使用例4

構成定義に登録されている次の情報を表示します。

組み込みDBのインストールモード

ajsembdbidlist -e

出力例1

_JF0〜_JF2までは，それぞれAJSROOT1，AJSROOT2，ROOT3でajsembdbsetupコマンド（組み込みDBのセットアップ）まで完了し，_JF3は，ajsembdbbuildコマンド（組み込みDB環境の構築）まで完了している場合の出力例を次に示します。

(1) *** Embeddb setup-id list 20XX/04/18 08:15:00
    (2)                  (3)
  _JF0 C:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JF0
  _JF1 C:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JF1
  _JF2 C:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JF2
  _JF3 C:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JF3

(4) Host-Name:JP1_DEFAULT
     (5)     (6)                (7)
  AJSROOT1 _JF0 C:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JF0

  Host-Name:LHOST1
  AJSROOT2 _JF1 C:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JF1
  ROOT3 _JF2 C:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JF2
(8)--

出力項目の説明

(1) タイトルおよびコマンド実行時の日時をYYYY/MM/DD hh:mm:ssの形式で出力します。

(2) セットアップ識別子を出力します。

(3) 組み込みDB運用ディレクトリを出力します。

(4) 論理ホスト名を出力します。物理ホストの場合は「JP1_DEFAULT」と出力します。

(5) スケジューラーサービス名を出力します。

(6) セットアップ識別子を出力します。

(7) 組み込みDB運用ディレクトリを出力します。

(8) 表示内容の終了を示します。

出力例2

物理ホストに_JF0および_JF1，論理ホスト（LHOST1）に_JF2がそれぞれインストールされている場合に，ajsembdbidlistコマンドに-vオプションを指定して実行した場合の出力例を次に示します。

(1) *** Embeddb setup-id list 20XX/04/18 08:15:00

(2) Host-Name:JP1_DEFAULT
   (3)     (4)                (5)
  _JF0 08-05-/N C:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JF0
  _JF1 08-05-/N C:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JF1

  Host-Name:LHOST1
  _JF2 08-05-/N C:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JF2
(6)--

出力項目の説明

(1) タイトルおよびコマンド実行時の日時をYYYY/MM/DD hh:mm:ssの形式で出力します。

(2) 論理ホスト名を出力します。物理ホストの場合は「JP1_DEFAULT」と出力します。

(3) セットアップ識別子を出力します。

(4) 組み込みDBのバージョンを出力します。

(5) 組み込みDBのインストール先ディレクトリを出力します。

(6) 表示内容の終了を示します。

出力例3

物理ホストのエージェント管理データベースが_JF0，論理ホスト（LHOST1）のエージェント管理データベースが_JF2に格納されている場合に，ajsembdbidlistコマンドに-aオプションを指定して実行した場合の出力例を次に示します。

(1) *** Embeddb setup-id list 20XX/04/18 08:15:00
(2)      (3)
_JF0 C:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JF0
_JF1 C:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JF1
_JF2 C:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JF2
_JF3 C:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JF3
(4) Host-Name:JP1_DEFAULT
(5)        (6)     (7)
AJSROOT1 _JF0 C:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JF0
Host-Name:LHOST1
AJSROOT2 _JF1 C:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JF1
ROOT3 _JF2 C:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JF2
(8) Agent DB
(9) Host-Name:JP1_DEFAULT
(10)      (11)
_JF0 C:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JF0
Host-Name:LHOST1
_JF2 C:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JF2
(12)--

出力項目の説明

(1) タイトルおよびコマンド実行時の日時をYYYY/MM/DD hh:mm:ssの形式で出力します。

(2) セットアップ識別子を出力します。

(3) 組み込みDB運用ディレクトリを出力します。

(4) 論理ホスト名を出力します。物理ホストの場合は「JP1_DEFAULT」と出力します。

(5) スケジューラーサービス名を出力します。

(6) セットアップ識別子を出力します。

(7) 組み込みDB運用ディレクトリを出力します。

(8) エージェント管理データベースの関連づけの出力開始を示します。

(9) 論理ホスト名を出力します。物理ホストの場合は「JP1_DEFAULT」と出力します。

(10) 各論理ホストのエージェント管理データベースが格納されている組み込みDBのセットアップ識別子を出力します。

(11) 組み込みDBのインストール先ディレクトリを出力します。

(12) 表示内容の終了を示します。

出力例4

物理ホストに_JF0および_JF1，論理ホスト（LHOST1）に_JF2および_JF3がそれぞれインストールされている場合に，ajsembdbidlistコマンドに-eオプションを指定して実行した場合の出力例を次に示します。なお，_JF0および_JF1はバージョン09-50のJP1/AJS3 - Manager，_JF2および_JF3はバージョン10-00以降のJP1/AJS3 - Managerでインストールしたとします。

(1) *** Embeddb setup-id list 20XX/04/01 08:15:00

(2) Host-Name:JP1_DEFAULT
   (3)     (4)     (5)         (6)
  _JF0 08-05-DA OS_CONTROL  C:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JF0
  _JF1 08-05-DA OS_CONTROL  C:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JF1

  Host-Name:LHOST1
  _JF2 08-05-DA AJS_CONTROL C:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JF2
  _JF3 08-05-DA AJS_CONTROL C:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JF3
(7)--

出力項目の説明

(1) タイトルおよびコマンド実行時の日時をYYYY/MM/DD hh:mm:ssの形式で出力します。

(2) 論理ホスト名を出力します。物理ホストの場合は「JP1_DEFAULT」と出力します。

(3) セットアップ識別子を出力します。

(4) 組み込みDBのバージョンを出力します。

(5) 組み込みDBの動作を出力します。

OS_CONTROL

次のどちらかで組み込みDBがインストールされたことを表します。

バージョンが10-00より前のJP1/AJS3 - Managerから，バージョンが10 - 00以降のJP1/AJS3 - Managerにバージョンアップしていて，組み込みDBの管理機能を強化するための設定をしていない

ajsembdbinstlコマンド実行時に-v9standardオプションを指定した

UNIXの場合，inittabからpdprcdプロセスが起動されます。

Windowsの場合，「JP1/AJS3 Database ClusterService」サービスが作成されます。また，「JP1/AJS3 Database」サービスのスタートアップの種類は「自動」です。

組み込みDBの管理機能を強化するための設定については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　3.6.1 組み込みDBの管理機能を強化するための設定」を参照してください。

AJS_CONTROL

バージョンが10-00以降のJP1/AJS3 - Managerで組み込みDBがインストールされたことを表します。

UNIXの場合，pdmgrdプロセスからpdprcdプロセスが起動されます。

Windowsの場合，「JP1/AJS3 Database ClusterService」サービスは作成されません。また，「JP1/AJS3 Database」サービスのスタートアップの種類は「手動」です。

(6) 組み込みDBのインストール先ディレクトリを出力します。

(7) 表示内容の終了を示します。

エラー発生時の対処

このコマンドの実行時に発生するエラーとその対処方法を次に示します。

メッセージID・メッセージ

原因

対処方法

KAVS2116-E There is an error in the specified option. Illegal option(オプション) exists.

指定したオプションに誤りがあります。不正なオプションが指定されています。

オプションを確認して再度実行してください。

KAVS0903-E System error occurred. : Get Conf NG

構成定義の読み込みに失敗しました。

コマンド実行権限を確認して再度実行してください。再度実行しても発生する場合は，システム管理者に連絡してください。

戻り値

0

正常終了。

登録情報を表示しました（表示する情報がない場合も含みます）。

4

異常終了。

オプション不正。

8

異常終了。

構成定義の読み込みに失敗。

ajsembdbinstl

形式

ajsembdbinstl
     -s 組み込みDBインストール媒体格納ディレクトリ
     [-mh 論理ホスト名]
     [-i 組み込みDBインストール先ディレクトリ]
     [-id セットアップ識別子]
     [-v9standard]

機能

JP1/AJS3の標準データベース（組み込みDB）をインストールします。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

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

UNIXの場合

/opt/jp1ajs2/tools/

引数

-s 組み込みDBインストール媒体格納ディレクトリ

組み込みDBインストール媒体を格納するディレクトリを絶対パスで指定します。

次のディレクトリを指定してください。

Windowsの場合

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

UNIXの場合

/opt/jp1ajs2/tools/AJS3DB

指定する絶対パスに空白文字または括弧を含む場合は，パスを「"（ダブルクォーテーションマーク）」で囲んでください。

-mh 論理ホスト名

組み込みDBのインストール対象の論理ホスト名を指定します。指定できる文字数は，1〜32（単位：バイト）です。

物理ホストの場合は指定する必要はありません。

-i 組み込みDBインストール先ディレクトリ

組み込みDBのインストール先ディレクトリを絶対パスで指定します。指定できる文字数は，1〜118（単位：バイト）です。

指定するパスはドライブ名で始まります。

指定できる文字を次に示します。

Windowsの場合

半角英数字，空白文字，パス区切りの¥，「.（ピリオド）」，「_（アンダーバー）」，「(」，「)」

UNIXの場合

半角英数字，「_（アンダーバー）」，「/（スラント）」

指定する絶対パスに空白文字または括弧を含む場合は，パスを「"（ダブルクォーテーションマーク）」で囲んでください。

このオプションを省略した場合は，次のディレクトリが仮定されます。

Windowsの場合

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

UNIXの場合

/opt/jp1ajs2/embdb/_JFn

_JFnのnの値は，-idオプションに指定したセットアップ識別子と同じ値になります。このオプションに指定するディレクトリには，ローカルディスク上のディレクトリを指定してください。

このコマンド実行時は，組み込みDBインストール先ディレクトリのディスクに空き容量を確保する必要があります。必要な空き容量については，リリースノートを参照してください。

-id セットアップ識別子

組み込みDBを識別するセットアップ識別子を「_JFn」（nは0〜9またはA〜Zのどれか）の4文字で指定します。

このオプションを省略した場合は，_JF0が仮定されます。

-v9standard

このオプションは，バージョンが10-00より前の方式で組み込みDBを構築する際に指定する，互換用オプションです。通常は，指定する必要はありません。

このオプションを指定した場合と省略した場合では，次の点が異なります。

Windowsの場合

-v9standardオプションを指定したとき

JP1/AJS3 Database ClusterServiceサービスが作成される

JP1/AJS3 Databaseサービスのスタートアップの種類が「自動」になる

-v9standardオプションを省略したとき

JP1/AJS3 Database ClusterServiceは作成されない

JP1/AJS3 Databaseサービスのスタートアップの種類が「手動」になる

UNIXの場合

-v9standardオプションを指定したとき

inittabからpdprcdプロセスが起動される

-v9standardオプションを省略したとき

pdmgrdプロセスからpdprcdプロセスが起動される

JP1/AJS3 Databaseサービスのスタートアップの種類が「手動」の組み込みDBに対して，-v9standardオプションを指定して上書きインストールしても，スタートアップの種類は「自動」になりません。

JP1/AJS3 Databaseサービスのスタートアップの種類が「自動」の組み込みDBに対して，-v9standardオプションを省略して上書きインストールした場合，スタートアップの種類が「手動」に変更されます。

注意事項

このコマンドの戻り値が0以外の場合，メッセージ「Database install failed(error code=yy)」が出力されます。「error code=yy」の「yy」には戻り値が表示されます。この場合，マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング　2.7.8(2) 組み込みDBのインストール中にエラーが発生したときの対処方法」を参照し，出力された戻り値yyに対応する方法で対処してください。

UNIXでは，-v9standardオプションを指定して組み込みDBをインストールした場合，/etc/inittab（Linuxの場合は/etc/init）ディレクトリに組み込みDBのエントリーが登録されます。組み込みDBを上書きインストールした場合は，/etc/inittabディレクトリの組み込みDBのエントリーが一度削除されたあとにエントリーが追加登録されるため，/etc/inittabディレクトリのエントリーの順番が変わることがあります。

-v9standardオプションを指定しないで組み込みDBをインストールした場合，インストールしようとした組み込みDBのエントリーがすでにあるときは削除され，追加登録はされません。

組み込みDBのシステム共通定義pd_mode_conf=AUTOの場合，上書きインストール後に組み込みDBが自動で起動することがあります。組み込みDBが起動した場合は，JP1/AJS3サービス起動前に組み込みDBを停止してください。

このコマンドを同時に複数実行しないでください。

戻り値

0

正常終了。

0以外の値

異常終了。

ajsembdbsetup

形式

ajsembdbsetup
     [-mh 論理ホスト名]
     [-F サービス名]
     [-p ポート番号]
     [-m [-s 送信バッファサイズ] [-r 受信バッファサイズ]]
     [-ct 最大待ち合わせ時間]
     [-tp テーブル名プリフィックス]
     [-c]
     [-ru { l | m | s }]
     [-id セットアップ識別子]
     [-convert]
     [-del]
     [-e { byte | sjis }]
     [-b]

機能

組み込みDB環境を，スケジューラーサービスおよびエージェント管理用のデータベースとしてセットアップします。

組み込みDBが稼働中の場合だけ実行できます。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

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

UNIXの場合

/opt/jp1ajs2/tools/

引数

-mh 論理ホスト名

処理対象とするJP1論理ホスト名を指定します。指定できる文字数は，1〜32（単位：バイト）です。

省略した場合，環境変数JP1_HOSTNAMEの設定があれば，環境変数値が仮定されます。環境変数JP1_HOSTNAMEの指定がない場合は，物理ホストが仮定されます。

-F サービス名

処理対象とするスケジューラーサービスのサービス名を指定します。

省略した場合，環境変数AJSCONFの設定があれば，環境変数値が仮定されます。環境変数AJSCONFの指定がない場合は，デフォルトのスケジューラーサービスが仮定されます。

-p ポート番号

組み込みDBに接続する際のポート番号を10進数で指定します。ajsembdbbuildコマンドの-pオプションで指定したポート番号を指定してください。

省略した場合，「22220」が仮定されます。

構成定義のRDBPORTパラメーターに設定されます。

指定できる値の範囲は5001〜65535となります。

-m [-s 送信バッファサイズ] [-r 受信バッファサイズ]

組み込みDBのプロセス間メモリー通信機能で使用する送信バッファサイズ，および受信バッファサイズを指定します。

構成定義のRDBIPC，RDBSENDMEMSIZE，およびRDBRECVMEMSIZEパラメーターに設定されます。

-s

送信バッファサイズを10進数で指定します（単位：キロバイト）。

-r

受信バッファサイズを10進数で指定します（単位：キロバイト）。

-sまたは-rオプションで指定できる値の範囲は，それぞれ4〜2,097,152となります。

-sまたは-rオプションを省略した場合は，組み込みDBの標準値で動作します。

JP1/AJS3での最適値は，送信バッファサイズ=100，受信バッファサイズ=1600です。

-mオプションを省略した場合はプロセス間メモリー通信機能を使用して-s，-rオプション指定の有無にかかわらず送信バッファサイズ=100，受信バッファサイズ=1600を設定します。

-ct 最大待ち合わせ時間

RDB接続待ち合わせ機能を使用する場合，RDB接続待ち合わせを打ち切る時間を，0〜60（単位：分）の範囲の値で指定します。

省略した場合，「1」が仮定されます。

「0」を指定した場合は，RDB接続待ち合わせ機能が無効になります。

このオプションに，0〜60以外の値を指定した場合，不正な値が構成定義に設定され，JP1/AJS3起動時にエラーメッセージ「KAVS1003-E 構成定義に誤った指定があります(項目名)」が出力されることがあります。また，ajsembdbsetupコマンド実行中にエラーメッセージKAVA0334-Eが出力される場合もあります。

-tp テーブル名プリフィックス

JP1/AJS3スケジューラーデータベースのテーブル名プリフィックスを4バイト以内の半角英数字で指定します。英字は大文字で指定してください。

省略した場合，「AJS1」が仮定されます。

構成定義TABLENAMEPREFIXパラメーターの設定が変更されます。

-c

スキーマ作成が成功し，それ以降のテーブル作成処理などでエラーが発生したあとに再セットアップを行う場合に指定してください。

-ru { l | m | s }

空き領域の再利用機能を使用する場合に指定します。l，m，sと同時に指定した場合，再利用開始ポイントを指定できます。

省略した場合は，-ru lが仮定されます。

-ruオプションの後ろに空き領域の再利用機能の再利用開始ポイントを指定します。データベース（テーブル）領域の使用率がここで指定したポイントに達した場合，空き領域が再利用されます。

l，m，sはそれぞれajsembdbbuildコマンドのデータベースモデル，大・中・小規模に対応しています。ajsembdbbuildコマンドで指定したデータベースモデルの規模と同じオプションを指定してください。

各テーブルに設定されるデータベース領域に対する空き領域の再利用機能の再利用開始ポイントは次のとおりになります。

表2‒1　各テーブルに設定されるデータベース領域に対する空き領域の再利用機能の再利用開始ポイント

テーブル名

各テーブルで設定される空き領域の再利用機能の再利用開始ポイント

AJS1UNIT

データベース領域AJS2DATA全体のセグメントの6%

（sを指定した場合は18，mを指定した場合は183，lを指定した場合は957を指定します）

AJS1ARROW

AJS1BODY

AJS1SCH

AJS1CAL

AJS1PERF

AJS1ENTRY

AJS1GEN

AJS1STAT

データベース領域AJS2DATA全体のセグメントの16%

（sを指定した場合は48，mを指定した場合は489，lを指定した場合は2553を指定します）

AJS1RELS

データベース領域AJS2DATA全体のセグメントの6%

（sを指定した場合は18，mを指定した場合は183，lを指定した場合は957を指定します）

AJS1ID

AJSAGTEXECCNT

データベース領域AJS2DATA全体のセグメントの1%

（sを指定した場合は3，mを指定した場合は30，lを指定した場合は159を指定します）

AJSEXECAGT

AJSEXECAGTGRP

AJSLINKAGT

AJS1JINF※

データベース領域AJS2DATA2全体のセグメントの70%（s，m，lのどれを指定した場合でも70を指定します）

注※

バックアップ強化機能が有効な場合だけ作成するテーブルです。

注

テーブル名は，テーブルプリフィックスを標準の「AJS」としている場合の名称です。

なお，ajsembdbbuildコマンドのデータベースモデル，大・中・小規模で作成される領域のセグメントの全体量は次のとおりです。

表2‒2　ajsembdbbuildのデータベースモデル，大・中・小規模で作成される領域のセグメントの全体量

データベース領域・名称

小規模

中規模

大規模

データ領域AJS2DATA

300

3,060

15,960

データ領域AJS2DATA2※

100

100

100

注※

バックアップ強化機能が有効な場合だけ作成する領域です。

-id セットアップ識別子

組み込みDBを識別するセットアップ識別子を「_JFn」（nは0〜9またはA〜Zのどれか）の4文字で指定します。ajsembdbbuildコマンドの-idオプションで指定した値を指定してください。

このオプションを省略した場合は，_JF0が仮定されます。

-convert

JP1/AJS2 - ManagerからJP1/AJS3 - Managerへのバージョンアップ後，高度な設定でのセットアップを実行する場合に指定します。

-del

-convertオプションを指定した高度な設定でのセットアップでエラーが発生した場合に，処理を回復させるときに指定します。

セットアップエラー発生時と同じオプションを指定した上で，このオプションを指定してください。異なるオプションを指定した場合，回復処理が正常に実行されないおそれがあります。

また，シフトJIS環境とUTF-8環境でユニット名などに同じ文字数を指定できるようにデータベースをセットアップする場合，セットアップ済みのデータベースを削除する場合にも指定します。

-convertオプション，-pオプション，および-tpオプションを省略して，かつ-delオプションを指定してajsembdbsetupコマンドを実行した場合，-pオプションおよび-tpオプションには，以前スケジューラーサービスを構築した際に設定した値が仮定されます。

-e {byte|sjis}

指定したスケジューラーサービスのデータベースで，シフトJIS環境とUTF-8環境でユニット名などに同じ文字数を指定できるようにするかどうかを指定します。省略するとbyteが仮定されます。

Linuxでこのオプションを省略した場合，環境設定パラメーターDEFLENTYPEに「byte」が設定されます。AIX，HP-UX，またはSolarisでこのオプションを省略した場合は，環境設定パラメーターDEFLENTYPEは変更されません。

このオプションは，-convertオプションおよび-delオプションと同時に指定できません。同時に指定した場合，エラーになります。

また，-Fオプションに指定したスケジューラーサービスの環境設定パラメーターAJSCHARCODEに「UTF-8」以外を指定した場合，メッセージKAVS1516-Eが出力されてエラーになります。

なお，このオプションはUNIXで指定できます。Windowsでは指定できません。

byte

UTF-8環境で指定できる文字数を，UTF-8で換算するようにデータベースをセットアップします。このオプションを指定すると，シフトJIS環境とUTF-8環境で，ユニット名などに指定できる文字数が異なります。

このオプションを指定して実行すると，環境設定パラメーターDEFLENTYPEに「byte」が設定されます。

sjis

UTF-8環境で指定できる文字数を，シフトJIS環境で換算するようにデータベースをセットアップします。このオプションを指定すると，UTF-8環境でユニットに定義できる次の項目の文字数が，シフトJIS環境で定義できる文字数と同じとなります。

ユニット詳細定義のユニット名

ユニット詳細定義のコメント

スケジュール設定の排他ジョブネット名

このオプションを指定してデータベースをセットアップする場合，指定したスケジューラーサービスのデータベースはセットアップされていない状態である必要があります。すでにデータベースがセットアップされているスケジューラーサービスを指定して実行した場合，エラーになります。

このオプションを指定して実行すると，環境設定パラメーターDEFLENTYPEに「sjis」が設定されます。

-b

バックアップ強化機能用のデータベースをセットアップする場合に指定します。

バックアップ強化機能が有効の場合に指定してください。指定しない場合はエラーとなります。また，バックアップ強化機能が無効の場合は指定しないでください。指定した場合，エラーとなります。

バックアップ強化機能の設定状況は，ajsembdbstatusコマンドで確認できます。ajsembdbstatusコマンドの詳細については，「3. 通常の運用で使用するコマンド　ajsembdbstatus」を参照してください。

このオプションは，-convertオプションおよび-delオプションと同時に指定できません。同時に指定した場合はエラーになります。

注意事項

ajsembdbsetupコマンドを実行する前に，JP1/AJS3 - Managerホストで論理ホストを含め，すべてのJP1/AJS3サービスを停止してください。これらのサービスを停止しないでajsembdbsetupコマンドを使用した場合でも，正常終了する場合があるため注意してください。また，-mhオプションに指定した論理ホスト名から解決したIPアドレスを使って通信できる状態になっている必要があります。

ajsembdbsetupコマンドは，スクリプトで実装されています。このため，オプションに不当に長い文字列や不正な文字列や値を指定すると，予期しないエラーが発生することがあります。オプション指定値は，DBMSおよびJP1/AJS3で規定されている範囲内の文字列または数値を指定してください。

スケジューラーデータベースのセットアップに必要のない構成定義の指定に誤りがある場合でも，エラーメッセージ「KAVS1003-E 構成定義に誤った指定があります(項目名)」が出力されます。このメッセージが複数回出力されても，ajsembdbsetupコマンドが正常終了した場合にはセットアップ処理は完了しているため，再セットアップの必要はありません。ajsembdbsetupコマンド終了後，エラーメッセージKAVS1003-Eに従って構成定義の誤りを訂正してください。

UNIXで文字コードを変更して環境を構築するときは，環境変数のLANGを正しく設定してください。

ajsembdbsetupコマンドを実行し，組み込みDBへのアクセスでエラーが発生した場合，組み込みDB接続時のエラー情報が，ajsembdbsetupコマンドを実行したときの作業ディレクトリにpderr1.trcおよびpderr2.trcのファイル名称で作成されます。コマンドの再実行によって正常終了した場合は，これらのファイルを削除してください。

ajsembdbsetupコマンドを同時に複数実行しないでください。同時に複数実行した場合，次に示す現象が起こるおそれがあります。

スケジューラーデータベースが不正になり，使用できなくなる。

ajsembdbsetupコマンドが，不当にエラーになる。

構成定義情報が不正になり，JP1/AJS3が運用できなくなる。

-e sjisオプションを指定してajsembdbsetupコマンドを実行した場合に，エラーになったときは，-cオプションを指定して再実行してください。-cオプションを指定し再実行するときに-e sjisオプションを指定しないと，メッセージKAVS0980-Eが出力されてエラーになります。

-e sjisオプションを指定しないでajsembdbsetupコマンドを実行してエラーになった場合，-cオプションを指定して再実行してください。-cオプションを指定し再実行するときに-e sjisオプションを指定すると，メッセージKAVS0980-Eが出力されてエラーになります。

エラー発生時の対処

ajsembdbsetupコマンド実行時にエラーが発生する場合があります。エラーが発生した場合は次の表に従って問題に対処し，再実行してください。

メッセージID

原因

対処方法

Invalid value specified in -ct option.

-ctオプションの引数に指定できない値が設定されている。

-ctオプションの引数に0から60以内の整数を指定してください。

KAVS0178-E

テーブルが作成済みである。

-tpオプションには，すでに登録されているテーブル名プリフィックスと重複しない値を指定してください。または，同時に-delオプションを指定して既存のテーブルを削除したあと，再度実行してください。

KAVS0190-E

ホストには指定されたスケジューラーサービスが定義されていない。

-Fオプションにすでに存在しているスケジューラーサービス名を指定してください。

KAVS0980-E

データベースのテーブル構造に互換性がない。

-e sjisオプションを指定して実行した環境に対して，-cオプションを指定して再実行しているにもかかわらず-e sjisオプションが指定されていません。または，-e sjisオプションを指定しないで実行した環境に対して，-cオプションを指定して再実行しているにもかかわらず-e sjisオプションを指定しています。

-eオプションは，再実行のときも同じように指定してください。

KAVS0985-E

データベースに接続できない。

次の問題が考えられます。

組み込みDBが起動していない。

-pオプションで指定したポート番号が組み込みDBのポート番号と一致していない。

これらの問題を解決してから再実行してください。

KAVS0996-E

指定されたオプションおよび値が不正。

オプションおよびオプションに指定する値を修正してください。

KAVS1003-E

構成定義に誤った指定がある。

オプションで指定した値を正しい値に修正して再実行してください。

KAVS2116-E

オプションに指定された値が不正，または同時に指定できないオプションが指定されている。

オプションおよびオプションに指定した値を修正して再実行してください。

KAVS8404-E

バックアップ強化機能が無効である。

-bオプションを指定しないで再実行してください。

バックアップ強化機能の設定状況はajsembdbstatusコマンドで確認できます。ajsembdbstatusコマンドの詳細については，「3. 通常の運用で使用するコマンド　ajsembdbstatus」を参照してください。

KAVS8409-E

バックアップ強化機能が有効である。

-bオプションを指定して再実行してください。

バックアップ強化機能の設定状況はajsembdbstatusコマンドで確認できます。ajsembdbstatusコマンドの詳細については，「3. 通常の運用で使用するコマンド　ajsembdbstatus」を参照してください。

KFPA11723-E

組み込みDBが停止している。

組み込みDBを起動してください。

KFPA11204-E

テーブルがない。

-tpオプションの指定値を見直して，正しいテーブルプリフィックスを指定してください。

上記のことを見直して再実行してください。

KFPA11563-E

KFPA11732-E

組み込みDBにほかのユーザーがアクセスしているため，排他待ちタイムアウトになった。

組み込みDBへのアクセスをすべて停止してから再実行してください。

The embedded DB work directory associated with the setup identifier specified by the -id option is invalid.

-idオプションに指定したセットアップ識別子に関連づけられている組み込みDB運用ディレクトリが不正。

構成定義に設定されている組み込みDB運用ディレクトリに正しい値を指定し，再実行してください。

登録済みのセットアップ識別子および組み込みDB運用ディレクトリは，ajsembdbidlistコマンドで確認できます。

ajsembdbidlistコマンドの詳細については，「2. セットアップコマンド　ajsembdbidlist」を参照してください。

The setup identifier specified with the -id option is not registered.

-idオプションで指定したセットアップ識別子は登録されていない。

登録済みのセットアップ識別子を指定し，再実行してください。なお，登録済みのセットアップ識別子および組み込みDB運用ディレクトリは，ajsembdbidlistコマンドで確認できます。

ajsembdbidlistコマンドの詳細については，「2. セットアップコマンド　ajsembdbidlist」を参照してください。

Failed to register the configuration definition.

構成定義の登録に失敗した。

高度な設定でのセットアップを実行している場合は，同時に-delオプションを指定して既存のテーブルを削除したあと，再度実行してください。

なお，KAVSで始まるメッセージの詳細については，マニュアル「JP1/Automatic Job Management System 3 メッセージ　3. KAVSで始まるメッセージ（スケジューラーおよび共通処理に関するメッセージ）」を参照してください。

戻り値

0

正常終了。

0以外の値

異常終了。

ajsembdbuninstl

形式

ajsembdbuninstl
     {-mh 論理ホスト名 |
      -id セットアップ識別子}

機能

JP1/AJS3の標準データベース（組み込みDB）をアンインストールします。

組み込みDBの稼働状態に関係なく実行できます。ただし，アンセットアップする組み込みDBにスケジューラーデータベースを作成しているすべてのスケジューラーサービスが停止中の場合だけ実行できます。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

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

UNIXの場合

/opt/jp1ajs2/tools/

引数

-mh 論理ホスト名

組み込みDBのアンインストール対象の論理ホスト名を指定します。指定した論理ホストにインストールされているすべての組み込みDBがアンインストールされます。

指定できる文字数は，1〜32（単位：バイト）です。

このオプションの引数には，JP1_DEFAULTを指定できません。

物理ホストにインストールされた組み込みDBをアンインストールする場合は，-idオプションを指定してください。

-id セットアップ識別子

アンインストール対象の組み込みDBを識別するセットアップ識別子を「_JFn」（nは0〜9またはA〜Zのどれか）の4文字で指定します。

物理ホスト，論理ホストのどちらにインストールされた組み込みDBに対しても指定できます。

次の組み込みDBには，システムに必要な情報が格納されているため，アンインストールしないでください。

セットアップ識別子が「_JF0」の組み込みDB

組み込みDBの高度な設定をする場合のデータ移行，組み込みDBの高度なセットアップ，または組み込みDBの再セットアップのどれかを実施してセットアップ識別子が「_JF0」以外に変更されている場合，そのホストに対して最初に構築された組み込みDB

論理ホストを構築している環境で，jajs_setup_clusterコマンドの-Iオプションに指定したセットアップ識別子で構築された組み込みDB

jajs_setup_clusterコマンドの詳細については，「2. セットアップコマンド　jajs_setup_cluster」を参照してください。

注意事項

このコマンドの戻り値が0以外の場合，メッセージ「Database uninstall failed(error code=yy)」を出力します。「error code=yy」の「yy」には戻り値が表示されます。この場合，マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング　2.7.8(3) 組み込みDBのアンインストール中にエラーが発生したときの対処方法」を参照し，出力された戻り値yyに対応する方法で対処してください。

すでにアンインストールした組み込みDBの情報がJP1/AJS3の共通定義情報に残っていた場合，ajsembdbuninstlコマンドがエラーになることがあります。その場合は，次に示すコマンドを実行して共通定義情報を削除してください。jbsunsetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

jbsunsetcnf -i -h JP1_DEFAULTまたは論理ホスト名 -c JP1AJS2 -n EMBDBINSTALL

なお，コマンドの実行時，設定されている情報がない場合は，メッセージ「KAVA0405-I The specified sub-key does not exist (JP1_DEFAULTまたは論理ホスト名¥JP1AJS2¥EMBDBINSTALL). Processing stops.」が出力されることがありますが，無視してください。

このコマンドでは，組み込みDBのインストール先ディレクトリ，およびデータ領域ディレクトリを削除できません。必要に応じて手動で削除してください。

UNIXでは，組み込みDBをアンインストールした場合，/etc/inittab（Linuxの場合は/etc/init）ディレクトリに組み込みDBのエントリーがあったときは削除されます。

このコマンドを同時に複数実行しないでください。

戻り値

0

正常終了。

0以外の値

異常終了。

ajsembdbunset

形式

ajsembdbunset
     {-r[-e]|-e[-r]}
     [-id 組み込みDBセットアップ識別子]
     [-i 組み込みDB運用ディレクトリ名称]

形式1（組み込みDBのOS登録を解除：UNIX限定）

ajsembdbunset
     -r
     [-id 組み込みDBセットアップ識別子]
     [-i 組み込みDB運用ディレクトリ名称]

形式2（組み込みDB環境の削除）

ajsembdbunset
     -e
     [-id 組み込みDBセットアップ識別子]
     [-i 組み込みDB運用ディレクトリ名称]

機能

組み込みDBをアンセットアップします。

組み込みDBの稼働状態に関係なく実行できます。また，アンセットアップする組み込みDBにスケジューラーデータベースを作成しているすべてのスケジューラーサービスが停止中の場合だけ実行できます。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

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

UNIXの場合

/opt/jp1ajs2/tools/

引数

-r

このオプションは，指定する必要はありません。指定した場合は，組み込みDBをアンセットアップしないで処理を終了します。

-e

組み込みDB環境を削除する場合に指定します。

組み込みDBのデータを削除するため，データを保存しておきたい場合は，事前にデータを退避してください。

UNIXの場合，-eオプションを指定したときは，指定したディレクトリで運用されている組み込みDBのOS登録の解除（-rオプション指定）も行います。

-id 組み込みDBセットアップ識別子

組み込みDBを識別するセットアップ識別子を「_JNn」（Nは組み込みDB環境構築時に指定した1文字，nは0〜9またはA〜Z）の4文字で指定します。

このオプションを省略した場合は，_JF0が仮定されます。

登録済みのセットアップ識別子および組み込みDB運用ディレクトリは，ajsembdbidlistコマンドで確認できます。

ajsembdbidlistコマンドの詳細については，「2. セットアップコマンド　ajsembdbidlist」を参照してください。

-i 組み込みDB運用ディレクトリ名称

組み込みDBの運用ディレクトリ名称を指定します。

このオプションは，ajsembdbbuildコマンドが正常に終了しなかった場合など，-idオプションを指定したアンセットアップが行えない場合だけ使用してください。

注意事項

ajsembdbunsetコマンドを実行した場合，次に示すメッセージが出力されます。

出力メッセージ：ssss Embeddb DELETE?(y/n):

ssss：セットアップ識別子

環境削除の確認メッセージであるため，問題ない場合は「y」を入力してください。

ajsembdbunsetコマンドを実行する場合，指定した運用ディレクトリが正しいかを確認してください。

ajsembdbunsetコマンドを実行する前に，JP1/AJS3 - Managerホストで論理ホストを含め，すべてのJP1/AJS3サービスを停止してください。これらのサービスを停止しないでこのコマンドを実行した場合でも，正常終了する場合があるので注意してください。

ajsembdbunsetコマンドは，スケジューラーサービスが起動していても，組み込みDBを強制的に終了させてしまうため，スケジューラーサービスが起動しているかどうかを確認する必要があります。

ajsembdbunsetコマンドは，スクリプトで実装されています。このため，オプションに不当に長い文字列や不正な文字列や値を指定すると，予期しないエラーが発生することがあります。オプション指定値は，DBMSおよびJP1/AJS3で規定されている範囲内の文字列または数値を指定してください。

ajsembdbunsetコマンドを同時に複数実行しないでください。同時に複数実行した場合，次に示す現象が起こるおそれがあります。

不当なメッセージを出力したり，本来出力するはずのメッセージを出力しなかったりするなど，メッセージ出力が不正になる。

ajsembdbunsetコマンドが，不当にエラーになる。

クラスタ運用時，ajsembdbunsetコマンドは実行系ホストと待機系ホストの両方で実行してください。実行系ホスト（ajsembdbbuildコマンドの-ehオプションに指定したホスト）では，共有ディスクをマウントした状態で実行してください。なお，ajsembdbunsetコマンドを実行する場合は，実行系ホストから実行してください。実行系ホストで実行する前に待機系ホストで共有ディスクをマウントした状態でajsembdbunsetコマンドを実行するとメッセージ「KFPS04619-E 組み込みDBが停止状態でないため，aa....aaコマンドを実行できません。」を出力してエラーになります。その場合は，実行系ホストに共有ディスクをマウントしてajsembdbunsetコマンドを実行したあと，待機系ホストで-iオプションを指定して再度ajsembdbunsetコマンドを実行してください。

組み込みDBを強制停止させている場合，または組み込みDBが異常終了している場合は，いったん起動して正常停止させたあとに実行してください。

戻り値

0

正常終了。

0以外の値

異常終了。

エラー発生時の対処

エラー発生時は，次に示す表に従って対処してください。

メッセージID

現象

対処方法

KAVS0996-E

指定したオプションに誤りがあります。

オプションの指定内容を見直してください。

KAVS2104-E

組み込みDBがセットアップされていません。

すでに組み込みDBの環境は削除されています。

KAVS2115-E

組み込みDBがインストールされていません。または，-iオプションに指定したパスに権限がありません。

削除する組み込みDBがインストールされていません。指定したパスを見直して再実行してください。AJS管理者で運用している場合は，AJS管理者に対して権限があるか見直してください。

KAVS2116-E

指定したオプションに誤りがあります。

メッセージに出力されているオプションを見直して再実行してください。

KAVS2117-E

コマンド実行時にエラーが発生しました。

保守情報に出力されているメッセージを参照してください。

ajssetup

形式

ajssetup
     [-F サービス名]
     [-t|[-m]]
     [-mh 論理ホスト名]

機能

サスペンド機能をセットアップします。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-F サービス名

処理対象とする，スケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

省略した場合，デフォルトスケジューラーサービス名が仮定されます。

-t

データベースが互換用ISAM構成の場合，スケジューラーサービスが使用するISAMデータベースをセットアップします。

-m

サスペンド機能を有効にします。

ジョブネットの実行登録中に定義を変更する場合は，必ず指定してください。インストール直後は，サスペンド機能は無効になっています。

-mh 論理ホスト名

環境変数JP1_HOSTNAMEの代わりに論理ホスト名を指定できます。このオプションを指定すると，環境変数JP1_HOSTNAMEの値よりこのオプション値の方が優先されます。

オプション値に，JP1_DEFAULTと指定することで，明示的に物理ホストを指定することもできます。物理ホストのマシン名をオプション値に指定しても，物理ホストの設定はできません。

注意事項

-mオプションを指定してサスペンド機能を有効にする場合，JP1/AJS3サービスおよびスケジューラーサービスの停止は不要です。また，設定は即時有効となります。ただし，JP1/AJS3 - Viewからの操作は，サスペンド機能を有効にしたあとのログインからできます。

このコマンドは，同時に複数実行できません。一つずつ実行されるように指定してください。

戻り値

0

正常終了。

4〜124で4の倍数値

異常終了。

使用例

スケジューラーサービス（service1）が使用するテーブルを作成します。

ajssetup -F service1

ajssysctlsetup

形式

JP1/AJS3 - Managerの場合

ajssysctlsetup
     [[-m][-a]|[-u]]

JP1/AJS3 - Agentの場合

ajssysctlsetup
     [[-a]|[-u]]

機能

マネジメントポータルの実行環境をセットアップまたはアンセットアップします。

このコマンドによって設定される情報を次に示します。

サービスの登録

Windows環境の場合だけ，次のサービスを登録します。

登録するサービス

サービス名

表示名

起動方法

アカウント

JP1/AJS3 - Manager

JP1/AJS3 - Agent

JP1/AJS3 System Control Managerサービス

JP1_AJS3_System_Control_Manager

JP1/AJS3 System Control Manager

自動

システム

○

−

JP1/AJS3 System Control Agentサービス

JP1_AJS3_System_Control_Agent

JP1/AJS3 System Control Agent

自動

システム

○

○

通信ポートの設定

次の通信ポートをservicesファイルに登録します。

登録するサービス

servicesファイル上のサービス名：ポート番号

JP1/AJS3 - Manager

JP1/AJS3 - Agent

JP1/AJS3 System Control Managerサービス

jp1ajs3sysctlm：22256

○

−

JP1/AJS3 System Control Agentサービス

jp1ajs3sysctla：22257

○

○

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

マネジメントポータルの実行環境で使用する環境設定パラメーターを設定します。

登録するサービス

設定情報

JP1/AJS3 - Manager

JP1/AJS3 - Agent

定義キー

環境設定パラメーター

JP1/AJS3 System Control Managerサービス

[JP1_DEFAULT¥JP1AJS2¥CONTROL]

"SYSLOGCODE"="C"

○

−

"UACAdministratorsMP"=dword:00000001

○

−

[JP1_DEFAULT¥JP1AJS2¥CONTROL¥MANAGER]

"LOGSIZE"=dword:00002800

○

−

"MAXOPEEXEC"=dword:00000005

○

−

JP1/AJS3 System Control Agentサービス

[JP1_DEFAULT¥JP1AJS2¥CONTROL]

"SYSLOGCODE"="C"

○

○

"UACAdministratorsMP"=dword:00000001

○

○

[JP1_DEFAULT¥JP1AJS2¥CONTROL¥AGENT]

"LOGSIZE"=dword:00002800

○

○

"MAXOPEEXEC"=dword:00000005

○

○

（凡例）

○：設定する。

−：設定しない。

環境設定パラメーターの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.15 マネジメントポータル実行環境設定」を参照してください。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

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

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

UNIXの場合

/opt/jp1ajs2/bin/

引数

-m

JP1/AJS3 System Control Managerサービスをセットアップします。

このオプションは，JP1/AJS3 - Managerの場合だけ指定できます。JP1/AJS3 - Agentでは指定できません。

このオプションは，-uオプションとは同時に指定できません。

-a

JP1/AJS3 System Control Agentサービスをセットアップします。

このオプションは，-uオプションとは同時に指定できません。

-u

マネジメントポータルの実行環境をアンセットアップします。

このオプションは，-mオプションおよび-aオプションとは同時に指定できません。

Windowsの場合，JP1/AJS3 System Control ManagerサービスおよびJP1/AJS3 System Control Agentサービスを停止します。そのあと，管理ツールのサービス一覧からJP1/AJS3 System Control Managerサービス（JP1/AJS3 System Control Manager）およびJP1/AJS3 System Control Agentサービス（JP1/AJS3 System Control Agent）を削除します。

UNIXの場合は，アンセットアップの前に，JP1/AJS3 System Control ManagerサービスおよびJP1/AJS3 System Control Agentサービスを停止してください。

注意事項

オプションをすべて省略した場合は，次のオプションが仮定されます。

JP1/AJS3 - Managerの場合：-mオプションおよび-aオプション

JP1/AJS3 - Agentの場合：-aオプション

Windowsのマシンでこのコマンドを実行する際には，コマンドプロンプトを管理者として起動する必要があります。ただし，UAC機能が無効の場合は，コマンドプロンプトを管理者として起動する必要はありません。

戻り値

0

正常終了。

0以外の値

異常終了。

ajswebsetup

形式

ajswebsetup
     -c|-p|-d 共有ディレクトリ名 [-m|-s]

機能

Web Consoleサーバをクラスタ構成で運用できる環境にセットアップします。セットアップは，実行系と待機系のそれぞれで実行してください。-mオプションを指定して実行系のセットアップを実施すると，JP1/AJS3 - Web Consoleをインストールしたローカルディスク上にある環境定義ファイルが共有ディスク上にコピーされ，クラスタ構成で運用できる環境がセットアップされます。

Web Consoleサーバを，JP1/AJS3 - Web Consoleがインストールされているローカルディスク上にある環境定義ファイルで運用するように戻します。

Web Consoleサーバにセットアップされている内容を表示します。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

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

Linuxの場合

/opt/jp1ajs3web/bin/

引数

-c

セットアップされている内容を表示します。表示される項目と内容を次に示します。

項番

表示項目

内容

1

共有ディレクトリ

共有ディレクトリを使用する場合，共有ディレクトリのパスが表示されます。

-p

Web Consoleサーバを，JP1/AJS3 - Web Consoleがインストールされているローカルディスク上にある環境定義ファイルで運用するように戻します。

-d 共有ディレクトリ名

クラスタ構成で運用する場合の共有ディレクトリのパスを指定します。指定するディレクトリは，存在するディレクトリを指定してください。

指定できる文字数は，Linuxの場合は2〜100（単位：バイト），Windowsの場合は4〜100（単位：バイト）です。

Windowsで先頭2バイトに「C:」などのドライブ文字以外を指定した場合は，コマンドが異常終了します。

絶対パスを指定してください。絶対パスで指定されていない場合は，コマンドが異常終了します。

ドライブ直下およびルートディレクトリは指定できません。

ネットワークドライブ上のディスクは指定できません。

マルチバイト文字を含むパスは指定できません。

共有ディレクトリとして，Windowsの場合は「指定した共有ディレクトリ名¥jp1ajs3web」，Linuxの場合は「指定した共有ディレクトリ名/jp1ajs3web」が作成され，その下にWeb Consoleサーバをクラスタ構成で運用する場合に必要な環境定義ファイルが作成されます。ただし，-mオプション指定時にこれらのディレクトリがすでにある場合は，コマンドが異常終了します。-mオプション指定時には，これらのディレクトリが存在しないことを確認してから実行してください。

-m

クラスタ構成（実行系）をセットアップします。

このオプションは，-dオプションと同時に指定してください。-dオプションに指定したディレクトリが存在しない場合，コマンドは異常終了します。

実行系をセットアップする場合，必ず共有ディスクをマウントした状態にしてください。

-s

クラスタ構成（待機系）をセットアップします。

このオプションは，-dオプションと同時に指定してください。

待機系をセットアップする場合，-dオプションには，実行系をセットアップしたときに指定した共有ディレクトリのパスを指定してください。

注意事項

UAC機能が有効な場合，このコマンドを実行する際にコマンドプロンプトを管理者として起動する必要があります。コマンドプロンプトを起動する際は，Windowsのスタートメニューの［コマンドプロンプト］を右クリックし，ショートカットメニューから［管理者として実行］を選択してください。なお，UAC機能が無効の場合は，コマンドプロンプトを管理者として起動する必要はありません。

このコマンドが出力するログは，クラスタ構成環境で常に物理ホストに出力されます。また，このコマンドが参照する環境設定ファイルでも，同様に常に物理ホストの環境設定ファイルを参照します。

ajswebsetupコマンドを実行すると，J2EEサーバ用ユーザープロパティファイル（usrconf.properties）※の設定が初期状態に戻り，JP1/AJS3 Web Application Serverサービスの起動が失敗することがあります。ajswebsetupコマンド実行後にJ2EEサーバ用ユーザープロパティファイル（usrconf.properties）を再設定してください。

次の条件が重なる場合に発生します。

ajswebsetupコマンド実行前にJ2EEサーバ用ユーザープロパティファイル（usrconf.properties）の設定を変更している。

ajswebsetupコマンドの引数に-dオプションまたは-pオプションを指定して実行する。

注※

JP1/AJS3 - Web Consoleのセットアップで使用するJ2EEサーバ用ユーザープロパティファイル（usrconf.properties）の設定項目については，次のマニュアルを参照してください。

Windowsの場合：マニュアル「JP1/Automatic Job Management System 3 構築ガイド　3.4.6 J2EEサーバ用ユーザープロパティファイル（usrconf.properties）の設定項目の詳細」

Linuxの場合：マニュアル「JP1/Automatic Job Management System 3 構築ガイド　13.3.6 J2EEサーバ用ユーザープロパティファイル（usrconf.properties）の設定項目の詳細」

戻り値

0

正常終了。

0以外の値

異常終了。

使用例

クラスタ構成（実行系）でセットアップします。

ajswebsetup -d 共有ディレクトリ -m

出力例

-cオプションの出力例を次に示します。

KNAK2520-I 設定情報の出力を開始します
共有ディレクトリ     E:¥share
KNAK2521-I 設定情報の出力を終了しました

jajs_config

形式

jajs_config
     -k 定義キー名
     環境設定パラメーター名=定義内容 ...

機能

JP1/AJS3の環境設定を変更します。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-k 定義キー名

環境設定パラメーターを設定する定義キー名を指定します。

定義キー名は，「[]」で囲んでください。

定義キー名は複数指定できません。1回のコマンド実行につき，一つの定義キー名に該当する環境設定パラメーターだけ設定できます。

指定した定義キー名に誤りがある場合，このコマンドを異常終了します。詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20. 環境設定パラメーター」を参照してください。

環境設定パラメーター名=定義内容 ...

設定する環境設定パラメーター名および定義内容を指定します。

指定した環境設定パラメーター名および定義内容に誤りがある場合，このコマンドは異常終了します。詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20. 環境設定パラメーター」を参照してください。

定義内容に数値を指定する場合は「dword:16進数」で指定してください。また，定義内容に複数の値を指定できる環境設定パラメーターを指定する場合は，値を「:（コロン）」で区切って指定してください。

環境設定パラメーター名および定義内容を複数指定する場合は，半角の空白文字で区切って指定します。

注意事項

このコマンドを実行して設定した環境設定パラメーターが有効になるタイミングは，環境設定パラメーターごとに異なります。環境設定パラメーターが有効になるタイミングについては，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20. 環境設定パラメーター」の各環境設定パラメーターの説明を参照してください。

指定した定義キーに，設定できない環境設定パラメーターを指定した場合は異常終了します。定義キーに設定できる環境設定パラメーターについては，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20. 環境設定パラメーター」を参照してください。

複数の定義キーに該当する環境設定パラメーターを指定する場合は，コマンドを数回に分けて実行するか，jbssetcnfコマンドを使用してください。jbssetcnfコマンドについては，マニュアル「JP1/Base 運用ガイド」のjbssetcnfコマンド説明を参照してください。

このコマンドを同時に複数実行しないでください。

コマンド実行中に強制終了しないでください。

このコマンドは，WindowsとUNIXで指定できる値が異なる環境設定パラメーターに関しては，次に示す範囲に値が含まれているかどうかをチェックします。値が範囲内であれば正常終了します。

分類

環境設定パラメーター

チェック範囲

システム管理の環境設定

"AJSSYSDIR"

191バイト以内の文字列

"AJSLOGDIR"

191バイト以内の文字列

スケジューラーサービス環境設定

"LOGSIZE"

16進数で0〜1E8480（単位：キロバイト）

（10進数で0〜2,000,000）

"AJSTMPDIR"

191バイト以内の文字列

"JOBINFDIR"

191バイト以内の文字列

"AJSBKUROOT"

191バイト以内の文字列

"AJSDBDIRECTORY"

191バイト以内の文字列

"AJSSYSDIR"

191バイト以内の文字列

"AJSLOGDIR"

191バイト以内の文字列

"AJSREPORTDIR"

191バイト以内の文字列

"AJSODBC_DSNAME"

255バイト以内の文字列

エージェント管理制御の環境設定

"AJSODBC_DSNAME"

255バイト以内の文字列

なお，OSによって指定できる値が異なるため，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20. 環境設定パラメーター」を参照し，正しい範囲で値を指定してください。

ajsembdbsetupコマンドを実行することで自動設定される環境設定パラメーターDEFLENTYPEについては，このコマンドでは変更できません。

戻り値

0〜9

正常終了。

10〜49

警告終了。コマンドは終了したが，手動による操作が必要。

50以上

異常終了。

使用例

物理ホスト（JP1_DEFAULT）のスケジューラーサービス（AJSROOT1）を次のとおり変更します。

スケジューラーログファイルのサイズを10,240（16進数で2800）キロバイトに変更します。

スケジューラーサービスの起動・終了メッセージをスケジューラーログファイルに出力するかどうかを「出力する」に変更します。

Windowsの場合

jajs_config -k [JP1_DEFAULT¥JP1AJSMANAGER¥AJSROOT1] "LOGSIZE"=dword:00002800 "AJSLOG"="all"

UNIXの場合

jajs_config -k "[JP1_DEFAULT¥JP1AJSMANAGER¥AJSROOT1]" "LOGSIZE"=dword:00002800 "AJSLOG"="all"

注

-kオプションおよびコマンドライン中に指定できる値は「¥」や空白を含むことがあるため，必要に応じて指定値や変更する環境設定パラメーター値を「"（ダブルクォーテーションマーク）」や「'（シングルクォーテーションマーク）」で囲んだり，「¥」を「¥¥」に置き換えたりしてください。詳細については，使用しているOSのマニュアルなどを参照してください。

jajs_migrate

形式

jajs_migrate
     [-h 論理ホスト名]
     {-C|-convert
       [-T ワークディレクトリ名]
       [-r|-f]
       [-S | [ [-s {l|m|s} ]
          [-u 一つのデータベースに格納するスケジューラーサービスの数] ] ] }

形式1（物理ホストの標準的なセットアップ）

jajs_migrate
     -convert
     [-T ワークディレクトリ名]
     [-s {l|m|s}]
     [-u 一つのデータベースに格納するスケジューラーサービスの数]

形式2（論理ホストのセットアップ）

jajs_migrate
     -convert
     -h 論理ホスト名
     [-T ワークディレクトリ名]
     {-r|-f}
     -S

形式3（物理ホストの組み込みDBを手動でセットアップする場合のセットアップ）

jajs_migrate
     -convert
     [-T ワークディレクトリ名]
     -S

形式4（現在のデータベース構成の出力）

jajs_migrate
     [-h 論理ホスト名]
     -C

機能

JP1/AJS3を標準構成にセットアップします。

セットアップは，JP1/AJS2からJP1/AJS3にバージョンアップインストールをしたあとに実行します。JP1/AJS2のスケジューラーサービスのデータベースにアクセスできる状態の場合に実行できます。

また，現在のデータベース構成を標準出力ファイルに出力することもできます。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

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

UNIXの場合

/opt/jp1ajs2/tools/

引数

-convert

JP1/AJS3を標準構成にセットアップします。

-h 論理ホスト名

環境変数JP1_HOSTNAMEの代わりに論理ホスト名を指定できます。指定できる文字数は，1〜32（単位：バイト）です。

このオプションを指定すると，環境変数JP1_HOSTNAMEの値よりこのオプションの値の方が優先されます。オプションの値に「JP1_DEFAULT」と指定することで，明示的に物理ホストを指定することもできます。物理ホストのマシン名も指定できます。

なお，物理ホスト名と同じ名称で論理ホストを構築している場合は，論理ホストとして処理します。

-T ワークディレクトリ名

移行で使用するワークディレクトリ名を指定します。

デフォルトで使用するワークディレクトリの容量を確保できない場合に指定します。デフォルトで使用するディレクトリを次に示します。

Windowsで，インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥backup

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

「システムで保護されたフォルダ」とは，次のフォルダを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

Windowsで，インストール先フォルダが上記以外の場合

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

UNIXの場合

/var/opt/jp1ajs2/backup/

空白を含むディレクトリは指定できません。

指定したディレクトリがない場合，コマンドは異常終了します。

コマンドが異常終了した場合，ファイルが残ることがあります。その場合，ファイルを削除したあと，再実行してください。

-S

移行時に組み込みDBをセットアップしない場合に指定します。組み込みDBをセットアップしたあとに実行してください。

なお，組み込みDBをセットアップしないで実行すると，メッセージ「KAVS0177-E データベースの種別が不正です」が出力されます。

-s {l|m|s}

データベースモデルを次の3種類の中から選択します。

l

次のような大規模システム用のモデルです。

総ユニット数：48,000〜240,000程度

1日に実行されるジョブ数・ジョブネット総数：30,000〜120,000

ディスク容量の目安：20,700メガバイト

m

次のような中規模システム用のモデルです。

総ユニット数：5,000〜48,000程度

1日に実行されるジョブ数・ジョブネット総数：5,000〜30,000

ディスク容量の目安：4,200メガバイト

s

次のような小規模システム用のモデルです。

総ユニット数：〜5,000程度

1日に実行されるジョブ数・ジョブネット総数：〜5,000

ディスク容量の目安：520メガバイト

デフォルトはs（小規模モデル）です。

-u 一つのデータベースに格納するスケジューラーサービスの数

移行前の構成を引き継がない場合，一つのデータベースに格納するスケジューラーサービスの数を10進数で指定します。

指定できる値は，1〜20です。省略した場合は，4が仮定されます。

なお，以前のバージョンでスケジューラーデータベースにV8で構築した組み込みDBを使用していた場合は，このオプションの指定に関係なく移行前の構成を引き継ぎます。

-r

クラスタ構成時に実行系ホストの環境を構築する場合に指定します。同時に，論理ホスト名（-hオプション）の指定が必要となります。

共有ディスクは，実行系ホスト側にマウントされている必要があります。また，論理ホストにアクセスできる状態になっている必要があります。

-f

クラスタ構成時に待機系ホストの環境を構築する場合に指定します。同時に，論理ホスト名（-hオプション）の指定が必要となります。

-C

現在のデータベース構成を標準出力ファイルに出力する場合に指定します。

注意事項

JP1/AJS2のスケジューラーサービスのデータベースに組み込みDBまたはHiRDBを使用している場合は，事前に組み込みDBまたはHiRDBを起動しておく必要があります。組み込みDBまたはHiRDBの起動方法については，使用しているJP1/AJS2のマニュアルまたはHiRDBのマニュアルを参照してください。

-convertオプションを指定してこのコマンドを実行する前に，次のことを実施してください。

Windowsの場合は，JP1/AJS3サービスを停止してください。

UNIXの場合は，JP1/AJS3サービスを停止し，ajsshmdelコマンドを実行してください。ajsshmdelコマンドのパスは，/opt/jp1ajs2/bin/ajsshmdelです。

実行例を次に示します。

shの場合

/opt/jp1ajs2/bin/ajsshmdel >/dev/null 2>&1

cshの場合

/opt/jp1ajs2/bin/ajsshmdel >&/dev/null

なお，UNIXの場合は，JP1/AJS3サービスの停止後にajsshmdelコマンドを実行しないでjajs_migrateコマンドを実行すると，メッセージKAVS0549-Eが出力されてコマンドが異常終了します。

-convertオプションを指定して，このコマンドを同時に複数実行しないでください。

-convertオプションを指定してこのコマンドを実行した場合，コマンドを強制終了しないでください。

-convertオプションを指定してこのコマンドを実行する前に，標準構成に移行するホストの物理ホスト名および論理ホスト名の両方を，hostsファイルまたはDNSに登録してください。

標準構成に移行するホストのホスト名をjp1hosts定義ファイルまたはjp1hosts2定義ファイルに登録しても，組み込みDBで使用するホスト名として有効になりません。

標準構成に移行するホストのホスト名には，エイリアス名を使用しないでください。

JP1/AJS3を標準構成で稼働できるホストのホスト名は，最大32バイトです。このため，標準構成へ移行するホストは，物理ホスト名および論理ホスト名ともに1〜32バイトで設定してください。

-convertオプションを指定してこのコマンドを実行した場合，コマンドの実行結果はログファイルに出力されます。格納先は，次の場所になります。

Windowsで，インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥log

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

「システムで保護されたフォルダ」とは，次のフォルダを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

Windowsで，インストール先フォルダが上記以外の場合

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

UNIXの場合

/var/opt/jp1ajs2/log

ファイル名はjajs_migrate_論理ホスト名_N.logです。Nには1から順にカウントアップされた数値が付けられます。

-convertオプションを指定してこのコマンドを実行したあとは，コマンドの戻り値とログファイルを確認し，標準構成のセットアップが正しく完了したことを確認してください。異常終了している場合，エラーの原因を取り除いたあとで再度コマンドを実行してください。

-convertオプションを指定してこのコマンドを実行し，物理ホストのJP1/AJS3を標準構成にセットアップする場合は，環境変数JP1_HOSTNAMEが設定されていない環境でjajs_migrateコマンドを実行してください。環境変数JP1_HOSTNAMEが設定されている環境でjajs_migrateコマンドを実行すると，物理ホストではなく環境変数JP1_HOSTNAMEに設定された論理ホストのJP1/AJS3が標準構成にセットアップされます。環境変数JP1_HOSTNAMEが設定されている場合は，設定を削除してから実行してください。

-convertオプションを指定してこのコマンドを実行すると，移行前の組み込みDBに対して操作を行います。そのため，移行前のスケジューラーデータベースに組み込みDBを使用している環境で，-convertオプションを指定してこのコマンドを実行する場合は，次の環境変数に設定を追加してください。

HP-UXの場合

SHLIB_PATH=移行前の組み込みDBのインストール先ディレクトリ/client/lib

SolarisまたはLinuxの場合

LD_LIBRARY_PATH=移行前の組み込みDBのインストール先ディレクトリ/client/lib

AIXの場合

LIBPATH=移行前の組み込みDBのインストール先ディレクトリ/client/lib

設定されていない場合は，メッセージKAVS0990-Eを出力してコマンドが異常終了します。

-convertオプションを指定して実行したこのコマンドが異常終了し，このコマンドを再実行する必要がある場合には，次のことに注意してください。

各スケジューラーサービスのデータベースディレクトリに「DBBKUP」ディレクトリが作成され，ディレクトリ内にファイルが格納されている場合は，「DBBKUP」ディレクトリの内容をデータベースディレクトリに配置してください。

V8で使用していた組み込みDBの状態をajsembdbstatusコマンドの-s ustオプションで確認し，STOP状態の場合は，ajsembdbstartコマンドでONLINE状態にしてください。

-convertオプションを指定してこのコマンドを実行すると，ポート番号22220〜22239を自動的に採番して組み込みDBを構築します。そのため，該当するポート番号を使用している場合はエラーになります。コマンドを実行する前にポート番号22220〜22239を空けておいてください。

V8以前の環境で，スケジューラーサービスのデータベースにISAMを使用していた場合，-convertオプションを指定して実行したこのコマンドが正常終了すると，対象となるスケジューラーサービスのデータベースディレクトリに「DBBKUP」ディレクトリが作成され，ISAMファイルが退避されます。運用に問題がない場合，必要に応じて削除してください。

V8以前の環境で，スケジューラーサービスのデータベースに組み込みDB（HiRDB）を使用している場合，-convertオプションを指定して実行したこのコマンドが正常終了すると，これ以降，JP1/AJS3のスケジューラーサービスのデータベースとして使用されません。必要に応じて環境を削除してください。

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

-convertオプションを指定してこのコマンドを実行すると，自ホストのエージェント定義にデフォルト実行エージェントと，自ホスト名と同じ名称の実行エージェントの二つが作成されます※。

注※

バージョン8以前の時点で自ホスト名と同じ名称のエージェント定義がない場合は，デフォルト実行エージェントだけが作成されます。自ホスト名と同じ名称の実行エージェントは作成されません。

ユニット定義の実行エージェントの指定方法によって，選択される実行エージェントが次のように異なるため注意が必要です。

ユニット定義の実行エージェントを省略している場合

デフォルト実行エージェントでジョブが実行されます。

ユニット定義の実行エージェントに自ホスト名を明示的に指定している場合

自ホスト名と同じ名称の実行エージェントでジョブが実行されます。

また，実行エージェントに設定しているジョブ実行多重度は，実行エージェント単位に適用されます。デフォルト実行エージェントと，自ホスト名と同じ名称の実行エージェントを定義している場合は，それぞれの実行エージェントに設定されているジョブ実行多重度の総和が自ホストで実行されることになります。

例えば，バージョン8以前で自ホスト名「host1」をエージェントとして定義していた場合，コマンドを実行すると「@SYSTEM」，「host1」という二つの実行エージェントが定義されます。実行エージェント「host1」のジョブ実行多重度を「00:00-00:00=10」（終日，ジョブ実行多重度は10）とした場合，デフォルト実行エージェントのジョブ実行多重度が「00:00-00:00=5」（終日，ジョブ実行多重度は5）であるため，最大で15のジョブが多重に実行されることがあります。

-Cオプションを指定してこのコマンドを実行する場合，JP1/AJS3サービスの起動状態に関係なく実行できます。

-Cオプションを指定してこのコマンドを実行する場合，-hオプションに物理ホストのマシン名を指定しても，出力項目の「論理ホスト」には，「JP1_DEFAULT」と表示されます。

JP1/AJS2 Version 8以前の環境の，スケジューラーサービスのデータベースに組み込みDBまたはHiRDBを使用している場合は，このコマンドを実行する環境上に設定されている組み込みDBおよびHiRDBのクライアント環境定義を無効にしておいてください。

戻り値

0

正常終了。

上記以外の値

異常終了。

使用例1

JP1/AJS2からJP1/AJS3にバージョンアップインストールをした物理ホストに対して，一つのデータベースに格納するスケジューラーサービスを五つ作成する設定でJP1/AJS3を標準構成にセットアップします。

jajs_migrate -convert -u 5

使用例2

論理ホスト（lhost）の現在のデータベース構成を標準出力ファイルに出力します。

jajs_migrate -h lhost -C

出力例

-Cオプションを指定した場合の出力例と出力内容の意味を次に示します。

論理ホスト lhost
ＤＢ構成 標準構成

出力内容の意味を次に示します。

論理ホスト（Logical host）

論理ホスト名が出力されます。

-hオプションに物理ホストのマシン名を指定した場合，「JP1_DEFAULT」と表示されます。

ＤＢ構成（DB construction）

現在のデータベース構成が出力されます。出力されるデータベース構成を次に示します。

ＤＢ構成

説明

標準構成

standard

標準構成に移行済みであることを示します

互換ISAM構成

compatible ISAM

標準構成に移行前で，互換用ISAM構成で動作することを示します

構成不正（未移行）

invalid (not yet shifted)

標準構成に移行が必要だが，移行が完了していないため，JP1/AJS3の運用ができない構成であることを示します

jajs_rpenvexport

形式

jajs_rpenvexport
     [-h 論理ホスト名]
     -d 出力ディレクトリ名

機能

JP1/AJS3 - Managerのディザスター・リカバリー運用設定情報を，指定したディレクトリに出力します（エクスポート）。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

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

UNIXの場合

/opt/jp1ajs2/bin/

引数

-h 論理ホスト名

JP1/AJS3 - Managerのディザスター・リカバリー運用設定情報をエクスポートする論理ホスト名を指定します。指定できる文字数は，1〜32（単位：バイト）です。

このオプションを指定すると，環境変数JP1_HOSTNAMEの値よりオプションに指定した値の方が優先されます。省略した場合，環境変数JP1_HOSTNAMEの設定があれば，環境変数値が仮定されます。環境変数JP1_HOSTNAMEの指定がない場合は，コマンドは異常終了します。

「JP1_DEFAULT」，または物理ホストのマシン名を指定した場合，もしくは指定した論理ホストがセットアップされていない（環境設定パラメーターの定義キー[論理ホスト名¥JP1AJSMANAGER]がない）場合，コマンドは異常終了します。

-d 出力ディレクトリ名

JP1/AJS3 - Managerのディザスター・リカバリー運用設定情報をエクスポートするディレクトリ名をフルパスで指定します。指定したディレクトリ内に「jp1ajs3_rp」ディレクトリが作成されてディザスター・リカバリー運用設定情報が出力されます。指定するディレクトリは，存在するディレクトリを指定してください。指定したディレクトリがない場合，コマンドは異常終了します。また，ネットワークドライブ上のディスクは指定しないでください。

指定できる文字数は，1〜185（単位：バイト）です。

このオプションは省略できません。

指定したディレクトリにディザスター・リカバリー運用設定情報がすでにある（「jp1ajs3_rp」ディレクトリがある）場合，以前エクスポートした情報を削除して作成します。以前のディザスター・リカバリー運用設定情報が必要な場合は，あらかじめ退避しておいてください。

注意事項

このコマンドは，スクリプトで実装されています。このため，オプションに不当に長い文字列や不正な文字列や値を指定すると，予期しないエラーが発生することがあります。オプション指定値は，JP1/AJS3で規定されている範囲内の文字列または数値を指定してください。

このコマンドを実行する前に，jajs_rpsiteコマンドに-vオプションまたは-Vオプションを指定して実行し，メッセージKAVS3711-Eが出力されない状態になっているか確認してください。

このコマンドを同時に複数実行しないでください。また，同一の論理ホストに対してこのコマンドと，jajs_rpenvimportコマンドまたはjajs_rpsiteコマンドを同時に実行しないでください。同時に実行した場合，次に示す現象が起こるおそれがあります。

不当なメッセージを出力したり，本来出力するはずのメッセージを出力しなかったりするなど，メッセージ出力が不正になる。

このコマンドが，不当にエラーになる。

構成定義情報が不正になり，JP1/AJS3が運用できなくなる。

出力したJP1/AJS3 - Managerのディザスター・リカバリー運用設定情報が不正になる。

このコマンド実行中に強制終了しないでください。

このコマンドは，エクスポート対象の環境が不正であっても正常終了する場合があります。この場合，取得したディザスター・リカバリー運用設定情報をインポートしたホストでは，JP1/AJS3 - Manager が正しく動作しません。

ディザスター・リカバリー運用設定情報をエクスポートする環境が，正常に動作することを事前に確認してください。

このコマンドの引数の値には次の文字を指定できません。

Windowsの場合

^ & = ! @ ~ % " < > | , ; * ?

UNIXの場合

^ & = ! @ ~ % " < > | , ; * ? ¥ ' $

エラー発生時の対処

メッセージに従ってエラーの原因を取り除いたあとに，再度コマンドを実行してください。

なお，次の表に示すメッセージが出力された場合は，要因と対処方法も参考にしてください。

メッセージ

要因

対処方法

KAVS1111-E

互換用ISAM構成では，この機能は使用できません

JP1/AJS3のデータベース構成が標準構成ではない（移行途中，組み込みDB未作成など）。

-hオプションで指定した論理ホストのデータベース構成を確認してください。

戻り値

0

正常終了。

上記以外の値

異常終了。

使用例

論理ホスト（LHOST1）のディザスター・リカバリー運用設定情報を次のディレクトリにエクスポートします。

c:¥temp¥export¥ajs3_rpenv_20100801

jajs_rpenvexport -h LHOST1 -d c:¥temp¥export¥ajs3_rpenv_20100801

jajs_rpenvimport

形式

jajs_rpenvimport
     [-h 論理ホスト名]
     -e 実行系物理ホスト名
     -d 入力ディレクトリ名
     [-s]

機能

jajs_rpenvexportコマンドでエクスポートしたディザスター・リカバリー運用設定情報を読み込んで，JP1/AJS3 - Managerの環境情報を設定します（インポート）。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

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

UNIXの場合

/opt/jp1ajs2/bin/

引数

-h 論理ホスト名

jajs_rpenvexportコマンドでエクスポートしたディザスター・リカバリー運用設定情報をインポートする論理ホスト名を指定します。指定できる文字数は，1〜32（単位：バイト）です。

このオプションを指定すると，環境変数JP1_HOSTNAMEの値よりオプションに指定した値の方が優先されます。省略した場合，環境変数JP1_HOSTNAMEの設定があれば，環境変数値が仮定されます。環境変数JP1_HOSTNAMEの指定がない場合は，コマンドは異常終了します。

「JP1_DEFAULT」，または物理ホストのマシン名を指定した場合は，コマンドは異常終了します。

-e 実行系物理ホスト名

リモートサイトの実行系ホストのオペレーティングシステムがTCP/IPホスト名として認識しているホスト名（hostnameコマンドで出力されるホスト名）を指定してください。指定できる文字数は，1〜63（単位：バイト）です。このオプションは省略できません。

-d 入力ディレクトリ名

jajs_rpenvexportコマンドでエクスポートしたディザスター・リカバリー運用設定情報が格納されたディレクトリ名をフルパスで指定します。指定するディレクトリは，ディレクトリ内に（jajs_rpenvexportコマンドでエクスポートした）「jp1ajs3_rp」ディレクトリがあるディレクトリを指定してください。指定したディレクトリがない場合，コマンドは異常終了します。また，ネットワークドライブ上のディスクは指定しないでください。

指定できる文字数は，1〜185（単位：バイト）です。

このオプションは省略できません。

指定したディレクトリにディザスター・リカバリー運用設定情報がない場合，コマンドは異常終了します。

-s

-hオプションで指定した論理ホストがセットアップ済みの（環境設定パラメーターの定義キー[論理ホスト名¥JP1AJSMANAGER]がある）場合でも強制的にJP1/AJS3 - Managerの環境情報を上書きします。

省略した場合，論理ホストがセットアップ済みのときは，応答要求メッセージを出力してJP1/AJS3 - Managerの環境情報を上書きするかどうかを確認します。

注意事項

このコマンドは，-hオプションで指定した論理ホストで使用する組み込みDBがインストールされている必要があります。-hオプションで指定した論理ホストで使用する組み込みDBがインストールされていない場合，コマンドは異常終了します。

このため，-hオプションで指定した論理ホスト名で使用する組み込みDBがインストールされていることを確認してください。インストール済み組み込みDBは，ajsembdbidlistコマンドで確認できます。ajsembdbidlistコマンドの詳細については，「2. セットアップコマンド　ajsembdbidlist」を参照してください。

このコマンドは，-hオプションで指定した論理ホストのJP1/AJS3 - Managerのすべてのサービスが停止している必要があります。JP1/AJS3 - Managerのすべてのサービスが停止していない場合，コマンドは異常終了します。

このため，-hオプションで指定した論理ホストのJP1/AJS3 - Managerのすべてのサービスが停止しているか確認してください。JP1/AJS3 - Managerのすべてのサービスが停止しているかどうかは，jajs_spmd_statusコマンドで確認できます。jajs_spmd_statusコマンドの詳細については，「3. 通常の運用で使用するコマンド　jajs_spmd_status」を参照してください。

組み込みDBが停止しているかどうかは，ajsembdbstatusコマンドで確認できます。ajsembdbstatusコマンドの詳細については，「3. 通常の運用で使用するコマンド　ajsembdbstatus」を参照してください。

組み込みDBのシステム状態が組み込みDBの再起動中断状態の場合，このコマンドは異常終了します。-hオプションで指定した論理ホストで使用している組み込みDBが停止状態であることを確認してください。組み込みDBの再起動中断状態を解除するには，ajsembdbstartコマンドに-Rfオプションを指定します。コマンドの詳細については，「3. 通常の運用で使用するコマンド　ajsembdbstatus」または，「3. 通常の運用で使用するコマンド　ajsembdbstart」を参照してください。

このコマンドは，スクリプトで実装されています。このため，オプションに不当に長い文字列や不正な文字列や値を指定すると，予期しないエラーが発生することがあります。オプション指定値は，JP1/AJS3で規定されている範囲内の文字列または数値を指定してください。

このコマンドを実行する前に，jajs_rpsiteコマンドに-vオプションまたは-Vオプションを指定して実行し，メッセージKAVS3711-Eが出力されない状態になっているか確認してください。

このコマンドを同時に複数実行しないでください。また，同一の論理ホストに対してこのコマンドと，jajs_rpenvexportコマンドまたはjajs_rpsiteコマンドを同時に実行しないでください。同時に実行した場合，次に示す現象が起こるおそれがあります。

不当なメッセージを出力したり，本来出力するはずのメッセージを出力しなかったりするなど，メッセージ出力が不正になる。

このコマンドが，不当にエラーになる。

構成定義情報が不正になり，JP1/AJS3が運用できなくなる。

このコマンド実行中に強制終了しないでください。

このコマンドの引数の値には次の文字を指定できません。

Windowsの場合

^ & = ! @ ~ % " < > | , ; * ?

UNIXの場合

^ & = ! @ ~ % " < > | , ; * ? ¥ ' $

このコマンドとjajs_spmd_statusコマンドを同時に実行すると，エラーが発生する場合があります。エラーが発生した場合は再度実行してください。

このコマンドは，エクスポート元ホストに設定されていた環境設定パラメーターを-hオプションで指定した論理ホスト名に変換して設定します。

次に示す定義キーおよび環境設定パラメーターは，物理ホストおよびすべての論理ホスト内で一意にする必要があります。このため，インポート先の論理ホストと，ほかの論理ホストおよび物理ホストで重複しないことを確認してから，このコマンドを実行してください。

定義キー

環境設定パラメーター

内容

AJSMANAGER¥スケジューラーサービス名

−

スケジューラーサービス名

AJSSERVICEID

スケジューラーサービスの識別番号

JOBSTATUSPORT

ジョブ状態取得ポートのサービス名

RDBPORT

RDB接続ポート番号

AJSTMPDIR

テンポラリーファイル用ディレクトリ名

JOBINFDIR

ジョブエラー情報ディレクトリ名

AJSDBDIRECTORY

データベースディレクトリ名

メインサイトの組み込みDB環境構築でajsembdbbuildコマンドに-blオプションを指定して実行した場合，インポート先のホストには-blオプションで指定したディレクトリが作成されます。

共有ディスクにアクセスできない状態でこのコマンドを実行すると，統合トレースログにメッセージ「KNAD3914-E　confディレクトリのロックファイルがオープンできません」が出力される場合があります。ただし，インポート処理は正常に行われています。

クラスタ構成の場合は，実行系および待機系の両方でこのコマンドを実行してください。なお，-eオプションには，実行系および待機系のそれぞれで実行系の物理ホスト名を指定してください。

エラー発生時の対処

メッセージに従ってエラーの原因を取り除いたあとに，再度コマンドを実行してエラーがないか確認してください。

なお，次の表に示すメッセージが出力された場合は，要因と対処方法も参考にしてください。

メッセージ

要因

対処方法

KAVS1111-E

互換用ISAM構成では，この機能は使用できません

JP1/AJS3のデータベース構成が標準構成ではない（移行途中，組み込みDB未作成など）。

-hオプションで指定した論理ホストのデータベース構成を確認してください。

KAVS1112-E

指定したディレクトリ（ディレクトリ名）が存在しません

-dオプションで指定するディレクトリ内にjajs_rpenvexportコマンドでエクスポートした「jp1ajs3_rp」ディレクトリがない。

jajs_rpenvexportコマンドでエクスポートした（「jp1ajs3_rp」ディレクトリを含む）正しいディレクトリ名を指定して，コマンドを再実行してください。

戻り値

0

正常終了。

上記以外の値

異常終了。

使用例

論理ホスト（LHOST1（実行系の物理ホスト：PHOST））に，次のディレクトリに格納されているディザスター・リカバリー運用設定情報をインポートします。

c:¥temp¥export¥ajs3_rpenv_20100801

jajs_rpenvimport -h LHOST1 -e PHOST -d c:¥temp¥export¥ajs3_rpenv_20100801

jajs_rpsite

形式

jajs_rpsite
     [-h 論理ホスト名]
     [-m {SET|SETSAME|CHANGE|UNSET} | -v | -V]

機能

JP1/AJS3を，ハードウェアのコピー・ミラーリング機能を使用してディザスター・リカバリー運用する場合のセットアップを実行します。

指定したオプションに応じて次の処理が実行されます。

メインサイトとして運用する論理ホストを新規に設定する。

メインサイトとして運用する論理ホストを変更する。

ディザスター・リカバリー運用を解除する。

メインサイトとして運用中の論理ホスト名を表示する。

メインサイトかリモートサイトかを表示する。

このコマンドは標準構成の場合だけ使用できます。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-h 論理ホスト名

処理対象の論理ホスト名を指定します。指定できる文字数は，1〜32（単位：バイト）です。

このオプションを指定すると，環境変数JP1_HOSTNAMEの値よりこのオプションの値の方が優先されます。

オプションの値に物理ホスト名（物理ホストのマシン名または「JP1_DEFAULT」）を指定した場合は異常終了します。

このオプションを省略し，環境変数JP1_HOSTNAMEを指定していない場合は，物理ホスト名が仮定されるため，異常終了します。

コマンドを実行したサイトに指定した論理ホストがない場合は異常終了します。

-m {SET|SETSAME|CHANGE|UNSET}

SET

ディザスター・リカバリー運用を別名の論理ホストで構成する場合に，メインサイトとして運用する論理ホストを新規に設定します。

メインサイトとして運用する論理ホストを設定したあと，メインサイトでの運用およびハードウェアの操作で共有ディスク間のコピーを開始すると，リモートサイト側のJP1/AJS3は起動抑止状態になります。

このオプションは，新規にメインサイトとして運用する論理ホストを設定する場合に指定します。すでにメインサイトとして運用する論理ホストが設定されている場合は，-m SET，-m SETSAMEのどちらで設定していても，異常終了します。

-vオプションまたは-Vオプションと同時に指定した場合は異常終了します。

処理が正常終了した場合，メッセージKAVS3707-Iを出力します。

SETSAME

ディザスター・リカバリー運用を同一名の論理ホストで構成する場合に，メインサイトとして運用する論理ホストを新規に設定します。

メインサイトとして運用する論理ホストを設定したあと，メインサイトでの運用およびハードウェアの操作で共有ディスク間のコピーを開始すると，リモートサイト側のJP1/AJS3は起動抑止状態になります。

このオプションは，新規にメインサイトとして運用する論理ホストを設定する場合に指定します。すでにメインサイトとして運用する論理ホストが設定されている場合は，-m SET，-m SETSAMEのどちらで設定していても，異常終了します。

-vオプションまたは-Vオプションと同時に指定した場合は異常終了します。

処理が正常終了した場合，メッセージKAVS3710-Iを出力します。

CHANGE

ディザスター・リカバリー運用でメインサイトとして運用する論理ホストを変更します。

大規模災害の発生などでメインサイト側のシステムが停止した場合，リモートサイトに運用拠点を切り替え，業務を継続するときに指定します。

メインサイトとして運用する論理ホストを変更すると，処理対象の論理ホストのJP1/AJS3の起動抑止状態が解除され，リモートサイトとなる論理ホストのJP1/AJS3が起動抑止状態になります。

次の場合は異常終了します。

メインサイトとして運用する論理ホストが設定されていない場合

ディザスター・リカバリー運用を別名の論理ホストで構成している場合に，すでにメインサイトとして運用している論理ホストと同じ論理ホスト名を指定した場合

ディザスター・リカバリー運用を同一名の論理ホストで構成している場合に，すでにメインサイトとして運用している論理ホストでコマンドを実行した場合

-vオプションまたは-Vオプションと同時に指定した場合

運用拠点の切り替えに失敗した場合

処理が正常終了した場合，メッセージKAVS3708-Iを出力します。

UNSET

ディザスター・リカバリー運用を解除します。

ディザスター・リカバリー運用の解除は，メインサイト，リモートサイトの両方で実行してください。リモートサイト側では解除が行われるまで，JP1/AJS3の起動抑止が解除されません。

-vオプションまたは-Vオプションと同時に指定した場合は異常終了します。

処理が正常終了した場合，メッセージKAVS3709-Iを出力します。

-v

ディザスター・リカバリー運用で，現在のメインサイトとして運用中の論理ホスト名を表示します。

メインサイトとして運用する論理ホストが設定されていない場合は異常終了します。

-mオプションまたは-Vオプションと同時に指定した場合は異常終了します。

-V

指定した論理ホストが現在メインサイトかリモートサイトかを表示します。メインサイトの場合は「Main」，リモートサイトの場合は「Remote」と表示します。

メインサイトとして運用する論理ホストが設定されていない場合は異常終了します。

-mオプションまたは-vオプションと同時に指定した場合は異常終了します。

注意事項

ハードウェアの操作で共有ディスク間のコピーを開始する前に，必ず-m SETオプションまたは-m SETSAMEオプションを指定してメインサイトとして運用する論理ホストを設定してください。メインサイトとして運用する論理ホストを指定しないと，リモートサイト側のJP1/AJS3サービスが起動抑止状態になりません。

jajs_rpsiteコマンドを，同時に複数実行しないでください。また，同一の論理ホストに対して，このコマンドとjajs_rpenvexportコマンド，jajs_rpenvimportコマンド，またはjajs_spmdコマンドを同時に実行しないでください。

同時に実行した場合，次に示す現象が起こるおそれがあります。

不当なメッセージを出力したり，本来出力するはずのメッセージを出力しなかったりするなど，メッセージ出力が不正になる。

jajs_rpsiteコマンドが，不当にエラーになる。

構成定義情報が不正になり，JP1/AJS3が運用できなくなる。

-m SET，-m SETSAME，-m CHANGE，および-m UNSETオプションは，ハードウェアの操作で共有ディスク間のコピーを停止してから実行してください。

-m SET，-m SETSAME，および-m CHANGEオプションは，メインサイトからリモートサイトへのコピー中にメインサイトで実行した場合，メインサイトとして運用する論理ホストがすでに設定済みのため，異常終了します。

-m SET，-m SETSAME，および-m CHANGEオプションは，メインサイトとして運用するサイトで実行してください。

-m UNSETオプションは，メインサイト，リモートサイトの両方で実行してください。

-m SET，-m SETSAME，および-m UNSETオプションを指定してjajs_rpsiteコマンドを実行したあと，-vオプションまたは-Vオプションを指定して再度jajs_rpsiteコマンドを実行し，ディザスター・リカバリー運用が正しくセットアップまたは解除されているか確認してください。

メインサイトからリモートサイトへのコピー中にリモートサイトでこのコマンドを実行した場合，共有ディスクへのアクセスができないため異常終了します。

論理ホストの共有ディスクをマウントしない状態でこのコマンドを実行すると異常終了します。

ディザスター・リカバリー運用の構成を再設定する場合は，一度-m UNSETオプションでディザスター・リカバリー運用の設定を解除したあと，再度-m SETオプションまたは-m SETSAMEオプションで設定してください。

戻り値

0

正常終了。

上記以外の値

異常終了。

使用例

ハードウェアのコピー・ミラーリング機能を使用してディザスター・リカバリー運用する場合の使用例を次に示します。

使用例1

論理ホストを別名で構成する場合で，論理ホストLHOST_Mを，メインサイトの論理ホストとして設定します。

jajs_rpsite -h LHOST_M -m SET

使用例2

論理ホストを同一名で構成する場合で，論理ホストLHOST_Mを，メインサイトの論理ホストとして設定します。

jajs_rpsite -h LHOST_M -m SETSAME

使用例3

論理ホストを別名で構成している場合に，運用拠点切り替えのため，現在リモートサイト側である論理ホストLHOST_Rをメインサイト側の論理ホストに変更します。

jajs_rpsite -h LHOST_R -m CHANGE

使用例4

論理ホストを同一名で構成している場合に，運用拠点切り替えのため，現在リモートサイト側である論理ホストLHOST_Mをメインサイト側の論理ホストに変更します。

jajs_rpsite -h LHOST_M -m CHANGE

使用例5

次に示す条件で運用している場合，現在メインサイトとして運用中の論理ホスト名を表示します。

メインサイト：論理ホスト（LHOST_M）

リモートサイト：論理ホスト（LHOST_R）

jajs_rpsite -h LHOST_M -v

または，

jajs_rpsite -h LHOST_R -v

使用例6

次に示す条件で運用している場合，コマンドを実行した環境で，指定した論理ホストが現在メインサイトかリモートサイトかを表示します。

メインサイト：論理ホスト（LHOST_M）

リモートサイト：論理ホスト（LHOST_R）

jajs_rpsite -h LHOST_M -V

または，

jajs_rpsite -h LHOST_R -V

使用例7

次に示す条件のディザスター・リカバリー運用を解除します。

メインサイト：論理ホスト（LHOST_M）

リモートサイト：論理ホスト（LHOST_R）

jajs_rpsite -h LHOST_M -m UNSET

および，

jajs_rpsite -h LHOST_R -m UNSET

出力例1

-vオプションを指定して，現在メインサイトとして運用中の論理ホスト名を表示した場合の出力例を次に示します。

> jajs_rpsite -h LHOST_M -v
LHOST_R

出力例2

-Vオプションを指定して，指定した論理ホストが現在メインサイトかリモートサイトかを表示した場合の出力例を次に示します。

> jajs_rpsite -h LHOST_M -V
Main

> jajs_rpsite -h LHOST_R -V
Remote

jajs_setup

形式

jajs_setup
     {[-F スケジューラーサービス名] | [-G]}
     {-a
      [-h 論理ホスト名]
      -n スケジューラーサービスの識別番号
      -p ジョブ状態通信ポートのサービス名
      -d データベースディレクトリ名
      -t テンポラリーディレクトリ名
      -j ジョブ情報ディレクトリ名
      -b 退避情報ディレクトリ名
      [-D 論理ホスト共有ディレクトリ名]
      [-k {EmbedDB | SQLSVR}]
      [-of ODBCファイルデータソース名 -od データベース名]
      [[-I セットアップ識別子
       -P 組み込みDBポート番号]
       [-M {s|m|l}]
       [-E {byte | sjis}]
       [-B]] |
       [-S] |
       -r -A 変更後のスケジューラーサービス名 |
      -e}

形式1（データベースが組み込みDBのスケジューラーサービスの追加）

jajs_setup
     -a
     [-h 論理ホスト名]
     [-F スケジューラーサービス名]
     -n スケジューラーサービスの識別番号
     -p ジョブ状態通信ポートのサービス名
     -d データベースディレクトリ名
     -t テンポラリーディレクトリ名
     -j ジョブ情報ディレクトリ名
     -b 退避情報ディレクトリ名
     [-D 論理ホスト共有ディレクトリ名]
     [-k EmbedDB]
     [[-I セットアップ識別子
       -P 組み込みDBポート番号]
      [-M {s|m|l}]
      [-E {byte | sjis}]
      [-B] |
      -S]

形式2（データベースが外部DBのスケジューラーサービスの追加）

jajs_setup
     -a
     -k SQLSVR
     [-h JP1_DEFAULT]
     [-F スケジューラーサービス名]
     -n スケジューラーサービスの識別番号
     -p ジョブ状態通信ポートのサービス名
     -d データベースディレクトリ名
     -t テンポラリーディレクトリ名
     -j ジョブ情報ディレクトリ名
     -b 退避情報ディレクトリ名
     -of ODBCファイルデータソース名
     -od データベース名
     [-E {byte | sjis}]

形式3（データベースが外部DBの実行エージェント情報のセットアップ）

jajs_setup
     -a
     -k SQLSVR
     [-h JP1_DEFAULT]
     -G
     -of ODBCファイルデータソース名
     -od データベース名

形式4（スケジューラーサービス名の変更）

jajs_setup
     -r
     [-F スケジューラーサービス名]
     -A 変更後のスケジューラーサービス名

形式5（スケジューラーサービスの削除）

jajs_setup
     -e
     [-F スケジューラーサービス名]

機能

JP1/AJS3のスケジューラーサービスをセットアップします。

指定したオプションに応じて次のセットアップが実行されます。

スケジューラーサービスの追加

スケジューラーサービスの名称変更

スケジューラーサービスの削除

外部DBを利用してJP1/AJS3を運用する場合の実行エージェント情報のセットアップ

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-a

新規にスケジューラーサービスを追加，または実行エージェント情報をセットアップします。

このコマンドを実行してデータベースが組み込みDBのスケジューラーサービスを追加する場合，新規に作成するスケジューラーサービスに対応したデータベースのインストールとセットアップを実行します。これによって，スケジューラーサービスを簡単に作成できます。

スケジューラーサービスの追加が正常終了したあとに，追加したスケジューラーサービスの環境設定パラメーターを変更する場合は，jajs_configコマンドの-kオプション（定義キー）に次の値を指定して変更します。

[{JP1_DEFAULT|論理ホスト名}※1¥JP1AJSMANAGER¥スケジューラーサービス名※2]

注※1

物理ホストの場合は「JP1_DEFAULT」を，論理ホストの場合は作成時に指定した論理ホスト名を指定します。

注※2

作成時に指定したスケジューラーサービス名を指定します。

このオプションは，-h，-F，-G，-n，-p，-d，-t，-j，-b，-k，-of，-od，-I，-P，-M，-E，-B，および-Sオプションと同時に指定します。論理ホストにスケジューラーサービスを追加する場合は，-Dオプションも同時に指定します。

このオプションを指定してスケジューラーサービスを追加する場合，-n，-p，-d，-t，-j，および-bオプションは省略できません。

論理ホストにスケジューラーサービスを追加する場合は，-D，-I，および-Pオプションは省略できません。

組み込みDBを新規に作成する場合，コマンドの実行に数分から数十分の時間が掛かります。物理ホストでは，-Iおよび-Pオプションを省略した場合，一つの組み込みDBに作成できるスケジューラーサービスの数は最大4個です。これを超えると組み込みDBを新規に作成するため，コマンドの実行に時間が掛かることがあります。-Iオプションを指定した場合は，指定した組み込みDBにスケジューラーサービスを作成します。-Iオプションに構築済みの組み込みDBのセットアップ識別子を指定しない場合は新規に組み込みDBを作成するため，コマンドの実行に時間が掛かることがあります。

また，jajs_migrateコマンドの-uオプションを指定していた場合も，一つの組み込みDBに最大4個のスケジューラーサービスが作成されます。一つの組み込みDBに作成されるスケジューラーサービスの数を指定したい場合は，組み込みDBの高度なセットアップを実施してください。jajs_migrateコマンドの詳細については，「2. セットアップコマンド　jajs_migrate」を参照してください。組み込みDBの高度なセットアップについては，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　23.4 組み込みDBの高度なセットアップ」を参照してください。

-r

スケジューラーサービスの名称を変更します。物理ホストおよび論理ホストの区別なく，コマンドを実行したホスト上のスケジューラーサービスの名称を処理対象とします。

このオプションは，-F，および-Aオプションと同時に指定します。このオプションを指定した場合，-Aオプションは省略できません。

スケジューラーサービスの名称を変更すると，JP1/AJS3の各種機能に影響を与えます。例えば，ユニットが異常終了したり，正しく実行されなかったりするなどの現象が発生する場合があります。このため，スケジューラーサービスの名称変更は，運用開始前のスケジューラーサービスに対して実施することを推奨します。

このオプションで，スケジューラーサービス名の大文字・小文字だけの変更はできません。スケジューラーサービス名の大文字・小文字だけを変更する場合は，いったん別の名前に変更してから，再度変更してください。

スケジューラーサービスの名称変更手順については，次の個所を参照してください。

Windowsの場合

非クラスタ環境のとき

マニュアル「JP1/Automatic Job Management System 3 構築ガイド　6.1.1(4) スケジューラーサービス名を変更する」

クラスタ環境のとき

マニュアル「JP1/Automatic Job Management System 3 構築ガイド　8.2.10(4) スケジューラーサービス名を変更する」

UNIXの場合

非クラスタ環境のとき

マニュアル「JP1/Automatic Job Management System 3 構築ガイド　15.1.1(4) スケジューラーサービス名を変更する」

クラスタ環境のとき

マニュアル「JP1/Automatic Job Management System 3 構築ガイド　17.2.10(4) スケジューラーサービス名を変更する」

-e

スケジューラーサービスを削除します。物理ホストおよび論理ホストの区別なく，コマンドを実行したホスト上のスケジューラーサービスの名称を処理対象とします。

このコマンドでスケジューラーサービスを削除すると，スケジューラーサービスに対応したデータベースも削除されます。

論理ホスト環境でのスケジューラーサービス削除手順については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　8.2.10(2) 追加したスケジューラーサービスを削除する」（Windowsの場合）またはマニュアル「JP1/Automatic Job Management System 3 構築ガイド　17.2.10(2) 追加したスケジューラーサービスを削除する」（UNIXの場合）を参照してください。

このオプションは，-Fオプションと同時に指定します。

-h 論理ホスト名

セットアップ対象とする論理ホスト名を指定します。

指定できる文字数は，1〜32（単位：バイト）です。

オプションに指定した論理ホストに対してセットアップが実行されます。

オプションを指定すると，環境変数JP1_HOSTNAMEの値よりオプションに指定した値の方が優先されます。省略した場合，環境変数JP1_HOSTNAMEの値が論理ホスト名に仮定されます。

物理ホストをセットアップする場合，次の方法でセットアップ対象に指定できます。

オプションの指定を省略し，環境変数JP1_HOSTNAMEを設定しない

オプションの値または環境変数JP1_HOSTNAMEの値に「JP1_DEFAULT」を指定する

オプションの値または環境変数JP1_HOSTNAMEの値に，物理ホストのマシン名を指定しても，物理ホストの設定はできません。

論理ホストをセットアップ対象とした場合，同時に-D，-Iオプションおよび-Pオプションの指定が必要です。

このオプションは，-rおよび-eオプションと同時に指定できません。

-F スケジューラーサービス名

処理対象とするスケジューラーサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

スケジューラーサービス名に指定できる文字については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4 スケジューラーサービス環境設定」の「表20-2 環境設定パラメーター一覧（スケジューラーサービス環境設定）」の下にある，スケジューラーサービスに関する注意を参照してください。

省略した場合は，デフォルトスケジューラーサービス名が仮定されます。

このオプションは，-Gオプションとは同時に指定できません。

-G

外部DBを利用してJP1/AJS3を運用する場合に，実行エージェント情報をセットアップします。

このオプションは，WindowsまたはLinuxで指定できます。AIX，HP-UX，およびSolarisでは指定できません。

このオプションは，-aおよび-k SQLSVRオプションと同時に指定します。

このオプションは，-F，-n，-p，-d，-t，-j，-b，-D，-I，-P，-M，-E，-B，および-Sオプションとは同時に指定できません。

このオプションは，論理ホストをセットアップ対象とする場合は指定できません。

-A 変更後のスケジューラーサービス名

変更後のスケジューラーサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

このオプションは，-rオプションと同時に指定します。

-n スケジューラーサービスの識別番号

スケジューラーサービスの識別番号を10進数で指定します。

指定できる値は，1〜20です。

次に示す場合，メッセージが表示され，コマンドが異常終了します。

範囲外の値を指定した場合

自ホスト内の物理ホスト，およびすべての論理ホストで使用している識別番号と重複する値を指定した場合

このオプションは，-aオプションと同時に指定します。

ここで指定した識別番号は，テンポラリーファイルの名称や，プロセス間通信のキーなど，内部的にスケジューラーサービスを識別する場合に使われるため，一度指定した識別番号を変更しないことを推奨します。変更した場合は，スケジューラーサービスをコールドスタートしてください。

このオプションは，-Gオプションとは同時に指定できません。

-p ジョブ状態通信ポートのサービス名

ジョブ状態の情報を取得するために使用する通信ポートのポート番号をサービス名で指定します。jajs_setupコマンド完了後に，指定したジョブ状態通信ポートのサービス名をservicesファイルに定義してください。

指定できる文字数は，1〜31（単位：バイト）です。

次に示す場合，メッセージが表示され，コマンドが異常終了します。

範囲外の値を指定した場合

スケジューラーサービスを多重起動する場合で，スケジューラーサービスごとに異なるサービス名を指定してservicesファイルに重複するポート番号が設定された場合

このオプションは，-aオプションと同時に指定します。

このオプションは，-Gオプションとは同時に指定できません。

-d データベースディレクトリ名

JP1/AJS3のユニット情報を格納するディレクトリ名をフルパスで指定します。このオプションで指定したディレクトリ名は，環境設定パラメーターAJSDBDIRECTORYに設定されます。

指定できる文字数は，1〜191（単位：バイト）です。

指定するデータベースディレクトリ名の最後にパス区切り文字（Windowsの場合は「¥」，UNIXの場合は「/」）を指定しないでください。

次に示す場合，メッセージが表示され，コマンドが異常終了します。

範囲外の値を指定した場合

指定したディレクトリがない場合

自ホスト内の物理ホスト，およびすべての論理ホストで使用しているデータベースディレクトリ名と重複する値を指定した場合

指定したデータベースディレクトリ名の最後にパス区切り文字がある場合

UNIXで「/」（ルート）を指定した場合

Windowsで，先頭2バイトにドライブ文字（例：「C:」）以外を指定した場合

このオプションは，-aオプションと同時に指定します。

このオプションは，-Gオプションとは同時に指定できません。

-t テンポラリーディレクトリ名

JP1/AJS3のテンポラリーファイルを作成するディレクトリ名をフルパスで指定します。

指定できる文字数は，1〜191（単位：バイト）です。

指定したディレクトリがない場合は，警告メッセージが表示されます。警告メッセージに表示されたディレクトリを手動で作成するか，jajs_configコマンドで環境設定パラメーターAJSTMPDIRを更新してください。jajs_configコマンドで指定する定義キーについては，-aオプションの説明を参照してください。

次に示す場合，メッセージが表示され，コマンドが異常終了します。

範囲外の値を指定した場合

自ホスト内の物理ホスト，およびすべての論理ホストで使用しているテンポラリーディレクトリ名と重複する値を指定した場合

UNIXで「/」（ルート）を指定した場合

Windowsで，先頭2バイトにドライブ文字（例：「C:」）以外を指定した場合

このオプションは，-aオプションと同時に指定します。

このオプションは，-Gオプションとは同時に指定できません。

-j ジョブ情報ディレクトリ名

データベースに組み込みDBを使用する場合，ジョブ定義時に標準エラー出力ファイルを指定していないときは，ジョブ実行時に標準エラー出力ファイルを格納するディレクトリ名をフルパスで指定します。

データベースに外部DBを使用する場合，ジョブ情報のワークファイルを作成するディレクトリ名をフルパスで指定します。

指定できる文字数は，1〜191バイト（単位：バイト）です。

指定したディレクトリがない場合は，警告メッセージが表示されます。警告メッセージに表示されたディレクトリを手動で作成するか，jajs_configコマンドで環境設定パラメーターJOBINFDIRを更新してください。jajs_configコマンドで指定する定義キーについては，-aオプションの説明を参照してください。

次に示す場合，メッセージが表示され，コマンドが異常終了します。

範囲外の値を指定した場合

自ホスト内の物理ホスト，およびすべての論理ホストで使用しているジョブ情報ディレクトリ名と重複する値を指定した場合

UNIXで「/」（ルート）を指定した場合

Windowsで，先頭2バイトにドライブ文字（例：「C:」）以外を指定した場合

このオプションは，-aオプションと同時に指定します。

このオプションは，-Gオプションとは同時に指定できません。

-b 退避情報ディレクトリ名

ユニットを退避させるときのディレクトリ名をフルパスで指定します。

指定できる文字数は，1〜191（単位：バイト）です。

指定したディレクトリがない場合は，警告メッセージが表示されます。警告メッセージに表示されたディレクトリを手動で作成するか，jajs_configコマンドで環境設定パラメーターAJSBKUROOTを更新してください。

jajs_configコマンドで指定する定義キーについては，-aオプションの説明を参照してください。

次に示す場合はメッセージが表示され，コマンドが異常終了します。

範囲外の値を指定した場合

UNIXで「/」（ルート）を指定した場合

Windowsで，先頭2バイトにドライブ文字（例：「C:」）以外を指定した場合

このオプションは，-aオプションと同時に指定します。

スケジューラーサービス参照制限機能を有効にする場合（環境設定パラメーターHIDEOTHERSERVICEにyesを設定している場合），スケジューラーサービスの退避情報ディレクトリは，スケジューラーサービス単位で別々のディレクトリを指定してください。退避情報ディレクトリが複数のスケジューラーサービスで共通だと，そのうちのどれかのスケジューラーサービスに対するアクセス権限さえあれば，共通の退避情報ディレクトリに格納されているすべての退避情報を参照できてしまいます。

このオプションは，-Gオプションとは同時に指定できません。

-D 論理ホスト共有ディレクトリ名

論理ホストにスケジューラーサービスを追加する際に，論理ホストで使用する共有ディレクトリ名をフルパスで指定します。指定する論理ホスト共有ディレクトリ名は，対象の論理ホストを作成する際にjajs_setup_clusterコマンドの-dオプションに指定した共有ディレクトリ名と同じ値を指定します。

指定できる文字数は，1〜165（単位：バイト）です。

次に示す場合はメッセージが表示され，コマンドが異常終了します。

範囲外の値を指定した場合

指定したディレクトリがない場合

UNIXで「/」（ルート）を指定した場合

Windowsで，先頭2バイトにドライブ文字（例：「C:」）以外を指定した場合

このオプションは，-aオプションと同時に指定します。

このオプションは，-G，-k SQLSVR，-of，および-odオプションとは同時に指定できません。

論理ホストにスケジューラーサービスを追加する場合は必ず指定してください。指定しない場合，コマンドが異常終了します。

-k {EmbedDB | SQLSVR}

使用するデータベース種別を指定します。省略するとEmbedDBが仮定されます。

このオプションは，WindowsまたはLinuxで指定できます。AIX，HP-UX，およびSolarisでは指定できません。

このオプションは，-aオプションと同時に指定します。

EmbedDB

使用するデータベースを組み込みDBとします。

この値は，-G，-ofおよび-odオプションとは同時に指定できません。

SQLSVR

使用するデータベースを外部DBとします。

この値は，-D，-I，-P，-M，-B，および-Sオプションとは同時に指定できません。

この値は，論理ホストをセットアップ対象とする場合は指定できません。

データベース種別はホスト内で同一である必要があります。次に示すデータベース種別が，指定した値と異なる場合，コマンドが異常終了します。

スケジューラーデータベース

エージェント管理用データベース

-of ODBCファイルデータソース名

データベースに外部DBを使用する場合，ODBCファイルデータソース名（ファイルDSNのファイル名）をフルパスで指定します。

ネットワークドライブは指定できません。

指定できる文字数は，次のとおりです。

Windowsの場合

1〜255（単位：バイト）

Linuxの場合

1〜128（単位：バイト）

指定できる文字は，次のとおりです。

半角英数字

記号

Windowsの場合：「¥」，「:」，「.」

UNIXの場合：「/」，「.」

また，空白を含む値は指定できません。

このオプションは，WindowsまたはLinuxで指定できます。AIX，HP-UX，およびSolarisでは指定できません。

このオプションは，-aおよび-k SQLSVRオプションと同時に指定します。

このオプションは，-D，-I，-P，-M，-B，および-Sオプションとは同時に指定できません。

このオプションは，論理ホストをセットアップ対象とする場合は指定できません。

データベースに外部DBを使用する場合は必ず指定してください。

このオプションに指定したODBCファイルデータソースが存在しない場合，コマンドが異常終了します。

-od データベース名

データベースに外部DBを使用する場合，外部DBのデータベース名を指定します。データベースに外部DBを使用する場合は必ず指定してください。

指定できる文字数は，1〜127（単位：バイト）です。ただし，指定できる文字は，半角英数字だけです。

このオプションは，WindowsまたはLinuxで指定できます。AIX，HP-UX，およびSolarisでは指定できません。

このオプションは，-aおよび-k SQLSVRオプションと同時に指定します。

このオプションは，-D，-I，-P，-M，-B，および-Sオプションとは同時に指定できません。

このオプションは，論理ホストをセットアップ対象とする場合は指定できません。

このオプションは，データベースに外部DBを利用する場合は必ず指定してください。

このオプションに指定した外部DBのデータベースが存在しない場合，コマンドが異常終了します。

-I セットアップ識別子

使用する組み込みDBのセットアップ識別子を「_JFn」（nは0〜9またはA〜Zのどれか）の4文字で指定します。

構築済みの組み込みDBにスケジューラーデータベースをセットアップする場合は，構築済みの組み込みDBのセットアップ識別子を指定してください。構築済みの組み込みDBのセットアップ識別子を指定しない場合は，-Iオプションに指定したセットアップ識別子で組み込みDBが新規に構築されます。

論理ホストで構築済みの組み込みDBセットアップ識別子を指定しなかった場合は，待機系の組み込みDBをセットアップしてください。

構築済みの組み込みDBのセットアップ識別子を指定しなかった場合，組み込みDBデータ領域は下記のディレクトリに作成されます。

Windowsの場合

物理ホスト：

JP1/AJS3のインストール先フォルダ¥embdb¥セットアップ識別子¥dbarea

論理ホスト：

共有フォルダ¥jp1ajs2¥embdb¥セットアップ識別子¥dbarea

UNIXの場合

物理ホスト：

/var/opt/jp1ajs2/embdb/セットアップ識別子/dbarea

論理ホスト：

共有ディレクトリ/jp1ajs2/embdb/セットアップ識別子/dbarea

このオプションは，-aオプションと同時に指定します。

このオプションは，-G，-k SQLSVR，-of，および-odオプションとは同時に指定できません。

論理ホストにスケジューラーサービスを追加する場合は必ず指定してください。指定しない場合，コマンドが異常終了します。

-P 組み込みDBポート番号

組み込みDBで使用するポート番号を指定します。

構築済みの組み込みDBにスケジューラーデータベースを作成する場合は，-Iオプションに指定したセットアップ識別子に対応する組み込みDBのポート番号を指定してください。組み込みDBを新規で構築する場合は，システム内で使用されていないポート番号を指定してください。

指定できる値は数値で，5001〜65535です。

このオプションは，-aオプションと同時に指定します。

このオプションは，-G，-k SQLSVR，-of，および-odオプションとは同時に指定できません。

論理ホストにスケジューラーサービスを追加する場合は必ず指定してください。指定しない場合，コマンドが異常終了します。

-M {s|m|l}

構築する組み込みDBのデータベースモデルを指定します。

データベースモデルの詳細およびディスク所要量については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　23.2 データベース領域の見積もり」を参照してください。

このオプションにlを指定して組み込みDBを構築した場合，組み込みDBの自動増分機能は無効となります。自動増分機能を使用したい場合は，高度なセットアップを実施してください。

-Iオプションに指定したセットアップ識別子で構築された組み込みDBが存在する場合，組み込みDBの空き領域の再利用開始ポイントだけが設定されます。この場合に，-Mオプションを省略したときは，格納先の組み込みDBのデータベースモデルが仮定されます。格納先の組み込みDBがJP1/AJS3 09-50以前に構築されている場合は，sが仮定されます。

-Iオプションに指定したセットアップ識別子で構築された組み込みDBが存在しない場合，指定したモデルで新規に組み込みDBがセットアップされます。省略した場合はsが仮定されます。

このオプションは，-aオプションと同時に指定します。

このオプションは，-G，-k SQLSVR，-of，-od，および-Sオプションとは同時に指定できません。

-E {byte|sjis}

指定したスケジューラーサービスのデータベースで，シフトJIS環境とUTF-8環境でユニット名などに同じ文字数を指定できるようにするかどうかを指定します。省略するとbyteが仮定されます。

このオプションはUNIXで指定できます。Windowsでは指定できません。

このオプションは，-aオプションと同時に指定します。

このオプションは，-Gおよび-Sオプションとは同時に指定できません。

byte

UTF-8環境で指定できる文字数を，UTF-8で換算するようにデータベースをセットアップします。このオプションを指定すると，シフトJIS環境とUTF-8環境で，ユニット名などに指定できる文字数が異なります。

このオプションを指定して実行すると，環境設定パラメーターDEFLENTYPEに「byte」が設定されます。

sjis

UTF-8環境で指定できる文字数を，シフトJIS環境で換算するようにデータベースをセットアップします。このオプションを指定すると，UTF-8環境でユニットに定義できる項目の文字数が，シフトJIS環境で定義できる文字数と同じとなります。

対象となる項目を次に示します。

ユニット詳細定義のユニット名

ユニット詳細定義のコメント

スケジュール設定の排他ジョブネット名

このオプションを指定して実行すると，環境設定パラメーターDEFLENTYPEに「sjis」，環境設定パラメーターAJSCHARCODEに「UTF-8」が設定されます。

-B

データベースに組み込みDBを使用する場合，バックアップ強化機能を有効にするときに指定します。省略すると，バックアップ強化機能は無効になります。

このオプションは，-aオプションと同時に指定します。

このオプションは，-G，-k SQLSVR，-of，および-odオプションと同時には指定できません。

-S

組み込みDBをセットアップしないで，別途，高度な設定で組み込みDBをセットアップする場合に指定します。このオプションを指定してコマンドが正常終了した場合は，必ず高度な設定で組み込みDBのセットアップを完了させてください。

高度な設定での組み込みDBのセットアップについては，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　23.5 組み込みDBの高度なセットアップ（クラスタ構成の場合）」を参照してください。

このオプションは，-aオプションと同時に指定します。

このオプションは，-G，-k SQLSVR，-of，-od，-E，-I，-P，および-Mオプションとは同時に指定できません。

注意事項

このコマンドを同時に複数実行しないでください。

コマンド実行中に強制終了しないでください。

データベースが組み込みDBのスケジューラーサービスを追加または削除する場合は，設定するホストに構築されているすべての組み込みDBを稼働状態にする必要があります。組み込みDBの状態を確認しないでコマンドを実行した場合は異常終了するおそれがあります。対象のホストに構築されている組み込みDBのセットアップ識別子（_JFn）については，ajsembdbidlistコマンドを実行して確認してください。

組み込みDBの状態の確認方法を次に示します。

Windowsの場合

・対象のJP1/AJS3 Database _JFn（nは0〜9またはA〜Zのどれか）のサービスが開始していることを確認してください。開始していない場合は，JP1/AJS3 Database _JFnのサービスを開始してください。

・ajsembdbstatusコマンドを-s ust -id _JFn（nは0〜9またはA〜Zのどれか）オプションを指定して実行し，組み込みDBが稼働状態になっていること（UNIT-STATがONLINEになっていること）を確認してください。稼働状態になっていない場合は，ajsembdbstartコマンドを-id _JFnオプションを指定して実行してください。

UNIXの場合

ajsembdbstatusコマンドを-s ust -id _JFn（nは0〜9またはA〜Zのどれか）オプションを指定して実行し，組み込みDBが稼働状態になっていること（UNIT-STATがONLINEになっていること）を確認してください。稼働状態になっていない場合は，ajsembdbstartコマンドを-id _JFnオプションを指定して実行してください。

スケジューラーサービスの追加，削除，名称変更の手順については，次のマニュアルの記載個所を参照してください。

Windowsの場合

・非クラスタ環境のとき

マニュアル「JP1/Automatic Job Management System 3 構築ガイド　6.1.1 スケジューラーサービスの多重起動の設定」

・クラスタ環境のとき

マニュアル「JP1/Automatic Job Management System 3 構築ガイド　8.2.10 論理ホストのスケジューラーサービスの多重起動の設定」

・外部DBを利用する環境のとき

マニュアル「JP1/Automatic Job Management System 3 構築ガイド　24.4.1(1) Windowsホストの場合」

UNIXの場合

・非クラスタ環境のとき

マニュアル「JP1/Automatic Job Management System 3 構築ガイド　15.1.1 スケジューラーサービスの多重起動の設定」

・クラスタ環境のとき

マニュアル「JP1/Automatic Job Management System 3 構築ガイド　17.2.10 論理ホストのスケジューラーサービスの多重起動の設定」

・外部DBを利用する環境のとき

マニュアル「JP1/Automatic Job Management System 3 構築ガイド　24.4.1(2) Linuxホストの場合」

なお，上記手順に記載されているJP1/AJS3サービスの停止処理を実施せずにコマンドを実行した場合でも，コマンドが正常終了する場合があります。この場合，コマンド終了後に必要な処理（JP1/AJS3サービスの停止処理，スケジューラーサービス情報の削除など）を実施してください。

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

コマンドを実行する際は，論理ホスト名から解決したIPアドレスを使って通信できる状態である必要があります。

組み込みDBポート番号とジョブ状態通信ポートのポート番号には，それぞれにシステム内で使用されていないポート番号を指定する必要があります。このため，-Pオプションで指定したポート番号（組み込みDBポート番号）と，-pオプション（ジョブ状態通信ポートのサービス名）に指定したサービスで使用されるポート番号は，同一のポート番号とならないようにしてください。

コマンド実行中に，メッセージ「Database maintenance failed(func code=xx, error code=yy)」を出力してコマンドが異常終了することがあります。その場合は，次の表に従って対処してください。

xxの値

対処

1

このメッセージの前に出力されているエラーメッセージについて，ajsembdbbuildコマンドのエラー発生時の対処方法に従って問題に対処し，コマンドを再度実行してください。

2

このメッセージの前に出力されているエラーメッセージについて，ajsembdbsetupコマンドのエラー発生時の対処方法に従って問題に対処し，コマンドを再度実行してください。

3

このメッセージの前に出力されているエラーメッセージについて，ajsembdbunsetコマンドのエラー発生時の対処方法に従って問題に対処し，コマンドを再度実行してください。

4

このメッセージの前に出力されているエラーメッセージの対処方法に従って問題に対処し，コマンドを再度実行してください。

5

出力されたメッセージのエラーコードyyについて，マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング　2.7.8(1) 組み込みDBのメンテナンス中にエラーが発生したときの対処方法」を参照し，問題に対処してください。

6

出力されたメッセージのエラーコードyyについて，マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング　2.7.8(2) 組み込みDBのインストール中にエラーが発生したときの対処方法」を参照し，問題に対処してください。

7

出力されたメッセージのエラーコードyyについて，マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング　2.7.8(3) 組み込みDBのアンインストール中にエラーが発生したときの対処方法」を参照し，問題に対処してください。

クラスタ構成の待機系ホストでは，jajs_setupコマンドでスケジューラーサービスを追加および削除できません。

待機系ホストに対してこれらの操作を実行したい場合は，JP1/Baseのコマンドを使用してください。手順は次のとおりです。

スケジューラーサービスの追加

実行系ホストで次のコマンドを実行し，論理ホストの構成定義を取得する。

jbsgetcnf -h 論理ホスト名 > 出力ファイル名

待機系ホストで次のコマンドを実行し，手順1で出力したファイルを取り込む。

jbssetcnf 出力ファイル名

スケジューラーサービスの削除

待機系ホストで次のコマンドを実行する。

jbsunsetcnf -h 論理ホスト名 -c "JP1AJSMANAGER¥スケジューラーサービス名"

運用プロファイルが設定されているスケジューラーサービスの名称を変更する場合，運用プロファイルのファイル名も変更してください。

例えば，ユニット属性プロファイルが設定されているスケジューラーサービスAJSROOT2の名称をAJSROOT3に変更する場合，ユニット属性プロファイルのファイル名を，次のように変更してください。

変更前：ajsprof_AJSROOT2_unit.conf

変更後：ajsprof_AJSROOT3_unit.conf

運用プロファイルが設定されているスケジューラーサービスを削除する場合，必要に応じて該当する運用プロファイルも削除してください。

jajs_setupコマンドに-Sオプションを指定したあとに，高度な設定で組み込みDBのセットアップを完了させないままJP1/AJS3サービスを起動したり，コマンドを実行したりすると，メッセージKAVS1516-Eが出力されて該当の操作が失敗します。

Windowsでインストール先ディレクトリをデフォルトのパスとは異なるパスに構築した組み込みDBに，スケジューラーサービスを追加する場合には，jajs_setupコマンドに-Sオプションを指定して，組み込みDBの高度なセットアップを実施してください。

JP1/AJS3のバージョンが10-50以前か11-00以降かで，追加するスケジューラーサービスの環境設定パラメーターの初期値に差異があります。初期値の差異については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　付録C.2 バージョン11-00で初期値が推奨値に変更された環境設定パラメーター一覧」を参照してください。

データベースが外部DBの場合，対象となるデータベースのインスタンスが起動している必要があります。インスタンスが起動していない状態でコマンドを実行した場合，コマンドが異常終了します。

データベースが外部DBのスケジューラーサービス，または実行エージェント情報が存在する場合，データベースが組み込みDBのスケジューラーサービスは追加できません。

データベースが組み込みDBのスケジューラーサービス，または実行エージェント情報が存在する場合，データベースが外部DBのスケジューラーサービスの追加，またはデータベースが外部DBの実行エージェント情報のセットアップはできません。

スケジューラーサービスまたは実行エージェント情報が存在する場合，データベースが外部DBの実行エージェント情報はセットアップできません。

データベースが外部DBのスケジューラーサービスを追加する場合，データベースが外部DBの実行エージェント情報がセットアップされている必要があります。

ホストのOSがLinuxの場合で，データベースが外部DBのスケジューラーサービスを追加，または実行エージェント情報をセットアップするとき，jajs_setupコマンドの-ofオプションに存在しないODBCファイルデータソース名を指定すると，ODBCドライバによって0バイトのファイルが作成されることがあります。0バイトのファイルが作成された場合は，不要なファイルであることを確認し，手動で削除してください。

データベースが組み込みDBのスケジューラーサービスを追加する場合，バックアップ強化機能の有効・無効を組み込みDBと一致させる必要があります。すでに構築されている組み込みDBの設定内容と異なる値を指定してコマンドを実行した場合，スケジューラーサービスは追加できません。

構築済みの組み込みDBに，バックアップ強化機能が有効なスケジューラーサービスを追加する場合，追加先の組み込みDBはバックアップ強化機能が有効な状態でセットアップされている必要があります。組み込みDBでバックアップ強化機能が有効になっているかどうかは，ajsembdbstatusコマンドで組み込みDBの構成情報を出力し，出力項目ENHANCEDBACKUPの値を確認してください。ajsembdbstatusコマンドの詳細については，「3. 通常の運用で使用するコマンド　ajsembdbstatus」を参照してください。

戻り値

0〜9

正常終了。

10〜49

警告終了。コマンドは終了したが，手動による操作が必要。

50以上

異常終了。

使用例1

物理ホストに対して，次の条件のスケジューラーサービスを追加します。

スケジューラーサービス名：AJSROOT2

スケジューラーサービスの識別番号：2

ジョブ状態通信ポートのサービス名：jp1ajs2report2

データベースディレクトリ名：/var/opt/jp1ajs2/database/schedule/AJSROOT2

テンポラリーディレクトリ名：/var/opt/jp1ajs2/tmp/schedule2

ジョブ情報ディレクトリ名：/var/opt/jp1ajs2/jobinf2

退避情報ディレクトリ名：/var/opt/jp1ajs2/backup/schedule2

jajs_setup -a -h JP1_DEFAULT -F AJSROOT2 -n 2 -p jp1ajs2report2
   -d "/var/opt/jp1ajs2/database/schedule/AJSROOT2"
   -t "/var/opt/jp1ajs2/tmp/schedule2"
   -j "/var/opt/jp1ajs2/jobinf2"
   -b "/var/opt/jp1ajs2/backup/schedule2"

使用例2

論理ホスト（lhost）に対して，次の条件のスケジューラーサービスを追加します。

スケジューラーサービス名：AJSROOT3

スケジューラーサービスの識別番号：3

ジョブ状態通信ポートのサービス名：jp1ajs2report3

データベースディレクトリ名：H:¥JP1LHOST¥jp1ajs2¥database¥schedule¥AJSROOT3

テンポラリーディレクトリ名：H:¥JP1LHOST¥jp1ajs2¥tmp¥schedule3

ジョブ情報ディレクトリ名：H:¥JP1LHOST¥jp1ajs2¥jobinf3

退避情報ディレクトリ名：H:¥JP1LHOST¥jp1ajs2¥backup¥schedule3

論理ホスト共有ディレクトリ名：H:¥JP1LHOST

セットアップ識別子：_JFA

組み込みDBポート番号：22250

jajs_setup -a -h lhost -F AJSROOT3 -n 3 -p jp1ajs2report3
   -d "H:¥JP1LHOST¥jp1ajs2¥database¥schedule¥AJSROOT3"
   -t "H:¥JP1LHOST¥jp1ajs2¥tmp¥schedule3"
   -j "H:¥JP1LHOST¥jp1ajs2¥jobinf3"
   -b "H:¥JP1LHOST¥jp1ajs2¥backup¥schedule3"
   -D "H:¥JP1LHOST"
   -I _JFA
   -P 22250

使用例3

スケジューラーサービス名（AJSROOT2）を（JP1AJS3001）に変更します。

jajs_setup -r -F AJSROOT2 -A JP1AJS3001

使用例4

スケジューラーサービス（AJSROOT2）を削除します。

jajs_setup -e -F AJSROOT2

使用例5

データベースが外部DBの実行エージェント情報をセットアップします。

jajs_setup -a -k SQLSVR -G -of C:¥odbc¥ajsdatasource.dsn -od AJSDB

使用例6

次の条件のデータベースが外部DBのスケジューラーサービスを追加します。

スケジューラーサービス名：AJSROOT2

スケジューラーサービスの識別番号：2

ジョブ状態通信ポートのサービス名：jp1ajs2report2

データベースディレクトリ名：/var/opt/jp1ajs2/database/schedule/AJSROOT2

テンポラリーディレクトリ名：/var/opt/jp1ajs2/tmp/schedule2

ジョブ情報ディレクトリ名：/var/opt/jp1ajs2/jobinf2

退避情報ディレクトリ名：/var/opt/jp1ajs2/backup/schedule2

ODBCファイルデータソース名：/odbc/ajsdatasource.dsn

データベース名：AJSROOT2DB

jajs_setup -a -k SQLSVR -F AJSROOT2 -n 2 -p jp1ajs2report2
   -d "/var/opt/jp1ajs2/database/schedule/AJSROOT2"
   -t "/var/opt/jp1ajs2/tmp/schedule2"
   -j "/var/opt/jp1ajs2/jobinf2"
   -b "/var/opt/jp1ajs2/backup/schedule2"
   -of "/odbc/ajsdatasource.dsn" -od AJSROOT2DB

jajs_setup_cluster

形式

JP1/AJS3 - Managerの場合

jajs_setup_cluster
     [-h 論理ホスト名]
     -F スケジューラーサービス名
     {-d 共有ディレクトリ名
      [-n スケジューラーサービスの識別番号]
      [-m {cold|warm|hot}]
      {-P 組み込みDBポート番号
       -I 組み込みDBセットアップ識別子
      [-M {s|m|l}]
      [-E {byte | sjis}]
      [-B] |
       -S} |
      [-S | -C 組み込みDB設定ファイル名]}
     [-R]

JP1/AJS3 - Agentの場合

jajs_setup_cluster
     [-h 論理ホスト名]
     [-d 共有ディレクトリ名]

形式1（JP1/AJS3 - Manager実行系のセットアップ）

jajs_setup_cluster
     [-h 論理ホスト名]
     -F スケジューラーサービス名
     -d 共有ディレクトリ名
     [-n スケジューラーサービスの識別番号]
     [-m {cold|warm|hot}]
     {-P 組み込みDBポート番号
      -I 組み込みDBセットアップ識別子 |
      [-M {s|m|l}]
      [-E {byte | sjis}]
      [-B] |
      [-S]}

形式2（JP1/AJS3 - Manager待機系のセットアップ）

jajs_setup_cluster
     [-h 論理ホスト名]
     -F スケジューラーサービス名
      [-S | -C 組み込みDB設定ファイル名]

形式3（JP1/AJS3 - Agent実行系のセットアップ）

jajs_setup_cluster
     [-h 論理ホスト名]
     -d 共有ディレクトリ名

形式4（JP1/AJS3 - Agent待機系のセットアップ）

jajs_setup_cluster
     [-h 論理ホスト名]

形式5（リモートサイトのJP1/AJS3 - Manager実行系/待機系のセットアップ）

jajs_setup_cluster
     [-h 論理ホスト名]
     -F スケジューラーサービス名
     -R

機能

JP1/AJS3の論理ホストに対応した動作環境をセットアップします。クラスタ運用環境のセットアップ時には，実行系と待機系のそれぞれで実行してください。

なお，このコマンドを実行する場合は，事前にJP1/Baseの物理ホスト環境および論理ホスト環境のセットアップを実施しておく必要があります。

このコマンドは，物理ホストの環境をコピーして論理ホストの環境を作成します。作成した論理ホストには，物理ホストのデフォルトスケジューラーサービスの設定をコピーして，スケジューラーサービスを作成します。デフォルトスケジューラーサービスに設定されたスケジューラーサービスがない場合，存在するすべてのスケジューラーサービスの中で最小のスケジューラーサービスの識別番号（環境設定パラメーターAJSSERVICEIDの設定値）が設定されたスケジューラーサービスの設定をコピーして，スケジューラーサービスを作成します。

また，-Rオプションを指定し，リモートサイトのJP1/AJS3 - Managerの実行系および待機系をセットアップすると，JP1/AJS3論理ホストのスケジューラーサービスが追加されます。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-h 論理ホスト名

セットアップする論理ホスト名（JP1/Baseで設定した論理ホスト名）を指定します。

指定できる文字数は，1〜32（単位：バイト）です。

オプションに指定した論理ホスト名で環境が作成されます。

オプションを指定すると，環境変数JP1_HOSTNAMEの値よりオプションに指定した値の方が優先されます。省略した場合，環境変数JP1_HOSTNAMEの値が論理ホスト名に仮定されます。

次の場合，コマンドは異常終了します。

オプションを省略し，環境変数JP1_HOSTNAMEが設定されていない場合

セットアップ対象とする論理ホスト名に，物理ホスト名「JP1_DEFAULT」が指定されている場合

実行系のセットアップを実施する場合に，セットアップ対象とする論理ホスト名から解決したIPアドレスを使って通信できない場合

-F スケジューラーサービス名

JP1/AJS3 - Managerでの実行系のセットアップの場合

作成するスケジューラーサービス名を指定します。

すでに作成されているスケジューラーサービスを指定すると，コマンドは異常終了します。

JP1/AJS3 - Managerでの待機系のセットアップの場合

実行系で指定したスケジューラーサービス名を指定します。

上記以外のスケジューラーサービス名を指定すると，コマンドは異常終了します。

ディザスター・リカバリー運用時にリモートサイトでJP1/AJS3 - Managerをセットアップする場合

メインサイトの実行系を作成したときに指定したスケジューラーサービス名を指定します。

上記以外のスケジューラーサービス名を指定すると，コマンドは異常終了します。

指定できる文字数は，1〜30（単位：バイト）です。

スケジューラーサービス名に指定できる文字については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4 スケジューラーサービス環境設定」の「表20-2 環境設定パラメーター一覧（スケジューラーサービス環境設定）」の下にある，スケジューラーサービスに関する注意を参照してください。

このオプションは，JP1/AJS3 - Managerでは省略できません。

-d 共有ディレクトリ名

実行系から待機系に引き継ぐ情報を格納する共有ディスクの，マウント先のディレクトリ名をフルパスで指定します。指定するディレクトリは，存在するディレクトリを指定してください。指定したディレクトリがない場合，コマンドは異常終了します。また，ネットワークドライブ上のディスクは指定しないでください。

指定できる文字数は，1〜122（単位：バイト）です。

UNIXで「/」（ルート）を指定した場合，またはWindowsで先頭2バイトにドライブ文字（例：「C:」）以外を指定した場合は，コマンドが異常終了します。

このオプションは，実行系のセットアップを実施する場合に必ず指定してください。省略した場合は，待機系としてセットアップされます。

共有ディレクトリとして，Windowsの場合は「指定した共有ディレクトリ名¥JP1AJS2」，UNIXの場合は「指定した共有ディレクトリ名/jp1ajs2」が作成され，その下に論理ホストの環境定義ファイルや実行環境が作成されます。ただし，これらのディレクトリがすでにある場合は，コマンドが異常終了します。実行系のセットアップを実施する場合は，必ず共有ディスクをマウントし，これらのディレクトリがないことを確認してから実行してください。

このオプションは，-Cおよび-Rオプションとは同時に指定できません。

-n スケジューラーサービスの識別番号

スケジューラーサービスの識別番号を10進数で指定します。

指定できる値は，1〜20です。

このオプションは，JP1/AJS3 - Managerでの実行系のセットアップ（-dオプションの指定）時にだけ指定できます。

識別番号は，自ホスト内の物理ホストおよびすべての論理ホストで使用している識別番号と重複しない番号を指定してください。すでに使用している識別番号を指定した場合，コマンドは異常終了します。

このオプションを省略した場合は，使用していない識別番号のいちばん小さい値が仮定されます。スケジューラーサービスの合計数が上限に達している場合は，スケジューラーサービス識別番号の割り当てに失敗し，コマンドが異常終了します。

-m {cold|warm|hot}

スケジューラーサービスの起動モードを指定します。

cold

スケジューラーサービスをコールドスタートします。

warm

スケジューラーサービスをウォームスタートします。

hot

スケジューラーサービスをホットスタートします。

このオプションは，JP1/AJS3 - Managerでの実行系のセットアップ（-dオプションの指定）時にだけ指定できます。

このオプションを省略した場合，物理ホストの環境設定パラメーターDEFAULTSERVICENAMEに指定されているスケジューラーサービスの，環境設定パラメーターSTARTMODEの値が仮定されます。

-P 組み込みDBポート番号

論理ホストのセットアップ時，同時に組み込みDBをセットアップする場合に，論理ホストで使用する組み込みDBのポート番号を指定します。

指定できる値は，5001〜65535の数値です。

ほかのプログラムが使うポート番号と重複しない値を指定してください。ここで指定したポート番号は，ほかのプログラムでは使えません。ポート番号がほかのアプリケーションと重複すると，アプリケーションか組み込みDBのどちらかにトラブルが発生します。その場合は，該当するアプリケーションのポート番号を変更するか，または組み込みDBのポート番号を変更する必要があります。

このオプションは，JP1/AJS3 - Managerでの実行系のセットアップ（-dオプションの指定）時に同時に組み込みDBをセットアップする場合には省略できません。

このオプションは，-C，-R，および-Sオプションとは同時に指定できません。

-I 組み込みDBセットアップ識別子

論理ホストのセットアップ時，同時に組み込みDBをセットアップする場合に，論理ホストで使用する組み込みDBのセットアップ識別子を「_JFn」（nは1〜9またはA〜Zのどれか）の4文字で指定します。システム内で登録されていないセットアップ識別子を指定してください。すでに登録されているセットアップ識別子を指定した場合，コマンドは異常終了します。登録済みのセットアップ識別子は，ajsembdbidlistコマンドで確認できます。ajsembdbidlistコマンドの詳細については，「2. セットアップコマンド　ajsembdbidlist」を参照してください。

このオプションは，JP1/AJS3 - Managerでの実行系のセットアップ時に同時に組み込みDBをセットアップする場合には省略できません。

このオプションは，-C，-R，および-Sオプションとは同時に指定できません。

-M {s|m|l}

構築する組み込みDBのデータベースモデルを指定します。

データベースモデルおよびディスク所要量の詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　23.2 データベース領域の見積もり」を参照してください。

このオプションにlを指定して組み込みDBを構築した場合，組み込みDBの自動増分機能は無効となります。自動増分機能を使用したい場合は，高度なセットアップを実施してください。

このオプションは，-C，-R，および-Sオプションとは同時に指定できません。

-E {byte|sjis}

指定したスケジューラーサービスのデータベースで，シフトJIS環境とUTF-8環境でユニット名などに同じ文字数を指定できるようにするかどうかを指定します。省略するとbyteが仮定されます。

このオプションはUNIXで指定できます。Windowsでは指定できません。

このオプションは，-C，-R，および-Sオプションとは同時に指定できません。

byte

UTF-8環境で指定できる文字数を，UTF-8で換算するようにデータベースをセットアップします。このオプションを指定すると，シフトJIS環境とUTF-8環境で，ユニット名などに指定できる文字数が異なります。

このオプションを指定して実行すると，環境設定パラメーターDEFLENTYPEに「byte」が設定されます。

sjis

UTF-8環境で指定できる文字数を，シフトJIS環境で換算するようにデータベースをセットアップします。このオプションを指定すると，UTF-8環境でユニットに定義できる項目の文字数が，シフトJIS環境で定義できる文字数と同じとなります。

対象となる項目を次に示します。

ユニット詳細定義のユニット名

ユニット詳細定義のコメント

スケジュール設定の排他ジョブネット名

このオプションを指定して実行すると，環境設定パラメーターDEFLENTYPEに「sjis」，環境設定パラメーターAJSCHARCODEに「UTF-8」が設定されます。

-B

データベースに組み込みDBを使用する場合，バックアップ強化機能を有効にするときに指定します。省略すると，バックアップ強化機能は無効になります。

このオプションは，-C，-R，および-Sオプションとは同時に指定できません。

-C 組み込みDB設定ファイル名

組み込みDB設定ファイルを指定します。

指定できる文字数は，1〜255（単位：バイト）です。

待機系のクラスタ環境を構築する場合に，実行系にある次の組み込みDB設定ファイルを待機系にコピーして指定してください。

Windowsの場合

組み込みDB運用ディレクトリ¥conf¥ajsdbst¥ajsembdbセットアップ識別子.conf

UNIXの場合

組み込みDB運用ディレクトリ/conf/ajsdbst/ajsembdbセットアップ識別子.conf

実行系を構築する際に-Mオプションを指定した場合は，このオプションを必ず指定してください。実行系の環境構築時にこのオプションを指定した場合，メッセージKAVS0116-Eが出力され，コマンドが異常終了します。組み込みDB設定ファイルの内容が不正であった場合，メッセージKAVS2130-Eが出力され，コマンドが異常終了します。

JP1/AJS3 09-50以前に構築された組み込みDBには，このオプションは指定できません。

このオプションは，-hおよび-Fオプション以外のオプションとは同時に指定できません。

実行系で組み込みDBの高度なセットアップを行っている場合，実行系で指定した次のディレクトリを待機系のホストにあらかじめ作成してください。

アンロードログファイル作成ディレクトリ

組み込みDB作業領域ディレクトリ

組み込みDBインストール先ディレクトリ

なお，アンロードログファイル作成ディレクトリは，実行系のセットアップ時にローカルディスク上のディレクトリを指定した場合，待機系でも作成が必要です。

-S

論理ホストのセットアップ時，組み込みDBをセットアップしないで，別途，高度なセットアップで組み込みDBを構築する場合に指定します。このオプションを指定してjajs_setup_clusterコマンドを実行したあと，組み込みDBの構築を完了させてください。

組み込みDBの構築が完了する前にjajs_configコマンド，jajs_setupコマンド，またはjajs_setup_clusterコマンドを実行すると，コマンドはエラーメッセージKAVS1516-Eを出力して異常終了します。

高度なセットアップでの組み込みDBの構築については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　23.5 組み込みDBの高度なセットアップ（クラスタ構成の場合）」を参照してください。

このオプションは，JP1/AJS3 - Managerの場合だけ指定できます。

このオプションは，-C，-E，-M，-R，-P，または-Iオプションとは同時に指定できません。

-R

ディザスター・リカバリー環境で，リモートサイトの論理ホストをセットアップする場合に指定します。

このオプションは，-hおよび-Fオプション以外のオプションとは同時に指定できません。

注意事項

このコマンドを実行する前に，すべてのJP1/AJS3サービスを停止してください。

このコマンドを同時に複数実行しないでください。

コマンド実行中に強制終了しないでください。

このコマンドは，物理ホストのjp1ajs_spmd.confファイルを論理ホストにコピーします。そのため，物理ホストのjp1ajs_spmd.confファイルを編集してプロセスの起動または起動プロセスの抑止の設定をしていると，論理ホストに設定が引き継がれます。この場合，論理ホストに必要のないプロセスが起動されたり，論理ホストに必要なプロセスが起動されなかったりしてしまいます。物理ホストでjp1ajs_spmd.confファイルを編集している場合は，論理ホストのjp1ajs_spmd.confファイルを編集し，必要なプロセスだけが起動されるようにしてください。

起動プロセスの抑止については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　13.1.6 JP1/AJS3 - Managerの運用をジョブの実行だけに限定して使用するリソースを低減したい」を参照してください。

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

コマンド実行中に，メッセージ「Database maintenance failed(func code=xx, error code=yy)」を出力してコマンドが異常終了することがあります。その場合は，次の表に従って対処してください。

xxの値

対処

1

このメッセージの前に出力されているエラーメッセージについて，ajsembdbbuildコマンドのエラー発生時の対処方法に従って問題に対処し，コマンドを再度実行してください。

2

このメッセージの前に出力されているエラーメッセージについて，ajsembdbsetupコマンドのエラー発生時の対処方法に従って問題に対処し，コマンドを再度実行してください。

3

このメッセージの前に出力されているエラーメッセージについて，ajsembdbunsetコマンドのエラー発生時の対処方法に従って問題に対処し，コマンドを再度実行してください。

4

このメッセージの前に出力されているエラーメッセージの対処方法に従って問題に対処し，コマンドを再度実行してください。

5

出力されたメッセージのエラーコードyyについて，マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング　2.7.8(1) 組み込みDBのメンテナンス中にエラーが発生したときの対処方法」を参照し，問題に対処してください。

6

出力されたメッセージのエラーコードyyについて，マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング　2.7.8(2) 組み込みDBのインストール中にエラーが発生したときの対処方法」を参照し，問題に対処してください。

7

出力されたメッセージのエラーコードyyについて，マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング　2.7.8(3) 組み込みDBのアンインストール中にエラーが発生したときの対処方法」を参照し，問題に対処してください。

実行系でのコマンド実行中にエラーが発生した場合は，エラーの原因を取り除いたあとに，「実行系でのエラー発生時の対処」に従って論理ホストの情報をアンセットアップしてください。その後，再度コマンドを実行してください。

待機系でのコマンド実行中にエラーが発生した場合は，エラーの原因を取り除いたあとで再度コマンドを実行してください（論理ホストの情報は削除しないでください）。

JP1/AJS3 - Managerで，実行系のセットアップ時に-Fオプションに指定したスケジューラーサービスを削除しないでください。削除すると待機系のセットアップに失敗します。削除する場合は，「実行系でのエラー発生時の対処」に示す手順と同じ手順で実行系の情報を削除したあと，再度実行系からセットアップしてください。

物理ホストのスケジューラーサービスに運用プロファイルを設定している場合にこのコマンドを実行すると，運用プロファイルが論理ホストにコピーされます。コピーされた運用プロファイルは，必要に応じて削除してください。

このコマンドは，物理ホストの実行許可コマンド設定ファイルを論理ホストにコピーします。そのため，物理ホストの実行許可コマンド設定ファイルで実行を許可したコマンドの設定は，論理ホストに引き継がれます。JP1/AJS3 - Viewから物理ホストに対してコマンドの実行を許可している場合は，論理ホストの実行許可コマンド設定ファイルを編集し，必要なコマンドだけ実行を許可するように設定してください。実行許可コマンド設定ファイルの設定方法については，マニュアル「JP1/Automatic Job Management System 3 操作ガイド　11.3.18 JP1/AJS3のコマンドを実行できるようにする」を参照してください。

スケジューラーサービスが使用するディレクトリを変更したい場合，次の対処をしてください。

データベースディレクトリを変更したい場合，環境設定パラメーターAJSDBDIRECTORYの値を変更してください。

テンポラリーディレクトリを変更したい場合，環境設定パラメーターAJSTMPDIRの値を変更してください。

ジョブ情報ディレクトリを変更したい場合，環境設定パラメーターJOBINFDIRの値を変更してください。

退避情報ディレクトリを変更したい場合，環境設定パラメーターAJSBKUROOTの値を変更してください。

各パラメーターの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2 スケジューラーサービスの環境設定パラメーターの詳細」を確認してください。

実行系でのエラー発生時の対処

実行系でのjajs_setup_clusterコマンド実行中にエラーが発生した場合は，エラーの原因を取り除いたあとに，論理ホストの情報を削除してください。その後，再度コマンドを実行してください。

jajs_setup_clusterコマンドがエラーメッセージKAVS1126-Eを出力して論理ホストのセットアップに失敗した場合は，論理ホストの組み込みDBの削除が必要です。ただし，jajs_setup_clusterコマンドに-Sオプションを指定して組み込みDBを同時にセットアップしていない場合や，エラーメッセージKAVS1126-Eが出力されないで論理ホストのセットアップに失敗した場合は，論理ホストの組み込みDBの削除は不要です。

論理ホストの組み込みDBを削除する場合は，ajsembdbuninstlコマンドを使用します。ajsembdbuninstlコマンドの詳細については，「2. セットアップコマンド　ajsembdbuninstl」を参照してください。なお，論理ホストの組み込みDBの削除は論理ホストを削除する前に実施してください。

論理ホストの情報を削除する手順を次に示します。

論理ホスト情報の削除

共有ディスク上の共有ファイルおよびディレクトリを削除する。

JP1/AJS3の共有ディスク情報を削除します。

Windowsの場合：共有ディスク¥JP1AJS2

UNIXの場合：共有ディスク/jp1ajs2

論理ホスト上のJP1/AJS3の共通定義情報を削除する。

次に示すコマンドを実行して論理ホスト上のJP1/AJS3の共通定義情報を削除してください。jbsunsetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

jbsunsetcnf -i -h 論理ホスト名 -c JP1AJS2

jbsunsetcnf -i -h 論理ホスト名 -c JP1AJS2COMMON

jbsunsetcnf -i -h 論理ホスト名 -c JP1NBQAGENT

jbsunsetcnf -i -h 論理ホスト名 -c JP1NBQMANAGER※

jbsunsetcnf -i -h 論理ホスト名 -c JP1NBQCLIENT

jbsunsetcnf -i -h 論理ホスト名 -c JP1NBQNOTIFY

jbsunsetcnf -i -h 論理ホスト名 -c JP1AOMMANAGER※

jbsunsetcnf -i -h 論理ホスト名 -c JP1AOMAGENT

jbsunsetcnf -i -h 論理ホスト名 -c JP1AJSMANAGER※

jbsunsetcnf -i -h 論理ホスト名 -c JP1QLAGENT

注※

　JP1/AJS3 - Managerの場合にだけあります。

なお，コマンドの実行時，設定されている情報がない場合は，メッセージ「KAVA0405-I The specified -cで指定した文字列 does not exist [論理ホスト名]. Processing Stops.」が出力されることがありますが，無視してください。

実行系セットアップ時に作成される共有ディレクトリ配下の権限について

Windowsの場合

「共有フォルダ¥jp1ajs2」を含む配下のフォルダが作成され，次の表に示すフォルダに「Everyoneフルコントロール」権限が設定されます。その他のフォルダは，上位フォルダの権限を引き継ぎます。

なお，「共有フォルダ¥jp1ajs2」の上位フォルダに対しては，SYSTEMおよび管理者権限を持つユーザーは「フルコントロール」，その他のユーザーは「読み取りと実行」以上の権限を設定し，配下のファイルおよびフォルダに引き継ぐ設定をしてください。

重要

「Everyoneフルコントロール」権限が設定されたフォルダの権限を変更しないでください。権限を変更すると，論理ホストの起動に失敗します。

表2‒3　「Everyoneフルコントロール」権限が設定されるフォルダ

項番

フォルダパス

JP1/AJS3 - Manager

JP1/AJS3 - Agent

1

共有フォルダ¥jp1ajs2¥backup

○

×

2

共有フォルダ¥jp1ajs2¥database

○

×

3

共有フォルダ¥jp1ajs2¥jobinf

○

×

4

共有フォルダ¥jp1ajs2¥log

○

○

5

共有フォルダ¥jp1ajs2¥sys

○

○

6

共有フォルダ¥jp1ajs2¥tmp

○

○

（凡例）

○：作成される

×：作成されない

UNIXの場合

「共有ディレクトリ/jp1ajs2」を含む配下のディレクトリが作成され，次の表に示すディレクトリに「777」権限が設定されます。「共有ディレクトリ/jp1ajs2」および「共有ディレクトリ/jp1ajs2」配下のディレクトリのうち，次の表に含まないディレクトリには，「755」権限が設定されます。

なお，AJS管理者ユーザーで実行系セットアップをする場合，「共有ディレクトリ/jp1ajs2」の上位ディレクトリに対して，JP1管理者グループの読み込みおよび書き込み権限が必要となります。

重要

「777」権限が設定されたディレクトリの権限を変更しないでください。権限を変更すると，論理ホストの起動に失敗します。

表2‒4　「777」権限が設定されるディレクトリ

項番

ディレクトリパス

JP1/AJS3 - Manager

JP1/AJS3 - Agent

1

共有ディレクトリ/jp1ajs2/backup/schedule

○

×

2

共有ディレクトリ/jp1ajs2/database/schedule/スケジューラーサービス名

○

×

3

共有ディレクトリ/jp1ajs2/jobinf

○

×

4

共有ディレクトリ/jp1ajs2/jobinf/schedule/スケジューラーサービス名

○

×

5

共有ディレクトリ/jp1ajs2/jobinf/delete

○

×

6

共有ディレクトリ/jp1ajs2/log

○

○

7

共有ディレクトリ/jp1ajs2/log/JAJS_SETUP

○

○

8

共有ディレクトリ/jp1ajs2/log/jpqagent

○

○

9

共有ディレクトリ/jp1ajs2/log/jpqclient

○

○

10

共有ディレクトリ/jp1ajs2/log/jpqmanager

○

×

11

共有ディレクトリ/jp1ajs2/log/jpqnotify

○

○

12

共有ディレクトリ/jp1ajs2/log/schedule

○

×

13

共有ディレクトリ/jp1ajs2/log/schedule/スケジューラーサービス名

○

×

14

共有ディレクトリ/jp1ajs2/tmp

○

○

15

共有ディレクトリ/jp1ajs2/tmp/schedule

○

×

16

共有ディレクトリ/jp1ajs2/tmp/schedule/スケジューラーサービス名

○

×

（凡例）

○：作成される

×：作成されない

戻り値

0〜9

正常終了。

10〜49

警告終了。コマンドは終了したが，手動による操作が必要。

50以上

異常終了。

補足事項

-P，-Iオプションを指定してセットアップした場合，次に示す値で組み込みDBが設定されます。

データベースモデル：-s（小規模モデル）

システムログ運用：行わない

システムファイルの二重化：行わない

アンロードログファイル：使用しない

データ領域ディレクトリ

Windowsの場合

共有フォルダ¥jp1ajs2¥embdb¥-Iオプションで指定した値¥dbarea

UNIXの場合

共有ディレクトリ/jp1ajs2/embdb/-Iオプションで指定した値/dbarea

作業領域ディレクトリ

Windowsの場合

JP1/AJS3のインストール先フォルダ¥embdb¥-Iオプションで指定した値¥dbarea

UNIXの場合

/opt/jp1ajs2/embdb/-Iオプションで指定した値/dbarea

組み込みDB運用ディレクトリ

Windowsの場合

JP1/AJS3のインストール先フォルダ¥embdb¥-Iオプションで指定した値

UNIXの場合

/opt/jp1ajs2/embdb/-Iオプションで指定した値

データベース領域の自動増分：行う

システムログの自動増分：行う

その他の項目は，デフォルトの設定が有効になります。

使用例1

JP1/AJS3 - Managerの実行系ホストで組み込みDBを同時にセットアップします。

論理ホスト：lhost1

スケジューラーサービス：AJS3SCHEDULE001

共有ディレクトリ名：F:¥shdsk¥lhost1

組み込みDBポート番号：22201

組み込みDBセットアップ識別子：_JF1

jajs_setup_cluster -h lhost1 -F AJS3SCHEDULE001 -d "F:¥shdsk¥lhost1" -P 22201 -I _JF1

使用例2

JP1/AJS3 - Managerの実行系ホストで，組み込みDBは別にセットアップします。

論理ホスト：lhost2

スケジューラーサービス：AJS3SCHEDULE002

共有ディレクトリ名：F:¥shdsk¥lhost2

スケジューラーサービスの識別番号：3

スケジューラーサービスの起動モード：ホットスタート

jajs_setup_cluster -h lhost2 -F AJS3SCHEDULE002 -d "F:¥shdsk¥lhost2" -n 3 -m hot -S

使用例3

JP1/AJS3 - Managerの待機系ホストで組み込みDBを同時にセットアップします。

論理ホスト：lhost1

スケジューラーサービス：AJS3SCHEDULE001

jajs_setup_cluster -h lhost1 -F AJS3SCHEDULE001

使用例4

JP1/AJS3 - Managerの待機系ホストで組み込みDBは別にセットアップします。

論理ホスト：lhost2

スケジューラーサービス：AJS3SCHEDULE002

jajs_setup_cluster -h lhost2 -F AJS3SCHEDULE002 -S

使用例5

JP1/AJS3 - Agentの実行系ホストをセットアップします。

論理ホスト：lhosta1

共有ディレクトリ名：F:¥shdsk¥lhosta1

jajs_setup_cluster -h lhosta1 -d "F:¥shdsk¥lhosta1"

使用例6

JP1/AJS3 - Agentの待機系ホストをセットアップします。

論理ホスト：lhosta1

jajs_setup_cluster -h lhosta1

jpomailrecv（UNIX限定）

形式

jpomailrecv
     -u 監視ユーザー名
     [-t リトライ打ち切り時間]

機能

SMTPメールサーバのエイリアスを利用してメールを取得し，メール受信監視独自のメールファイルを作成したり，排他制御を実行したりするための，メール配信機能を設定します。

実行権限

なし

引数

-u 監視ユーザー名

環境設定パラメーターUserNameに指定したユーザー名を指定します。

指定できる文字数は，1〜256（単位：バイト）です。

-t リトライ打ち切り時間

編集しようとしたメールファイルに排他制御が設定されている場合に，編集のリトライを打ち切る時間を指定します。

指定できる値は，1〜1,440（単位：分）です。省略した場合，リトライは無制限になります。

注意事項

コマンドを実行する場合には，JP1/AJS3サービスを起動しておく必要があります。

環境設定パラメーターUserNameには，コマンドの監視ユーザー名と同じユーザー名を指定してください。また，コマンドの実行前に，jajs_configコマンドで環境設定パラメーターUserNameの内容をシステムに反映してください。環境設定パラメーターUserNameの詳細，およびjajs_configコマンドでの設定方法については，マニュアル「JP1/Automatic Job Management System 3 連携ガイド　2.4.2 メール受信監視ジョブのための環境設定をする」を参照してください。

コマンド実行時にエラーが発生した場合や，編集のリトライを打ち切った場合，受信したメールは送信元に返信されます（ロックファイルの削除に失敗した場合を除く）。

このコマンドは，必ずエイリアスファイルに記述し，SMTPメールサーバから起動してください。手動で直接起動した場合の動作については保証できません。

エイリアスファイルに記述する際は，コマンド全体を「"」で囲んでください。

使用例1

環境設定パラメーターUserNameに「mailuser」と指定している場合に，リトライ打ち切り時間を10分とします。

mailuser:"|/opt/jp1ajs2/bin/jpomailrecv -u mailuser -t 10"

使用例2

環境設定パラメーターUserNameに「user1」と指定している場合に，リトライを打ち切りません。

user1:user1,"|/opt/jp1ajs2/bin/jpomailrecv -u user1"

jpqregguestuser

形式

jpqregguestuser
     [-lh 論理ホスト名] [{-lu ユーザー名|-d}]

機能

JP1ユーザー仮定機能を使用する場合，指定したマネージャーホストに，JP1仮定ユーザーを一つだけ登録します。また，登録したJP1仮定ユーザー情報を表示します。

このコマンドで設定した内容を反映させるには，コマンド実行後にJP1/AJS3の再起動が必要です。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-lh 論理ホスト名

JP1仮定ユーザー情報を登録する，マネージャーホストの論理ホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，自ホスト名が仮定されます。

-lu ユーザー名

仮定するJP1ユーザーのユーザー名を小文字で指定します。

指定できる文字数は，1〜31（単位：バイト）です。

省略した場合，JP1仮定ユーザー情報に登録しません。このとき，すでにJP1ユーザーが仮定されている場合は，標準出力にメッセージ「KAVU0819-I JP1仮定ユーザー（JP1仮定ユーザー名）が登録されています」が出力されます。

新しく仮定しようとするJP1ユーザーのユーザー名と，すでに仮定しているJP1ユーザーのユーザー名が同一になる場合は，新しく仮定しようとするJP1ユーザーの情報が上書きされます。

-d

登録済みのJP1仮定ユーザー情報を削除します。

このオプションを指定すると，JP1ユーザー仮定機能は使用できません。

注意事項

JP1/Baseを前提とするJP1シリーズの製品の稼働中には，このコマンドを実行しないでください。

JP1ユーザーのユーザー名を指定するときは，小文字を使用しください。大文字を使用した場合は小文字で登録されるので注意してください。小文字で登録されることによって，新しく仮定しようとするJP1ユーザーのユーザー名が，すでに仮定しているJP1ユーザーのユーザー名と同一名称になる場合，登録されている情報に対して上書きします。

JP1ユーザー仮定機能を使用する場合は，このコマンドで指定したJP1仮定ユーザーをユーザーマッピングに登録してください。また，ジョブを実行するエージェントホストにも登録が必要です。ユーザー権限レベルの設定は，実行したい操作に合わせてください。

コマンドの使用目的，手順，その他の注意事項については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　7.1.6 JP1ユーザー仮定機能の設定」を参照してください。

戻り値

0

正常終了。

1

引数の指定が不適切である。

140

このコマンドを実行する権限がない。

145

メモリー不足が発生した。

147

内部的要因エラーが発生した。

160

登録されていないJP1仮定ユーザー情報を削除しようとしている。

172

JP1仮定ユーザー登録状態が不正である。

補足事項

このコマンドの実行によってJP1ユーザーを仮定できるのは，JP1/AJS3のジョブ実行制御で提供しているコマンドです。

JP1ユーザーとしてあらかじめ仮定したユーザーを登録しておくことで，OSユーザーがJP1ユーザーとして登録されていないユーザーであっても，仮定したJP1ユーザーの権限を使用してJP1/AJS3の操作ができます。実行するOSユーザーがJP1ユーザーとして登録されている場合は，そのJP1ユーザーを使用します。

jpqreguser

形式1

jpqreguser
     [-lh 論理ホスト名]
     [-lu ユーザー名]
     -rh 接続するJP1/OJE for VOS3ホスト名
     -ru 接続するJP1/OJE for VOS3ホスト上のユーザー名
     [-rg 接続するJP1/OJE for VOS3ホスト上のグループ名]

機能1

JP1/OJE for VOS3との連携を開始する前に，ジョブの操作元のJP1/AJS3ホストに，VOS3ユーザーのユーザー情報を登録します。また，登録したユーザー情報を変更します。

登録するユーザーおよび登録するホストは，JP1/AJS3 - ViewでQUEUEジョブを実行する場合と，コマンドを使用してジョブを実行する場合で異なります。詳細については，マニュアル「JP1/Automatic Job Management System 3 連携ガイド　7.2 QUEUEジョブまたはサブミットジョブを実行するためのセットアップ」を参照してください。

形式2

jpqreguser
     [-lh 論理ホスト名]
     [-lu ユーザー名]
     -d
     -rh 接続するJP1/OJE for VOS3ホスト名

機能2

登録したユーザー情報を削除します。

形式3

jpqreguser
     [-lh 論理ホスト名]
     -a

機能3

登録したユーザー情報の一覧を表示します。

実行権限

Windowsで，機能1および機能2を実行する場合：Administrators権限

-luオプションを指定する場合

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

その他の場合：なし

引数

-lh 論理ホスト名

ユーザー情報を登録する，JP1/AJS3ホストの論理ホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。省略した場合，自ホスト名が仮定されます。

-lu ユーザー名

JP1/OJE for VOS3ホストのジョブを操作するときに使用するユーザー名を指定します。

指定できる文字数は，1〜63（単位：バイト）です。

JP1ユーザーまたはOSユーザーを指定します。どちらを指定するかは，ジョブの要求元ユーザーに合わせて指定してください。次のように，場合によってジョブの要求元ユーザーが異なります。

ジョブネットでQUEUEジョブを定義して実行する場合：JP1ユーザー

サブミットジョブで実行する場合：OSユーザー

省略した場合，ログインしているユーザー名が仮定されます。

このオプションは，Administrators権限（Windowsの場合），またはスーパーユーザー権限（UNIXの場合）を持つユーザーだけが指定できます。

-rh 接続するJP1/OJE for VOS3ホスト名

接続するJP1/OJE for VOS3ホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

-ru 接続するJP1/OJE for VOS3ホスト上のユーザー名

-rhオプションで指定したホストのジョブを操作するときに使用する，JP1/OJE for VOS3ホスト上のユーザー名を指定します。

指定できる文字数は，1〜32（単位：バイト）です。

-rg 接続するJP1/OJE for VOS3ホスト上のグループ名

-ruオプションで指定したユーザーが所属するJP1/OJE for VOS3上のグループ名を指定します。

指定できる文字数は，1〜32（単位：バイト）です。省略した場合，グループなしと仮定されます。

-d

登録済みのユーザー情報を削除します。

-luオプションを指定して登録したユーザー情報を削除する場合は，-luオプションを指定してください。

-luオプションを省略して登録したユーザー情報を削除する場合は，ユーザーを登録する際に指定したパスワードの入力が必要です。

-a

ユーザー情報の一覧を表示します。

注意事項

JP1/Baseを前提とするJP1シリーズの製品の稼働中には，このコマンドを実行しないでください。

JP1/OJE for VOS3ホストにジョブをサブミットしたり，サブミットしたジョブを削除したりしたい場合は，必ず事前にユーザー情報を登録しておいてください。ただし，ユーザー情報を登録しなくても，JP1/OJE for VOS3ホストのジョブ情報を参照することはできます。

ユーザー情報の登録時，情報変更時，および削除時は，パスワードの入力が必要です。

ユーザー情報の登録時は，接続するJP1/OJE for VOS3ホスト上のユーザーに対応するパスワードを入力してください。

ユーザー情報の変更時は，登録時に指定したVOS3ユーザーに対応するパスワードを入力してください。別のVOS3ユーザーに変更する場合は，新しいVOS3ユーザーに対応するパスワードも入力してください。

ユーザー情報の削除時は，登録時に指定したVOS3ユーザーに対応するパスワードを入力してください。

-luオプションを指定して登録したユーザー情報を変更，削除する場合，パスワードを入力する必要はありません。

大文字・小文字が異なるだけのユーザー名は，1件しか登録できません。

パスワードなどの入力情報の制限値については，マニュアル「VOS3 オープンジョブウェイ支援 JP1/Open Job Entry」を参照してください。

Windowsのマシンでこのコマンドを実行する際（-aオプション指定時以外）には，コマンドプロンプトを管理者として起動する必要があります。なお，UAC機能が無効の場合は，コマンドプロンプトを管理者として起動する必要はありません。

クラスタ運用する場合の注意事項

クラスタ運用する場合は，実行系ホストおよび待機系ホストの両方にユーザー情報を設定する必要があります。実行系ホストのユーザー情報を追加・変更・削除した場合は，次の手順に従って待機系ホストのユーザー情報を追加・変更・削除してください。

実行系ホストで次のコマンドを実行して定義情報を保存する。

jbsgetcnf -h 論理ホスト名 > 定義情報ファイル名

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

待機系ホストで次のコマンドを実行し，バックアップとして定義情報を退避する。

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

待機系ホストで次のコマンドを実行し，登録済みのユーザー情報を削除する。

jbsunsetcnf -h 論理ホスト名 -c JP1NBQCLIENT -n Profile

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

待機系ホストで手順1で保存した定義情報ファイルを使用し，次のコマンドを実行する。

jbssetcnf 手順1で保存した定義情報ファイル

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

待機系ホストでJP1/AJS3を再起動する。

定義情報ファイルに記述した内容が反映されます。

戻り値

0

正常終了。

1

引数の指定が不適切である。

160

登録されていないユーザー情報を削除しようとしている。

165

実行ホストのOSがWindowsの場合で，Administrators権限を持たないユーザーが機能1または機能2を実行しようとした。

166

パスワードが一致しないため，ユーザー情報を更新・削除できない。

170

メモリー不足が発生した。

171

このコマンドを実行する権限がない。

172

内部的要因エラーが発生した。

3　通常の運用で使用するコマンド

この章では，通常の運用で使用するコマンドの詳細について説明します。

ajs

形式

ajs
     [[-F サービス名
       |-v monitor
        -n ジョブネットまたはジョブの完全名
        {-l 実行ID | -m{state|result}}]
     [-a ログイン情報ファイル名]]
     [-h 接続先ホスト名]

機能

JP1/AJS3 - Viewを起動します。また，引数の指定によって，次のことができます。

［ログイン］画面および［JP1/AJS3 - View］ウィンドウの，表示および操作を省略して，［ジョブネットモニタ］ウィンドウを直接起動できます。

［ログイン］画面の表示および操作を省略して，［JP1/AJS3 - View］ウィンドウを直接起動できます。

実行権限

なし

引数

-F サービス名

処理対象とする，スケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

-v monitor

［ジョブネットモニタ］ウィンドウでの起動を指定します。

このオプションは，-n，-lまたは-mオプションと同時に指定します。

-n ジョブネットまたはジョブの完全名

［ジョブネットモニタ］ウィンドウに表示するジョブネットまたはジョブのユニット完全名を「スケジューラーサービス名:/ジョブネット名」または「スケジューラーサービス名:/ジョブ名」の形式で指定します。

指定できる文字数は，スケジューラーサービス名は1〜30（単位：バイト），ジョブネット名およびジョブ名は1〜930（単位：バイト）です。

リモートジョブネットを指定する場合，転送先のリモートジョブネット名を「スケジューラーサービス名:/転送先ホストのリモートジョブネット名」の形式で指定します（例：AJSROOT1:/1042614948234/net07）。

ネストジョブネットを指定した場合は，［ジョブネットモニタ］ウィンドウに，指定したネストジョブネットがツリーエリアで選択された状態で表示されます。

ジョブを指定した場合は，［ジョブネットモニタ］ウィンドウに，指定したジョブを含むジョブネットがツリーエリアで選択された状態で表示されます。

このオプションは，-v，-lまたは-mオプションと同時に指定します。

-l 実行ID

［ジョブネットモニタ］ウィンドウに表示する最上位ジョブネットの実行ID（10バイト以内の文字列）を指定します。

このオプションは，-v，-nオプションと同時に指定します。

このオプションは，-mオプションと同時には指定できません。

-m {state|result}

-nオプションで指定したジョブネットまたはジョブを［ジョブネットモニタ］ウィンドウで表示する場合に，状態（state）を表示するのか，結果（result）を表示するのかを指定します。

状態（state）を指定した場合は，［JP1/AJS3 - View］ウィンドウの［表示］−［ジョブネットモニタ］−［状態］を実行した場合と同じ動作となり，ジョブネットまたはジョブの最新の実行状態が表示されます。

結果（result）を指定した場合は，［JP1/AJS3 - View］ウィンドウの［表示］−［ジョブネットモニタ］−［結果］を実行した場合と同じ動作となり，ジョブネットまたはジョブの最新の実行結果が表示されます。

このオプションは，-v，-nオプションと同時に指定します。

このオプションは，-lオプションと同時には指定できません。

なお，環境設定パラメーターVIEWSTATUSRANGEに「today」が設定されている場合は，当日分の世代の状態または結果が表示されます。

-a ログイン情報ファイル名

JP1/AJS3 - Managerにログインするために必要な情報（ユーザー名，パスワード，接続先ホスト名）が定義されている，ログイン情報ファイルの名称を指定します。

このオプションを指定した場合，ログイン情報ファイルに記述されているログイン情報でJP1/AJS3 - Managerにログインし，［JP1/AJS3 - View］ウィンドウまたは［ジョブネットモニタ］ウィンドウが表示されます。

このオプションを省略した場合，［ログイン］画面が表示され，ログイン操作を行ったあとに［JP1/AJS3 - View］ウィンドウまたは［ジョブネットモニタ］ウィンドウが表示されます。

ログイン情報は，［ログイン］画面で指定する情報と同じです。ログイン情報の詳細については，マニュアル「JP1/Automatic Job Management System 3 操作ガイド　3. ログインとログアウト」を参照してください。

指定できる文字数は，1〜255（単位：バイト）です。ログイン情報ファイル名には次のファイル名を指定できません。

空白文字を含むファイル名

「-（ハイフン）」で始まるファイル名

空白文字を含むファイル名を指定した場合は，空白文字の前までがファイル名になります。「-（ハイフン）」で始まるファイル名を指定した場合は，ログイン情報ファイルとして認識されないで，次のエラーメッセージが表示されます。

「KAVV192-E 必要なパラメータが不足しています。［-a］」

ログイン情報ファイルは，次の場所に作成する必要があります。

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

confディレクトリ配下にログイン情報ファイルがない場合，次のエラーメッセージが表示されます。

「KAVV380-E ログイン情報ファイル（ファイル名）が見つかりません。詳細情報：詳細情報1，詳細情報2」

ログイン情報ファイルは，次の形式で記述します。

username=ログインユーザー名
password=パスワード
host=接続先ホスト名またはIPアドレス

IPアドレスはドット表記（例：100.100.1.1）で指定します。なお，IPアドレスを指定する場合，IPv4アドレス形式のアドレスだけを指定できます。IPv6アドレス形式のアドレスは指定できません。

各行には，改行を必ず入れてください。同じキーワードを含む行を複数定義した場合，最後に定義した行の値が有効になります。username，password，host以外のキーワードを定義した場合，そのキーワードは無視されます。行頭に「#」を記載することで，その行はコメントとして扱われます。次に例を示します。

#これは業務サーバへのログイン情報ファイルです
username=user1
password=user0000
host=apserve

-h 接続先ホスト名またはIPアドレス

自動ログインする場合に，接続先ホストを一時的に変更したいときに指定します。IPアドレスはドット表記（例：100.100.1.1）で指定します。なお，IPアドレスを指定する場合，IPv4アドレス形式のアドレスだけを指定できます。IPv6アドレス形式のアドレスは指定できません。

-aオプションのログイン情報ファイルまたは環境設定による自動ログインの設定で接続先ホスト名が指定されていても，-hオプションで指定されたホストに対してログインを行います。起動コマンドの引数として，-aオプションと-hオプションを同時に指定する場合には，ログイン情報ファイルで接続先ホスト名を指定する必要はありません。

-aオプションのログイン情報ファイルまたは環境設定による自動ログインを行わないときは，起動時に表示するログイン画面の［接続ホスト名］の初期表示として指定されたホスト名を表示します。

注意事項

ログイン情報ファイルに記述するパスワードは暗号化やスクランブルを掛けることはできません。このため，ログイン情報ファイルには，OSのユーザー権限によるアクセス制限を設定する運用にしてください。

OSのユーザー権限によるアクセス制限を設定する運用例を次に示します。

マシン管理者ユーザー（Administratorsなど）でログイン情報ファイルのプロパティの［セキュリティ］タブを選択する。

［名前］リストから，アクセスを許可または拒否させたいユーザーを選択する。

［アクセス許可］リストでアクセスの許可または拒否を設定する。

この運用でセキュリティの問題が発生する場合は，キーワード「password」を指定しないでください。passwordを指定しない場合，エラーメッセージ「KAVV140-E ログイン情報ファイル（ファイル名）のキーワード（キーワード名）が指定されていません。」が表示されたあとに［ログイン］ダイアログボックスが表示されるので，パスワードを入力してください。

-aオプションを指定した場合，JP1/AJS3 - Viewの［環境設定］ダイアログボックスの［起動］−［自動ログイン］で［する］が設定されていても，自動ログイン機能は無効となり，ログイン情報ファイルで指定した情報でログインします。

JP1/AJS3 - Viewを連続して複数起動するときは，前回起動した［JP1/AJS3 - View］ウィンドウが表示されてから，次のJP1/AJS3 - Viewを起動してください。前回起動した画面が表示しきらないうちに，次のJP1/AJS3 - Viewを起動した場合，環境設定の情報が無効になる場合があります。

オプションと値との間は，必ず1バイト以上の空白文字で区切ってください。

ログイン情報ファイルの名称を指定する場合，「"（ダブルクォーテーションマーク）」でファイル名を囲まないでください。「"（ダブルクォーテーションマーク）」でファイル名を囲むと，メッセージ「KAVV380-E ログイン情報ファイル（ファイル名）が見つかりません。詳細情報：詳細情報1，詳細情報2」が表示されます。

使用例1

［ログイン］画面および［JP1/AJS3 - View］ウィンドウの表示および操作を省略し，［ジョブネットモニタ］ウィンドウを直接起動します。ログイン情報ファイルはapserver_login.txtを使用し，［ジョブネットモニタ］ウィンドウでは「AJSROOT1:/GYOUMU_GROUP1/PCジョブ」というジョブネットの最新の実行結果を表示するものとします。

ajs -v monitor -n AJSROOT1:/GYOUMU_GROUP1/PCジョブ -m result -a
apserver_login.txt

使用例2

［ログイン］画面の表示および操作を省略し，［JP1/AJS3 - View］ウィンドウを直接起動します。ログイン情報ファイルはapserver_login.txtを使用するものとします。

ajs -a apserver_login.txt

ajs2collectcore（UNIX限定）

形式

ajs2collectcore
     [-b]
     [-c]
     [-f 出力パス名]
     [-l]
     [-s]
     [コアダンプがあるディレクトリまたはコアダンプファイル...]

機能

次に示すディレクトリ配下にあるコアダンプファイル（ファイル名：core，core-，およびcore.で始まるファイル）を探索し，見つかったコアダンプファイルに対する解析情報を採取します。

/opt/jp1ajs2/配下

/var/opt/jp1ajs2/配下

/opt/jp1ajs2v/配下

/opt/jp1base/bin/配下

/var/opt/jp1base/log/配下

/tmp/jp1ajs2/ajs2gencore_create/配下

/var/lib/systemd/coredump/配下

ajs2collectcoreコマンドで採取できる情報を次の表に示します。

表3‒1　ajs2collectcoreコマンドで採取できる情報

採取情報

内容

出力ファイル名※1

コアダンプ

コアダンプファイル（core）の取得

core.Z

バックトレース情報

コアダンプに対する一次解析情報の出力

coreinfo.backtrace.Z※2

共有メモリー情報

ISAM，スケジューラーサービス，および接続元制限機能が使用する共有メモリーの内容を出力

coreinfo-ISAM.shmdump.tar.Z

coreinfo-scheduler.shmdump.Z

coreinfo-pmtcon_m.shmdump.physical.Z

coreinfo-pmtcon_a.shmdump.physical.Z

coreinfo-pmtcon_m.shmdump.logical.Z

coreinfo-pmtcon_a.shmdump.logical.Z

共有ライブラリー情報

次のディレクトリ以外にある共有ライブラリー情報の取得

/opt/jp1ajs2/lib/

/opt/jp1ajs2v/lib/

/opt/jp1base/lib/

coreinfo-analyze.tar.Z※2

注※1

採取した資料は，ajs2collectcoreで圧縮します。OSごとの圧縮方法を次に示します。

Linuxの場合

gzipコマンドで資料を圧縮します。ファイル名の拡張子は「.gz」です。gzipコマンドをインストールしていない場合，資料は圧縮されません。このとき，出力ファイル名には拡張子「.gz」は付加されません。また，compressコマンドは使用されません。

Linux以外のUNIXの場合

compressコマンドで資料を圧縮し，ファイル名の拡張子は「.Z」です。compressコマンドをインストールしていない場合は，gzipコマンドがインストールされていれば，compressコマンドの代わりにgzipコマンドで資料が圧縮されます。この場合，出力ファイル名の拡張子は「.gz」です。compressコマンドおよびgzipコマンドをインストールしていない場合，資料は圧縮されません。このとき，出力ファイル名には拡張子「.Z」および「.gz」は付加されません。

注※2

コアダンプ数分，出力されます。

採取されたファイルは，出力先ディレクトリ（デフォルトは/tmp/jp1ajs2/core_analyze/）の下に次の例に示すように出力されます。

（例）

/opt/jp1ajs2/bin/にcoreがある状態でこのコマンドを実行した場合（出力先はデフォルト）

/tmp/jp1ajs2/core_analyze/opt/jp1ajs2/bin/

また，採取した情報のファイルリストも同時に出力されます。ファイルリストは出力先ディレクトリの直下に出力されます。ファイル名は次のとおりです。

Ajs2collectcore_filelist.log

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1ajs2/tools/

引数

-b

採取対象となるコアダンプファイルのバックトレース情報だけを採取します。

-c，-l，または-sオプションと同時に指定することで，バックトレース情報以外の情報も合わせた部分採取ができます。-c，-l，または-sオプションが指定され，このオプションを省略した場合は，バックトレース情報は採取されません。

-c

採取対象となるコアダンプファイルだけを採取します。

-b，-l，または-sオプションと同時に指定することで，コアダンプファイル以外の情報も合わせた部分採取ができます。-b，-l，または-sオプションが指定され，このオプションを省略した場合は，コアダンプファイルは採取されません。

-f 出力パス名

採取するコアダンプ情報の格納先を，空白文字を含まない絶対パスで指定します。相対パスで指定した場合，このコマンドは引数エラーで異常終了します。また，指定したパス名に空白文字が含まれている場合，空白文字直前までの文字列が出力パス名とされ，空白文字以降の文字列は別の引数と見なされます。

このオプションを指定した場合，出力パスの配下にコアダンプ情報が格納されます。指定した出力パスがない場合は，ディレクトリ作成確認のメッセージが出力されます。このとき「y」を入力するとディレクトリが作成されます。「n」を入力すると，情報は採取されません。

省略した場合，「/tmp/jp1ajs2/core_analyze」が仮定されます。

-l

採取対象となるJP1/AJS3で提供しているライブラリー以外の共有ライブラリー情報だけを採取します。

-b，-c，または-sオプションと同時に指定することで，共有ライブラリー情報以外の情報も合わせた部分採取ができます。-b，-c，または-sオプションが指定され，このオプションを省略した場合は，共有ライブラリー情報は採取されません。

-s

採取対象となる共有メモリー情報だけを採取します。

このとき，出力先ディレクトリ直下にcoreinfo-ISAM.shmdump_*，coreinfo-Scheduler.shmdump_*，coreinfo-pmtcon_{m | a}.shmdump.physical_*，またはcoreinfo-pmtcon_{m | a}.shmdump.logical*_*がある場合，ファイルの末尾に「.bk」を付けて退避します。

-b，-c，または-lオプションと同時に指定することで，共有メモリー情報以外の情報も合わせた部分採取ができます。-b，-c，または-lオプションが指定され，このオプションを省略した場合は，共有メモリー情報は採取されません。

コアダンプがあるディレクトリまたはコアダンプファイル

標準で採取対象となるコアダンプの探索パス配下（「機能」を参照）以外の，追加探索したいコアダンプのディレクトリパス，またはファイル名を，空白文字を含まない絶対パスで指定します。相対パスで指定した場合，このコマンドは引数エラーで異常終了します。また，指定したパス名に空白文字が含まれている場合，空白文字直前までの文字列が出力パス名とされ，空白文字以降の文字列は別の引数と見なされます。

探索パス内にコアダンプ（ファイル名：core，core-，およびcore.で始まるファイル）があれば，バックトレース情報および共有ライブラリー情報を取得します。

コアダンプがあるディレクトリまたはコアダンプファイルを指定しない場合，次のディレクトリ下のコアダンプを検索します。

/opt/jp1ajs2/配下

/var/opt/jp1ajs2/配下

/opt/jp1ajs2v/配下

/opt/jp1base/bin/配下

/tmp/jp1ajs2/ajs2gencore_create/配下

/var/lib/systemd/coredump/配下

注意事項

このコマンドの実行時，出力パス内に同じ名称のファイルがある場合は，上書き確認のメッセージが出力されます。このとき「y」を入力すると上書きされ，「n」を入力すると情報の採取は行いません。

複数のコアダンプファイルがある場合は，すべてに対する情報を採取します。

引数でコアダンプがあるディレクトリ，またはファイルを指定する場合，指定する先にあるcore，core-，およびcore.で始まるファイル名は，コアダンプファイルだけであることを確認してから実行してください。

このコマンドを同時に複数起動する場合は，-fオプションを指定して，指定する出力先ディレクトリをそれぞれ別のディレクトリへ分けて出力するようにしてください。

ISAM共有メモリー情報を採取するとき，出力先ディレクトリの容量不足によって coreinfo-ISAM.shmdump.tar として出力できない場合があります。この場合，末尾に「.bk」を含まないcoreinfo-ISAM.shmdump_*ファイルの有無を確認してください。該当するファイルがある場合は，それらのファイルがISAM共有メモリー情報となるので，別のディスク領域でtarコマンド実行したあと，資料として送付してください。

プロセスがコアダンプファイルを出力したあとに対象プロセスの実行ファイルが更新されると，すでに出力していたコアダンプファイルの解析情報がうまく収集されないため注意してください。

ajs2collectcoreコマンドでは，バックトレース情報を採取するために，fileコマンドで出力されるモジュール名を使用しています。このため，fileコマンドでモジュール名が表示されないコアダンプについては，バックトレース情報が採取できません。

/var/lib/systemd/coredump/配下の探索は，OSがRed Hat Enterprise Linux Server 8以降の環境の場合だけ対象になります。

/var/lib/systemd/coredump/配下を探索する場合，/opt/jp1ajs2/配下の実行ファイルが出力したコアダンプファイルだけを採取します。/opt/jp1ajs2/配下以外の実行ファイルが出力したコアダンプファイルは採取しません。

戻り値

0

すべての資料採取成功。

4

一部の資料採取成功。

上記以外の値

異常終了。

出力メッセージ

戻り値

出力メッセージ

意味

動作

対処方法

0

Collection of the backtrace data [ ファイル名 ] was successful.

OutputPath:

出力パス名

正常採取（バックトレース）。

正常終了または次の取得情報へ継続。

−

0

Collection of the core dump file [ ファイル名 ] was successful.

OutputPath:

出力パス名

正常採取（コアダンプファイル）。

正常終了または次の取得情報へ継続。

−

0

Collection of the shared library data [ ファイル名 ] was successful.

OutputPath:

出力パス名

正常採取（ライブラリー情報）。

正常終了または次の取得情報へ継続。

−

0

Collection of the {ISAM | Scheduler | {JP1_DEFAULT | 論理ホスト名} PMTCON_M | {JP1_DEFAULT | 論理ホスト名} PMTCON_A} shared memory dump was successful.

Output Path:

出力パス名

正常採取（共有メモリー情報）。

正常終了または次の取得情報へ継続。

−

4または

8

Error!!The input parameter [ 引数 ] is invalid.

<< ### Usage ### >>

ajs2collectcore [ -b ] [ -c ] [ -l ] [ -s ] [ -f Output_fullpath ] [ Additional_search_fullpath ... ]

パラメーターエラー。

異常終了または処理続行（追加パス指定誤りの場合）。

必要なパラメーターを確認し，再実行してください。

16

Error!!

The specified directory [ 出力先ディレクトリ ] could not be created.

出力先ディレクトリの作成不可。

異常終了。

出力先ディスク容量がいっぱいになっているおそれがあります。

出力先のディスク容量を確認し，改善したあと，再実行してください。

4または

8

Error!!

The specified file [ ファイル名 ] does not have overwrite permissions.

既存ファイルへの上書き不可。

処理続行（対象となるファイル以外の採取を継続）。

対象となるファイルへの書き込み権限を与えて，再実行してください。

4または

8

Error!!

The backtrace data for the core dump file could not be collected.

Corefile:

対応するコアダンプファイル名

バックトレース情報の採取不可。

処理続行（対象となるバックトレース情報以外の採取を継続）。

出力先ディスク容量がいっぱいになっているおそれがあります。

出力先のディスク容量を確認し，改善したあと，再実行してください。

4または

8

Error!!

The core dump file could not be collected.

Corefile:

対応するコアダンプファイル名

コアダンプファイルの採取不可。

処理続行（対象となるコアダンプファイル以外の採取を継続）。

4または

8

Error!!

Shared library data for the core dump file could not be collected.

Corefile:

対応するコアダンプファイル名

共有ライブラリー情報の採取不可。

処理続行（対象となる共有ライブラリー情報以外の採取を継続）。

4または

8

Error!!

{ISAM | Scheduler | {JP1_DEFAULT | 論理ホスト名} PMTCON_M | {JP1_DEFAULT | 論理ホスト名} PMTCON_A} shared memory data could not be collected.

共有メモリー情報の採取不可。

処理続行（対象となる共有メモリー情報以外の採取を継続）。

共有メモリーが存在していない場合はこのメッセージが出力されますが，無視してください。

それ以外の場合は，次のエラーが考えられます。

メモリー不足

出力先ディスク容量がいっぱいである

メモリーの使用状況または出力先のディスク容量を確認し，改善したあと，再実行してください。

4，8，または124

An error occurred!!

ErrorCause:[ エラー要因]

ErrorInfo:[エラー情報]

その他のエラー。

処理続行（対象となる情報以外を採取）。

−

−

There are no core dump files in default directories.

標準探索パスで何もコアダンプがないとき。

−

−

−

There are no core dump files in the specified path.

追加指定パスで何もコアダンプがないとき。

−

−

（凡例）

−：該当しない。

ajsagtadd

形式

ajsagtadd
     [-h 論理ホスト名]
     {-a 実行エージェント名 [-s 実行ホスト名]
       [-c 時刻-時刻=ジョブ実行多重度,...]
       [-t {e|i|h|b}] [-d 説明文] |
      -g 実行エージェントグループ名 [-l 実行エージェント名[:優先順位],...]
       [-t {e|i|h|b}] [-d 説明文] |
      -f 実行エージェント定義ファイル名 [-i]}

形式1（実行エージェントの追加）

ajsagtadd
     [-h 論理ホスト名]
     -a 実行エージェント名
     [-s 実行ホスト名]
     [-c 時刻-時刻=ジョブ実行多重度,...]
     [-t {e|i|h|b}]
     [-d 説明文]

形式2（実行エージェントグループの追加）

ajsagtadd
     [-h 論理ホスト名]
     -g 実行エージェントグループ名
     [-l 実行エージェント名[:優先順位],...]
     [-t {e|i|h|b}]
     [-d 説明文]

形式3（実行エージェントまたは実行エージェントグループの一括追加）

ajsagtadd
     [-h 論理ホスト名]
     -f 実行エージェント定義ファイル名
     [-i]

機能

実行エージェントまたは実行エージェントグループを追加します。

実行エージェント定義ファイルに追加情報を定義して一括登録することもできます。

実行権限

次に示すJP1権限レベルを与えられたユーザー

JP1_JPQ_Admin権限

引数

-h 論理ホスト名

実行エージェントまたは実行エージェントグループを追加する自ホストの論理ホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

このオプションを省略した場合は，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合は，物理ホスト名が仮定されます。

物理ホストの場合，このオプションおよび環境変数JP1_HOSTNAMEを指定しないでください。

-a 実行エージェント名

追加する実行エージェント名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

-g 実行エージェントグループ名

追加する実行エージェントグループ名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

-f 実行エージェント定義ファイル名

実行エージェント定義ファイルを使用して実行エージェントまたは実行エージェントグループを追加する場合にファイル名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

実行エージェント定義ファイルの記述方法については，後述の「実行エージェント定義ファイルの定義方法」を参照してください。実行エージェント定義ファイルの形式は，ajsagtprintコマンドの出力形式と同じです。

なお，実行エージェント定義ファイルに記載されているデフォルト実行エージェント（実行エージェント名が@SYSTEMの実行エージェント）については，ジョブ実行多重度とコメントだけ設定を変更できます。

-s 実行ホスト名

ジョブの実行先ホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

省略した場合は，実行エージェント名が仮定されます。

このオプションは，-aオプションを指定している場合だけ指定できます。

-c 時刻-時刻=ジョブ実行多重度,...

ジョブ実行多重度を設定する時間帯と，その時間帯のジョブ実行多重度を指定します。

ジョブ実行多重度を指定すると，この実行エージェントで同時に実行できるジョブ数を制限できます。同時実行数が制限されるジョブは，UNIXジョブ，PCジョブ，フレキシブルジョブ，HTTP接続ジョブ，アクションジョブ，カスタムジョブ，および引き継ぎ情報設定ジョブです。同時に実行しようとしたジョブ数が，ジョブ実行多重度に達した場合，それを超えた分のジョブは，実行中のジョブが終了するまでキューイング（実行待ち）の状態になります。

時間帯は，時刻と時刻とを「-（ハイフン）」でつないで指定します。時刻は30分単位で「hh:mm」の形式で指定します。

hhに指定できる値は，0または00〜23（単位：時）です。

mmに指定できる値は，0，00，または30（単位：分）です。

ジョブ実行多重度に指定できる値は，0〜4,294,967,295です。

省略した場合は，00:00-00:00=5（終日，ジョブ実行多重度が5）が仮定されます。

時間帯とジョブ実行多重度は複数指定できます。複数の時間帯を指定する場合は，「時刻-時刻=ジョブ実行多重度」の組み合わせを「,（コンマ）」で区切って指定します。途中に空白を含めないでください。指定できる時間帯の数は48までです。時間帯を重複して指定した場合は，あとで指定した値が反映されます。例えば，「-c 1:00-2:30=5,2:00-4:00=10」と指定した場合，重複している2:00〜2:30のジョブ実行多重度は10となります。

ジョブ実行多重度を指定しなかった時間帯には，ジョブ実行多重度0が仮定されます。例えば，「-c 1:00-5:00=10」だけ指定した場合，00:00〜1:00のジョブ実行多重度は0，1:00〜5:00のジョブ実行多重度は10，5:00〜00:00のジョブ実行多重度は0になります。

コマンドを実行した時刻を含む時間帯を指定した場合，ジョブ実行多重度はすぐに変更されます。

このオプションは，-aオプションを指定している場合だけ指定できます。

-l 実行エージェント名[:優先順位],...

実行エージェントグループに関連づける実行エージェント名とそのグループ内での優先順位を「:（コロン）」で区切って指定します。

実行エージェント名にはすでに登録済みの実行エージェントを指定します。

実行エージェント名に指定できる文字数は，1〜255（単位：バイト）です。

優先順位に指定できる値は，1〜16です。優先順位がいちばん低いのが1，いちばん高いのが16です。優先順位が高いほど，ジョブが優先的に実行されます。省略した場合，16が仮定されます。

実行エージェントグループに複数の実行エージェントを関連づける場合は，「実行エージェント名[:優先順位]」の組み合わせを「,（コンマ）」で区切って指定します。途中に空白は含めないでください。関連づけできる実行エージェントの数は1,024（環境設定パラメーターAGENTLIMITEXTENDが「2」の場合は2,048）までです。

このオプションは，-gオプションを指定している場合だけ指定できます。

-t {e|i|h|b}

実行エージェントまたは実行エージェントグループのジョブの受付配信制限の状態を指定します。

値

状態

説明

e

有効

ジョブを受け付け，実行ホストに配信されます。

i

無効

ジョブを受け付けません。ただし，すでに受け付けたジョブは実行ホストに配信されます。

h

保留

ジョブを受け付けます。ただし，実行ホストには配信されません。

b

閉塞

ジョブを受け付けません。また，実行ホストにも配信されません。

省略した場合は，eが仮定されます。

このオプションは，-aオプションまたは-gオプションを指定している場合だけ指定できます。

-d 説明文

追加する実行エージェントまたは実行エージェントグループに対するコメントを文字列で指定します。

指定できる文字数は，1〜80（単位：バイト）です。

このオプションは，-aオプションまたは-gオプションを指定している場合だけ指定できます。

-i

実行エージェント定義ファイルを指定して実行エージェントまたは実行エージェントグループを一括登録する際，追加の途中でエラーが発生しても追加処理を続行する場合に指定します。

省略した場合，エラーが発生した時点で追加処理を中断します。この場合，途中でエラーが発生すると，その時点までに追加された実行エージェントおよび実行エージェントグループはそのままの状態になります。

このオプションは，実行エージェント定義ファイルの内容が正しい場合に有効になります。実行エージェント定義ファイルの内容に誤りがある場合は，何も登録しないで終了します。

このオプションは，-fオプションを指定している場合に指定できます。

このオプションを指定して実行エージェントまたは実行エージェントグループを一括登録した場合は，ajsagtshowコマンドまたはajsagtprintコマンドで実行結果を確認してください。ajsagtshowコマンドおよびajsagtprintコマンドの詳細については，「3. 通常の運用で使用するコマンド　ajsagtshow」および「3. 通常の運用で使用するコマンド　ajsagtprint」を参照してください。

注意事項

このコマンドで指定するジョブ実行多重度，受付配信制限の状態，および実行エージェントの優先順位は，イベントジョブおよびカスタムイベントジョブには無効です。

このコマンドは，JP1/AJS3からJP1/OJE for VOS3への要求には使用できません。

このコマンドは，別ホストのJP1/AJS3 - Managerに対しては実行できません。

このコマンドの-sオプションに，マネージャーホストで名前解決ができない実行ホスト名を指定すると，コマンドの実行に時間が掛かることがあります。

実行エージェントに追加する実行ホスト名は，コマンドを実行する前に正しく名前解決できている必要があります。そのため，追加する実行ホスト名をhostsファイルまたはDNSなどに設定してからこのコマンドを実行してください。名前解決の詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.2.2(4) マネージャー・エージェント構成時の注意事項」を参照してください。

説明文の末尾に連続して設定した半角空白文字は無効になる場合があります。このため，末尾に半角空白文字を使用しないでください。

ajsagtaddコマンド，ajsagtaltコマンド，およびajsagtdelコマンドを同一ホスト上で実行する場合，コマンドの同時実行数の合計は5個までです。5個を超えて実行した場合，コマンドは異常終了します。

戻り値

0

正常終了。

4

コマンド実行時の環境変数が不正である。

JP1/AJS3サービスが起動されていない。

-hオプション指定時，指定された論理ホストがない，または環境設定に誤りがある。

追加しようとした実行エージェントと同じ名称の実行エージェントがすでにある。

実行エージェントの最大定義数を超える。

実行エージェントグループの最大定義数を超える。

認証サーバが起動していない。

JP1/AJS3サービスとの通信でエラーが発生した。

8

コマンド引数の指定に誤りがある。

12

コマンド処理中にメモリー不足が発生した。

20

共有メモリーのアクセスが排他エラーで失敗した。

24

コマンド実行権限がない。

28

実行エージェント定義ファイルの内容に誤りがある。

36

実行エージェント定義ファイルのアクセス時にエラーが発生した。

40

共有メモリーの割り当て，ファイルディスクリプタの割り当て，排他資源の割り当ての際，システムの限界値を超えた。

120

OSのシステムコールで予期しないエラーを検知した。

データベースの領域不足，または増分に失敗した。

データベースへのアクセスが排他エラーで失敗した。

データベースの入出力でエラーが発生した。

124

JP1/AJSの内部処理で予期しないエラーを検知した。

補足事項

ジョブ実行多重度の指定例を次に示します。

1:00〜5:00のジョブ実行多重度を1にする場合

-c 01:00-05:00=1

23:00〜24:00のジョブ実行多重度を1にする場合

-c 23:00-00:00=1

24:00は，00:00または0:0と指定します。

23:00〜24:00および翌日の00:00〜05:00のジョブ実行多重度を1にする場合

-c 23:00-05:00=1

日をまたいでジョブ実行多重度を設定できます。

1日のジョブ実行多重度を1にする場合

-c 00:00-00:00=1

実行エージェント定義ファイルの定義方法

実行エージェント定義ファイルの定義方法を次に示します。

一つの実行エージェント定義ファイルに，実行エージェントと実行エージェントグループを定義できます。

各項目を「,（コンマ）」で区切り，1行に一つの実行エージェントまたは実行エージェントグループを定義します。複数定義する場合は，改行して次の行に定義します。

行頭に「#」を記述すると，その行はコメントとして扱われます。

空行は無視されます。

各項目は，「"（ダブルクォーテーションマーク）」で囲んでください。

項目は省略できません。値を省略する場合は，「""」を指定してください。

実行エージェントおよび実行エージェントグループの記述方法を次に示します。

実行エージェントの定義

形式

"フラグ","実行エージェント名","実行先ホスト名","ジョブ実行多重度","受付配信制限の状態","説明文"

引数

フラグ

「A」を指定します。実行エージェントの定義であることを意味します。

実行エージェント名

追加する実行エージェント名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

実行エージェント名は省略できません。

実行先ホスト名

ジョブの実行先ホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

省略した場合は，実行エージェント名が仮定されます。

ジョブ実行多重度

ジョブ実行多重度を設定する時間帯と，その時間帯のジョブ実行多重度を指定します。

時間帯は，時刻と時刻とを「-（ハイフン）」でつないで指定します。時刻は30分単位で「hh:mm」の形式で指定します。

hhに指定できる値は，0または00〜23（単位：時）です。

mmに指定できる値は，0，00，または30（単位：分）です。

ジョブ実行多重度に指定できる値は，0〜4,294,967,295です。

省略した場合は，00:00-00:00=5（終日，ジョブ実行多重度が5）が仮定されます。

複数の時間帯を指定する場合は，「時刻-時刻=ジョブ実行多重度」の組み合わせを「,（コンマ）」で区切って指定します。

受付配信制限の状態

実行エージェントを追加したときのジョブの受付配信制限の状態について，次のどれかを指定します。

値

状態

説明

Ef

有効

ジョブを受け付け，実行ホストに配信されます。

In

無効

ジョブを受け付けません。ただし，すでに受け付けたジョブは実行ホストに配信されます。

Hd

保留

ジョブを受け付けます。ただし，実行ホストには配信されません。

Bl

閉塞

ジョブを受け付けません。また，実行ホストにも配信されません。

省略した場合は，Efが仮定されます。

説明文

追加する実行エージェントに対するコメントを文字列で指定します。

指定できる文字数は，1〜80（単位：バイト）です。

記述例

次に示す実行エージェントを定義します。

実行エージェント名：AGT01

実行先ホスト名：HOST01

ジョブ実行多重度：0:00〜12:00のジョブ実行多重度を10，12:00〜0:00のジョブ実行多重度を20

受付配信制限の状態：ジョブを受け付けません。また，実行ホストにも配信されません。

説明文：AGT01 実行エージェント

"A","AGT01","HOST01","00:00-12:00=10,12:00-00:00=20","Bl","AGT01 実行エージェント"

実行エージェントグループの定義

形式

"フラグ","実行エージェントグループ名","接続先実行エージェントと優先順位","受付配信制限の状態","説明文"

引数

フラグ

「G」を指定します。実行エージェントグループの定義であることを意味します。

実行エージェントグループ名

追加する実行エージェントグループ名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

実行エージェントグループ名は省略できません。

接続先実行エージェントと優先順位

実行エージェントグループに関連づける実行エージェント名とそのグループ内での優先順位を「:（コロン）」で区切って指定します。

実行エージェント名にはすでに登録済みの実行エージェントを指定します。

実行エージェント名に指定できる文字数は，1〜255（単位：バイト）です。

優先順位に指定できる値は，1〜16です。優先順位がいちばん低いのが1，いちばん高いのが16です。優先順位が高いほど，ジョブが優先的に実行されます。

実行エージェントグループに複数の実行エージェントを関連づける場合は，「実行エージェント名[:優先順位]」の組み合わせを「,（コンマ）」で区切って指定します。途中に空白は含めないでください。

関連づけできる実行エージェントの数は1,024（環境設定パラメーターAGENTLIMITEXTENDが「2」の場合は2,048）までです。

省略した場合，接続先実行エージェントは設定されません。

受付配信制限の状態

実行エージェントグループを追加したときのジョブの受付配信制限の状態について，次のどれかを指定します。

値

状態

説明

Ef

有効

ジョブを受け付け，実行ホストに配信されます。

In

無効

ジョブを受け付けません。ただし，すでに受け付けたジョブは実行ホストに配信されます。

Hd

保留

ジョブを受け付けます。ただし，実行ホストには配信されません。

Bl

閉塞

ジョブを受け付けません。また，実行ホストにも配信されません。

省略した場合は，Efが仮定されます。

説明文

追加する実行エージェントグループに対するコメントを文字列で指定します。指定できる文字数は，1〜80（単位：バイト）です。

記述例

次に示す実行エージェントグループを定義します。

実行エージェントグループ名：AGTGRP01

接続先実行エージェントと優先順位：AGT01（優先順位：1），AGT02（優先順位：指定なし）

受付配信制限の状態：ジョブを受け付けます。ただし，実行ホストには配信されません。

説明文：AGTGRP01 実行エージェントグループ

"G","AGTGRP01","AGT01:1,AGT02","Hd","AGTGRP01 実行エージェントグループ"

使用例1

実行ホスト「AP1」と同じ名称の実行エージェントを追加します。

ajsagtadd -a AP1

使用例2

01:00〜05:00のジョブ実行多重度を1とする実行エージェント「AP1」を追加します。

ajsagtadd -a AP1 -c 01:00-05:00=1

使用例3

実行エージェント「AP1（優先順位：16）」，「AP2（優先順位：指定なし）」，および「AP3（優先順位：5）」が属する実行エージェントグループ「APG1」を追加します。

ajsagtadd -g APG1 -l AP1:16,AP2,AP3:5

ajsagtalt

形式

ajsagtalt
     [-h 論理ホスト名]
     {-a 実行エージェント名
        [-s 実行ホスト名] [-c 時刻-時刻=ジョブ実行多重度,...] [-d 説明文] |
      -a 実行エージェント名 -t {e|i|h|b} |
      -g 実行エージェントグループ名 -d 説明文 |
      -g 実行エージェントグループ名 -l 実行エージェント名[:優先順位] |
      -g 実行エージェントグループ名 -m 実行エージェント名[:優先順位] |
      -g 実行エージェントグループ名 -u 実行エージェント名 |
      -g 実行エージェントグループ名 -t {e|i|h|b} |
      -a 実行エージェント名 -e {u|m}}

形式1（実行エージェントの設定変更）

ajsagtalt
     [-h 論理ホスト名]
     -a 実行エージェント名
     [-s 実行ホスト名] [-c 時刻-時刻=ジョブ実行多重度,...] [-d 説明文]

形式2（実行エージェントグループの設定変更）

ajsagtalt
     [-h 論理ホスト名]
     -g 実行エージェントグループ名
     -d 説明文

形式3（実行エージェントグループへの実行エージェントの追加）

ajsagtalt
     [-h 論理ホスト名]
     -g 実行エージェントグループ名
     -l 実行エージェント名[:優先順位]

形式4（実行エージェントグループに属している実行エージェントの優先順位の変更）

ajsagtalt
     [-h 論理ホスト名]
     -g 実行エージェントグループ名
     -m 実行エージェント名[:優先順位]

形式5（実行エージェントグループからの実行エージェントの除外）

ajsagtalt
     [-h 論理ホスト名]
     -g 実行エージェントグループ名
     -u 実行エージェント名

形式6（実行エージェントのジョブの受付配信制限の状態の変更）

ajsagtalt
     [-h 論理ホスト名]
     -a 実行エージェント名
     -t {e|i|h|b}

形式7（実行エージェントグループのジョブの受付配信制限の状態の変更）

ajsagtalt
     [-h 論理ホスト名]
     -g 実行エージェントグループ名
     -t {e|i|h|b}

形式8（実行エージェントの状態を変更）

ajsagtalt
     [-h 論理ホスト名]
     -a 実行エージェント名
     -e {u|m}

機能

実行エージェントまたは実行エージェントグループの設定またはジョブの受付配信制限の状態を変更します。

実行権限

次に示すJP1権限レベルのどちらかを与えられたユーザー

JP1_JPQ_Admin権限

JP1_JPQ_Operator権限

次のどちらかだけ実行できます。

実行エージェントおよび実行エージェントグループの受付配信制限の状態の変更（-tオプション）

実行エージェントの状態の変更（-eオプション）

引数

-h 論理ホスト名

設定を変更する実行エージェントまたは実行エージェントグループが登録されている自ホストの論理ホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

このオプションを省略した場合は，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合は，物理ホスト名が仮定されます。

物理ホストの場合，このオプションおよび環境変数JP1_HOSTNAMEを指定しないでください。

-a 実行エージェント名

設定を変更する実行エージェント名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

-g 実行エージェントグループ名

設定を変更する実行エージェントグループ名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

-s 実行ホスト名

実行ホスト名（エージェントホスト名）を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

このオプションは，-aオプションを指定している場合だけ指定できます。

指定する実行ホスト名は，正しく名前解決できている必要があります。コマンドを実行する前に，指定する実行ホスト名をhostsファイルまたはDNSなどに設定しておいてください。マネージャーホストで名前解決できない実行ホスト名を指定すると，コマンドの実行に時間が掛かることがあります。

名前解決の詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.2.2(4) マネージャー・エージェント構成時の注意事項」を参照してください。

-c 時刻-時刻=ジョブ実行多重度,...

ジョブ実行多重度を変更する時間帯と，その時間帯のジョブ実行多重度を指定します。

ジョブ実行多重度を指定すると，この実行エージェントで同時に実行できるジョブ数を制限できます。同時実行数が制限されるジョブは，UNIXジョブ，PCジョブ，フレキシブルジョブ，HTTP接続ジョブ，アクションジョブ，カスタムジョブ，および引き継ぎ情報設定ジョブです。同時に実行しようとしたジョブ数が，ジョブ実行多重度に達した場合，それを超えた分のジョブは，実行中のジョブが終了するまでキューイング（実行待ち）の状態になります。

時間帯は，時刻と時刻とを「-（ハイフン）」でつないで指定します。時刻は30分単位で「hh:mm」の形式で指定します。

hhに指定できる値は，0または00〜23（単位：時）です。

mmに指定できる値は，0，00，または30（単位：分）です。

ジョブ実行多重度に指定できる値は，0〜4,294,967,295です。

時間帯とジョブ実行多重度は複数指定できます。複数の時間帯を指定する場合は，「時刻-時刻=ジョブ実行多重度」の組み合わせを「,（コンマ）」で区切って指定します。途中に空白を含めないでください。指定できる時間帯の数は48までです。時間帯を重複して指定した場合は，あとで指定した値が反映されます。例えば，「-c 1:00-2:30=5,2:00-4:00=10」と指定した場合，重複している2:00〜2:30のジョブ実行多重度は10となります。

ジョブ実行多重度を指定しなかった時間帯は，変更されません。

コマンドを実行した時刻を含む時間帯を指定した場合，ジョブ実行多重度はすぐに変更されます。

このオプションは，-aオプションを指定している場合だけ指定できます。

-d 説明文

実行エージェントまたは実行エージェントグループに対するコメントを文字列で指定します。

指定できる文字数は，1〜80（単位：バイト）です。

このオプションは，-aオプションまたは-gオプションを指定している場合に指定できます。

-l 実行エージェント名[:優先順位]

実行エージェントグループに関連づける実行エージェント名とそのグループ内での優先順位を「:（コロン）」で区切って指定します。

実行エージェント名にはすでに登録済みの実行エージェントを指定します。

実行エージェント名に指定できる文字数は，1〜255（単位：バイト）です。

優先順位に指定できる値は，1〜16です。優先順位がいちばん低いのが1，いちばん高いのが16です。優先順位が高いほど，ジョブが優先的に実行されます。省略した場合，16が仮定されます。

このオプションは，-gオプションを指定している場合だけ指定できます。

-m 実行エージェント名[:優先順位]

実行エージェントグループに属する実行エージェントの優先順位を変更する場合に指定します。実行エージェント名と優先順位を「:（コロン）」で区切って指定します。

実行エージェント名に指定できる文字数は，1〜255（単位：バイト）です。

優先順位に指定できる値は，1〜16です。優先順位がいちばん低いのが1，いちばん高いのが16です。優先順位が高いほど，ジョブが優先的に実行されます。省略した場合，16が仮定されます。

このオプションは，-gオプションを指定している場合だけ指定できます。

-u 実行エージェント名

実行エージェントグループから除外する実行エージェント名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

このオプションは，-gオプションを指定している場合だけ指定できます。

-t {e|i|h|b}

実行エージェントまたは実行エージェントグループのジョブの受付配信制限の状態を変更する場合に指定します。

値

状態

説明

e

有効

ジョブを受け付け，実行ホストに配信されます。

i

無効

ジョブを受け付けません。ただし，すでに受け付けたジョブは実行ホストに配信されます。

h

保留

ジョブを受け付けます。ただし，実行ホストには配信されません。

b

閉塞

ジョブを受け付けません。また，実行ホストにも配信されません。

このオプションは，-aオプションまたは-gオプションを指定している場合に指定できます。

-e {u|m}

実行エージェントの状態を変更する場合に指定します。「接続可」および「接続不可」には変更できません。

値

状態

説明

u

未確認

通信状態確認の対象です。通信状態確認の結果，「接続可」または「接続不可」に変更されます。

m

使用不可

ジョブ配信は抑止されます。

このオプションは，ジョブ配信遅延の軽減機能が有効な場合だけ実行できます。ジョブ配信遅延の軽減機能が無効な場合は，エラーになります。

JP1/AJS3サービスを停止すると，実行エージェントの状態は「使用不可」の状態でない場合，「未確認」になります。

ajsagtaddコマンドまたはエージェント自動定義機能で実行エージェントを追加すると，追加した実行エージェントの状態は「未確認」になります。

-sオプションで実行ホスト名を変更すると，実行エージェントの状態は「未確認」になります。ただし，実行ホスト名を同じホスト名（大文字と小文字を区別しません）に変更した場合，状態は変更されません。

同じ実行ホストでも，実行エージェントが異なる場合，実行エージェントごとに操作が必要です。

注意事項

このコマンドで指定するジョブ実行多重度，受付配信制限の状態，および実行エージェントの優先順位は，イベントジョブおよびカスタムイベントジョブには無効です。

このコマンドは，JP1/AJS3からJP1/OJE for VOS3への要求には使用できません。

このコマンドは，別ホストのJP1/AJS3 - Managerに対しては実行できません。

実行中のジョブ（PCジョブ，UNIXジョブ，フレキシブルジョブ，HTTP接続ジョブ，カスタムジョブ，またはアクションジョブ）がある場合は，実行エージェントグループから実行エージェントを除外できません。

実行中のジョブ（PCジョブ，UNIXジョブ，フレキシブルジョブ，HTTP接続ジョブ，カスタムジョブ，アクションジョブ，イベントジョブ，またはカスタムイベントジョブ）がある場合は，実行ホストを変更できません。

デフォルト実行エージェント（実行エージェント名が@SYSTEMの実行エージェント）の実行ホストは変更できません。デフォルト実行エージェントの詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　5.1.4 デフォルト実行エージェント」を参照してください。

説明文の末尾に連続して設定した半角空白文字は無効になる場合があります。このため，末尾に半角空白文字を使用しないでください。

-uオプションを指定したコマンド実行中に，-gオプションで指定した実行エージェントグループ内の実行エージェントでジョブを実行すると，タイミングによってジョブの実行開始が最大で20秒遅延する（キューイング状態となる）おそれがあります。そのため，-gオプションで指定した実行エージェントグループ内にキューイング状態のジョブが存在しないときにコマンドを実行してください。

ajsagtaddコマンド，ajsagtaltコマンド，およびajsagtdelコマンドを同一ホスト上で実行する場合，コマンドの同時実行数の合計は5個までです。5個を超えて実行した場合，コマンドは異常終了します。

戻り値

0

正常終了。

4

コマンド実行時の環境変数が不正である。

JP1/AJS3サービスが起動されていない。

-hオプション指定時，指定された論理ホストがない，または環境設定に誤りがある。

指定した実行エージェントがない。

指定した実行エージェントグループがない。

認証サーバが起動していない。

実行中のジョブがある。

JP1/AJS3サービスとの通信でエラーが発生した。

-eオプション指定時，ジョブ配信遅延の軽減機能が無効である。

8

コマンド引数の指定に誤りがある。

12

コマンド処理中にメモリー不足が発生した。

16

ファイル容量が不足している。

20

共有メモリーのアクセスが排他エラーで失敗した。

24

コマンド実行権限がない。

40

共有メモリーの割り当て，ファイルディスクリプタの割り当て，排他資源の割り当ての際，システムの限界値を超えた。

120

OSのシステムコールで予期しないエラーを検知した。

データベースの領域不足，または増分に失敗した。

データベースへのアクセスが排他エラーで失敗した。

データベースの入出力でエラーが発生した。

124

JP1/AJSの内部処理で予期しないエラーを検知した。

使用例1

実行エージェント「AP1」の1:00〜5:00のジョブ実行多重度を「1」に変更します。

ajsagtalt -a AP1 -c 01:00-05:00=1

使用例2

実行エージェントグループ「APG1」に実行エージェント「AP2（優先順位：1）」を追加します。

ajsagtalt -g APG1 -l AP2:1

使用例3

実行エージェントグループ「APG1」から実行エージェント「AP3」を除外します。

ajsagtalt -g APG1 -u AP3

使用例4

実行エージェント「AP1」の状態を「使用不可」に変更します。

ajsagtalt -a AP1 -e m

ajsagtcheck

形式

ajsagtcheck
     [-h 論理ホスト名]
     [-m { start | stop | status }]

機能

「使用不可」の実行エージェント以外のすべての実行エージェントを対象として，ジョブ配信遅延の軽減機能の，通信状態確認の開始，終了および状態確認をします。

このコマンドは，ジョブ配信遅延の軽減機能が有効である場合だけ実行できます。ジョブ配信遅延の軽減機能が無効である場合は，エラーメッセージを表示して中断します。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-h 論理ホスト名

通信状態確認の対象の実行エージェントが登録されている論理ホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

このオプションを省略した場合は，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

-m { start | stop | status }

ジョブ配信遅延の軽減機能に対する操作を指定します。指定できる値を次に示します。

このオプションを省略した場合は，statusが仮定されます。

start

通信状態確認を開始します。

通信状態確認で通信障害を検知した実行エージェントは，通信状態回復確認が実行されます。

なお，ajsagtaltコマンドで状態を「使用不可」にした実行エージェントは，通信状態確認されません。

通信状態確認中である場合は，エラーメッセージを表示してコマンドが中断されます。通信状態確認は続行されます。

stop

通信状態確認を終了します。ただし，すでに通信障害を検知した実行エージェントの通信状態回復確認は継続します。

通信状態確認中でない場合は，エラーメッセージを表示してコマンドが中断されます。

status

次の項目を標準出力に出力します。

通信状態確認の確認時刻

通信状態回復確認の確認時刻

通信状態確認および通信状態回復確認の進捗状況（状態別の実行エージェント数）

出力形式は，出力例を参照してください。

戻り値

0

正常終了。

4

コマンド実行時の環境変数が不正である。

JP1/AJS3サービスが起動されていない。

-hオプション指定時，指定された論理ホストがない，または環境設定に誤りがある。

ホストが運用開始処理中，運用停止処理中，運用停止中または縮退運転中である。

ジョブ配信遅延の軽減機能が無効である。

エージェント監視プロセスが停止している。

操作できる状態でない。

8

コマンド引数の指定に誤りがある。

12

コマンド処理中にメモリー不足が発生した。

20

共有メモリーのアクセスが排他エラーで失敗した。

24

コマンド実行権限がない。

36

JP1/AJS3サービスとの通信でエラーが発生している，またはJP1/AJS3サービスからの応答がない。

エージェント監視プロセスとの通信でエラーが発生している，またはエージェント監視プロセスからの応答がない。

40

共有メモリーの割り当て，ファイルディスクリプタの割り当て，排他資源の割り当ての際，システムの限界値を超えた。

120

OSのシステムコールで予期しないエラーを検知した。

124

JP1/AJSの内部処理で予期しないエラーを検知した。

使用例1

物理ホストの実行エージェントの通信状態確認を開始する。

ajsagtcheck -m start

使用例2

論理ホスト（lhost1）の実行エージェントの通信状態確認の状態を確認する。

ajsagtcheck -h lhost1 -m status

出力例

-mオプションにstatusを指定した場合の出力例と出力内容の意味を次に示します。

ajsagtcheck -m status
KNAC1202-I エージェント監視の情報の出力を開始します
HOSTNAME:HOST01

CONNECT
START TIME : 2016/02/02 10:10:05
END   TIME : 2016/02/02 10:11:10

RECOVERY
START TIME : 2016/02/02 11:20:04
END   TIME : 2016/02/02 11:20:35

  CONNECTABLE UNCONNECTABLE   NOT CHECKED   UNAVAILABLE
------------- ------------- ------------- -------------
          100             5             0             4
KNAC1203-I エージェント監視の情報の出力を終了します

出力内容の意味を次に示します。

HOSTNAME

ホスト名を示します。

物理ホストの場合は自ホスト名，論理ホストの場合は論理ホスト名が出力されます。

CONNECT

START TIME

通信状態確認の開始時刻を，「YYYY/MM/DD hh:mm:ss」の形式で示します。

END TIME

通信状態確認の終了時刻を，「YYYY/MM/DD hh:mm:ss」の形式で示します。

通信状態確認が実行中の場合は，「----/--/--」を示します。

RECOVERY

START TIME

通信状態回復確認の開始時刻を，「YYYY/MM/DD hh:mm:ss」の形式で示します。

END TIME

通信状態回復確認の終了時刻を，「YYYY/MM/DD hh:mm:ss」の形式で示します。

通信状態回復確認が実行中の場合は，「----/--/--」を示します。

CONNECTABLE

「接続可」状態の実行エージェントの数を示します。

UNCONNECTABLE

「接続不可」状態の実行エージェントの数を示します。

NOT CHECKED

「未確認」状態の実行エージェントの数を示します。

UNAVAILABLE

「使用不可」状態の実行エージェントの数を示します。

ajsagtdel

形式

ajsagtdel
     [-h 論理ホスト名]
     {-a 実行エージェント名 | -g 実行エージェントグループ名}

形式1（実行エージェントの削除）

ajsagtdel
     [-h 論理ホスト名]
     -a 実行エージェント名

形式2（実行エージェントグループの削除）

ajsagtdel
     [-h 論理ホスト名]
     -g 実行エージェントグループ名

機能

実行エージェントまたは実行エージェントグループを削除します。

実行権限

次に示すJP1権限レベルを与えられたユーザー

JP1_JPQ_Admin

引数

-h 論理ホスト名

削除する実行エージェントまたは実行エージェントグループが登録されている自ホストの論理ホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

このオプションを省略した場合は，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

物理ホストの場合，このオプションおよび環境変数JP1_HOSTNAMEを指定しないでください。

-a 実行エージェント名

削除する実行エージェント名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

-g 実行エージェントグループ名

削除する実行エージェントグループ名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

注意事項

ajsagtdelコマンドを実行する前にajsagtaltコマンドで，削除する実行エージェントの受付配信制限の状態を「閉塞」状態にし，ジョブが実行されないようにしておいてください。実行エージェントの受付配信制限の状態については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　5.2 ジョブの受付配信制限」を参照してください。

なお，イベントジョブおよびカスタムイベントジョブは，実行エージェントの受付配信制限の状態の影響を受けないため，削除する実行エージェントに対する新たなイベントジョブ，カスタムイベントジョブおよび起動条件付きジョブネットを実行しないようにしておいてください。

実行中のジョブ（PCジョブ，UNIXジョブ，カスタムジョブ，フレキシブルジョブ，HTTP接続ジョブ，アクションジョブ，イベントジョブ，またはカスタムイベントジョブ）がある場合は，実行エージェントを削除できません。削除するには，実行中のジョブを強制終了させる必要があります。

なお，実行中のジョブは，ajsagtshowコマンドで確認できます。ajsagtshowコマンドについては，「3. 通常の運用で使用するコマンド　ajsagtshow」を参照してください。

ajsagtdelコマンドで削除した実行ホストで，イベントジョブ，カスタムイベントジョブまたは起動条件付きジョブネットを実行したことがある場合，削除された実行ホストは，ajsagtdelコマンドを実行したマネージャーホスト名を記憶しています。この場合，削除された実行ホストは，起動時または停止時に，ajsagtdelコマンドを実行したマネージャーホストに対して不要な通信（起動した旨または停止した旨の通知）をします。そのため，次の手順でajsagtdelコマンドを実行したマネージャーホスト名を削除してください。

手順を次に示します。

ajsagtdelコマンドで削除した実行ホストが，ajsagtdelコマンドを実行したマネージャーホスト名を記憶しているか確認する。

ajsagtdelコマンドで削除した実行ホストで，次のコマンドを実行します。

jpoagoec -p

ajsagtdelコマンドを実行したマネージャーホスト名を削除する。

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

jpoagoec [-h 論理ホスト名]※ -d ajsagtdelを実行したマネージャーホスト名

注※　対象のマネージャーホストが物理ホストの場合，-hオプションを指定する必要はありません。

jpoagoecコマンドについては，「3. 通常の運用で使用するコマンド　jpoagoec」を参照してください。

イベントジョブ，カスタムイベントジョブまたは起動条件付きジョブネットを実行した状態で，次の操作を行わないでください。

実行エージェントに対応する実行先ホスト上でJP1/AJS3サービスを停止する前にOSを停止する。

実行エージェントに対応する実行先ホストを電源オフする。

上記の状態でajsagtdelコマンドを実行しても，該当する実行エージェントを削除できません。そのような状態になった場合は，マネージャーホストのJP1/AJS3サービスを停止させてコールドスタートするか，または該当する実行エージェントで実行中のイベントジョブ，カスタムイベントジョブもしくは起動条件付きジョブネットの情報を削除してからajsagtdelコマンドを実行してください。

実行エージェントで実行中のイベントジョブ，カスタムイベントジョブまたは起動条件付きジョブネットの情報を削除する手順を次に示します。

各スケジューラーサービスに対して，該当する実行エージェントで実行中のイベントジョブ，カスタムイベントジョブまたは監視中の起動条件付きジョブネットがあることを確認する。

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

jpomanjobshow [-h 論理ホスト名]※ -F スケジューラーサービス名 -a 該当する実行エージェント名

手順1に該当するスケジューラーサービスを停止する。

手順2で停止したスケジューラーサービス上で，該当する実行エージェントに対して実行中のイベントジョブ，カスタムイベントジョブまたは監視中の起動条件付きジョブネットの情報を削除する。

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

jpomanevreset [-h 論理ホスト名]※ -F スケジューラーサービス名 -a 該当する実行エージェント名 -s

注※

対象のマネージャーホストが物理ホストである場合，-hオプションを指定する必要はありません。

スケジューラーサービスの停止方法については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　7.5.2 スケジューラーサービスを停止する」を，jpomanjobshowコマンドについては「3. 通常の運用で使用するコマンド　jpomanjobshow」を，jpomanevresetコマンドについては「3. 通常の運用で使用するコマンド　jpomanevreset」を参照してください。

ajsagtdelコマンドは，JP1/AJS3からJP1/OJE for VOS3への要求には使用できません。

ajsagtdelコマンドは，別ホストのJP1/AJS3 - Managerに対しては実行できません。

ajsagtaddコマンド，ajsagtaltコマンド，およびajsagtdelコマンドを同一ホスト上で実行する場合，コマンドの同時実行数の合計は5個までです。5個を超えて実行した場合，コマンドは異常終了します。

戻り値

0

正常終了。

4

コマンド実行時の環境変数が不正である。

JP1/AJS3サービスが起動されていない。

-hオプション指定時，指定された論理ホストがない，または環境設定に誤りがある。

指定した実行エージェントがない。

指定した実行エージェントグループがない。

実行中のジョブがあるため削除できない。

認証サーバが起動していない。

指定した実行エージェントは，実行エージェントグループから接続されているため削除できない。

実行エージェントまたは実行エージェントグループの受付配信制限の状態が「閉塞」ではないため削除できない。

JP1/AJS3サービスとの通信でエラーが発生した。

8

コマンド引数の指定に誤りがある。

12

コマンド処理中にメモリー不足が発生した。

20

共有メモリーのアクセスが排他エラーで失敗した。

24

コマンド実行権限がない。

40

共有メモリーの割り当て，ファイルディスクリプタの割り当て，排他資源の割り当ての際，システムの限界値を超えた。

120

OSのシステムコールで予期しないエラーを検知した。

データベースの領域不足，または増分に失敗した。

データベースへのアクセスが排他エラーで失敗した。

データベースの入出力でエラーが発生した。

124

JP1/AJSの内部処理で予期しないエラーを検知した。

使用例1

実行エージェント「AP1」を削除します。

ajsagtdel -a AP1

使用例2

実行エージェントグループ「APG1」を削除します。

ajsagtdel -g APG1

ajsagtprint

形式

ajsagtprint
     [-h 論理ホスト名]
     {-a 実行エージェント名 | -g 実行エージェントグループ名 | -l}

形式1（実行エージェント定義の出力）

ajsagtprint
     [-h 論理ホスト名]
     -a 実行エージェント名

形式2（実行エージェントグループの出力）

ajsagtprint
     [-h 論理ホスト名]
     -g 実行エージェントグループ名

形式3（すべての実行エージェントおよび実行エージェントグループ定義情報の出力）

ajsagtprint
     [-h 論理ホスト名]
     -l

機能

実行エージェントまたは実行エージェントグループの定義情報をCSV形式で標準出力ファイルに出力します。

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

JP1_JPQ_Admin権限

JP1_JPQ_Operator権限

JP1_JPQ_User権限

または，

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-h 論理ホスト名

定義情報を出力する実行エージェントまたは実行エージェントグループが登録されている自ホストの論理ホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

このオプションを省略した場合は，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合は，物理ホスト名が仮定されます。

物理ホストの場合，このオプションおよび環境変数JP1_HOSTNAMEを指定しないでください。

-a 実行エージェント名

実行エージェントを指定して定義情報を出力する場合は，対象の実行エージェント名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

-g 実行エージェントグループ名

実行エージェントグループを指定して定義情報を出力する場合は，対象の実行エージェントグループ名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

-l

すべての実行エージェントおよび実行エージェントグループの定義情報を出力する場合に指定します。

注意事項

このコマンドは，JP1/AJS3からJP1/OJE for VOS3への要求には使用できません。

このコマンドは，別ホストのJP1/AJS3 - Managerに対しては実行できません。

戻り値

0

正常終了。

4

コマンド実行時の環境変数が不正である。

JP1/AJS3サービスが起動されていない。

-hオプション指定時，指定された論理ホストがない，または環境設定に誤りがある。

指定した実行エージェントがない。

指定した実行エージェントグループがない。

認証サーバが起動していない。

8

コマンド引数の指定に誤りがある。

12

コマンド処理中にメモリー不足が発生した。

20

共有メモリーのアクセスが排他エラーで失敗した。

24

コマンド実行権限がない。

40

共有メモリーの割り当て，ファイルディスクリプタの割り当て，排他資源の割り当ての際，システムの限界値を超えた。

120

OSのシステムコールで予期しないエラーを検知した。

124

JP1/AJSの内部処理で予期しないエラーを検知した。

使用例1

実行エージェント「AP1」の定義情報を出力します。

ajsagtprint -a AP1

使用例2

すべての実行エージェントまたは実行エージェントグループの情報を表示します。

ajsagtprint -l

出力例1

-aオプションを指定した場合の出力例と出力内容の意味を次に示します。

ajsagtprint -a AP1

# <タイムスタンプ> HOSTNAME:<ホスト名※>
#,AGENT,HOST,CON-EXE,STATUS,DESCRIPTION
"A","AP1","Host1","1:00-3:00=10","Ef","エージェント1"

注※

物理ホストの場合は自ホスト名，論理ホストの場合は論理ホスト名が出力されます。

出力内容の意味を次に示します。

フラグ

#

コメント行であることを示します。

A

実行エージェントの定義情報であることを示します。

AGENT

実行エージェント名を示します。

HOST

実行ホスト名（エージェントホスト名）を示します。

CON-EXE

ジョブ実行多重度を示します。

STATUS

実行エージェントの受付配信制限の状態を示します。

値

状態

説明

Ef

有効

ジョブを受け付け，実行ホストに配信されます。

In

無効

ジョブを受け付けません。ただし，すでに受け付けたジョブは実行ホストに配信されます。

Hd

保留

ジョブを受け付けます。ただし，実行ホストには配信されません。

Bl

閉塞

ジョブを受け付けません。また，実行ホストにも配信されません。

DESCRIPTION

実行エージェントに対するコメントを示します。

出力例2

-gオプションを指定した場合の出力例と出力内容の意味を次に示します。

ajsagtprint -g AGG1

# <タイムスタンプ> HOSTNAME:<ホスト名※>
#,AGENT GROUP,LINK AGENT,STATUS,DESCRIPTION
"G","AGG1","AG1:1","Ef","エージェントグループ1"

注※

物理ホストの場合は自ホスト名，論理ホストの場合は論理ホスト名が出力されます。

出力内容の意味を次に示します。

フラグ

#：

コメント行であることを示します。

G：

実行エージェントグループの定義情報であることを示します。

AGENT GROUP

実行エージェントグループ名を示します。

LINK AGENT

実行エージェントグループに属している実行エージェント名および優先順位を示します。

STATUS

実行エージェントグループの受付配信制限の状態を示します。

値

状態

説明

Ef

有効

ジョブを受け付け，実行ホストに配信されます。

In

無効

ジョブを受け付けません。ただし，すでに受け付けたジョブは実行ホストに配信されます。

Hd

保留

ジョブを受け付けます。ただし，実行ホストには配信されません。

Bl

閉塞

ジョブを受け付けません。また，実行ホストにも配信されません。

DESCRIPTION

実行エージェントグループに対するコメントを示します。

ajsagtreport

形式

ajsagtreport
     [-h 論理ホスト]
     -a 実行エージェント名
     [-n [-r 分]|
         [-b 年/月/日] [-s 時:分]
         [-e 年/月/日] [-f 時:分]]
     [-i 集計間隔]
     [-H]

機能

実行エージェント稼働状況レポートを出力します。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

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

UNIXの場合

/opt/jp1ajs2/bin/

引数

-h 論理ホスト名

実行エージェント稼働状況を出力したい実行エージェントが登録されている自ホストの論理ホスト名を指定します。指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合は，物理ホスト名が仮定されます。

物理ホストの場合，このオプションおよび環境変数JP1_HOSTNAMEを指定しないでください。

-a 実行エージェント名

実行エージェント稼働状況を出力したい実行エージェント名を指定します。指定できる文字数は，1〜255（単位：バイト）です。

-n

コマンドを実行した日時の直近の実行エージェント稼働状況を出力します。

-rを指定した場合，コマンドを実行した日時分の0秒を基準として，-rで指定した値（分）さかのぼった時間からコマンド実行時間の0秒になる直前までの実行エージェント稼働状況を出力します。

-iを指定した場合，-rで指定した時間範囲内での収集間隔を指定できます。

このオプションは，-b，-s，-e，-fオプションと同時に指定できません。

-r 分

コマンドを実行した日時からさかのぼる時間を指定します。

省略した場合，1（分）を仮定します。

このオプションは，-b，-s，-e，-fオプションと同時に指定できません。

分

指定できる値は，1〜1,440（単位：分）です。

-b 年/月/日

実行エージェント稼働状況を出力する期間の開始日を指定します。

省略した場合，コマンドを実行した日を開始日とします。

このオプションは，-n，-rオプションと同時に指定できません。

年

指定できる値は，1994〜2099（単位：西暦年）です。

月

指定できる値は，1（または01）〜12（単位：月）です。

日

指定できる値は，1（または01）〜31（単位：日）です。

-s 時:分

実行エージェント稼働状況を出力する期間の開始時間を指定します。

省略した場合，00:00を開始時間とします。

このオプションは，-n，-rオプションと同時に指定できません。

時

指定できる値は，0（または00）〜23（単位：時間）です。

分

指定できる値は，0（または00）〜59（単位：分）です。

-e 年/月/日

実行エージェント稼働状況を出力する期間の終了日を指定します。

省略した場合，-bオプションと同じ日を終了日とします。

このオプションは，-n，-rオプションと同時に指定できません。

-bオプションで指定した開始日，または省略して設定される開始日より過去の日付は指定できません。

年

指定できる値は，1994〜2099（単位：西暦年）です。

月

指定できる値は，1（または01）〜12（単位：月）です。

日

指定できる値は，1（または01）〜31（単位：日）です。

-f 時:分

実行エージェント稼働状況を出力する期間の終了時間を指定します。

省略した場合，開始時間の24時間後を終了時間とします。

-eオプションおよび-fオプションをどちらも省略した場合は，開始日時に24時間を加算した時刻を終了日時とします。

このオプションは，-n，-rオプションと同時に指定できません。

-bと-sオプションで指定した開始日時と同一日時，または過去の日時を，-eと-fオプションには指定できません。

時

指定できる値は，0（または00）〜23（単位：時間）です。

分

指定できる値は，0（または00）〜59（単位：分）です。

-b，-s，-eおよび-fオプションの組み合わせによる実行エージェント稼働状況レポートの集計期間の例を次の表に示します。

表3‒2　-b，-s，-eおよび-fオプションの組み合わせによる稼働状況レポートの集計期間の例（コマンド実行日が2025/09/08の場合）

項番

-bオプション

-sオプション

-eオプション

-fオプション

開始日時

終了日時

集計期間

1

省略

省略

省略

省略

2025/09/08 00:00

2025/09/09 00:00

2025/09/08 00:00:00.000から2025/09/08 23:59:59.999までの1日分

2

2025/09/01

省略

省略

省略

2025/09/01 00:00

2025/09/02 00:00

2025/09/01 00:00:00.000から2025/09/01 23:59:59.999までの1日分

3

省略

09:00

省略

省略

2025/09/08 09:00

2025/09/09 09:00

2025/09/08 09:00:00.000から2025/09/09 08:59:59.999までの1日分

4

2025/09/01

11:00

省略

省略

2025/09/01 11:00

2025/09/02 11:00

2025/09/01 11:00:00.000から2025/09/02 10:59:59.999までの1日分

5

省略

省略

2025/09/08

省略

2025/09/08 00:00

2025/09/09 00:00

2025/09/08 00:00:00.000から2025/09/08 23:59:59.999までの1日分

6

省略

省略

省略

20:00

2025/09/08 00:00

2025/09/08 20:00

2025/09/08 00:00:00.000から2025/09/08 19:59:59.999までの約1日分

7

省略

省略

2025/09/08

22:30

2025/09/08 00:00

2025/09/08 22:30

2025/09/08 00:00:00.000から2025/09/08 22:29:59.999までの約1日分

8

2025/09/01

省略

2025/09/07

省略

2025/09/01 00:00

2025/09/08 00:00

2025/09/01 00:00:00.000から2025/09/07 23:59:59.999までの7日分

9

省略

11:00

省略

22:30

2025/09/08 11:00

2025/09/08 22:30

2025/09/08 11:00:00.000から2025/09/08 22:29:59.999までの約半日分

10

2025/09/01

08:00

2025/09/07

21:30

2025/09/01 08:00

2025/09/07 21:30

2025/09/01 08:00:00.000から2025/09/07 21:29:59.999までの約7日分

-i 集計間隔

実行エージェント稼働状況を集計する間隔を指定します。

省略した場合は1（分）を仮定します。

このオプションと同時に-rオプションが指定されている場合，-rオプションの指定値より大きい値は指定できません。

集計間隔

指定できる値は，1〜1,440（単位：分）です。

-H

実行エージェント稼働状況のヘッダー情報として，コマンド実行日時，コマンド指定内容，および項目名を出力しない場合に指定します。

注意事項

このコマンドは，リモート実行できません。

オプションと値との間は，必ず1バイト以上の空白文字で区切ってください。

実行エージェント名には，正規表現を指定できません。

このコマンドはシステム時刻で集計した結果を出力します。

ジョブネットまたはジョブの実行中に，このコマンドを実行した場合，実行中に状態が遷移したジョブネット，ジョブの情報は，集計開始後の情報となるため集計結果に含まれません。

コマンド実行時にメッセージKAVS1112-Eが出力された場合は，実行エージェント稼働状況ログファイル格納ディレクトリが存在するか確認してください。

ajsagtreportコマンドは，実行エージェント稼働状況レポートを出力する期間に応じてコマンドの実行時間が長くなり，メモリ使用量も大きくなります。コマンドの実行時間を短くしたい場合やメモリ使用量の増加による影響を小さくしたい場合は，レポートを出力する期間を短く指定して，分割して出力してください。

コマンドを実行すると，ajsagtreportコマンドのプロセスによってCPU負荷が一時的に高くなります。CPU負荷が低い時間帯に実行することを推奨します。

戻り値

0

正常終了。

0以外の値

異常終了。

実行エージェント稼働状況レポートに出力される項目

実行エージェント稼働状況レポートに出力される項目を次に示します。

表3‒3　実行エージェント稼働状況レポートに出力される項目一覧

項番

項目

説明

集計種別

1

MAX_CON-EXE

ジョブ実行多重度を示します。

最大数/時間

2

QUEUING_JOB_NUM

キューイング中のUNIXジョブ，PCジョブ，フレキシブルジョブ，HTTP接続ジョブ，アクションジョブ，カスタムジョブ，および引き継ぎ情報設定ジョブの数※です。

最大数/時間

3

RUNNING_JOB_NUM

実行中のUNIXジョブ，PCジョブ，フレキシブルジョブ，HTTP接続ジョブ，アクションジョブ，カスタムジョブ，および引き継ぎ情報設定ジョブの数です。

最大数/時間

4

RUNNING_EVJOB_NUM

実行中のイベントジョブおよびカスタムイベントジョブの数です。

最大数/時間

5

JOB_QUEUING_START_NUM

UNIXジョブ，PCジョブ，フレキシブルジョブ，HTTP接続ジョブ，アクションジョブ，カスタムジョブ，および引き継ぎ情報設定ジョブのキューイング開始数※です。

件数/時間

6

JOB_QUEUING_END_NUM

UNIXジョブ，PCジョブ，フレキシブルジョブ，HTTP接続ジョブ，アクションジョブ，カスタムジョブ，および引き継ぎ情報設定ジョブのキューイング終了数※です。

件数/時間

7

JOB_EXEC_START_NUM

UNIXジョブ，PCジョブ，フレキシブルジョブ，HTTP接続ジョブ，アクションジョブ，カスタムジョブ，および引き継ぎ情報設定ジョブの実行開始数です。

件数/時間

8

JOB_EXEC_END_NUM

UNIXジョブ，PCジョブ，フレキシブルジョブ，HTTP接続ジョブ，アクションジョブ，カスタムジョブ，および引き継ぎ情報設定ジョブの実行終了数です。

件数/時間

9

EVJOB_EXEC_START_NUM

イベントジョブおよびカスタムイベントジョブの実行開始数です。

件数/時間

10

EVJOB_EXEC_END_NUM

イベントジョブおよびカスタムイベントジョブの実行終了数です。

件数/時間

注※

ジョブの実行先に実行エージェントグループを指定したジョブは対象外です。

使用例

当日（2025/01/01）の実行エージェント「AGT01」の稼働状況を出力します。

ajsagtreport -a AGT01

出力例

#exectime: 2025/01/01 09:02:51
#command: ajsagtreport -a AGT01
#DATE,MAX_CON-EXE,QUEUING_JOB_NUM,RUNNING_JOB_NUM,RUNNING_EVJOB_NUM,…
2025/01/01 09:00,5,0,3,0,…
2025/01/01 09:01,5,1,5,0,…
        :       ,:,:,:
2025/01/01 21:29,5,0,0,0,…

ajsagtshow

形式

ajsagtshow
     [-h 論理ホスト名]
     {-a 実行エージェント名 [-j] | -g 実行エージェントグループ名|-l|-n|-e}

形式1（実行エージェントの情報表示）

ajsagtshow
     [-h 論理ホスト名]
     -a 実行エージェント名

形式2（実行エージェントグループの情報表示）

ajsagtshow
     [-h 論理ホスト名]
     -g 実行エージェントグループ名

形式3（すべての実行エージェントおよび実行エージェントグループの情報表示）

ajsagtshow
     [-h 論理ホスト名]
     -l

形式4（すべての実行エージェントおよび実行エージェントグループの名称表示）

ajsagtshow
     [-h 論理ホスト名]
     -n

形式5（実行エージェントの状態の情報表示）

ajsagtshow
     [-h 論理ホスト名]
     -e

形式6（実行エージェントで実行中またはキューイング中のジョブ数の一覧表示）

ajsagtshow
     [-h 論理ホスト名]
     -a 実行エージェント名 -j

機能

実行エージェントまたは実行エージェントグループのジョブ実行状態などの情報を標準出力に出力します。

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

JP1_JPQ_Admin権限

JP1_JPQ_Operator権限

JP1_JPQ_User権限

または，

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-h 論理ホスト名

実行エージェント情報を出力したい実行エージェントまたは実行エージェントグループが登録されている自ホストの論理ホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

このオプションを省略した場合は，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合は，物理ホスト名が仮定されます。

物理ホストの場合，このオプションおよび環境変数JP1_HOSTNAMEを指定しないでください。

-a 実行エージェント名

実行エージェント情報を出力したい実行エージェント名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

ジョブ配信遅延の軽減機能が有効である場合，実行エージェントの状態もあわせて出力されます。

-g 実行エージェントグループ名

実行エージェント情報を出力したい実行エージェントグループ名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

ジョブ配信遅延の軽減機能が有効である場合，実行エージェントの状態もあわせて出力されます。

-l

すべての実行エージェントおよび実行エージェントグループの情報を出力する場合に指定します。

ジョブ配信遅延の軽減機能が有効である場合，実行エージェントの状態もあわせて出力されます。

-n

すべての実行エージェントおよび実行エージェントグループの名称だけを出力する場合に指定します。実行エージェント名および実行エージェントグループ名以外の情報は出力されません。

-e

実行エージェントの状態を出力する場合に指定します。

このオプションは，ジョブ配信遅延の軽減機能が有効である場合だけ指定できます。ジョブ配信遅延の軽減機能が無効である場合は，エラーメッセージを出力してコマンドが中断されます。

-j

実行エージェントで実行中またはキューイング中のジョブ数の一覧を表示する場合に指定します。

このオプションは，-aオプションと同時に指定します。

ajsagtshowコマンドに-jオプションを指定した場合，複数同時に実行できません。

また，ajsagtshowコマンドに-jオプションを指定して実行中に，JP1/AJS3 - Web Consoleから実行エージェントの実行状況の一覧を取得することはできません。

実行エージェントで実行中またはキューイング中のジョブ数に応じて，コマンドの実行時間が長くなります。

注意事項

このコマンドは，JP1/AJS3からJP1/OJE for VOS3への要求には使用できません。

このコマンドは，別ホストのJP1/AJS3 - Managerに対しては実行できません。

-jオプションでユニットの情報を出力できるのは，次のどちらかのユーザーです。

ユニットを定義したとき，または属性を変更したときに，参照権限を与えられたユーザー

Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングされたJP1ユーザー

-jオプションで権限のないユニットが含まれる場合はメッセージKNAC1133-Eが出力されますが，コマンドの処理は続行されます。

戻り値

0

正常終了。

4

コマンド実行時の環境変数が不正である。

JP1/AJS3サービスが起動されていない。

-hオプション指定時，指定された論理ホストがない，または環境設定に誤りがある。

指定した実行エージェントがない。

指定した実行エージェントグループがない。

認証サーバが起動していない。

-eオプション指定時，ジョブ配信遅延の軽減機能が無効である。

8

コマンド引数の指定に誤りがある。

12

コマンド処理中にメモリー不足が発生した。

20

共有メモリーのアクセスが排他エラーで失敗した。

24

コマンド実行権限がない。

ユニットに参照権限がない。

40

共有メモリーの割り当て，ファイルディスクリプタの割り当て，排他資源の割り当ての際，システムの限界値を超えた。

120

OSのシステムコールで予期しないエラーを検知した。

124

JP1/AJSの内部処理で予期しないエラーを検知した。

使用例1

すべての実行エージェントまたは実行エージェントグループの情報を表示します。

ajsagtshow -l

使用例2

実行エージェント「AP1」の情報を表示します。

ajsagtshow -a AP1

使用例3

実行エージェントの状態の一覧情報を表示します。

ajsagtshow -e

出力例1

-aオプションを指定した場合の出力例と出力内容の意味を次に示します。

なお，次の例はジョブ配信遅延の軽減機能が無効な場合の例です。

ajsagtshow -a AGT01
KNAC1101-I エージェント管理の情報の出力を開始します
HOSTNAME:HOST01
AGENT      STATUS HOST       CON-EXE   QUE   JOB EVENT DESCRIPTION
---------- ------ --------- -------- ----- ----- ----- -----------
AGT01      Ef     AGT01            5     0     0     0
KNAC1102-I エージェント管理の情報の出力を終了します

出力内容の意味を次に示します。

HOSTNAME

ホスト名を示します。

物理ホストの場合は自ホスト名，論理ホストの場合は論理ホスト名が出力されます。

AGENT

実行エージェント名を示します。

STATUS

実行エージェントの受付配信制限の状態を示します。

値

状態

説明

Ef

有効

ジョブを受け付け，実行ホストに配信されます。

In

無効

ジョブを受け付けません。ただし，すでに受け付けたジョブは実行ホストに配信されます。

Hd

保留

ジョブを受け付けます。ただし，実行ホストには配信されません。

Bl

閉塞

ジョブを受け付けません。また，実行ホストにも配信されません。

HOST

実行ホスト名を示します。

CON-EXE

ジョブ実行多重度を示します。

QUE

キューイング中のUNIXジョブ，PCジョブ，フレキシブルジョブ，HTTP接続ジョブ，アクションジョブ，カスタムジョブ，および引き継ぎ情報設定ジョブの数を示します。

JOB

実行中のUNIXジョブ，PCジョブ，フレキシブルジョブ，HTTP接続ジョブ，アクションジョブ，カスタムジョブ，および引き継ぎ情報設定ジョブの数を示します。

EVENT

実行中のイベントジョブ数およびカスタムイベントジョブ数を示します。

DESCRIPTION

追加・変更時に設定した実行エージェントに対するコメントを示します。

出力例2

-gオプションを指定した場合の出力例と出力内容の意味を次に示します。

なお，次の例はジョブ配信遅延の軽減機能が無効な場合の例です。

ajsagtshow -g AGTG01
KNAC1101-I エージェント管理の情報の出力を開始します
HOSTNAME:HOST01
AGENT GROUP     STATUS   QUE LINKAGENT         AGT ST DESCRIPTION
--------------- ------ ----- ----------------- ------ ------------
AGTG01          Ef         0 -                 -
                -          - AGT01:16          Ef
                -          - AGT02:16          Ef
KNAC1102-I エージェント管理の情報の出力を終了します

出力内容の意味を次に示します。

HOSTNAME

ホスト名を示します。

物理ホストの場合は自ホスト名，論理ホストの場合は論理ホスト名が出力されます。

AGENT GROUP

実行エージェントグループ名を示します。

STATUS

実行エージェントグループの受付配信制限の状態を示します。

値

状態

説明

Ef

有効

ジョブを受け付け，実行ホストに配信されます。

In

無効

ジョブを受け付けません。ただし，すでに受け付けたジョブは実行ホストに配信されます。

Hd

保留

ジョブを受け付けます。ただし，実行ホストには配信されません。

Bl

閉塞

ジョブを受け付けません。また，実行ホストにも配信されません。

QUE

キューイング中のUNIXジョブ，PCジョブ，フレキシブルジョブ，HTTP接続ジョブ，アクションジョブ，およびカスタムジョブの数を示します。

LINKAGENT

実行エージェントグループに属する実行エージェント名と優先順位を「:（コロン）」で区切って示します。優先順位は，いちばん低いのが1，いちばん高いのが16です。

AGT ST

実行エージェントの受付配信制限の状態を示します。

値

状態

説明

Ef

有効

ジョブを受け付け，実行ホストに配信されます。

In

無効

ジョブを受け付けません。ただし，すでに受け付けたジョブは実行ホストに配信されます。

Hd

保留

ジョブを受け付けます。ただし，実行ホストには配信されません。

Bl

閉塞

ジョブを受け付けません。また，実行ホストにも配信されません。

DESCRIPTION

追加・変更時に設定した実行エージェントグループに対するコメントを示します。

出力例3

-aオプションを指定した場合の出力例と出力内容の意味を次に示します。

なお，次の例はジョブ配信遅延の軽減機能が有効な場合の例です。

ajsagtshow -a AGT01
KNAC1101-I エージェント管理の情報の出力を開始します
HOSTNAME:HOST01
AGENT      STATUS HOST       CON-EXE   QUE   JOB EVENT DESCRIPTION
---------- ------ --------- -------- ----- ----- ----- --------------------
AGT01      In-Co  AGT01           10     0     5     3 エージェント1
KNAC1102-I エージェント管理の情報の出力を終了します

出力内容の意味を次に示します。

HOSTNAME

ホスト名を示します。

物理ホストの場合は自ホスト名，論理ホストの場合は論理ホスト名が出力されます。

AGENT

実行エージェント名を示します。

STATUS

実行エージェントの受付配信制限の状態と，実行エージェントの状態を示します。

実行エージェントの受付配信制限の状態を次に示します。

値

状態

説明

Ef

有効

ジョブを受け付け，実行ホストに配信されます。

In

無効

ジョブを受け付けません。ただし，すでに受け付けたジョブは実行ホストに配信されます。

Hd

保留

ジョブを受け付けます。ただし，実行ホストには配信されません。

Bl

閉塞

ジョブを受け付けません。また，実行ホストにも配信されません。

ジョブ配信遅延の軽減機能が有効である場合，実行エージェントの受付配信制限の状態を示す値のあとに，実行エージェントの状態を「-実行エージェントの状態」の形式で示します。

実行エージェントの状態を次に示します。

値

状態

説明

Nc

未確認

実行エージェントの状態が「未確認」です。

Co

接続可

実行エージェントの状態が「接続可」です。

Uc

接続不可

実行エージェントの状態が「接続不可」です。

Ua

使用不可

実行エージェントの状態が「使用不可」です。

HOST

実行ホスト名を示します。

CON-EXE

ジョブ実行多重度を示します。

QUE

キューイング中のUNIXジョブ，PCジョブ，フレキシブルジョブ，HTTP接続ジョブ，アクションジョブ，カスタムジョブ，および引き継ぎ情報設定ジョブの数を示します。

JOB

実行中のUNIXジョブ，PCジョブ，フレキシブルジョブ，HTTP接続ジョブ，アクションジョブ，カスタムジョブ，および引き継ぎ情報設定ジョブの数を示します。

EVENT

実行中のイベントジョブ数およびカスタムイベントジョブ数を示します。

DESCRIPTION

追加・変更時に設定した実行エージェントに対するコメントを示します。

出力例4

-gオプションを指定した場合の出力例と出力内容の意味を次に示します。

なお，次の例はジョブ配信遅延の軽減機能が有効な場合の例です。

ajsagtshow -g AGTG01
KNAC1101-I エージェント管理の情報の出力を開始します
HOSTNAME:HOST01
AGENT GROUP     STATUS   QUE LINKAGENT         AGT ST DESCRIPTION
--------------- ------ ----- ----------------- ------ --------------------
AGTG01          Ef         0 -                 -      エージェントグループ
                -          - AGT01:1           In-Co  エージェント1
                -          - AGT02:2           Bl-Co  エージェント2
KNAC1102-I エージェント管理の情報の出力を終了します

出力内容の意味を次に示します。

HOSTNAME

ホスト名を示します。

物理ホストの場合は自ホスト名，論理ホストの場合は論理ホスト名が出力されます。

AGENT GROUP

実行エージェントグループ名を示します。

STATUS

実行エージェントグループの受付配信制限の状態を示します。

値

状態

説明

Ef

有効

ジョブを受け付け，実行ホストに配信されます。

In

無効

ジョブを受け付けません。ただし，すでに受け付けたジョブは実行ホストに配信されます。

Hd

保留

ジョブを受け付けます。ただし，実行ホストには配信されません。

Bl

閉塞

ジョブを受け付けません。また，実行ホストにも配信されません。

QUE

キューイング中のUNIXジョブ，PCジョブ，フレキシブルジョブ，HTTP接続ジョブ，アクションジョブ，およびカスタムジョブの数を示します。

LINKAGENT

実行エージェントグループに属する実行エージェント名と優先順位を「:（コロン）」で区切って示します。優先順位は，いちばん低いのが1，いちばん高いのが16です。

AGT ST

実行エージェントの受付配信制限の状態と，実行エージェントの状態を示します。

実行エージェントの受付配信制限の状態を次に示します。

値

状態

説明

Ef

有効

ジョブを受け付け，実行ホストに配信されます。

In

無効

ジョブを受け付けません。ただし，すでに受け付けたジョブは実行ホストに配信されます。

Hd

保留

ジョブを受け付けます。ただし，実行ホストには配信されません。

Bl

閉塞

ジョブを受け付けません。また，実行ホストにも配信されません。

ジョブ配信遅延の軽減機能が有効である場合，実行エージェントの受付配信制限の状態を示す値のあとに，実行エージェントの状態を「-実行エージェントの状態」の形式で示します。

実行エージェントの状態を次に示します。

値

状態

説明

Nc

未確認

実行エージェントの状態が「未確認」です。

Co

接続可

実行エージェントの状態が「接続可」です。

Uc

接続不可

実行エージェントの状態が「接続不可」です。

Ua

使用不可

実行エージェントの状態が「使用不可」です。

DESCRIPTION

追加・変更時に設定した実行エージェントグループに対するコメントを示します。

出力例5

-eオプションを指定した場合の出力例と出力内容の意味を次に示します。

ajsagtshow -e
KNAC1101-I エージェント管理の情報の出力を開始します
HOSTNAME:HOST01
AGENT           STATUS HOST           IP ADDRESS      CHECK TIME
--------------- ------ -------------- --------------- -------------------
AGT01           Ef-Co  AGT01          -               2016/01/01 10:00:00
AGT02           Ef-Nc  AGT02          -               ----/--/-- --:--:--
AGT04           Ef-Uc  AGT04          123.456.789.25  2016/01/01 10:00:10
                -                     123.456.987.10  2016/01/01 10:01:40
                -                     123.456.797.65  2016/01/01 10:03:10
AGT05           Hd-Ua  AGT05          -               ----/--/-- --:--:--
AGT06           Ef-Uc  AGT06          123.456.789.27  2016/01/01 10:00:11
KNAC1102-I エージェント管理の情報の出力を終了します

HOSTNAME

ホスト名を示します。

物理ホストの場合は自ホスト名，論理ホストの場合は論理ホスト名が出力されます。

AGENT

実行エージェント名を示します。

STATUS

実行エージェントの受付配信制限の状態と実行エージェントの状態を「実行エージェントの受付配信制限の状態-実行エージェントの状態」の形式で示します。

実行エージェントの受付配信制限の状態を次に示します。

値

状態

説明

Ef

有効

ジョブを受け付け，実行ホストに配信されます。

In

無効

ジョブを受け付けません。ただし，すでに受け付けたジョブは実行ホストに配信されます。

Hd

保留

ジョブを受け付けます。ただし，実行ホストには配信されません。

Bl

閉塞

ジョブを受け付けません。また，実行ホストにも配信されません。

実行エージェントの状態を次に示します。

値

状態

説明

Nc

未確認

実行エージェントの状態が「未確認」です。

Co

接続可

実行エージェントの状態が「接続可」です。

Uc

接続不可

実行エージェントの状態が「接続不可」です。

Ua

使用不可

実行エージェントの状態が「使用不可」です。

HOST

実行ホスト名を示します。

IP ADDRESS

接続IPアドレスを示します。

実行エージェントの状態が「接続不可」の場合だけ，通信障害が発生しているIPアドレスを1行ずつ示します。IPアドレスは，最も新しいIPアドレスから順に，最大四つまで示します。

なお，IPアドレスが解決される前に発生した通信障害の場合は，表示されません。

CHECK TIME

実行エージェントを確認した時間を，IPアドレスごとに「YYYY/MM/DD hh:mm:ss」の形式で示します。

注意事項

「IP ADDRESS」および「CHECK TIME」には，ジョブ配信遅延の軽減機能の通信状態確認で通信障害を検知した実行エージェントの情報だけが出力されます。通信状態確認以外で検知したエラーの情報は，統合トレースログに出力されるエラーメッセージで確認してください。

出力例6

-jオプションを指定した場合の出力例と出力内容の意味を次に示します。

UNITFULLPATHNAME,SERVICENAME,EXECID,JOBCLASS
"/JobgroupA/JobnetA/job1","AJSROOT1","@A102","JOB"
"/Jobnet1/job1","AJSROOT1","@A242","QUE"
"/Jobnet-A1/jobA","AJSROOT1","@A544","JOB"
"/Jobnet-B1/Event/evjob1","AJSROOT2","@A436","EVENT"

出力内容の意味を次に示します。

UNITFULLPATHNAME

ジョブ完全名を示します。

SERVICENAME

スケジューラーサービス名を示します。

EXECID

実行IDを示します。

JOBCLASS

実行エージェントで管理されているジョブの分類を示します。

値

説明

QUE

キューイング中のUNIXジョブ，PCジョブ，フレキシブルジョブ，HTTP接続ジョブ，アクションジョブ，カスタムジョブ，および引き継ぎ情報設定ジョブを示します。

JOB

実行中のUNIXジョブ，PCジョブ，フレキシブルジョブ，HTTP接続ジョブ，アクションジョブ，カスタムジョブ，および引き継ぎ情報設定ジョブを示します。

EVENT

実行中のイベントジョブおよびカスタムイベントジョブを示します。

ajsalter

形式

ajsalter
     [-F サービス名]
     [-s {none|EXEC}]
     [[-o] -c {CHANGE|COPY}]

機能

スケジューラーサービスの運用環境を一時的に変更します。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-F サービス名

処理対象とする，スケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

省略した場合，デフォルトスケジューラーサービス名が仮定されます。

-s {none|EXEC}

ジョブネットおよびジョブの実行を抑止するか，または抑止を解除するかを指定します。

ジョブネットおよびジョブの実行中にこのオプションで実行を抑止した場合は，抑止以降，新たなジョブネットおよびジョブは起動されません。

none

ジョブネットおよびジョブの実行抑止を解除します。

EXEC

ジョブネットおよびジョブの実行を抑止します。現在実行中のジョブネットおよびジョブの実行が終了したあとは，新たにジョブネットおよびジョブは起動されません。

なお，このオプションを指定すると，環境設定パラメーターSUPPRESSの設定を一時的に変更できます。

-o

ホスト単位のスケジューラーログファイルを交代します。

このオプションの指定の有無と環境設定パラメーターAJSLOGOUTPUTDESTの指定値によって，交代されるスケジューラーログファイルが異なります。交代されるスケジューラーログファイルを次に示します。

AJSLOGOUTPUTDESTの指定値

-oオプション

指定あり

指定なし

schedule（デフォルト値）

ホスト単位

スケジューラーサービス単位

host

ホスト単位

ホスト単位

（凡例）

ホスト単位：ホスト単位のスケジューラーログファイル

スケジューラーサービス単位：スケジューラーサービス単位のスケジューラーログファイル

このオプションは，-cオプションと同時に指定します。

-c {CHANGE|COPY}

スケジューラーログファイルの交代方法を指定します。

CHANGE

履歴情報を交代用のスケジューラーログファイルに記述します。

COPY

使用中のスケジューラーログファイルの内容を交代用のスケジューラーログファイルにコピーします。使用中のスケジューラーログファイルのデータを削除したあと，ファイルの先頭から履歴情報を記述します。

なお，スケジューラーログの出力中にログ出力障害が発生し，ログ出力が閉塞していた場合に，このオプションを指定してスケジューラーログファイルを交代すると，ログ出力の閉塞を解除します。

注意事項

スケジューラーログファイルの交代については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　7.7 スケジューラーログを交代する」を参照してください。

-sオプションを指定すると，環境設定パラメーターSUPPRESSの設定を一時的に変更します。そのため，次回スケジューラーサービスが起動したときは，環境設定パラメーターSUPPRESSで指定してある運用環境に戻ります。

戻り値

0

正常終了。

4〜124で4の倍数値

異常終了。

使用例1

ジョブネットの運用環境を一時的に変更します。その際，ジョブの実行を抑止します。

ajsalter -s EXEC

使用例2

スケジューラーサービス「AJSROOT2」を含むホストのホスト単位のスケジューラーログファイルを交代用のスケジューラーログファイルに複写して交代します。

ajsalter -F AJSROOT2 -o -c COPY

環境設定パラメーターAJSLOGOUTPUTDESTに「host」が設定されている場合は，-oオプションの指定の有無に関係なく，ホスト単位のスケジューラーログファイルを交代します。

ajsalter -F AJSROOT2 [-o] -c COPY

ajsatmstart（Linux限定）

形式

ajsatmstart

機能

JP1/AJS3 Autonomous Agent Messengerサービスを起動します。

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1ajs2/bin/

引数

なし

注意事項

このコマンドはLinuxだけで実行できます。Windowsでは実行できません。

このコマンドは，サービスの起動完了を待たないで終了します。サービスが起動したかどうかは，ajsatstatusコマンドで確認してください。

JP1/AJS3 Autonomous Agent Messengerサービスの起動時，servicesファイルのJP1/AJS3 Autonomous Agent Messengerサービスのポートの情報が読み込めなかった場合，メッセージKAVS8107-Eを出力して異常終了します。

戻り値

0

正常終了。

0以外の値

異常終了。

ajsatmstop（Linux限定）

形式

ajsatmstop

機能

JP1/AJS3 Autonomous Agent Messengerサービスを停止します。

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1ajs2/bin/

引数

なし

注意事項

このコマンドはLinuxだけで実行できます。Windowsでは実行できません。

このコマンドは，JP1/AJS3 Autonomous Agent Messengerサービスへの停止要求を送信した時点で終了します。このため，このコマンドからはJP1/AJS3 Autonomous Agent Messengerサービスが停止したかどうかを確認できません。JP1/AJS3 Autonomous Agent Messengerサービスの停止を確認したい場合は，ajsatstatusコマンドを実行してください。

戻り値

0

正常終了。

0以外の値

異常終了。

ajsatstart（Linux限定）

形式

ajsatstart

機能

JP1/AJS3 Autonomous Agentサービスを起動します。

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1ajs2/bin/

引数

なし

注意事項

このコマンドはLinuxだけで実行できます。Windowsでは実行できません。

このコマンドは，サービスの起動完了を待たないで終了します。サービスが起動したかどうかは，ajsatstatusコマンドで確認してください。

戻り値

0

正常終了。

0以外の値

異常終了。

ajsatstatus（Linux限定）

形式

ajsatstatus

機能

JP1/AJS3 Autonomous Agentサービス，JP1/AJS3 Autonomous Agent Messengerサービスの状態を出力します。

実行権限

なし

格納先ディレクトリ

/opt/jp1ajs2/bin/

引数

なし

注意事項

このコマンドはLinuxだけで実行できます。Windowsでは実行できません。

戻り値

0

正常終了。

0以外の値

異常終了。

出力例

(1) JP1/AJS3 Autonomous Agentサービス状態              運用中
(2) JP1/AJS3 Autonomous Agent Messengerサービス状態    運用中

出力項目の説明

(1)JP1/AJS3 Autonomous Agentサービス状態

JP1/AJS3 Autonomous Agentサービスの起動状態を出力します。

運用中（active）：JP1/AJS3 Autonomous Agentサービスの運用を開始しています。

停止（inactive）：JP1/AJS3 Autonomous Agentサービスの運用を停止しています。または，JP1/AJS3 Autonomous Agentサービスがセットアップされていません。

(2)JP1/AJS3 Autonomous Agent Messengerサービス状態

JP1/AJS3 Autonomous Agent Messengerサービスの起動状態を出力します。

運用中（active）：JP1/AJS3 Autonomous Agent Messengerサービスの運用を開始しています。

停止（inactive）：JP1/AJS3 Autonomous Agent Messengerサービスの運用を停止しています。または，JP1/AJS3 Autonomous Agent Messengerサービスがセットアップされていません。

ajsatstop（Linux限定）

形式

ajsatstop

機能

JP1/AJS3 Autonomous Agentサービスを停止します。

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1ajs2/bin/

引数

なし

注意事項

このコマンドはLinuxだけで実行できます。Windowsでは実行できません。

このコマンドは，JP1/AJS3 Autonomous Agentサービスへの停止要求を送信した時点で終了します。このため，このコマンドからはJP1/AJS3 Autonomous Agent サービスが停止したかどうかを確認できません。JP1/AJS3 Autonomous Agent サービスの停止を確認したい場合は，ajsatstatusコマンドを実行してください。

戻り値

0

正常終了。

0以外の値

異常終了。

ajsbackup

形式

ajsbackup
     [-F サービス名]
     [-b 退避情報ディレクトリ名]
     [-R]
     [-E|-L]
     [-T]
     [{-G|-N|-J}]
     [{-i|-e|-f}]
     [{-m|-a}]
     -n 退避ボックス名
     ユニット名...

機能

ユニットを退避ファイルの形式に変換し，退避ボックスに格納します。

このコマンドを実行すると，一つの退避ファイルが指定した退避ボックスに作成されます。退避ファイル名には，0001〜1024の未使用の値が，値の小さい方から順次設定されます。

環境設定パラメーターAJSPRINTNETSCHPRFによって，上位ジョブネットのスケジュールに依存する指定があり，かつスケジュールルールを持つネストジョブネットのユニット定義情報を出力する場合に，次のどちらかの出力方法を指定できます。

スケジュールルールを有効にし，上位ジョブネットのスケジュールに依存しない。

スケジュールルールを削除し，上位ジョブネットのスケジュールに依存する。

環境設定パラメーターAJSPRINTNETSCHPRFの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2(79) AJSPRINTNETSCHPRF」を参照してください。

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Editor権限

JP1_AJS_Operator権限

JP1_AJS_Guest権限

このコマンドは，Administrators権限（Windowsの場合），またはスーパーユーザー権限（UNIXの場合）を持つユーザーが使用することを推奨します。

引数

-F サービス名

処理対象とする，スケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

-b 退避情報ディレクトリ名

環境設定時に指定した退避情報ディレクトリ※と異なるディレクトリを使用する場合に，ディレクトリ名をフルパスで指定します。

指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，環境設定時に指定した退避情報ディレクトリ名※が仮定されます。

注※

環境設定パラメーターAJSBKUROOTに指定したディレクトリ名。

-R

指定したジョブグループ，またはジョブネットに含まれるすべてのユニットを階層ごとに繰り返して退避します（詳細については，後述の「補足事項」を参照してください）。

このオプションは，-Tオプションと同時に指定することを推奨します。-Tオプションと同時に指定すると，ユニットを階層単位でまとめて退避できるため，退避情報全体のサイズを抑えられます。また，-E，-L，-G，-N，-Jオプションと同時に指定した場合，各オプションの指定内容に従ってユニットを退避します。

-E

実行登録済みのジョブネットに含まれるジョブネットおよびジョブを退避します。

このオプションを，-T，-N，-Jオプションと同時に指定した場合，各オプションの指定内容に従ってユニットを退避します。

-L

実行登録していないジョブネットに含まれるジョブネットとジョブを退避します。

このオプションを，-T，-N，-Jオプションと同時に指定した場合，各オプションの指定内容に従ってユニットを退避します。なお，-Gオプションと同時には指定できません。

-T

ルートジョブネットおよびリカバリージョブネットを退避します。

このオプションを-Lオプションと同時に指定した場合，-Lオプションの指定内容に従ってユニットを退避します。なお，-G，-Jオプションと同時には指定できません。

-G

ジョブグループを退避します。

このオプションは，-L，-Tオプションと同時には指定できません。

-N

ジョブネットおよびリカバリージョブネットを退避します。

このオプションを-Lオプションと同時に指定した場合，-Lオプションの指定内容に従ってユニットを退避します。

-J

ジョブ（リカバリージョブ，QUEUEジョブ，リカバリーQUEUEジョブ，ORジョブ，イベントジョブ，カスタムイベントジョブなど）を退避します。

このオプションは，-Tオプションと同時には指定できません。

-i

退避先に，これから退避するユニットと同一名称のユニットがある場合，メッセージおよび了解を求めるプロンプトを表示します。

-e

退避先に，これから退避するユニットと同一名称のユニットがある場合，エラーとします（情報は更新されません）。

-f

退避先に，これから退避するユニットと同一名称のユニットがある場合でも，強制的に退避します（情報は更新されます）。

-m

退避ボックスを新規に作成したあと，ユニットを退避します。

退避ボックスがすでに作成されている場合，コマンドは異常終了します。

-a

退避ボックスに退避ファイルを追加します。

退避ボックスが作成されていない場合，コマンドは異常終了します。

-n 退避ボックス名

退避ボックス名を指定します。

指定できる文字数は，1〜50（単位：バイト）です。

退避ボックスの名称は，OSのファイルシステムに依存します。OSがWindowsの場合，退避ボックス名の大文字・小文字は区別されません。OSがUNIXの場合，退避ボックス名の大文字・小文字は区別されます。

ユニット名

退避するユニット名を指定します。

指定できる文字数は，1〜930（単位：バイト）です。

ユニット名は複数指定できます。-R，-E，-L，-T，-G，-N，-Jオプションと同時に指定すると，各オプションの指定内容に従ってユニットを退避します。

なお，ユニット名に，論理ホスト名および実行IDは指定できません。

注意事項

ユニットを退避できるのは，次のどちらかのユーザーです。

退避するすべてのユニットに対する参照権限を持ち，かつ退避ボックスに対する更新権限を持つユーザー

Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザー

ただし，環境設定パラメーターADMACLIMITをデフォルトから変更して「yes」を設定している場合は，Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザーであっても，すべてのユニットに対する参照権限および退避ボックスに対する更新権限が必要です。

一つの退避ボックスに作成できる退避ファイルは，最大1,024個です。1,025個以上は作成できません。

操作対象がリリース登録したルートジョブネット（リリース先ジョブネット）の場合は，「適用中」状態のジョブネット定義が退避されます。ただし，退避されるユニット定義情報にリリース情報は含まれません。

戻り値

0

正常終了。

4〜124で4の倍数値

異常終了。

補足事項

ユニットを階層ごとに繰り返して退避する場合について，例を挙げて説明します。

（例）

下記構成のジョブグループ（group1）を-Rオプションを指定して退避する場合，(A)〜(H)の単位で別々の退避ファイルに格納されます。

使用例

ジョブグループ（/資材部/出庫管理）に含まれるすべてのユニットを，新規に作成する退避ボックス（BOX1）に退避します。

ajsbackup -RTmn BOX1 /資材部/出庫管理

ajsbkudel

形式

ajsbkudel
     [-F サービス名]
     [-b 退避情報ディレクトリ名]
     [-i]
     -n 退避ボックス名
     [退避ファイル名...]

機能

退避ボックスや退避ファイルを削除します。

実行権限

削除対象の退避ファイルおよびディレクトリに対するOS実行権限

引数

-F サービス名

処理対象とする，スケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

省略した場合，デフォルトスケジューラーサービス名が仮定されます。

-b 退避情報ディレクトリ名

環境設定時に指定した退避情報ディレクトリ※と異なるディレクトリを使用する場合に，ディレクトリ名をフルパスで指定します。

指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，環境設定時に指定した退避情報ディレクトリ名※が仮定されます。

注※

環境設定パラメーターAJSBKUROOTに指定したディレクトリ名。

-i

削除する前に，メッセージおよび了解を求めるプロンプトを表示します。

-n 退避ボックス名

削除したい退避ボックス名を指定します。

指定できる文字数は，1〜50（単位：バイト）です。

退避ボックスの名称は，OSのファイルシステムに依存します。OSがWindowsの場合，退避ボックス名の大文字・小文字は区別されません。OSがUNIXの場合，退避ボックス名の大文字・小文字は区別されます。

退避ファイル名

退避ファイルを削除する場合に，退避ファイルが格納されている退避ボックス名に続けて退避ファイル名を指定します。

指定できる値は，0001〜1024です。退避ファイル名は複数指定できます。複数指定する場合は，退避ファイル名間を1バイト以上の空白文字で区切ります。

注意事項

退避ボックス，および退避ファイルを削除できるのは，退避ボックス，および退避ファイルの両方に更新権限を与えられたユーザーだけです。

退避ボックスを削除した場合，退避情報ディレクトリ内の退避ボックス名のディレクトリは削除されません。ajsbkudelコマンドで退避ボックスを削除したあと，必要に応じてrmdirコマンドで退避ボックス名のディレクトリを削除してください。

戻り値

0

正常終了。

4〜124で4の倍数値

異常終了。

使用例

退避ボックス（BOX1）の中の退避ファイル（0001）を削除します。

ajsbkudel -n BOX1 0001

ajscalendar

形式

ajscalendar
     [-F サービス名]
     [-lt {時:分|none|no}]
     [-ld {日|none|no|{sun|su|mon|mo|tue|
          tu|wed|we|thu|th|fri|fr|sat|sa}:n}]
     [-md {this|th|next|ne|none|no}]
     [-c]
     [-op {sun|su|mon|mo|tue|tu|wed|we|
          thu|th|fri|fr|sat|sa|
          {年/月/{日|
          {sun|su|mon|mo|tue|tu|wed|we|
          thu|th|fri|fr|sat|sa}[:n]}}}]
     [-cl {sun|su|mon|mo|tue|tu|wed|we|
          thu|th|fri|fr|sat|sa|
          {年/月/{日|
          {sun|su|mon|mo|tue|tu|wed|we|
          thu|th|fri|fr|sat|sa}[:n]}}}]
     [-no {sun|su|mon|mo|tue|tu|wed|we|
          thu|th|fri|fr|sat|sa|{年/月/{日|
          {sun|su|mon|mo|tue|
          tu|wed|we|thu|th|fri|fr|sat|sa}
          [:n]}}}]
     [-of 運用日情報ファイル名]
     [-cf 休業日情報ファイル名]
     [-nf 取消日情報ファイル名]
     [-df カレンダー情報ファイル名]
     [-d 年/月/日]
     [-R]
     ジョブグループ名...

機能

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

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Editor権限

引数

-F サービス名

処理対象とする，スケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

-lt {時:分|none|no}

カレンダーに基準時刻を設定します。

時:分

時に指定できる値は，0〜23（単位：時）です。

分に指定できる値は，0〜59（単位：分）です。

none|no

上位ジョブグループに定義されているカレンダー情報の基準時刻を引き継ぎます。

上位のすべてのジョブグループにカレンダー情報が定義されていない場合，0時00分が仮定されます。

-ld {日|none|no|{sun|su|mon|mo|tue|tu|wed|we|thu|th|fri|fr|sat|sa}:n}

カレンダーに基準日を設定します。

日

指定できる値は，1〜31（単位：日）です。

none|no

上位ジョブグループに定義されているカレンダー情報の基準日を引き継ぎます。

上位のすべてのジョブグループにカレンダー情報が定義されていない場合は，1日が仮定されます。

sun|su

日曜日を基準日とします。

mon|mo

月曜日を基準日とします。

tue|tu

火曜日を基準日とします。

wed|we

水曜日を基準日とします。

thu|th

木曜日を基準日とします。

fri|fr

金曜日を基準日とします。

sat|sa

土曜日を基準日とします。

n

月初めを基準に何週目の曜日かを指定します。

指定できる値は，1〜5（単位：週）です。

「sun」や「su」のように曜日を指定した場合は，必ず指定してください。

-md {this|th|next|ne|none|no}

カレンダーの月区分（基準日に対して，その日付をどの月に扱うか）を指定します。

this|th

基準日以降の日を基準日の月（当月）とします。

next|ne

基準日以降の日を翌月とします。

none|no

上位ジョブグループに定義されたカレンダー情報の月区分を引き継ぎます。

上位のすべてのジョブグループにカレンダー情報が定義されていない場合は，当月が仮定されます。

-c

カレンダー情報を削除します。

カレンダー情報を削除すると，上位のジョブグループに定義されたカレンダー情報を引き継げます。

なお，このオプションでは基準時刻，基準日，および月区分は削除できません。これらの情報は，各オプションでnoneを指定して削除してください。

このオプションと，-op，-cl，-no，-of，-cf，-nf，または-dfオプションのどれかを同時に指定した場合，指定順にかかわらず，カレンダー情報をいったん削除してから，運用日，休業日，または取消日を設定します。

-op {sun|su|mon|mo|tue|tu|wed|we|thu|th|fri|fr|sat|sa|{年/月/{日|{sun|su|mon|mo|tue|tu|wed|we|thu|th|fri|fr|sat|sa}[/n]}}}

運用日（ジョブネットを実行する日）を指定します。

運用日は複数指定できます。

日付の形式については，後述の「補足事項」を参照してください。

-cl {sun|su|mon|mo|tue|tu|wed|we|thu|th|fri|fr|sat|sa|{年/月/{日|{sun|su|mon|mo|tue|tu|wed|we|thu|th|fri|fr|sat|sa}[:n]}}}

休業日（ジョブネットを実行しない日）を指定します。

休業日は複数指定できます。

日付の形式については，後述の「補足事項」を参照してください。

-no {sun|su|mon|mo|tue|tu|wed|we|thu|th|fri|fr|sat|sa|{年/月/{日|{sun|su|mon|mo|tue|tu|wed|we|thu|th|fri|fr|sat|sa}[:n]}}}

取消日（運用日，休業日の指定を取り消す日）を指定します。

取消日は複数指定できます。

日付の形式については，後述の「補足事項」を参照してください。

-of 運用日情報ファイル名

運用日の日付（日付の形式については，後述の「補足事項」を参照してください）が格納されたファイル名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

このファイルの内容が，運用日としてカレンダー情報に追加されます。

-cf 休業日情報ファイル名

休業日の日付（日付の形式については，後述の「補足事項」を参照してください）が格納されたファイル名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

このファイルの内容が，休業日としてカレンダー情報に追加されます。

-nf 取消日情報ファイル名

取消日の日付（日付の形式については，後述の「補足事項」を参照してください）が格納されたファイル名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

このファイルの内容が，取消日としてカレンダー情報に追加されます。

-df カレンダー情報ファイル名

運用日，休業日を示すカレンダー情報パラメーターが定義されている，カレンダー情報ファイル名を指定します。

次に示す結果をファイルに格納することで，カレンダー情報ファイルとして，このオプションに指定できます。

ajsprintコマンドに-dオプションを指定して出力した結果

ajscalutilコマンドで出力した結果

指定できる文字数は，1〜255（単位：バイト）です。

ファイル名としてstdinを指定した場合，標準入力からカレンダー情報を入力します。

カレンダー情報ファイル内に指定できるユニット定義パラメーターは，運用日と休業日を示すパラメーターだけです。基準時刻，基準日，月区分は指定できません。ユニット定義パラメーターの詳細については，「5.1 ユニット定義ファイルの作成」を参照してください。

-d 年/月/日

指定された日以前のカレンダー情報を削除します（例えば，「-d 2009/7/1」と指定した場合，2009年7月1日を含み，それ以前のカレンダー情報を削除します）。

年

指定できる値は，1994〜環境設定パラメーターSCHEDULELIMITの値（単位：西暦年）です。環境設定パラメーターSCHEDULELIMITの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2(123) SCHEDULELIMIT」を参照してください。

月

指定できる値は，1〜12（単位：月）です。

日

指定できる値は，1〜31（単位：日）です。

-R

指定したジョブグループに含まれるすべてのジョブグループに，カレンダー情報を定義します。

ジョブグループ名

カレンダー情報を定義するジョブグループ名を指定します。

指定できる文字数は，1〜930（単位：バイト）です。

ジョブグループ名は，複数指定できます。

なお，ジョブグループ名に，論理ホスト名および実行IDは指定できません。

注意事項

カレンダー情報を定義できるのは，次のどちらかのユーザーです。

ジョブグループを定義したときに，またはその属性を変更したときに，更新権限を与えられているユーザーで，かつそのジョブグループに上位のジョブグループがある場合，上位のすべてのジョブグループに参照権限があるユーザー

Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザー

ただし，環境設定パラメーターADMACLIMITをデフォルトから変更して「yes」と設定している場合は，Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザーであっても，参照権限および更新権限が必要です。

運用日情報ファイル，休業日情報ファイル，取消日情報ファイル，またはカレンダー定義情報ファイル内のカレンダー情報が規定する形式でない場合，ajscalendarコマンドはそれらの形式外情報を無視して処理を続行します。また，情報ファイルの最後には，必ず改行を指定してください。改行を指定しないと，最終行が形式外情報として無視され，ajscalendarコマンドが正常終了しても最終行に指定したカレンダー情報が定義されません。

運用日情報ファイル，休業日情報ファイル，取消日情報ファイル，カレンダー定義情報ファイルを同時に指定し，どれかのファイルの処理で異常が発生した場合，ajscalendarコマンドは異常が発生したファイルの処理を中断し，その他のファイルの処理を続行します。

なお，ajscalendarコマンドは，正常に処理された情報ファイルのカレンダー情報だけを定義し，異常終了します。

運用日情報ファイル，休業日情報ファイル，取消日情報ファイル，カレンダー定義情報ファイルに何も定義されていない場合，該当するカレンダー情報は変更されません。

ajscalendarコマンドや，JP1/AJS3 - Viewの［月間カレンダー編集］ウィンドウ，［年間カレンダー編集］ウィンドウを使って，あるジョブグループのカレンダー情報を同時に変更した場合，変更結果は保証できません。

オプションと値との間は，必ず1バイト以上の空白文字で区切ってください。

ajscalendarコマンドは，オプションを連続して指定できません。

指定できる例：ajscalendar -c -F AJSROOT1 /GROUP

指定できない例：ajscalendar -cF AJSROOT1 /GROUP

運用日情報ファイル，休業日情報ファイル，取消日情報ファイル，またはカレンダー定義情報ファイル内に有効なカレンダー情報が一つもなく，かつ有効なカレンダー定義オプションが一つも指定されていない場合，ajscalendarコマンドは異常終了します。

無効なカレンダー定義オプションが一つでも指定されている場合，ajscalendarコマンドは異常終了します。

ajscalendarコマンドは，業務量が少ない時間帯に実行してください。ajscalendarコマンドの実行中は，カレンダー情報を定義するジョブグループと同一のスケジューラーサービスに実行登録されているルートジョブネットの実行を抑止するため，業務に影響を及ぼすおそれがあります。ただし，定義を変更する前に「監視中」状態になっている起動条件付きジョブネットは，ajscalendarコマンドの実行中に起動条件が成立すると実行されます。

当日のカレンダー情報を休業日から運用日に変更した場合，計画実行登録されたジョブネットでは，スケジュールの再計算によって当日の実行予定が生成され，ジョブが実行されることがあります。

戻り値

0

正常終了。

4〜124で4の倍数値

異常終了。

補足事項

次に示す条件が成立したあと，スケジュールが再計算されます。

指定したジョブグループがあるスケジューラーサービスが起動している場合。

このコマンドが正常終了した場合。

運用日情報ファイル，休業日情報ファイル，取消日情報ファイルに格納するカレンダー情報である，「週間標準値」および「運用日，休業日，または取消日」の形式を次に示します。なお，形式は上記3種類の情報ファイルに共通です。情報ファイルの最後には，必ず改行を指定してください。改行を指定しないと，最終行が形式外情報として無視され，ajscalendarコマンドが正常終了しても最終行に指定したカレンダー情報が定義されません。

週間標準値の形式

sun|su：日曜日を指定します。

mon|mo：月曜日を指定します。

tue|tu：火曜日を指定します。

wed|we：水曜日を指定します。

thu|th：木曜日を指定します。

fri|fr：金曜日を指定します。

sat|sa：土曜日を指定します。

運用日，休業日，または取消日の形式

YYYY/MM/

{DD{sun|su|mon|mo|tue|tu|wed|we|thu|th|fri|fr|sat|sa}[:n]}

YYYY

指定できる値は，1994〜環境設定パラメーターSCHEDULELIMITの値（単位：西暦年）です。環境設定パラメーターSCHEDULELIMITの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2(123) SCHEDULELIMIT」を参照してください。

MM

指定できる値は，1〜12（単位：月）です。

DD

指定できる値は，1〜31（単位：日）です。

n

月初めを基準に何週目の曜日かを指定します。

指定できる値は，1〜5（単位：週）です。

なお，第5週がない月に5を指定した場合，カレンダー情報は無効になります。

カレンダー情報のオプション（-op，-cl，および-noオプション）はあとに指定されたものが優先されます（例えば，「-op mon -cl mon -no mon」と指定した場合，「-no mon」が優先され，月曜日は取消日になります）。

週間標準値，運用日，休業日，および取消日を同時に指定した場合，運用日，休業日，および取消日が優先されます（例えば，「-op 2009/10/25 -cl sun」と指定した場合，「-op 2009/10/25」が優先され，2009年10月25日は運用日になります）。

運用日，休業日または取消日に曜日を指定した場合，該当する日付に変更してから，カレンダー情報として格納します。

ジョブグループのカレンダー情報の設定を省略した場合は，上位のジョブグループまたはスケジューラーサービスのカレンダー情報を参照します。上位ジョブグループ，スケジューラーサービスすべてのカレンダー情報の設定が省略されている場合は，運用日が仮定されます。

使用例1

ジョブグループ（/営業部）のカレンダー情報をいったん削除したあと，2009年10月分の休業日（土曜日と日曜日）を設定します。休業日は休業日情報ファイル（/tmp/calendar）に定義してあるものとします。

ajscalendar -c -cf /tmp/calendar /営業部

休業日情報ファイル（/tmp/calendar）の内容

2009/10/sat
2009/10/sun

使用例2

ジョブグループ（/営業部）のカレンダー情報（日曜日と土曜日は週間標準値によって休業日とする。ただし，2009年10月は土曜日を運用日とする）を設定します。

ajscalendar -cl su -cl sa -op 2009/10/sa /営業部

ajscalutil

形式

ajscalutil
     [-F スケジューラーサービス名]
     -b 年/月[/日] -e 年/月[/日]
     [-o|-a|-x|-v|
      -s {db|da|be|af},シフト日数[,シフト猶予日数] |
      -t {be|af}[,振り替え猶予日数] ]
     [-cg ジョブグループ名 | -cf カレンダー情報ファイル名]
     [-Xg ジョブグループ名 | -Xf カレンダー情報ファイル名]
     {-g ジョブグループ名 | -f カレンダー情報ファイル名}...

形式1（運用日のOR条件でのマージ）

ajscalutil
     [-F スケジューラーサービス名]
     -b 年/月[/日] -e 年/月[/日]
     [-o] {-g ジョブグループ名 | -f カレンダー情報ファイル名}...

形式2（運用日のAND条件でのマージ）

ajscalutil
     [-F スケジューラーサービス名]
     -b 年/月[/日] -e 年/月[/日]
     -a {-g ジョブグループ名 | -f カレンダー情報ファイル名}...

形式3（運用日の除外）

ajscalutil
     [-F スケジューラーサービス名]
     -b 年/月[/日] -e 年/月[/日]
     -x
     {-g ジョブグループ名 | -f カレンダー情報ファイル名}
     {-Xg ジョブグループ名 | -Xf カレンダー情報ファイル名}

形式4（運用日および休業日の反転）

ajscalutil
     [-F スケジューラーサービス名]
     -b 年/月[/日] -e 年/月[/日]
     -v
     {-g ジョブグループ名 | -f カレンダー情報ファイル名}

形式5（運用日の前後シフト）

ajscalutil
     [-F スケジューラーサービス名]
     -b 年/月[/日] -e 年/月[/日]
     -s {db|da|be|af},シフト日数[,シフト猶予日数]
     [-cg ジョブグループ名 | -cf カレンダー情報ファイル名]
     {-g ジョブグループ名 | -f カレンダー情報ファイル名}

形式6（休業日の振り替え）

ajscalutil
     [-F スケジューラーサービス名]
     -b 年/月[/日] -e 年/月[/日]
     -t {be|af}[,振り替え猶予日数]
     {-cg ジョブグループ名 | -cf カレンダー情報ファイル名}
     {-g ジョブグループ名 | -f カレンダー情報ファイル名}

形式7（カレンダー情報の期間抽出）

ajscalutil
     [-F スケジューラーサービス名]
     -b 年/月[/日] -e 年/月[/日]
     {-g ジョブグループ名 | -f カレンダー情報ファイル名}

機能

複数のカレンダー情報を組み合わせて計算し（これをカレンダー計算と呼びます），カレンダー情報ファイル形式で標準出力ファイルに出力します。出力した結果をajscalendarコマンドの-dfオプションに指定することで，組み合わせたカレンダー情報をジョブグループに定義できます。ajscalendarコマンドについては，「3. 通常の運用で使用するコマンド　ajscalendar」を参照してください。また，ajscalutilコマンドの-cf，-Xf，-fオプションに指定することで，複数のカレンダー計算の結果を組み合わせることができます。

なお，出力される情報は，運用日および休業日のユニット定義パラメーターです。ajscalutilコマンドに指定できるユニット定義パラメーターの形式については，注意事項を参照してください。

実行権限

ジョブグループ名を指定する場合

次に示すJP1権限レベルを与えられたユーザー

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Editor権限

JP1_AJS_Operator権限

JP1_AJS_Guest権限

ジョブグループ名を指定しない場合

なし

引数

-F スケジューラーサービス名

処理対象とする，スケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

-b 年/月[/日]

カレンダー情報を出力する期間の開始日を指定します。このオプションは省略できません。

年

指定できる値は，1994〜2099（単位：西暦年）です。

月

指定できる値は，1（または01）〜12（単位：月）です。

日

指定できる値は，1（または01）〜31（単位：日）です。省略した場合，「1」が仮定されます。

-e 年/月[/日]

カレンダー情報を出力する期間の終了日を指定します。このオプションは省略できません。

年

指定できる値は，1994〜2099（単位：西暦年）です。

月

指定できる値は，1（または01）〜12（単位：月）です。

日

指定できる値は，1（または01）〜31（単位：日）です。省略した場合，「年」および「月」に指定した年月の最終日が仮定されます。

-o

-g，-fオプションで指定したカレンダー情報の運用日を，OR条件でマージします。

このオプションを指定した場合，-g，-fオプションを合わせて8回まで指定できます。

このオプションは，-a，-x，-v，-s，-t，-cg，-cf，-Xg，および-Xfオプションとは同時に指定できません。

-o，-a，-x，-v，-s，-tオプションが一つも指定されなかった場合，-oオプションを仮定します。

-a

-g，-fオプションで指定したカレンダー情報の運用日を，AND条件でマージします。

このオプションを指定した場合，-g，-fオプションを合わせて8回まで指定できます。

このオプションは，-o，-x，-v，-s，-t，-cg，-cf，-Xg，および-Xfオプションとは同時に指定できません。

-x

-Xg，-Xfオプションで指定したカレンダー情報の運用日を，-g，-fオプションで指定したカレンダー情報に，休業日として反映します。

このオプションを指定した場合，-g，-fオプションのどちらかを1回だけ指定できます。

このオプションは，-o，-a，-v，-s，-t，-cg，-cfオプションとは同時に指定できません。

-v

-g，-fオプションで指定したカレンダー情報の運用日と休業日を反転します。

このオプションを指定した場合，-g，-fオプションのどちらかを1回だけ指定できます。

このオプションは，-o，-a，-x，-s，-t，-cg，-cf，-Xg，-Xfオプションとは同時に指定できません。

-s {db|da|be|af},シフト日数[,シフト猶予日数]

運用日のシフト条件を指定します。

-g，-fオプションで指定したカレンダー情報の運用日をシフト対象として，指定された条件で運用日が前後にシフトされます。

db

指定したシフト日数分，運用日を前にシフトします。

da

指定したシフト日数分，運用日を後ろにシフトします。

be

シフト対象の運用日を，-cg，-cfオプションで指定したカレンダー情報の運用日で，指定したシフト日数分だけ前にシフトします。

af

シフト対象の運用日を，-cg，-cfオプションで指定したカレンダー情報の運用日で，指定したシフト日数分だけ後ろにシフトします。

シフト日数

シフトする日数を指定します。指定できる値は，1（または01）〜31（単位：日）です。

シフト猶予日数

シフトできる期間（日数）を指定します。指定できる値は，1（または01）〜31（単位：日）です。省略した場合，31が仮定されます。

beまたはafを指定した場合，シフト猶予日数の期間内にシフト後の運用日がない場合は，シフト対象の運用日は休業日となります。シフトの考え方は，スケジュールルールの起算スケジュールと同じです。詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　3.3.2(1)(g) 起算スケジュール」を参照してください。なお，シフト日数にシフト猶予日数より大きい値は指定できません。

dbまたはdaを指定した場合，-cg，-cfオプションおよびシフト猶予日数は指定されていても無視されます。

beまたはafを指定した場合は，-cg，-cfオプションのどちらかを必ず指定してください。

このオプションを指定した場合，-g，-fオプションのどちらかを1回だけ指定できます。

このオプションは，-o，-a，-x，-v，-t，-Xg，-Xfオプションとは同時に指定できません。

-t {be|af}[,振り替え猶予日数]

休業日の振り替え条件を指定します。

-g，-fオプションで指定したカレンダー情報の運用日を振り替え対象として，-cg，-cfオプションで指定したカレンダー情報の休業日と比較します。振り替え対象の運用日が，比較対象の休業日と重なっている場合は，比較対象のカレンダーで重なった日付の前後の日付で最も近い運用日に振り替えられます。

be

重なった休業日より前の日付で，最も近い運用日の日付に振り替えます。

af

重なった休業日より後ろの日付で，最も近い運用日の日付に振り替えます。

振り替え猶予日数

振り替えできる期間（日数）を指定します。指定できる値は，1（または01）〜31（単位：日）です。省略した場合，31が仮定されます。

振り替え猶予日数の期間内に振り替え後の運用日がない場合は，振り替え対象の運用日は休業日となります。休業日の振り替えの考え方については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　3.3.2(1)(c) 休業日の振り替え」を参照してください。

このオプションを指定した場合は，-cg，-cfオプションのどちらかを必ず指定してください。

このオプションを指定した場合，-g，-fオプションのどちらかを1回だけ指定できます。

このオプションは，-o，-a，-x，-v，-s，-Xg，-Xfオプションとは同時に指定できません。

-cg ジョブグループ名

運用日のシフト，または休業日の振り替えで，比較対象のカレンダー情報が定義されたジョブグループ名を指定します。

指定できる文字数は，1〜930（単位：バイト）です。

このオプションは，-s，-tオプションと同時に指定してください。

ジョブグループ名に，スケジューラーサービス名，論理ホスト名，実行ID，および総称名は指定できません。

-cf カレンダー情報ファイル名

運用日のシフト，または休業日の振り替えで，比較対象のカレンダー情報が定義されたカレンダー情報ファイルを指定します。ajscalutilコマンドで出力したカレンダー情報ファイルを指定することで，複数の計算結果を組み合わせることができます。

指定できる文字数は，1〜255（単位：バイト）です。

ファイル名としてstdinを指定した場合，標準入力からカレンダー情報を入力します。

このオプションは，-s，-tオプションと同時に指定してください。

-Xg ジョブグループ名

運用日を除外するカレンダー情報が定義されたジョブグループ名を指定します。

指定できる文字数は，1〜930（単位：バイト）です。

このオプションは，-xオプションと同時に指定してください。

ジョブグループ名に，スケジューラーサービス名，論理ホスト名，実行ID，および総称名は指定できません。

-Xf カレンダー情報ファイル名

運用日を除外するカレンダー情報が定義されたカレンダー情報ファイルを指定します。ajscalutilコマンドで出力したカレンダー情報ファイルを指定することで，複数の計算結果を組み合わせることができます。

指定できる文字数は，1〜255（単位：バイト）です。

カレンダー情報ファイル名としてstdinを指定した場合，標準入力からカレンダー情報を入力します。

このオプションは，-xオプションと同時に指定してください。

-g ジョブグループ名

カレンダー計算の元となるカレンダー情報が定義されたジョブグループ名を指定します。

指定できる文字数は，1〜930（単位：バイト）です。

-o，-aオプションを指定した場合は，-fオプションと合わせて8回まで指定できます。

ジョブグループ名に，スケジューラーサービス名，論理ホスト名，実行ID，および総称名は指定できません。

-f カレンダー情報ファイル名

カレンダー計算の元となるカレンダー情報が定義されたカレンダー情報ファイルを指定します。ajscalutilコマンドで出力したカレンダー情報ファイルを指定することで，複数の計算結果を組み合わせることができます。

指定できる文字数は，1〜255（単位：バイト）です。

ファイル名としてstdinを指定した場合，標準入力からカレンダー情報を入力します。

-o，-aオプションを指定した場合は，-gオプションと合わせて8回まで指定できます。

注意事項

-s，-tオプションでは，-b，-eオプションで指定した期間の範囲から，シフト日数，シフト猶予日数，および振り替え猶予日数の分だけ，前後のカレンダー情報を，カレンダー計算に使用します。-s，-tオプションを指定する場合，カレンダー計算の元となるカレンダー情報は，余裕を持った期間を指定してください。

この図では，振り替え猶予日数が「31」であるため，出力期間の5月だけでなく，その前後の月についても，カレンダー計算の対象にされます。

このため，このコマンドを複数回に分けて実行する場合は，シフトや振り替えを考慮して期間を設定しておき，使用する期間のカレンダー情報を必要に応じて抽出してください。

-cf，-Xf，-fオプションに指定するカレンダー情報ファイル名にstdinを指定できるのは，1回のコマンド実行で1回だけです。

-cf，-Xf，-fオプションに指定するカレンダー情報ファイル内に指定できるユニット定義パラメーターに，同一日を指定した場合，あとから指定した定義内容が有効になります。

-cf，-Xf，-fオプションに指定するカレンダー情報ファイル内に指定できるユニット定義パラメーターには，特定の運用日を示すパラメーター（op=yyyy/mm/dd;），または特定の休業日を示すパラメーター（cl=yyyy/mm/dd;）のどちらかを指定してください。

yyyy：指定できる値は，1994〜2099（単位：西暦年）です。

mm：指定できる値は，1（または01）〜12（単位：月）です。

dd：指定できる値は，1（または01）〜31（単位：日）です。

ユニット定義パラメーターは，1行に一つだけ指定してください。カレンダー情報ファイルに半角空白，タブ文字やその他の指定できない文字が含まれる場合，および指定できる形式以外でユニット定義パラメーターを指定した場合，その行を不正なユニット定義パラメーターとして無視し，KAVS0603-Eメッセージを出力して処理を続行します。

カレンダー情報ファイルは，1行ごとに改行してください。

指定例

op=2016/05/01;<改行>
cl=2016/05/02;<改行>
：
cl=2016/05/30;<改行>
op=2016/05/31;<改行>

また，カレンダー情報ファイルの最後の行以外に改行だけの行が含まれる場合，その行を不正なユニット定義パラメーターとして無視し，KAVS0603-Eメッセージを出力して処理を続行します。改行だけの行の場合，KAVS0603-Eメッセージに表示される「オプション文字列」に文字列は出力されません。

-cf，-Xf，-fオプションに指定するカレンダー情報ファイルに不正なユニット定義パラメーターが含まれる場合，その行を不正なユニット定義パラメーターとして無視し，KAVS0602-EメッセージまたはKAVS0603-Eメッセージを出力して処理を続行します。また，0バイトのファイルや有効なユニット定義パラメーターがないファイルなど，カレンダー情報ファイルではないファイルを一つでも指定した場合，カレンダー情報を計算しないで異常終了します。

ジョブグループ名を指定している場合，カレンダー情報を出力できるのは，次のどちらかのユーザーです。

カレンダー情報の計算対象であるすべてのジョブグループに参照権限を与えられたユーザーで，かつそのジョブグループに上位のジョブグループがある場合，最上位のジョブグループから指定したジョブグループ名までのすべてのジョブグループに参照権限があるユーザー。

Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザー。

ただし，環境設定パラメーターADMACLIMITをデフォルトから変更して「yes」を設定している場合は，Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザーであっても，参照権限が必要です。

戻り値

0

正常終了。

4〜124で4の倍数値

異常終了。

補足事項

-cg，-Xg，-gオプションでは，指定したジョブグループのカレンダー情報と，上位のすべてのジョブグループのカレンダー情報をマージしてから，カレンダーを計算します。マージした結果，運用日とも休業日とも定義されていない日付は，運用日として扱われます。

-cf，-Xf，-fオプションに指定したカレンダー情報ファイルで，運用日または休業日と指定されていない日付は，運用日として扱われます。

使用例1

複数のジョブグループ（/CAL/業務Aと/CAL/業務B）のカレンダー情報をOR条件で組み合わせて，標準出力ファイルに出力します。

ajscalutil -b 2016/4 -e 2017/3 -o -g /CAL/業務A -g /CAL/業務B

使用例2

複数のジョブグループ（/CAL/業務Cと/CAL/業務D）のカレンダー情報をAND条件で組み合わせて，標準出力ファイルに出力します。

ajscalutil -b 2016/4 -e 2017/3 -a -g /CAL/業務C -g /CAL/業務D

使用例3

ジョブグループ「/CAL/業務C」のカレンダー情報に，ジョブグループ「/CAL/業務E」の運用日を休業日として反映して，標準出力ファイルに出力します。

ajscalutil -b 2016/5 -e 2016/5 -x -g /CAL/業務C -Xg /CAL/業務E

使用例4

ジョブグループ「/CAL/業務A」の運用日と休業日を反転して，標準出力ファイルに出力します。

ajscalutil -b 2016/5 -e 2016/5 -v -g /CAL/業務A

使用例5

ジョブグループ「/CAL/業務A」のカレンダー情報を1日前にシフトして，標準出力ファイルに出力します。

ajscalutil -b 2016/5 -e 2016/5 -s db,1 -g /CAL/業務A

使用例6

ジョブグループ「/CAL/業務F」のカレンダー情報を，ジョブグループ「/CAL/業務G」のカレンダー情報と比較し，2運用日分後ろにシフトして，標準出力ファイルに出力します。

ajscalutil -b 2016/5 -e 2016/5 -s af,2 -cg /CAL/業務G -g /CAL/業務F

使用例7

ジョブグループ「/CAL/業務H」のカレンダー情報を，ジョブグループ「/CAL/業務G」のカレンダー情報と比較し，次の運用日に振り替えて，標準出力ファイルに出力します。

ajscalutil -b 2016/5 -e 2016/5 -t af -cg /CAL/業務H -g /CAL/業務G

使用例8

締め日の2営業日後が定義されているカレンダー情報と，システムの運用日が定義されているカレンダー情報をOR条件で組み合わせて，標準出力ファイルに出力します。なお，カレンダー情報が次に示すジョブグループに定義されているものとします。

営業日が定義されているジョブグループ「/CAL/営業日」

締め日が定義されているジョブグループ「/CAL/締め日」

システムの運用日が定義されているジョブグループ「/CAL/システム運用日」

この場合，ジョブグループ「/CAL/締め日」のカレンダー情報を，ジョブグループ「/CAL/営業日」のカレンダー情報と比較し，2運用日後ろにシフトして，カレンダー情報ファイル「C:¥temp¥cal.txt」に出力します。

次に，カレンダー情報ファイル「C:¥temp¥cal.txt」のカレンダー情報と，ジョブグループ「/CAL/システム運用日」のカレンダー情報をOR条件で組み合わせて，標準出力ファイルに出力します。

ajscalutil -b 2016/5 -e 2016/5 -s af,2 -cg /CAL/営業日 -g /CAL/締め日 > C:¥temp¥cal.txt
ajscalutil -b 2016/5 -e 2016/5 -o -g /CAL/システム運用日 -f "C:¥temp¥cal.txt"

出力例

cl=2016/05/01;
op=2016/05/02;
cl=2016/05/03;
  :
cl=2016/05/29;
op=2016/05/30;
op=2016/05/31;

ajschange

形式

ajschange
     [-F サービス名]
     [属性情報変更オプション]
     [スケジュール情報変更オプション]
     [ジョブ情報変更オプション]
     [関連情報変更オプション]
     [ルートジョブネットの実行順序制御情報変更オプション]
     [待ち合わせ条件変更オプション]
     [-R]
     [-L|-E]
     [-T]
     [-G|-N|-J]
     [-S]
     ジョブ名，ジョブネット名，またはジョブグループ名...

機能

ユニットの定義内容を変更します。

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

要素を更新（定義）する場合

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Editor権限

-g，-o，-mオプションで要素の属性を変更する場合

JP1_AJS_Admin権限

ユニットの所有者

注意事項

ユニットの実行ユーザー種別が所有ユーザーに設定されている場合，ジョブネットに対するJP1権限レベルがJP1_AJS_Admin権限以外のJP1ユーザーは，自分が所有するユニットでなければ変更操作はできません。

ユニットにJP1資源グループが設定されていない場合，上記に示すJP1権限レベルが与えられていなくても，あらゆるユーザーはそのユニットに対してすべての操作ができます。

ユニットに所有者が設定されていない場合，上記に示すJP1権限レベルが与えられていなくても，あらゆるユーザーはそのユニットの属性を変更できます。

引数

-F サービス名

処理対象とする，スケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

-R

指定したユニットに含まれるすべてのジョブグループ，ジョブネット，およびジョブの定義内容を変更します。

このオプションを，-L，-E，-T，-G，-N，-Jオプションと同時に指定した場合，各オプションの指定内容に従って定義内容を変更します。

-L

ジョブグループ，実行登録していないジョブネット，およびジョブの定義内容を変更します。

このオプションを，-T，-N，-Jオプションと同時に指定した場合，実行登録していないジョブネットまたはジョブについて，各オプションの指定内容に従って定義内容を変更します。なお，-E，-Gオプションと同時には指定できません。

-E

実行登録済みのジョブネットおよびジョブの定義内容を変更します。

このオプションを，-T，-N，-Jオプションと同時に指定した場合，実行登録済みジョブネットまたはジョブについて，各オプションの指定内容に従って定義内容を変更します。なお，-L，-Gオプションと同時には指定できません。

-T

ルートジョブネットの定義内容を変更します。

このオプションを，-E，-Lオプションと同時に指定した場合，各オプションの指定内容に従って，ルートジョブネットの定義内容を変更します。-Nオプションと同時に指定した場合，-Nオプションは無効になります。なお，-G，-Jオプションと同時には指定できません。

-G

ジョブグループの定義内容を変更します。

このオプションは，-L，-E，-T，-N，-J，および関連情報変更オプションと同時には指定できません。

-N

ジョブネットの定義内容を変更します。

このオプションを-Tオプションと同時に指定した場合，このオプションは無効になります。-E，-Lオプションと同時に指定した場合，各オプションの指定内容に従って，ジョブネットの定義内容を変更します。なお，-G，-Jオプションと同時には指定できません。

-J

ジョブの定義内容を変更します。

このオプションは，-T，-G，-Nオプション，および関連情報変更オプションと同時には指定できません。

-S

ジョブネットがサスペンド状態の場合，実行登録済みのジョブネットであっても，ジョブネットやジョブの定義情報を変更できるようにします。

サスペンド中に変更できない項目を変更するオプションを同時に指定すると，コマンドは異常終了します。

ジョブ名，ジョブネット名，またはジョブグループ名

定義内容を変更したいジョブ名，ジョブネット名，またはジョブグループ名を指定します。

指定できる文字数は，1〜930（単位：バイト）です。

ジョブ名，ジョブネット名，またはジョブグループ名は，複数指定できます。ただし，次のユニットは定義情報が一部異なります。複数指定する際は，混在させないでください。

ジョブグループとマネージャージョブグループ

ジョブネットとマネージャージョブネット

ジョブ，ジョブネット，またはジョブグループ名に，論理ホスト名を指定できます。実行IDは指定できません。

属性情報変更オプション

ユニットの属性を変更します。

このオプションは，すべてのユニットに共通です（ただし，-H，および-Iオプションは除きます。-H，および-Iオプションは，マネージャーユニットの場合にだけ指定してください）。

-m 許可モード

ジョブ実行時のJP1ユーザーの設定を変更する場合に，許可モードを指定します。

指定できる値は，8進数で4けたの値です。

表記上の左から1番目を1けた，2番目を2けた...とした場合の，各けたの意味を次に示します。

1けた目

ジョブ実行時のユーザーの扱いを指定します。

0〜3：ジョブネットを登録したJP1ユーザーを，ジョブ実行時のユーザーとします。

4〜7：ジョブを所有するJP1ユーザーを，ジョブ実行時のユーザーとします。

2〜4けた目

0〜7の任意の値を指定します。

このオプションは，ジョブに対してだけ有効です。ジョブ以外のユニットに対して指定した場合，オプションの指定は無視されます。

-o 所有者名

ユニットの所有者を変更します。

指定できる文字数は，1〜31（単位：バイト）です。

-g JP1資源グループ名

ユニットの所有者のグループ名を変更します。

指定できる文字数は，1〜63（単位：バイト）です。指定できる文字は，英数字，および「_（アンダーバー）」です。

-C コメント

ユニットのコメントを変更します。

指定できる文字数は，1〜80（単位：バイト）です。

-H マネージャーホスト名

マネージャーホスト名を変更します。

マネージャーユニット名の場合にだけ指定できます。

指定できる文字数は，1〜255（単位：バイト）です。

-I マネージャーユニット名

マネージャーユニット名を変更します。

マネージャーユニット名の場合にだけ指定できます。

指定できる文字数は，1〜961（単位：バイト）です。

スケジュール情報変更オプション

ジョブネットに定義されたスケジュールを変更します（スケジュールを変更した場合，コマンドの実行終了時にスケジュールが再計算されます）。

このオプションは，ジョブネットだけに指定できます。

-D ジョブグループ名

カレンダー情報を変更する場合に，使用したいカレンダー情報が定義されているジョブグループ名を指定します。

指定できる文字数は，1〜930（単位：バイト）です。

-d [N，]{[[年/]月/]{[+|*|@]日|[+|*|@]b[-日]|[+]{sun|su|mon|mo|tue|tu|wed|we|thu|th|fri|fr|sat|sa}[:{n|b}]}|en|ud|undefine}

ジョブネットの実行開始日を変更します。

144個まで同時に指定できます。

すべて未定義にする場合は，「-d 0, ud」または「-d 0, undefine」を指定します。

N

ジョブネットの実行開始日時を複数定義している場合に，対応するルール番号を指定します。

指定できる値は，1〜144です。

省略した場合，ルール番号として1が仮定されます（ルール番号が1であるスケジュールを変更すると仮定されます）。

年

実行開始日の西暦年を指定します。

指定できる値は，1994〜環境設定パラメーターSCHEDULELIMITの値（単位：西暦年）です。環境設定パラメーターSCHEDULELIMITの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2(123) SCHEDULELIMIT」を参照してください。

省略した場合，ジョブネットを実行登録した年が仮定されます。

月

実行開始日の月を指定します。

指定できる値は，1〜12（単位：月）です。

省略した場合，ジョブネットを実行登録した月が仮定されます。

+

実行開始日を，基準日からの相対日数で指定します。

*

実行開始日を，基準日から運用日だけの日数で指定します。

@

実行開始日を，基準日から休業日だけの日数で指定します。

日

実行開始日を指定します。

指定できる値を次に示します。

絶対日指定の場合

年月日指定：1〜指定年月の最終日（単位：日）です。

月日指定：1〜指定月の最終日（単位：日）です。ただし，2月の場合は，1〜29です。

日指定：1〜31（単位：日）です。

相対日，運用日，休業日指定の場合

1〜35（単位：日）です。

「+（相対日）」，「*（運用日）」，「@（休業日）」を省略した場合，ジョブネットを実行登録した月の絶対日が仮定されます。

b

その月の最終日をジョブネットの開始日にします。

-日

月末から何日前をジョブネットの実行開始日にするかを指定します。

指定できる値を次に示します。

絶対日指定の場合

年月日指定：0〜指定年月の最終日−1（単位：日）です。

月日指定：0〜指定月の最終日−1（単位：日）です。ただし，2月の場合は，0〜28です。

日指定：0〜30（単位：日）です。

相対日，運用日，休業日指定の場合

0〜34（単位：日）です。

「+（相対日）」，「*（運用日）」，「@（休業日）」と同時に指定できます。

sun|su|mon|mo|tue|tu|wed|we|thu|th|fri|fr|sat|sa

日曜，月曜，火曜，水曜，木曜，金曜，または土曜をジョブネットの実行開始日に指定します。

n

月初めを基準に何週目の曜日かを指定します。

指定できる値は，1〜5（単位：週）です。

省略した場合，実行登録操作をした日，およびajsscheduleコマンドの実行操作をした日から次の曜日を開始日として扱います。なお，開始年月の［年］または［月］のどちらかを指定している場合に，この指定を省略すると，実行登録操作時，およびajsscheduleコマンド実行時に第1週が仮定されます。

en

定義済みの実行開始日をジョブネットの実行登録日に変更します。

ud|undefine

ジョブネットのスケジュールをすべて未定義にします。

このオプションを指定する場合，「N（ジョブネットのルール番号）」の値に0を指定してください。

また，このオプションを指定すると，-d，-t，-V，-W，-K，-y，-s，-hオプションは無効になります。

-t [N,][+]時:分

ジョブネットの実行開始時刻を変更します。

144個まで同時に指定できます。

N

ジョブネットの実行開始日時を複数定義している場合に，対応するルール番号を指定します。

指定できる値は，1〜144です。

省略した場合，ルール番号として1が仮定されます（ルール番号が1であるスケジュールを変更すると仮定されます）。

+

「時：分」で指定する時刻を相対時刻として扱います。

省略した場合，指定する時刻が絶対時刻として扱われます。

時:分

ジョブネットの開始時刻を指定します。

時に指定できる値は，0〜47（単位：時）です。

分に指定できる値は，0〜59（単位：分）です。

-V [N,]{時:分|M分|U分|C分}

ジョブネットの開始遅延時刻を変更します。

144個まで同時に指定できます。

N

ジョブネットの開始遅延日時を複数定義している場合に，対応するルール番号を指定します。

指定できる値は，1〜144です。

省略した場合，ルール番号として1が仮定されます（ルール番号が1であるスケジュールを変更すると仮定されます）。

時:分

絶対時刻で指定します。

時に指定できる値は，0〜47（単位：時）です。

分に指定できる値は，0〜59（単位：分）です。

M分

ルートジョブネットの実行開始時刻からの相対分で指定します。

指定できる値は，1〜2,879（単位：分）です。

U分

上位ジョブネットの実行開始時刻からの相対分で指定します。

指定できる値は，1〜2,879（単位：分）です。

C分

自ジョブネットの実行開始時刻からの相対分で指定します。

指定できる値は，1〜2,879（単位：分）です。

-W [N,]{時:分|M分|U分|C分}

ジョブネットの終了遅延時刻を変更します。

144個まで同時に指定できます。

N

ジョブネットの終了遅延日時を複数定義している場合に，対応するルール番号を指定します。

指定できる値は，1〜144です。

省略した場合，ルール番号として1が仮定されます（ルール番号が1であるスケジュールを変更すると仮定されます）。

時:分

絶対時刻で指定します。

時に指定できる値は，0〜47（単位：時）です。

分に指定できる値は，0〜59（単位：分）です。

M分

ルートジョブネットの実行開始時刻からの相対分で指定します。

指定できる値は，1〜2,879（単位：分）です。

U分

上位ジョブネットの実行開始時刻からの相対分で指定します。

指定できる値は，1〜2,879（単位：分）です。

C分

自ジョブネットの実行開始時刻からの相対分で指定します。

指定できる値は，1〜2,879（単位：分）です。

-K [N,]リンクするルール番号

スケジュールを複数定義している場合に，上位ジョブネットのルール番号にリンクするルール番号を変更します。

144個まで同時に指定できます。ルートジョブネットには指定できません。

N

ジョブネットの，スケジュールのルール番号を指定します。

指定できる値は，1〜144です。

省略した場合，ルール番号として1が仮定されます（ルール番号が1であるスケジュールを変更すると仮定されます）。

リンクするルール番号

上位のジョブネットの，どのルール番号と対応するかを指定します。

-y [N,] 処理サイクル数,{y|m|w|d}

ジョブネットの処理サイクルを変更します。

144個まで同時に指定できます。

N

ジョブネットの開始遅延日時を複数定義している場合に，対応するルール番号を指定します。

指定できる値は，1〜144です。

省略した場合，ルール番号として1が仮定されます（ルール番号が1であるスケジュールを変更すると仮定されます）。

処理サイクル数,{y|m|w|d}

処理サイクルの数と処理サイクルの単位を変更します（例えば，6か月ごとに処理したい場合は，「-y 6,m」と指定します）。

y

年の単位で処理します。処理サイクル数に指定できる値は，1〜9（単位：年）です。

m

月の単位で処理します。処理サイクル数に指定できる値は，1〜12（単位：月）です。

w

週の単位で処理します。処理サイクル数に指定できる値は，1〜5（単位：週）です。

実行開始日を運用日，または休業日で定義している場合は，指定できません。指定した場合，1週を7運用日，または7休業日としてスケジュールが算出されますが，日単位で指定することを推奨します（例えば，「1,w」の代わりに，「7,d」と指定することを推奨します）。

d

日の単位で処理します。処理サイクル数に指定できる値は，1〜31（単位：日）です。

-s [N,] {af|be|no|ca}

ジョブネットの実行予定日がJP1/AJS3のカレンダー上で休業日であった場合の，実行日の振り替え方法を変更します。

144個まで同時に指定できます。

N

ジョブネットの開始遅延日時を複数定義している場合に，対応するルール番号を指定します。

指定できる値は，1〜144です。

省略した場合，ルール番号として1が仮定されます（ルール番号が1であるスケジュールを変更すると仮定されます）。

af

実行予定日よりあとの日に振り替えて，ジョブネットを実行します。

be

実行予定日より前の日に振り替えて，ジョブネットを実行します。

no

スケジューラーサービスが起動している場合に限り，実行予定日が休業日であってもジョブネットを強制的に実行します。

ca

実行予定日が休業日の場合，ジョブネットを実行しません。

-h [N,] 振り替え猶予日数

-sオプションに「af（実行日よりあとの日に振り替え）」，または「be（実行日より前の日に振り替え）」を指定した場合に，実行日を振り替える期間を指定します。

144個まで同時に指定できます。

N

ジョブネットの開始遅延日時を複数定義している場合に，対応するルール番号を指定します。

指定できる値は，1〜144です。

省略した場合，ルール番号として1が仮定されます（ルール番号が1であるスケジュールを変更すると仮定されます）。

振り替え猶予日数

指定できる値は，1〜31（単位：日）です（例えば，実行予定日を含めて5日の間，1日ずつあとの日に実行日を見つけるように指定したい場合は，「-s af -h 5」と指定します）。

-p 年/月/日

ジョブネットの実行有効期日を変更します。

年

期日の西暦年を指定します。

指定できる値は，1994〜環境設定パラメーターSCHEDULELIMITの値（単位：西暦年）です。環境設定パラメーターSCHEDULELIMITの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2(123) SCHEDULELIMIT」を参照してください。

月

期日の月を指定します。

指定できる値は，1〜12（単位：月）です。

日

期日の日を指定します。

指定できる値は，1〜31（単位：日）です。

-l 保存世代数

ジョブネットの実行結果を保存する世代数を変更します。

指定できる値は，1〜99（単位：世代）です。ただし，システム設定オプションを有効にしておくと，最大999（単位：世代）まで拡張できます。

ルートジョブネットだけに指定できます。

-n 優先順位の値

ジョブネット中のジョブの，実行優先順位の仮定値を変更します。

指定できる値は，1〜5です。

優先順位がいちばん低いのが1，いちばん高いのが5です。

-b {y|w|a|n}

ジョブネットの保留属性を変更します。ネストジョブネットにwまたはaを指定した場合，nが仮定されます。

y

ジョブネットの実行を保留します。

w

前回のジョブネットの終了結果が警告終了，または異常終了の場合に保留します。

a

前回のジョブネットの終了結果が異常終了の場合に保留します。

n

ジョブネットの実行を保留しません。

ジョブ情報変更オプションに，同名のオプション（ジョブの保留属性を変更するオプション）があります。総称名指定などで，ユニットが混在する場合に注意してください。

ジョブ情報変更オプション

ジョブの定義情報を変更します。

ジョブごとの使用できるジョブ情報変更オプションを次の表に示します。

表3‒4　ジョブごとの使用できるジョブ情報変更オプション

項番

ジョブ

使用できるジョブ情報変更オプション

1

UNIXジョブ，およびリカバリーUNIXジョブ

-c コマンドテキスト

-z スクリプトファイル名

-v 環境変数ファイル名

-i 標準入力ファイル名

-u 標準出力ファイル名

-e 標準エラー出力ファイル名

-w 警告終了しきい値

-a 異常終了しきい値

-j ジョブ実行エージェントホスト名

-U 実行ユーザー名

-b {y|n}

2

PCジョブ，およびリカバリーPCジョブ

-z スクリプトファイル名

-v 環境変数ファイル名

-i 標準入力ファイル名

-u 標準出力ファイル名

-e 標準エラー出力ファイル名

-w 警告終了しきい値

-a 異常終了しきい値

-j ジョブ実行エージェントホスト名

-U 実行ユーザー名

-b {y|n}

3

カスタムUNIXジョブ，およびリカバリーカスタムUNIXジョブ

-c コマンドテキスト

-z スクリプトファイル名

-v 環境変数ファイル名

-i 標準入力ファイル名

-u 標準出力ファイル名

-e 標準エラー出力ファイル名

-w 警告終了しきい値

-a 異常終了しきい値

-j ジョブ実行エージェントホスト名

-U 実行ユーザー名

-b {y|n}

4

カスタムPCジョブ，およびリカバリーカスタムPCジョブ

-u 標準出力ファイル名

-e 標準エラー出力ファイル名

-w 警告終了しきい値

-a 異常終了しきい値

-j ジョブ実行エージェントホスト名

-U 実行ユーザー名

-b {y|n}

5

QUEUEジョブ，およびリカバリーQUEUEジョブ

-z スクリプトファイル名

-w 警告終了しきい値

-a 異常終了しきい値

-b {y|n}

-q キュー名

-k ジョブ名

6

ORジョブ，およびリカバリーORジョブ

該当なし

7

判定ジョブ，およびリカバリー判定ジョブ

-b {y|n}

8

フレキシブルジョブ，およびリカバリーフレキシブルジョブ

-z スクリプトファイル名

-w 警告終了しきい値

-a 異常終了しきい値

-j 中継エージェント名

-b {y|n}

9

HTTP接続ジョブ，およびリカバリーHTTP接続ジョブ

-u 標準出力ファイル名

-e 標準エラー出力ファイル名

-w 警告終了しきい値

-a 異常終了しきい値

-j ジョブ実行エージェントホスト名

-U 実行ユーザー名

-b {y|n}

-c コマンドテキスト

コマンドテキストを変更します。

指定できる文字数は，1〜1,023（単位：バイト）です。

-z スクリプトファイル名

UNIXジョブの場合はスクリプトファイル名を変更します。PCジョブ，フレキシブルジョブおよびQUEUEジョブの場合は実行ファイル名を変更します。

指定できる文字数は，1〜511（単位：バイト）です。

-v 環境変数ファイル名

環境変数ファイル名を変更します。

ファイル名はフルパスで指定します。

指定できる文字数は，1〜511（単位：バイト）です。

-i 標準入力ファイル名

標準入力ファイル名を変更します。

ファイル名はフルパスで指定します。

指定できる文字数は，1〜511（単位：バイト）です。

-u 標準出力ファイル名

標準出力ファイル名を変更します。

ファイル名はフルパスで指定します。

指定できる文字数は，1〜511（単位：バイト）です。

「$JP1AJS2_JPQSTDOUTTEMP$」を指定すると，標準出力ファイルが一時ファイルに出力されます。

また，マクロ変数を指定できます。

-e 標準エラー出力ファイル名

標準エラー出力ファイル名を変更します。

ファイル名はフルパスで指定します。

指定できる文字数は，1〜511（単位：バイト）です。

-w 警告終了しきい値

警告終了のしきい値を変更します。

指定できる値は，0〜2,147,483,647です。

指定した値が，異常終了しきい値よりも大きい場合は，異常終了しきい値に指定した値を仮定して定義します。

-a 異常終了しきい値

異常終了のしきい値を変更します。

指定できる値は，0〜2,147,483,647です。

指定した値が，警告終了しきい値よりも小さい場合は，警告終了しきい値に指定した値を仮定して定義します。

更新するユニットにリトライ設定をしていて，自動リトライする終了コードを指定している場合，自動リトライする終了コードの下限または上限を超える値は指定できません。

-j ジョブ実行エージェントホスト名または中継エージェント名

ジョブ実行エージェントホスト名または中継エージェント名を変更します。

フレキシブルジョブの場合，「@SYSTEM」の値で更新すると，中継エージェント名の定義は初期化されます。

指定できる文字数は，1〜255（単位：バイト）です。

-U 実行ユーザー名

ジョブを実行するユーザー名を変更します。

指定できる文字数は，1〜63（単位：バイト）です。

-b {y|n}

ジョブの保留属性を変更します。

このオプションは，起動条件に定義されたジョブには指定できません。

y

保留します。

n

保留しません。

スケジュール情報変更オプションに同名のオプション（ジョブネットの保留属性を変更するオプション）があります。総称名指定などで，ユニットが混在する場合は，注意してください。

-q キュー名

ジョブをキューイングするキュー名を変更します。

指定できる文字数は，1〜63（単位：バイト）です。

-k ジョブ名

ジョブ名を変更します。

指定できる文字数は，1〜63（単位：バイト）です。

関連情報変更オプション

ジョブネットやジョブの実行順序関係を変更します。ジョブネットにだけ指定できます。

-Aオプション（関連設定オプション）と-Bオプション（関連解除オプション）は，それぞれ20個まで同時に指定できます。

-A 先行ユニット名，後続ユニット名 [,{seq|con}]

関連設定する（ユニットを関連づける）場合に，先行ユニット名，および後続ユニット名を指定します。さらに，接続種別を指定します。

先行ユニット名および後続ユニット名に指定できる文字数は，それぞれ1〜30（単位：バイト）です。

関連設定の対象となる先行ユニットおよび後続ユニットに対して，関連線がすでに設定されている場合，コマンドは戻り値0で正常終了します。

seq

順接続します。

con

判定ジョブと従属ユニットとを判定接続します。

なお，次の場合は関連設定できません。

先行ユニット名と後続ユニット名に同じユニット名を指定する場合。

先行ユニット名または後続ユニット名に指定したユニットがない場合。

先行ユニット名にリカバリーユニットを指定して，後続ユニット名に通常のユニットを指定する場合。

すでに関連設定されているユニットに対して，関連を逆に設定する場合。

同一の先行・後続ユニットに対して関連設定と関連設定解除を同時に指定する場合。

ジョブグループ，マネージャージョブグループ，マネージャージョブネット，およびルートジョブネットを指定する場合。

後続ユニットが判定ジョブの場合に，先行ユニットが二つ以上になる場合。

後続ユニットがORジョブの場合に，先行ユニットがイベントジョブまたはカスタムイベントジョブ以外の場合。

判定接続の場合に，先行ユニットに判定ジョブ以外のユニットを指定する場合。

判定ジョブと従属ユニットの判定接続が1対1にならない場合。

先行ユニット名，または後続ユニット名に起動条件ユニット名を指定した場合。

後続ユニットがリカバリー判定ジョブの場合に，先行ユニットがリカバリーユニットではない場合。

-B 先行ユニット名，後続ユニット名

関連解除する（ユニットの関連づけを解除する）場合に，先行ユニット名，および後続ユニット名を指定します。

指定できる文字数は，それぞれ1〜30（単位：バイト）です。

関連解除の対象となる先行ユニットおよび後続ユニットに対して，関連線が存在しない場合，コマンドは戻り値0で正常終了します。

ルートジョブネットの実行順序制御情報変更オプション

ジョブネットコネクタを使ってルートジョブネットの実行順序を制御するための情報を変更します。このオプションは，未登録のルートジョブネットおよび配下のユニットが未登録であるプランニンググループにだけ指定できます。

-M ルートジョブネットの実行順序制御

ルートジョブネットの実行順序を制御するかどうかを指定します。

y：ルートジョブネットの実行順序を制御します。

n：ルートジョブネットの実行順序を制御しません。

このオプションで「y」から「n」に変更した場合，-Oオプション（ジョブネットコネクタ名），-Qhオプション（接続ホスト名），-Qsオプション（接続サービス名）は未定義の状態に，-Pオプション（ルートジョブネットの実行順序制御方式），-Qxオプション（ルートジョブネットの実行順序制御のスケジューラーサービス間連携）は「n」に変更されます。

-O ジョブネットコネクタ名

接続するジョブネットコネクタのユニット完全名を指定します。指定できる文字数は，1〜930（単位：バイト）です。

-Mオプションに「y」が指定されている場合に変更できます。「n」が指定されている場合にこのオプションを指定するとエラーになります。

-P ルートジョブネットの実行順序制御方式

ルートジョブネットの実行順序制御方式を指定します。

y：ジョブネットコネクタと同期してルートジョブネットを実行します。

n：ジョブネットコネクタと非同期でルートジョブネットを実行します。

-Mオプションに「y」が指定されている場合に変更できます。「n」が指定されている場合にこのオプションを指定するとエラーになります。

-Qx ルートジョブネットの実行順序制御のスケジューラーサービス間連携

ルートジョブネットの実行順序を制御する場合に，スケジューラーサービス間連携させるかどうかを指定します。

このオプションは，配下のユニットが未登録のプランニンググループ，および未登録のルートジョブネットでだけ指定できます。

このオプションの値を「y」から「n」を指定した場合，-Qhオプション（接続ホスト名），-Qsオプション（接続サービス名）は未定義状態になります。

y

スケジューラーサービス間連携します。

別のホストまたは別のスケジューラーサービスに定義したジョブネットコネクタと連携します。

n

スケジューラーサービス間連携しません。

同一スケジューラーサービスに定義したジョブネットコネクタとだけ連携します。

-Qh 接続ホスト名

接続するジョブネットコネクタが定義されているホストの名称を指定します。指定できる文字数は，1〜255（単位：バイト）です。半角スペース，タブ文字，改行文字は指定できません。

-Qxオプション（ルートジョブネットの実行順序制御のスケジューラーサービス間連携）に「y」を指定している場合だけ指定できます。

-Qs 接続サービス名

接続するジョブネットコネクタが定義されているスケジューラーサービスの名称を指定します。指定できる文字数は，1〜30（単位：バイト）です。このオプションの値に「""」を指定して，スケジューラーサービス名を定義していない状態（デフォルトの状態）にすることはできません。

-Qxオプション（ルートジョブネットの実行順序制御のスケジューラーサービス間連携）に「y」を指定している場合だけ指定できます。

待ち合わせ条件変更オプション

待ち合わせ条件を変更します。

このオプションは，-Sオプションを同時に指定することで，サスペンド中のユニットに対して実行できます。

-Qm {and|or}

待ち合わせ方法を指定します。待ち合わせ対象ユニットが一つも定義されていないユニットに対して指定する場合，-Qnオプションと-Quオプションを同時に指定する必要があります。

このオプションの値に「""」を指定すると，andが仮定されます。

and

すべての待ち合わせ対象ユニットが終了したら実行を開始する。

or

待ち合わせ対象ユニットが一つでも終了したら実行を開始する。

-Qn {y|n}

待ち合わせ対象ユニットのルートジョブネットに待ち合わせる世代がない場合の動作を指定します。待ち合わせ対象ユニットが一つも定義されていないユニットに対して指定する場合，-Qmオプションと-Quオプションを同時に指定する必要があります。

このオプションの値に「""」を指定すると，nが仮定されます。

y

実行を開始する。

n

実行を開始しない。

-Qu 追加する待ち合わせ対象ユニット名

待ち合わせ条件に追加する，待ち合わせ対象ユニットのユニット完全名を指定します。指定できる文字列は，1〜930（単位：バイト）です。指定したユニットは，定義済みの待ち合わせ条件の待ち合わせ対象ユニットに追加されます。

定義済みの待ち合わせ対象ユニットと同一のユニットを指定した場合，新たに待ち合わせ対象ユニットは追加されないで，コマンドは正常終了します。

32個より多くの待ち合わせ対象ユニットを追加することはできません。

このオプションは，-Qdオプション（待ち合わせ対象ユニットの削除）と同時に複数指定できます。

このオプションと同時に-Qdオプションを指定し，-Quオプションと-Qdオプションの「削除する待ち合わせ対象ユニット名」に同一名称を指定した場合，-Qdオプションの指定が有効になり，指定したユニットは削除されます。

待ち合わせ対象ユニット名が一つも定義されていないユニットに対して指定する場合，-Qmオプションと-Qnオプションを同時に指定する必要があります。

-Qd 削除する待ち合わせ対象ユニット名

待ち合わせ条件から削除する，待ち合わせ対象ユニットのユニット完全名を指定します。指定できる文字列は，1〜930（単位：バイト）です。指定したユニットは，定義済みの待ち合わせ条件の待ち合わせ対象ユニットから削除されます。

指定したユニットが定義済みの待ち合わせ対象ユニットにない場合でも，コマンドは正常終了します。

このオプションは，-Quオプション（待ち合わせ対象ユニットの追加）と同時に複数指定できます。

このオプションと同時に-Quオプションを指定し，-Qdオプションと-Quオプションの「追加する待ち合わせ対象ユニット名」に同一名称を指定した場合，-Qdオプションの指定が有効になり，指定したユニットは削除されます。

-Qz

定義済みの待ち合わせ条件で指定されているすべての待ち合わせ対象ユニットを削除します。

このオプションは，-Quオプションおよび-Qdオプションと同時に指定できません。

-Qg {exec|execdeffer|none}

起動条件付きジョブネットを待ち合わせ対象に指定した場合に，実行世代に異常終了があるときの動作を指定します。

待ち合わせ対象ユニットが一つも定義されていないユニットに対して指定する場合，-Qmオプション，-Qnオプション，および-Quオプションと同時に指定する必要があります。

このオプションの値に「""」を指定すると，noneが仮定されます。

exec

実行を開始する。

execdeffer

実行を開始しない。ただし，実行世代が「繰り越し未実行」状態の場合は，実行を開始する。

none

実行を開始しない。

-QU {y|n}

起動条件付きジョブネットを待ち合わせ対象に指定して，監視世代が監視未起動終了になった場合の動作を指定します。

待ち合わせ対象ユニットが一つも定義されていないユニットに対して指定する場合，-Qmオプション，-Qnオプション，および-Quオプションと同時に指定する必要があります。

このオプションの値に「""」を指定すると，nが仮定されます。

y

実行を開始する。

n

実行を開始しない。

注意事項

ユニットの定義内容を変更できるのは，次のどちらかのユーザーです。

そのユニットを定義したときに，またはその属性を変更したときに，更新権限を与えられたユーザー。

Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザー。

ただし，環境設定パラメーターADMACLIMITをデフォルトから変更して「yes」を設定している場合は，Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザーであっても，更新権限が必要です。

ジョブネットを実行している間には，このコマンドを実行しないことを推奨します（操作対象のユニットが他で使用中の場合，このコマンドは異常終了します。また，このコマンドでユニットの定義内容を変更している間は，JP1/AJS3 - Viewでユニットを操作・更新できません。操作中のユニットは実行できません）。

実行登録済みのジョブネットの定義内容を変更する場合は，ジョブネットの実行登録をあらかじめ解除しておくことを推奨します（ジョブネットが実行登録されている場合，関連情報を変更できません）。ジョブネットの実行登録解除には，ajsleaveコマンドを使ってください。

ユニットに不適切なオプションを指定した場合，このコマンドは異常終了します。総称名での変更時には注意してください（「A」で始まる名称は，「A*」などの正規表現で指定してください）。

スケジュールを変更した場合，それ以前に実施した計画一時変更は無効になります。

実行開始日を，変更する日より過去に戻した場合，過去の実行分は無効になります（スケジュールは無効になり，ジョブネットは実行されません）。

コマンドを使用してジョブネットを定義する場合，ユニットの実行順序の整合性はチェックしません。ユニットの実行順序がループするように関連づけたジョブネット，または従属ユニットが関連づけられていない判定ジョブは，実行時に「順序不正」でエラーになります。

各情報を未定義（デフォルトの状態）にするには，オプションに対する値に，「""」を指定してください。

-t，-V，-W，-K，-y，-s，-hオプションは，ジョブネットのスケジュール定義に該当しないルール番号を指定してコマンドを実行した場合，コマンドは正常終了しますが，スケジュールは追加されません。スケジュールルールを追加したい場合は，-dオプションと同時に指定してください。

リリース登録されているルートジョブネット（リリース先ジョブネット）を変更した場合は，「適用中」状態のジョブネット定義が変更されます。

リリース登録されているルートジョブネット（リリース先ジョブネット）の実行順序は制御できません。

サスペンド中のユニットに対して，-Aオプションまたは-Bオプションを指定して関連線の定義を変更することはできません。サスペンド中のユニットに対して関連線の定義を変更したい場合は，ajschgnetコマンドを実行してください。

スケジュール情報の変更は，業務量が少ない時間帯に実行してください。スケジュール情報変更オプションを指定した場合，このコマンドを実行中は，スケジュール情報を変更するジョブネットと同一のスケジューラーサービスに実行登録されているルートジョブネットの実行を抑止するため，業務に影響を及ぼすおそれがあります。ただし，定義を変更する前に「監視中」状態になっている起動条件付きジョブネットは，起動条件が成立すると実行されます。

-dオプションに2/29を指定する場合は，2/29が存在する年を指定してください。

戻り値

0

正常終了。

4〜124で4の倍数値

異常終了。

補足事項

属性情報変更オプション，スケジュール情報変更オプション，ジョブ情報変更オプションについて各情報を未定義（デフォルトの状態）にするためには，オプションに対する値として「""」を指定してください。

使用例1

ジョブネット（net1）の実行開始日時を，2009年10月の毎週金曜日の17:00（絶対時刻）に変更します。

ajschange -d 2009/10/fr -y 1,w -t 17:00 net1

使用例2

ジョブ(net1/job1)の標準出力ファイルを/dev/nullに変更します。

ajschange -u /dev/null net1/job1

使用例3

二つのジョブ（net1/job1とnet1/job2）を関連づけます。

ajschange -A job1,job2 net1

使用例4

ルートジョブネット（/net1）に，ジョブネットコネクタ（/net2/netconl）と同期して実行するように実行順序制御情報を設定します。

ajschange -M y -O /net2/netconl -P y /net1

ルートジョブネット（/net1）の実行順序制御を解除します。

ajschange -M n /net1

ajschgjob

形式

ajschgjob
     [-F サービス名]
     [ジョブ共通情報変更オプション]
     [UNIX／PC／QUEUE／カスタムジョブ／フレキシブルジョブ／HTTP接続ジョブ情報変更オプション]
     [判定ジョブ情報変更オプション]
     [JP1イベント受信監視ジョブ情報変更オプション]
     [ファイル監視ジョブ情報変更オプション]
     [メール受信監視ジョブ情報変更オプション]
     [メッセージキュー受信監視ジョブ情報変更オプション]
     [MSMQ受信監視ジョブ情報変更オプション]
     [ログファイル監視ジョブ情報変更オプション]
     [Windowsイベントログ監視ジョブ情報変更オプション]
     [実行間隔制御ジョブ情報変更オプション]
     [JP1イベント送信ジョブ情報変更オプション]
     [メール送信ジョブ情報変更オプション]
     [メッセージキュー送信ジョブ情報変更オプション]
     [MSMQ送信ジョブ情報変更オプション]
     [JP1/Cm2状態通知ジョブ情報変更オプション]
     [ローカル電源制御ジョブ情報変更オプション]
     [リモート電源制御ジョブ情報変更オプション]
     [カスタムイベントジョブ情報変更オプション]
     [-R]
     [-L|-E]
     [-J]
     ジョブ名，ジョブネット名，またはジョブグループ名...

機能

ジョブの定義内容を変更します。

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Editor権限

注意事項

ユニットの実行ユーザー種別が所有ユーザーに設定されている場合，ジョブネットに対するJP1権限レベルがJP1_AJS_Admin権限以外のJP1ユーザーは，自分が所有するユニットでなければ変更操作はできません。

ユニットにJP1資源グループが設定されていない場合，上記に示すJP1権限レベルが与えられていなくても，あらゆるユーザーはそのユニットに対してすべての操作ができます。

引数

-F サービス名

処理対象とする，スケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

-R

指定したユニットに含まれる，すべてのジョブの定義内容を変更します。

このオプションを，-L，-E，-Jオプションと同時に指定した場合，各オプションの定義内容に従って定義内容を変更します。

-L

実行登録していないジョブネット中のジョブの定義内容を変更します。

このオプションを-Jオプションと同時に指定した場合，実行登録していないジョブネット中のジョブの定義内容を変更します。-Eオプションと同時には指定できません。

-E

実行登録済みのジョブネット中のジョブの定義内容を変更します。

このオプションを-Jオプションと同時に指定した場合，実行登録済みジョブネット中のジョブの定義内容を変更します。-Lオプションと同時には指定できません。

-J

ジョブの定義内容を変更します。

ジョブ，ジョブネット，またはジョブグループ名

定義内容を変更するジョブ名，または-R，-E，-L，-Jオプションと同時にジョブ名，ジョブネット名，またはジョブグループ名を完全名で指定します。

指定できる文字数は，1〜930（単位：バイト）です。

ジョブ，ジョブネットまたはジョブグループ名は，複数指定できます。

なお，ジョブ，ジョブネットまたはジョブグループ名に，論理ホスト名を指定できます。実行IDは指定できません。

ジョブ共通情報変更オプション

ジョブ共通情報変更オプションを変更します。

-ex "実行エージェントホスト名または中継エージェント名"

ジョブ実行エージェントホスト名または中継エージェント名を変更します。

フレキシブルジョブの場合，「@SYSTEM」の値で更新すると，中継エージェント名の定義は初期化されます。

指定できる文字数は，1〜255（単位：バイト）です。

QUEUEジョブ，判定ジョブ，ORジョブには指定できません。

-et 実行打ち切り時間

実行打ち切り時間を変更します。

指定できる値は，1〜1,440（単位：分）です。

QUEUEジョブ，判定ジョブ，ORジョブ，および起動条件内のジョブには指定できません。

-ha {y|n}

保留属性を変更します。

ORジョブ，および起動条件内のジョブには指定できません。

y

ジョブの実行を保留します。

n

ジョブの実行を保留しません。

-es {kl|nr|wr|an}

実行打ち切り時間が経過したあとのイベントジョブおよびカスタムイベントジョブの打ち切り状態を変更します。次の情報変更オプションに対して有効です。

JP1イベント受信監視ジョブ

ファイル監視ジョブ

メール受信監視ジョブ

メッセージキュー受信監視ジョブ

MSMQ受信監視ジョブ

ログファイル監視ジョブ

Windowsイベントログ監視ジョブ

実行間隔制御ジョブ

カスタムイベントジョブ

このオプションを指定した場合に指定できる文字列を次に示します。

kl：強制終了

nr：正常終了

wr：警告検出終了

an：異常検出終了

このオプションは，イベントジョブおよびカスタムイベントジョブだけに指定できます。起動条件内のイベントジョブおよびカスタムイベントジョブには指定できません。

実行打ち切り時間の指定がないユニットに対してこのオプションを指定する場合，-etオプションで実行打ち切り時間を指定する必要があります。

-fd 実行所要時間

終了遅延を監視するジョブの実行所要時間を変更します。

指定できる値は，1〜1,440（単位：分）です。数字以外の文字または1〜1,440の範囲外の値を指定した場合はエラーとなります。

判定ジョブおよびORジョブには指定できません。判定ジョブおよびORジョブを指定した場合は無効オプションとして処理が続行されます。

UNIX／PC／QUEUE／カスタムジョブ／フレキシブルジョブ／HTTP接続ジョブ情報変更オプション

ジョブの定義情報を変更します。

ジョブごとの使用できる情報変更オプションを次の表に示します。

表3‒5　ジョブごとの使用できる情報変更オプション

項番

ジョブ

使用できる情報変更オプション

1

UNIXジョブ，およびリカバリーUNIXジョブ

-te コマンドテキスト

-sc スクリプトファイル名

-pm パラメーター

-wk 作業用パス名

-ev 環境変数ファイル名

-en 環境変数

-si 標準入力ファイル名

-so 標準出力ファイル名

-se 標準エラー出力ファイル名

-oa {new|add}

-ea {new|add}

-pr 実行優先順位

-un ジョブ実行ユーザー名

-jd {nm|ab|cod|mdf|exf}

-wt 警告終了しきい値

-th 異常終了しきい値

-jf 終了判定ファイル名

-Ab {y|n}

-rs 自動リトライする終了コードの下限

-re 自動リトライする終了コードの上限

-rc 最大リトライ回数

-ri リトライ間隔

-s1 転送元ファイル名1

-d1 転送先ファイル名1

-t1 {sav|del}

-s2 転送元ファイル名2

-d2 転送先ファイル名2

-t2 {sav|del}

-s3 転送元ファイル名3

-d3 転送先ファイル名3

-t3 {sav|del}

-s4 転送元ファイル名4

-d4 転送先ファイル名4

-t4 {sav|del}

-jt {q|n}

2

PCジョブ，およびリカバリーPCジョブ

-sc スクリプトファイル名

-pm パラメーター

-wk 作業用パス名

-ev 環境変数ファイル名

-en 環境変数

-si 標準入力ファイル名

-so 標準出力ファイル名

-se 標準エラー出力ファイル名

-oa {new|add}

-ea {new|add}

-pr 実行優先順位

-un ジョブ実行ユーザー名

-jd {nm|ab|cod|mdf|exf}

-wt 警告終了しきい値

-th 異常終了しきい値

-jf 終了判定ファイル名

-Ab {y|n}

-rs 自動リトライする終了コードの下限

-re 自動リトライする終了コードの上限

-rc 最大リトライ回数

-ri リトライ間隔

-s1 転送元ファイル名1

-d1 転送先ファイル名1

-t1 {sav|del}

-s2 転送元ファイル名2

-d2 転送先ファイル名2

-t2 {sav|del}

-s3 転送元ファイル名3

-d3 転送先ファイル名3

-t3 {sav|del}

-s4 転送元ファイル名4

-d4 転送先ファイル名4

-t4 {sav|del}

-jt {q|n}

3

カスタムUNIXジョブ，およびリカバリーカスタムUNIXジョブ

-te コマンドテキスト

-sc スクリプトファイル名

-pm パラメーター

-wk 作業用パス名

-ev 環境変数ファイル名

-en 環境変数

-si 標準入力ファイル名

-so 標準出力ファイル名

-se 標準エラー出力ファイル名

-oa {new|add}

-ea {new|add}

-pr 実行優先順位

-un ジョブ実行ユーザー名

-jd {nm|ab|cod|mdf|exf}

-wt 警告終了しきい値

-th 異常終了しきい値

-jf 終了判定ファイル名

-Ab {y|n}

-rs 自動リトライする終了コードの下限

-re 自動リトライする終了コードの上限

-rc 最大リトライ回数

-ri リトライ間隔

-s1 転送元ファイル名1

-d1 転送先ファイル名1

-t1 {sav|del}

-s2 転送元ファイル名2

-d2 転送先ファイル名2

-t2 {sav|del}

-s3 転送元ファイル名3

-d3 転送先ファイル名3

-t3 {sav|del}

-s4 転送元ファイル名4

-d4 転送先ファイル名4

-t4 {sav|del}

4

カスタムPCジョブ，およびリカバリーカスタムPCジョブ

-so 標準出力ファイル名

-se 標準エラー出力ファイル名

-pr 実行優先順位

-un ジョブ実行ユーザー名

-jd {nm|ab|cod|mdf|exf}

-wt 警告終了しきい値

-th 異常終了しきい値

-jf 終了判定ファイル名

-Ab {y|n}

-rs 自動リトライする終了コードの下限

-re 自動リトライする終了コードの上限

-rc 最大リトライ回数

-ri リトライ間隔

5

QUEUEジョブ，およびリカバリーQUEUEジョブ

-sc スクリプトファイル名

-pm パラメーター

-pr 実行優先順位

-jd {nm|ab|cod}

-wt 警告終了しきい値

-th 異常終了しきい値

-Ab {y|n}

-rs 自動リトライする終了コードの下限

-re 自動リトライする終了コードの上限

-rc 最大リトライ回数

-ri リトライ間隔

-qu キュー名

-qm キューマネージャーホスト名

-rq ジョブ名

-s1 転送元ファイル名1

-d1 転送先ファイル名1

-s2 転送元ファイル名2

-d2 転送先ファイル名2

-s3 転送元ファイル名3

-d3 転送先ファイル名3

-s4 転送元ファイル名4

-d4 転送先ファイル名4

6

フレキシブルジョブ，およびリカバリーフレキシブルジョブ

-sc スクリプトファイル名

-pm パラメーター

-en 環境変数

-jd {nm|ab|cod|mdf|exf}

-wt 警告終了しきい値

-th 異常終了しきい値

-jf 終了判定ファイル名

-Ab {y|n}

-rs 自動リトライする終了コードの下限

-re 自動リトライする終了コードの上限

-rc 最大リトライ回数

-ri リトライ間隔

-da 宛先または一斉配信エージェント

-fg {none|sync|async}

7

HTTP接続ジョブ，およびリカバリーHTTP接続ジョブ

-so 標準出力ファイル名

-se 標準エラー出力ファイル名

-pr 実行優先順位

-un ジョブ実行ユーザー名

-jd {nm|ab|cod|mdf|exf}

-wt 警告終了しきい値

-th 異常終了しきい値

-jf 終了判定ファイル名

-Ab {y|n}

-rs 自動リトライする終了コードの下限

-re 自動リトライする終了コードの上限

-rc 最大リトライ回数

-ri リトライ間隔

-HC 接続設定ファイル名

-HK {GET|POST|PUT|DELETE}

-HE {y|n}

-HS 送信情報ファイル名

-HU 送信情報ファイル名（URLパラメーター）

-HM 送信情報ファイル名（メッセージボディ）

-HT ステータス格納ファイル名

-HD {diff|same}

-HH 受信ヘッダー格納ファイル名

-HB 受信ボディ格納ファイル名

-HR 終了コード1:HTTPステータスコード1[,HTTPステータスコード2...];

-te コマンドテキスト

コマンドテキストを変更します。

指定できる文字数は，1〜1,023（単位：バイト）です。

-sc スクリプトファイル名

UNIXジョブの場合はスクリプトファイル名を変更します。PCジョブ，フレキシブルジョブおよびQUEUEジョブの場合は実行ファイル名を変更します。

指定できる文字数は，1〜511（単位：バイト）です。

-pm パラメーター

実行ファイルに対するパラメーターを変更します。

指定できる文字数は，1〜1,023（単位：バイト）です。

-wk 作業用パス名

作業用パス（カレントパス）名を変更します。

指定できる文字数は，1〜511（単位：バイト）です。

-ev 環境変数ファイル名

環境変数ファイル名を変更します。

指定できる文字数は，1〜511（単位：バイト）です。

環境変数ファイル名はフルパスで指定します。

環境変数を定義する際の注意事項については，「付録A 環境変数および環境変数ファイルを定義する場合の注意事項」を参照してください。

-en 環境変数

環境変数を変更します。

指定できる文字数は，1〜20,479（単位：バイト）です。

フレキシブルジョブの場合，バイト数の合計が10,240バイトまで複数指定できます。フレキシブルジョブ以外のジョブの場合，バイト数の合計が20,479バイトまで複数指定できます。

環境変数を定義する際の注意事項については，「付録A 環境変数および環境変数ファイルを定義する場合の注意事項」を参照してください。

-si 標準入力ファイル名

標準入力ファイル名を変更します。

指定できる文字数は，1〜511（単位：バイト）です。

標準入力ファイル名はフルパスで指定します。

-so 標準出力ファイル名

標準出力ファイル名を変更します。

指定できる文字数は，1〜511（単位：バイト）です。

標準出力ファイル名はフルパスで指定します。

「$JP1AJS2_JPQSTDOUTTEMP$」を指定すると，標準出力ファイルが一時ファイルに出力されます。

また，マクロ変数を指定できます。

-se 標準エラー出力ファイル名

標準エラー出力ファイル名を変更します。

指定できる文字数は，1〜511（単位：バイト）です。

標準エラー出力ファイル名はフルパスで指定します。

-oa {new|add}

標準出力ファイルの情報更新方法を変更します。

new

新しい標準出力ファイルに情報を出力します。

add

既存の標準出力ファイルに情報を追加します。

-ea {new|add}

標準エラー出力ファイルの情報更新方法を変更します。

new

新しい標準エラー出力ファイルに情報を出力します。

add

既存の標準エラー出力ファイルに情報を追加します。

-pr 実行優先順位

ジョブの実行優先順位を変更します。

指定できる値は，1〜5です。

優先順位がいちばん低いのが1，いちばん高いのが5です。

-un ジョブ実行ユーザー名

ジョブを実行する実行ユーザー名を変更します。

指定できる文字数は，1〜63（単位：バイト）です。

-jd {nm|ab|cod|mdf|exf}

終了判定の種別を変更します。

「cod」以外の値に変更した場合，リトライ設定に関連する-Ab，-rs，-re，-rc，および-riオプションの設定値はすべて初期化されます。

nm

すべて正常終了として扱います。

ab

すべて異常終了として扱います。

cod

終了コードが指定値以下の場合に，正常終了として扱います。

mdf

ファイルが更新されている場合に，正常終了として扱います。

QUEUEジョブおよびそのリカバリージョブには指定できません。

exf

ファイルが作成されている場合に，正常終了として扱います。

QUEUEジョブおよびそのリカバリージョブには指定できません。

-wt 警告終了しきい値

警告終了のしきい値を変更します。

指定できる値は，0〜2,147,483,647です。

指定した値が，異常終了しきい値よりも大きい場合は，異常終了しきい値に指定した値を仮定して定義します。

-th 異常終了しきい値

異常終了のしきい値を変更します。

指定できる値は，0〜2,147,483,647です。

指定した値が，警告終了しきい値よりも小さい場合は，警告終了しきい値に指定した値を仮定して定義します。

更新するジョブにリトライ設定をしていて，自動リトライする終了コードを指定している場合は，自動リトライする終了コードの上限または下限以上の値は指定できません。

-jf 終了判定ファイル名

終了判定ファイル名を変更します。

指定できる値は，1〜511（単位：バイト）です。

-Ab {y|n}

異常終了時の，自動リトライの動作を変更します。

y

異常終了時に自動リトライします。

n

異常終了時に自動リトライしません。

-jdオプションの指定値が「cod」の場合だけ，このオプションに「y」を指定できます。

このオプションの値を「y」から「n」に変更した場合，関連する-rs，-re，-rc，および-riオプションの設定がすべて削除されます。また，このオプションに「n」を指定して，同時に-rs，-re，-rc，または-riオプションを指定しても，無視されます。

引き継ぎ情報設定ジョブには定義できません。

-rs 自動リトライする終了コードの下限

自動リトライする終了コードの下限を指定します。異常終了時に自動リトライする場合，異常終了時に出力された終了コードがこのオプションの指定値以上のときに，自動リトライが実行されます。

指定できる値は，1〜4,294,967,295です。「""」を指定すると未定義となり，ジョブ実行時に終了判定の「異常終了しきい値＋1」の値が仮定されます。

異常終了しきい値以下の値，および自動リトライする終了コードの上限より大きい値は指定できません。また，実行時に有効となる自動リトライする終了コードの下限と上限の範囲が無効な範囲となる場合，エラーになります。

引き継ぎ情報設定ジョブには定義できません。

-re 自動リトライする終了コードの上限

自動リトライする終了コードの上限を指定します。異常終了時に自動リトライする場合，異常終了時に出力された終了コードがこのオプションの指定値以下のときに，自動リトライが実行されます。

指定できる値は，1〜4,294,967,295です。「""」を指定すると未定義となり，ジョブ実行時に最大値の「4,294,967,295」が仮定されます。

異常終了しきい値以下の値，および自動リトライする終了コードの下限より小さい値は指定できません。また，自動リトライする終了コードの下限と上限の範囲が無効な範囲になる場合，エラーになります。

引き継ぎ情報設定ジョブには定義できません。

-rc 最大リトライ回数

自動リトライする場合の，最大リトライ回数を指定します。

指定できる値は1〜12（単位：回）です。

引き継ぎ情報設定ジョブには定義できません。

-ri リトライ間隔

自動リトライする場合の，リトライ間隔を指定します。

指定できる値は1〜10（単位：分）です。

引き継ぎ情報設定ジョブには定義できません。

-qu キュー名

ジョブをキューイングするキュー名を変更します。

指定できる文字数は，1〜63（単位：バイト）です。

-qm キューマネージャーホスト名

キューマネージャーホスト名を変更します。

指定できる文字数は，1〜255（単位：バイト）です。

-rq ジョブ名

ジョブ名を変更します。

指定できる文字数は，1〜63（単位：バイト）です。

-s1 転送元ファイル名1

転送元ファイル名1を変更します。

指定できる文字数は，1〜511（単位：バイト）です。

-d1 転送先ファイル名1

転送先ファイル名1を変更します。

指定できる文字数は，1〜511（単位：バイト）です。

-t1 {sav|del}

転送先ファイル名1のジョブ実行終了後の削除オプションを変更します。

sav

ジョブ実行後，ファイルを保存します。

del

ジョブ実行後，ファイルを削除します。

-s2 転送元ファイル名2

転送元ファイル名2を変更します。

指定できる文字数は，1〜511（単位：バイト）です。

-d2 転送先ファイル名2

転送先ファイル名2を変更します。

指定できる文字数は，1〜511（単位：バイト）です。

-t2 {sav|del}

転送先ファイル名2のジョブ実行終了後の削除オプションを変更します。

sav

ジョブ実行後，ファイルを保存します。

del

ジョブ実行後，ファイルを削除します。

-s3 転送元ファイル名3

転送元ファイル名3を変更します。

指定できる文字数は，1〜511（単位：バイト）です。

-d3 転送先ファイル名3

転送先ファイル名3を変更します。

指定できる文字数は，1〜511（単位：バイト）です。

-t3 {sav|del}

転送先ファイル名3のジョブ実行終了後の削除オプションを変更します。

sav

ジョブ実行後，ファイルを保存します。

del

ジョブ実行後，ファイルを削除します。

-s4 転送元ファイル名4

転送元ファイル名4を変更します。

指定できる文字数は，1〜511（単位：バイト）です。

-d4 転送先ファイル名4

転送先ファイル名4を変更します。

指定できる文字数は，1〜511（単位：バイト）です。

-t4 {sav|del}

転送先ファイル名4のジョブ実行終了後の削除オプションを変更します。

sav

ジョブ実行後，ファイルを保存します。

del

ジョブ実行後，ファイルを削除します。

-jt {q|n}

キューイング属性の種別を変更します。

q

キューイング属性あり。

n

キューイング属性なし。

-da 宛先または一斉配信エージェント

宛先または一斉配信エージェントを変更します。

指定できる文字数は，1〜128（単位：バイト）です。

このオプションはフレキシブルジョブだけに指定できます。その他のジョブに指定した場合，無効として処理が続行されます。

-fg {none|sync|async}

フレキシブルジョブを一斉実行する場合の方式を変更します。

フレキシブルジョブの一斉実行には，後続ジョブの処理について，同期モードと非同期モードの二つの方式があります。同期モードでは，一斉配信エージェントがすべての宛先エージェントから実行完了の通知を受け取ったあと，後続ジョブを実行します。非同期モードでは，一斉配信エージェントがすべての宛先エージェントへの実行要求を完了した時点で，後続ジョブを実行します。

none

一斉実行をしないで，通常のフレキシブルジョブを実行します。

SYNC

同期モードで実行します。

ASYNC

非同期モードで実行します。

-HC 接続設定ファイル名

接続設定ファイル名を変更します。

指定できる文字数は，1〜511（単位：バイト）です。

ファイル名は絶対パスで指定します。

-HK {GET|POST|PUT|DELETE}

リクエスト種別を変更します。

GET（取得）

POST（追加）

PUT（更新）

DELETE（削除）

「""」を指定した場合，デフォルト値の「GET」が仮定されます。

-HE {y|n}

拡張モードを使用するかどうかを定義します。JP1/AJS3 - ManagerおよびJP1/AJS3 - Agentのバージョンが12-50以降の場合に指定できます。

「""」を指定した場合，デフォルト値の「n」が仮定されます。

y

拡張モードを使用します。送信情報ファイル名（URLパラメーター）および送信情報ファイル名（メッセージボディ）の内容をHTTPリクエストとして送信します。

n

拡張モードを使用しません。送信情報ファイル名の内容をHTTPリクエストとして送信します。

このオプションに「y」を指定した場合，送信情報ファイル名の定義は初期化されます。また，このオプションに「y」を指定して，同時に-HSオプションを指定しても，無視されます。

このオプションに「n」を指定した場合，送信情報ファイル名（URLパラメーター）および送信情報ファイル名（メッセージボディ）の定義は初期化されます。また，このオプションに「n」を指定して，同時に-HUおよび-HMオプションを指定しても，無視されます。

-HS 送信情報ファイル名

送信情報ファイル名を変更します。JP1/AJS3 - ManagerおよびJP1/AJS3 - Agentのバージョンが12-10以前の場合，または拡張モードを使用しない場合に指定できます。

指定できる文字数は，1〜511（単位：バイト）です。

ファイル名は絶対パスで指定します。

「""」を指定した場合，この項目は未定義となります。

-HEオプションと同時に指定する場合，-HEオプションに「n」を指定する必要があります。変更前の「拡張モード」の定義値が「n」の場合は，-HEオプションを省略できます。変更前の「拡張モード」の定義値が「y」の場合に-HEオプションを省略すると，-HSオプションの指定は無視されます。

-HU 送信情報ファイル名（URLパラメーター）

送信情報ファイル名（URLパラメーター）を変更します。JP1/AJS3 - ManagerおよびJP1/AJS3 - Agentのバージョンが12-50以降で，拡張モードを使用する場合に指定できます。

指定できる文字数は，1〜511（単位：バイト）です。

ファイル名は絶対パスで指定します。

「""」を指定した場合，この項目は未定義となります。

-HEオプションと同時に指定する場合，-HEオプションに「y」を指定する必要があります。変更前の「拡張モード」の定義値が「y」の場合は，-HEオプションを省略できます。変更前の「拡張モード」の定義値が「n」の場合に-HEオプションを省略すると，-HUオプションの指定は無視されます。

-HM 送信情報ファイル名（メッセージボディ）

送信情報ファイル名（メッセージボディ）を変更します。JP1/AJS3 - ManagerおよびJP1/AJS3 - Agentのバージョンが12-50以降で，拡張モードを使用する場合に指定できます。

指定できる文字数は，1〜511（単位：バイト）です。

ファイル名は絶対パスで指定します。

「""」を指定した場合，この項目は未定義となります。

-HEオプションと同時に指定する場合，-HEオプションに「y」を指定する必要があります。変更前の「拡張モード」の定義値が「y」の場合は，-HEオプションを省略できます。変更前の「拡張モード」の定義値が「n」の場合に-HEオプションを省略すると，-HMオプションの指定は無視されます。

-HT ステータス格納ファイル名

ステータス格納ファイル名を変更します。

指定できる文字数は，1〜511（単位：バイト）です。

ファイル名は絶対パスで指定します。

-HD {diff|same}

受信データ格納方式を変更します。

diff

受信データのヘッダー部分を受信ヘッダー格納ファイルに，ボディ部分を受信ボディ格納ファイルに記述します。

same

受信データのヘッダー部分とボディ部分を分けずに，受信ヘッダー格納ファイルだけに記述します。

「""」を指定した場合，デフォルト値の「diff」が仮定されます。

「same」を指定した場合，「-HB 受信ボディ格納ファイル名」に指定されている値は無視されます。

-HH 受信ヘッダー格納ファイル名

受信ヘッダー格納ファイル名を変更します。

指定できる文字数は，1〜511（単位：バイト）です。

ファイル名は絶対パスで指定します。

-HB 受信ボディ格納ファイル名

受信ボディ格納ファイル名を変更します。

指定できる文字数は，1〜511（単位：バイト）です。

ファイル名は絶対パスで指定します。

「-HD {diff|same}」オプションで「same」を指定した場合，このオプション設定は無視されます。

-HR 終了コード1:HTTPステータスコード1[,HTTPステータスコード2...];

HTTPステータスコードごとのジョブの終了コードを指定します。

このオプションは，複数指定できます。複数のジョブの終了コードを指定する場合は，「-HR 終了コード1:HTTPステータスコード1 -HR 終了コード2:HTTPステータスコード2」のように指定してください。

指定できる文字数は，1〜511（単位：バイト）です。指定できるジョブの終了コードの値は0〜9です。指定できるHTTPステータスコードの値は100〜999です。指定できる文字列は，0〜9（アラビア数字），「:（コロン）」です。

「""」を指定した場合，この項目は未定義となります。

判定ジョブ情報変更オプション

判定ジョブの定義情報を変更します。

-ej {gt|ge|lt|le|eq|ne|ri|ro|ef|nf|vgt|vge|vlt|vle|veq|vne|vri|vro|sce|spe|sne|spn|snn|snl}

判定方法を変更します。

gt

先行ジョブの終了コードが判定値より大きいことを示します。

ge

先行ジョブの終了コードが判定値以上であることを示します。

lt

先行ジョブの終了コードが判定値より小さいことを示します。

le

先行ジョブの終了コードが判定値以下であることを示します。

eq

先行ジョブの終了コードが判定値と等しいことを示します。

ne

先行ジョブの終了コードが判定値と異なることを示します。

ri

先行ジョブの終了コードが判定値の範囲内であることを示します。同時に下限の判定終了コード（-elオプション）および上限の判定終了コード（-ehオプション）の指定が必要です。必要に応じて境界条件（-lP，-uPオプション）も指定してください。

ro

先行ジョブの終了コードが判定値の範囲外であることを示します。同時に下限の判定終了コード（-elオプション）および上限の判定終了コード（-ehオプション）の指定が必要です。必要に応じて境界条件（-lP，-uPオプション）も指定してください。

ef

ファイルが作成されていることを示します。

nf

ファイルが作成されていないことを示します。

vgt

指定された変数の値が判定値（数値）より大きいことを示します。

vge

指定された変数の値が判定値（数値）以上であることを示します。

vlt

指定された変数の値が判定値（数値）より小さいことを示します。

vle

指定された変数の値が判定値（数値）以下であることを示します。

veq

指定された変数の値が判定値（数値）と等しいことを示します。

vne

指定された変数の値が判定値（数値）と異なることを示します。

vri

指定された変数の値が判定値（数値）の範囲内であることを示します。同時に下限の変数判定数値（-jSオプション）および上限の変数判定数値（-jGオプション）の指定が必要です。必要に応じて境界条件（-lP，-uPオプション）も指定してください。

vro

指定された変数の値が判定値（数値）の範囲外であることを示します。同時に下限の変数判定数値（-jSオプション）および上限の変数判定数値（-jGオプション）の指定が必要です。必要に応じて境界条件（-lP，-uPオプション）も指定してください。

sce

指定された変数の値が判定値（文字列）と等しいことを示します。

spe

指定された変数の値が判定値（文字列）を含むことを示します。

sne

指定された変数の値が判定値（文字列）と異なることを示します。

spn

指定された変数の値が判定値（文字列）を含まないことを示します。同時に変数名（-jVオプション）および変数の判定文字列（-jTオプション）の指定が必要です。

snn

指定された変数の値があることを示します。

snl

指定された変数の値がないことを示します。

-ec 判定終了コード

判定の対象となる終了コードを変更します。

指定できる値は，0〜4,294,967,295です。

-el 下限の判定終了コード

判定の対象となる下限の終了コードを変更します。

指定できる値は，0〜4,294,967,295です。下限の判定終了コード（-elオプション）と境界条件（-lPオプション），および上限の判定終了コード（-ehオプション）と境界条件（-uPオプション）から，終了コードを判定する範囲内に整数値が存在しない場合，エラーとなります。

終了コードが判定値の範囲内または範囲外（-ejオプションにviまたはroを指定）の場合に有効になります。

終了コードが負数の場合，符号なしに換算した値を指定することで判定できます。例えば，「-1」はWindowsでは「4,294,967,295」，UNIXでは「255」として扱われます。ただし，終了コードの負数を符号なしに換算すると「2,147,483,648」から「4,294,967,295」の範囲となるため，終了コードが「0」をまたがる場合は範囲指定できません。

-eh 上限の判定終了コード

判定の対象となる上限の終了コードを変更します。

指定できる値は，0〜4,294,967,295です。下限の判定終了コード（-elオプション）と境界条件（-lPオプション），および上限の判定終了コード（-ehオプション）と境界条件（-uPオプション）から，終了コードを判定する範囲内に整数値が存在しない場合，エラーとなります。

終了コードが判定値の範囲内または範囲外（-ejオプションにviまたはroを指定）の場合に有効になります。

終了コードが負数の場合，符号なしに換算した値を指定することで判定できます。例えば，「-1」はWindowsでは「4,294,967,295」，UNIXでは「255」として扱われます。ただし，終了コードの負数を符号なしに換算すると「2,147,483,648」から「4,294,967,295」の範囲となるため，終了コードが「0」をまたがる場合は範囲指定できません。

-ef 終了判定ファイル名

判定の対象となるファイル名を変更します。

指定できる文字数は，1〜260（単位：バイト）です。

-jV 変数名

判定の対象となる変数名を変更します。

指定できる文字数は，「?AJS2xxxxx?」の形式で1〜64（単位：バイト）です。xxxxxの部分に指定できるのは，英大文字，数字，「.（ピリオド）」だけです。

-jT 変数の判定文字列

変数との判定対象とする文字列を変更します。

指定できる文字数は，1〜511（単位：バイト）です。

-jI 変数の判定数値

変数との判定対象とする数値を変更します。

指定できる値は，0〜2,147,483,647です。

-jS 下限の変数判定数値

変数との判定対象とする下限の数値を変更します。

指定できる値は，0〜2,147,483,647です。下限の変数判定数値（-jSオプション）と境界条件（-lPオプション），および上限の変数判定数値（-jGオプション）と境界条件（-uPオプション）から，変数判定数値を判定する範囲内に整数値が存在しない場合，エラーとなります。

変数の値が判定値（数値）の範囲内または範囲外（-ejオプションにvriまたはvroを指定）の場合に有効になります。

-jG 上限の変数判定数値

変数との判定対象とする下限の数値を変更します。

指定できる値は，0〜2,147,483,647です。下限の変数判定数値（-jSオプション）と境界条件（-lPオプション），および上限の変数判定数値（-jGオプション）と境界条件（-uPオプション）から，変数判定数値を判定する範囲内に整数値が存在しない場合，エラーとなります。

変数の値が判定値（数値）の範囲内または範囲外（-ejオプションにvriまたはvroを指定）の場合に有効になります。

-lP {gt|ge}

下限の判定終了コード（-elオプション）または下限の変数の判定数値（-jSオプション）の境界条件を定義します。

gt

先行ジョブの終了コードまたは変数の判定値（数値）が，判定値より大きいことを示します。

ge

先行ジョブの終了コードまたは変数の判定値（数値）が，判定値以上であることを示します。

-uP {lt|le}

上限の判定終了コード（-ehオプション）または上限の変数の判定数値（-jGオプション）の境界条件を定義します。

lt

先行ジョブの終了コードまたは変数の判定値（数値）が，判定値より小さいことを示します。

le

先行ジョブの終了コードまたは変数の判定値（数値）が，判定値以下であることを示します。

JP1イベント受信監視ジョブ情報変更オプション

JP1イベント受信監視ジョブの定義情報を変更します。

-jp マクロ変数指定

マクロ変数の指定を変更します。

「-jp マクロ変数名:引き継ぎ情報名」の形式で同時に複数指定できます。ただし，同一マクロ変数名を複数指定した場合，最初に指定したマクロ変数の引き継ぎ情報だけが引き継がれます。

マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

全体で指定できる文字数は，最大2,048バイト（-jpオプションに指定された値を，ajsprint -aオプションで出力される「jpoif=?AJS2xxxxx?:引き継ぎ情報名;」形式に変換したあとのバイト数の合計が2,048以内）です。

引き継ぎ情報名に指定できる文字列を次に示します。

CMTMOUT：ジョブが打ち切り終了したかどうか

EVID：イベントID

EVUSR：イベント発行元ユーザー名

EVGRP：イベント発行元グループ名

EVHOST：発行元イベントサーバ名

EVIPADDR：イベント発行元IPアドレス

EVMSG：メッセージ情報

EVDETAIL：イベント詳細情報

EVSEV：拡張属性の重大度

EV:拡張属性名：任意の拡張属性

EVENV1〜EVENV9：切り出したデータ

EVUSRID：イベント発行元ユーザーID

EVGRPID：イベント発行元グループID

EVPROCESSID：イベント発行元プロセスID

EVDATE：イベント発行年月日

EVTIME：イベント発行時間

-EI 監視イベントID

監視イベントIDを変更します。

指定できる値は，16進数の値で，00000000:00000000〜FFFFFFFF:FFFFFFFFです。

-EU イベント発行元ユーザー名

イベント発行元ユーザー名を変更します。

指定できる文字数は，1〜20（単位：バイト）です。

-EG イベント発行元グループ名

イベント発行元グループ名を変更します。

指定できる文字数は，1〜20（単位：バイト）です。

-EH イベント発行元ホスト名

イベント発行元ホスト名を変更します。

指定できる文字数は，1〜255（単位：バイト）です。

-Ei イベント発行元IPアドレス

イベント発行元IPアドレスを変更します。

指定できる値は，「XXX.YYY.xxx.yyy」の形式で，0.0.0.0〜255.255.255.255です。なお，「XXX」「YYY」「xxx」「yyy」に指定できる値は，それぞれ0〜255です。

-EM イベントメッセージ情報

イベントメッセージ情報を変更します。

指定できる文字数または正規表現は，1〜1,024（単位：バイト）です。

-ED イベント詳細情報

イベント詳細情報を変更します。

指定できる文字数または正規表現は，1〜1,024（単位：バイト）です。

-ES イベント拡張属性重大度

イベント拡張属性の重大度を変更します。

指定できる文字列を次に示します。重大度は複数指定できます（「-ES em:al」のように，「:」で区切って指定します）。

em：「Emergency」を一致条件とします。

al：「Alert」を一致条件とします。

cr：「Critical」を一致条件とします。

er：「Error」を一致条件とします。

wr：「Warning」を一致条件とします。

no：「Notice」を一致条件とします。

in：「Information」を一致条件とします。

db：「Debug」を一致条件とします。

-EF 任意のイベント拡張属性

任意のイベント拡張属性を変更します。

「-EF "任意のイベント拡張属性名:¥"値¥""」の形式で同時に複数指定できます。

値中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#¥"」，「#」は「##」と指定します。

全体で指定できる文字数は，最大2,048（-EFオプションに指定された値を，ajsprint -aオプションで出力される「evwfr=任意のイベント拡張属性名:"値";」の形式に変換したあとのバイト数の合計が2,048以内）です。

-ET 終了判定条件

終了判定条件を変更します。

指定できる文字列を次に示します。

n：常に正常終了とします。

a：常に異常終了とします。

n:ファイル名：メッセージが指定したファイルの内容と一致する場合に正常終了とします。

a:ファイル名：メッセージが指定したファイルの内容と一致する場合に異常終了とします。

d:ファイル名：詳細情報が指定したファイルの内容と一致する場合に正常終了とします。

b:ファイル名：詳細情報が指定したファイルの内容と一致する場合に異常終了とします。

ファイル名に指定できる文字数は，1〜256（単位：バイト）です。

-Eu イベント発行元ユーザーID

イベント発行元ユーザーIDを変更します。

指定できる値は，−1〜9,999,999,999です。

-Eg イベント発行元グループID

イベント発行元グループIDを変更します。

指定できる値は，−1〜9,999,999,999です。

-Ep イベント発行元プロセスID

イベント発行元プロセスIDを変更します。

指定できる値は，−1〜9,999,999,999です。

-Ee {no|分}

JP1イベント受信監視ジョブが実行された直後（JP1イベントの監視を始める前）に，それ以前に発生したJP1イベントを受信監視の対象とするかどうかを指定します。

no

過去のJP1イベントを検索しません。

分

JP1イベント受信監視ジョブが実行された時刻から指定された時間だけさかのぼった時刻以降のJP1イベントを検索します。指定できる値は，10進数の値で，1〜720（単位：分）です。

分を指定する場合，-EIオプションで監視イベントIDを指定しておく必要があります。

監視イベントIDが指定されていない場合に分を指定するときは，同時に-EIオプションで監視イベントIDを指定してください。

ファイル監視ジョブ情報変更オプション

ファイル監視ジョブの定義情報を変更します。

-jp マクロ変数指定

マクロ変数の指定を変更します。

「-jp マクロ変数名:引き継ぎ情報名」の形式で同時に複数指定できます。ただし，同一マクロ変数名を複数指定した場合，最初に指定したマクロ変数の引き継ぎ情報だけが引き継がれます。

マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

全体で指定できる文字数は，最大2,048バイト（-jpオプションに指定された値を，ajsprint -aオプションで出力される「jpoif=?AJS2xxxxx?:引き継ぎ情報名;」形式に変換したあとのバイト数の合計が2,048以内）です。

引き継ぎ情報名に指定できる文字列を次に示します。

CMTMOUT：ジョブが打ち切り終了したかどうか

FLFNAME：変更があったファイルの完全名

FLCOND：成立条件パラメーター

FLCTIME：ファイル更新時刻

FLSIZE：変更があったファイルのサイズ

-FF 監視対象ファイル名

監視対象のファイル名を変更します。

指定できる文字数は，1〜255（単位：バイト）です。ファイル名は，完全名または総称名で指定します。ただし，-FIオプションに監視間隔として1〜9を指定する場合，ファイル名は総称名では指定できません。

-FC 監視条件

監視条件を変更します。

指定できる文字を次に示します。条件は複数指定できます（「-FC c:d」のように，「:」で区切って指定します）。ただし，sとmは同時に指定できません。

c：ファイルの作成を監視します。

d：ファイルの削除を監視します。

s：ファイルのサイズ変更を監視します。

m：ファイルの最終書き込み時刻変更を監視します。

-FOオプションを指定する場合は，cを指定してください。

cを指定して，-FOオプションを省略した場合，ファイル監視ジョブを実行したあとに，監視対象ファイルの作成を監視します。

cを削除した場合，ファイルの作成を監視しません。

-FI 監視間隔

ファイル監視の時間間隔を変更します。

指定できる値は，1〜600（単位：秒）です。ただし，-FFオプションに監視対象ファイル名を総称名で指定する場合，監視間隔に1〜9は指定できません。

-FO 監視対象ファイルがある場合の扱い

ファイル監視ジョブ実行時に，監視対象ファイルがある場合の扱いを変更します。このオプションは，監視条件に「ファイルの作成を監視する」が指定されている場合にだけ指定できます。

指定できる文字を次に示します。

y：監視条件成立とし，正常終了します。

n：監視対象ファイルの監視を続けます。

メール受信監視ジョブ情報変更オプション

メール受信監視ジョブの定義情報を変更します。

-jp マクロ変数指定

マクロ変数の指定を変更します。

「-jp マクロ変数名:引き継ぎ情報名」の形式で同時に複数指定できます。ただし，同一マクロ変数名を複数指定した場合，最初に指定したマクロ変数の引き継ぎ情報だけが引き継がれます。

マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

全体で指定できる文字数は，最大2,048バイト（-jpオプションに指定された値を，ajsprint -aオプションで出力される「jpoif=?AJS2xxxxx?:引き継ぎ情報名;」形式に変換したあとのバイト数の合計が2,048以内）です。

引き継ぎ情報名に指定できる文字列を次に示します。

CMTMOUT：ジョブが打ち切り終了したかどうか

MLRCVADDRESS：メールの差し出し人のアドレス※

MLRCVSUBJECT：メールの件名

MLRCVBODY：メールの本文を保存したファイル名

MLRCVATTACHFILEnn（nnは01〜20の値）：メールに添付されていた添付ファイル名

MLRCVATTACHLIST：メールに添付されていたファイル一覧のファイル名

MLRCVMAILBODY：メール

MLRCVTIME：メールの到着時間

注※

Windowsの場合，表示名（ニックネーム）を引き継ぐこともできます。

表示名を引き継ぐ場合は，環境設定パラメーターNextAddressにNicknameを設定してください。詳細については，マニュアル「JP1/Automatic Job Management System 3 連携ガイド　2.3.4 メールシステム連携のための環境設定をする」を参照してください。

-pf プラットフォーム種別

メール受信定義のプラットフォーム種別を変更します。

指定できる文字を次に示します。

u：UNIX上で定義します。

p：Windows上で定義します。

-MA 送信者

受信したメールの送信者を変更します。

指定できる文字数は，1〜256（単位：バイト）です。

「-MA 送信者」の形式で，20件まで同時に指定できます。

-ML メール受信リスト名

メール受信リスト名を変更します。

指定できる文字数は，1〜255（単位：バイト）です。

-MP プロファイル名

プロファイル名を変更します。

指定できる文字数は，1〜256（単位：バイト）です。

-Ms メールの保存

受信したメールの保存方法を変更します。

指定できる文字を次に示します。

y：保存します。

n：保存しません。

-MS 件名

受信したメールの件名を変更します。

指定できる文字数は，1〜256（単位：バイト）です。

「-MS 件名」の形式で，20個まで同時に指定できます。

-MF 添付ファイル保存先フォルダ名

受信したメールの添付ファイルの保存先のフォルダ名を変更します。

指定できる文字数は，1〜256（単位：バイト）です。

-mf 添付ファイルのリストファイル名

添付ファイルのリストファイル名を変更します。

指定できる文字数は，1〜256（単位：バイト）です。リストファイル名はフルパスで指定します。

-Mt 本文保存先ファイル名

受信したメール本文の保存先ファイル名を変更します。

指定できる文字数は，1〜256（単位：バイト）です。ファイル名はフルパスで指定します。

-MT 本文

受信したメール本文を変更します。

指定できる文字数は，1〜512（単位：バイト）です。

「-MT 本文」の形式で，20個まで同時に指定できます。

メッセージキュー受信監視ジョブ情報変更オプション

メッセージキュー受信監視ジョブの定義情報を変更します。

-jp マクロ変数指定

マクロ変数の指定を変更します。

「-jp マクロ変数名:引き継ぎ情報名」の形式で同時に複数指定できます。ただし，同一マクロ変数名を複数指定した場合，最初に指定したマクロ変数の引き継ぎ情報だけが引き継がれます。

マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

全体で指定できる文字数は，最大2,048バイト（-jpオプションに指定された値を，ajsprint -aオプションで出力される「jpoif=?AJS2xxxxx?:引き継ぎ情報名;」形式に変換したあとのバイト数の合計が2,048以内）です。

引き継ぎ情報名に指定できる文字列を次に示します。

CMTMOUT：ジョブが打ち切り終了したかどうか

MQRCVCORRELATION：メッセージの相関識別子

MQRCVDISCRIMINATION：メッセージのメッセージ識別子

MQRCVQUEUE：メッセージ受信キュー名

MQRCVMODELQUEUE：モデルキュー名

MQRCVMESSAGEFILE：メッセージ構造体格納ファイル名

-QC 相関識別子

受信したメッセージの相関識別子を変更します。

指定できる文字数は，1〜24（単位：バイト）です。ただし，指定できる文字は，英（大文字だけ）数字だけです。

-QD メッセージ識別子

受信したメッセージのメッセージ識別子を変更します。

指定できる文字数は，1〜24（単位：バイト）です。ただし，指定できる文字は，英（大文字だけ）数字だけです。

-QM モデルキュー名

メッセージ受信を監視するキューのモデルキュー名を変更します。

指定できる文字数は，1〜48（単位：バイト）です。キュー名はMQ文字列で指定します。

-QQ メッセージ受信キュー名

メッセージ受信を監視するキュー名を変更します。

指定できる文字数は，1〜48（単位：バイト）です。キュー名はMQ文字列で指定します。

-QS メッセージ格納ファイル名

メッセージ格納ファイル名を変更します。

指定できる文字数は，1〜256（単位：バイト）です。

MSMQ受信監視ジョブ情報変更オプション

MSMQ受信監視ジョブの定義情報を変更します。

-jp マクロ変数指定

マクロ変数の指定を変更します。

「-jp マクロ変数名:引き継ぎ情報名」の形式で同時に複数指定できます。ただし，同一マクロ変数名を複数指定した場合，最初に指定したマクロ変数の引き継ぎ情報だけが引き継がれます。

マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

全体で指定できる文字数は，最大2,048バイト（-jpオプションに指定された値を，ajsprint -aオプションで出力される「jpoif=?AJS2xxxxx?:引き継ぎ情報名;」形式に変換したあとのバイト数の合計が2,048以内）です。

引き継ぎ情報名に指定できる文字列を次に示します。

CMTMOUT：ジョブが打ち切り終了したかどうか

MSRCVQUEUEPATH：メッセージのキューパス名

MSRCVMUTUAL：メッセージの相互関係

MSRCVMESSAGELABEL：メッセージラベル

MSRCVAPPLICATION：メッセージのアプリケーション情報

MSRCVMESSAGEFILE：メッセージ構造体格納ファイル名

-SA アプリケーション情報

監視するメッセージのアプリケーション情報を変更します。

指定できる文字数は，16進数の値で，0〜FFFFFFFFです。

-SM メッセージラベル

監視するメッセージのメッセージラベルを変更します。

指定できる文字数は，1〜249（単位：バイト）です。

-SQ キューパス名

メッセージを監視するキューのキューパス名を変更します。

指定できる文字数は，1〜259（単位：バイト）です。

-SR メッセージ相互関係

監視するメッセージの相互関係を変更します。

指定できる文字数は，1〜20（単位：バイト）です。ただし，指定できるのは，英（大文字だけ）数字だけです。

-SF メッセージ格納ファイル名

メッセージ格納ファイル名を変更します。

指定できる文字数は，1〜256（単位：バイト）です。ファイル名はフルパスで指定します。

ログファイル監視ジョブ情報変更オプション

ログファイル監視ジョブの定義情報を変更します。

-jp マクロ変数指定

マクロ変数の指定を変更します。

「-jp マクロ変数名:引き継ぎ情報名」の形式で同時に複数指定できます。ただし，同一マクロ変数名を複数指定した場合，最初に指定したマクロ変数の引き継ぎ情報だけが引き継がれます。

マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

全体で指定できる文字数は，最大2,048バイト（-jpオプションに指定された値を，ajsprint -aオプションで出力される「jpoif=?AJS2xxxxx?:引き継ぎ情報名;」形式に変換したあとのバイト数の合計が2,048以内）です。

引き継ぎ情報名に指定できる文字列を次に示します。

CMTMOUT：ジョブが打ち切り終了したかどうか

LFFNAME：トラップしたログファイル名

LFDATA：トラップしたデータ

-Lw ファイル作成待ちオプション

ログファイル監視ジョブ開始時のファイル作成待ちオプションを変更します。

指定できる文字を次に示します。

y：ログファイルがない場合，エラーとします。

n：ログファイルが作成されるまで，ファイルのオープンを繰り返します。

-Ld ログファイルの出力ファイル形式

ログファイルの出力ファイル形式を変更します。

指定できる文字列を次に示します。

s：シーケンシャルファイル（デフォルト。一つのログファイルに追加書き込みし続け，ログファイルが一定の容量に達すると，別のファイル名で新たにログファイルを作成して書き込むファイル）

s2：シーケンシャルファイル（ファイル名を変更して保存，またはファイルをいったん削除したあと，同じ名称のファイルを作成して新たにログを書き込むファイル）

ジョブの実行先ホストがWindowsの場合は，JP1/Baseが08-10以降で，JP1/AJS3，またはJP1/AJS2 08-00以降のときに指定できます。

UNIXの場合は，JP1/Baseが07-00以降で，JP1/AJS3，またはJP1/AJS2 07-00以降のときに指定できます。

w1：ラップアラウンド（ログファイルが一定の容量に達すると，ラップアラウンドして再び先頭からデータを上書きする形式のファイル）

w2：ラップアラウンド（ログファイルが一定の容量に達してラップアラウンドするとき，データを削除して再び先頭からデータを書き込む形式のファイル）

-LF ログファイル名

監視するログファイル名を変更します。

指定できる文字数は，1〜256（単位：バイト）です。

「-LF "ログファイル名"」の形式で，8件まで同時に指定できます。

-LL ヘッダー指定

ヘッダーを変更します。

指定できる文字を次に示します。

l:ヘッダー行数：ヘッダーの行数を変更します。指定できる値は，0〜99,999（単位：行）です。

s:ヘッダーサイズ：ヘッダーのサイズを変更します。指定できる値は，9,999,999（単位：バイト）です。

-LM ログ情報以外のデータ

ログ情報以外のデータを変更します。

「-LM "[!]¥"ログ情報以外のデータ¥""」の形式で同時に複数指定できます。

データ中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#¥"」，「#」は「##」と指定します。

全体で指定できる文字数は，最大1,024バイト（-LMオプションに指定した値を，ajsprint -aオプションで出力される「lfmks=[!]"ログ情報以外のデータ1"[:[!]"ログ情報以外のデータ2"...];」の形式に変換したあとのバイト数の合計が1,024以内）です。

-LX イベントデータの最大長

イベントデータの最大長を変更します。

指定できる値は，2〜512（単位：バイト）です。

-LR ログデータのレコード形式

トラップするログデータのレコード形式を変更します。

指定できる文字を次に示します。

v:'[¥]区切り文字'：可変長レコードで行を区切ります。区切り文字に指定できる文字数は，1（単位：バイト）です。

f:レコード長：固定長レコードで行を区切ります。レコード長に指定できる文字数は，1〜9,999,999（単位：バイト）です。

-LI ログファイル検索間隔

ログファイル検索の時間間隔を変更します。

指定できる値は，1〜86,400（単位：秒）です。

-Ls 検索開始オプション

検索開始オプションを変更します。

指定できる文字を次に示します。

y：先頭データから入力します。

n：先頭データから入力しません。

-LD トラップデータ

トラップするデータを変更します。

「-LD "[!]¥"トラップデータ¥""」の形式で同時に複数指定できます。

トラップデータ中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#¥"」，「#」は「##」と指定します。

全体で指定できる文字数は，最大2,048バイト（-LDオプションに指定された値を，ajsprint -aオプションで出力される「lftpd=[!]"トラップデータ1"[:[!]"トラップデータ2"...];」の形式に変換したあとのバイト数の合計が2,048以内）です。

Windowsイベントログ監視ジョブ情報変更オプション

Windowsイベントログ監視ジョブの定義情報を変更します。

-jp マクロ変数指定

マクロ変数の指定を変更します。

「-jp マクロ変数名:引き継ぎ情報名」の形式で同時に複数指定できます。ただし，同一マクロ変数名を複数指定した場合，最初に指定したマクロ変数の引き継ぎ情報だけが引き継がれます。

マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

全体で指定できる文字数は，最大2,048バイト（-jpオプションに指定された値を，ajsprint -aオプションで出力される「jpoif=?AJS2xxxxx?:引き継ぎ情報名;」形式に変換したあとのバイト数の合計が2,048以内）です。

引き継ぎ情報名に指定できる文字列を次に示します。

CMTMOUT：ジョブが打ち切り終了したかどうか

NELOG：ログ種別

NEEVKIND：イベントの種類

NESOURCE：ソース

NECLASS：分類

NEEVID：イベントID

NEDETAIL：説明

-NJ イベント分類の判定条件

イベント分類の判定条件を変更します。

指定できる文字を次に示します。

y：指定した分類を監視対象にします。

n：指定した分類以外の分類を監視対象にします。

-NC 分類

監視するイベントの分類を変更します。

指定できる文字数は，1〜255（単位：バイト）です。

-ND 説明

イベントの詳細説明を監視する場合の，比較対象となる説明を変更します。

指定できる文字数は，1〜1,024（単位：バイト）です。

-Ni イベントIDの判定条件

イベントIDの判定条件を変更します。

指定できる文字を次に示します。

y：指定したイベントIDを監視対象にします。

n：指定したイベントID以外のイベントIDを監視対象にします。

-NI イベントID

監視するイベントのイベントIDを変更します。

指定できる値は，0〜4,294,967,295です。

-NE イベントの種類

イベントの種類を変更します。

指定できる文字を次に示します。種類は複数指定できます（「-NE i:w:e」のように，「:」で区切って指定します）。

v：詳細イベントを監視します。

i：情報イベントを監視します。

w：警告イベントを監視します。

e：エラーイベントを監視します。

c：重大イベントを監視します。

s：成功の監査イベントを監視します。

f：失敗の監査イベントを監視します。

-NL ログ種別

ログ種別を変更します。

指定できる文字列を次に示します。

sys：システムログを監視します。

sec：セキュリティログを監視します。

app：アプリケーションログを監視します。

dns：DNS Serverログを監視します。

dir：Directory Serviceログを監視します。

frs：ファイル複製サービスログを監視します。

oth：-Ntオプションに指定したログ種別を監視します。

othを指定した場合，同時に-Ntオプションを指定する必要があります。othを指定している状態からoth以外に変更した場合，-Ntオプションに指定した値は削除されます。

-Nt 任意のログ種別

監視対象とする，任意のログ種別を変更します。

指定できる文字数は，1〜255（単位：バイト）です。

-NLオプションにothを指定していない場合，エラーになります。

-Ns ソースの判定条件

ソースの判定条件を変更します。

指定できる文字を次に示します。

y：指定したソースを監視対象にします。

n：指定したソース以外のソースを監視対象にします。

-NS ソース

監視するソースを変更します。

指定できる文字数は，1〜255（単位：バイト）です。

実行間隔制御ジョブ情報変更オプション

実行間隔制御ジョブの定義情報を変更します。

-jp マクロ変数指定

マクロ変数の指定を変更します。

「-jp マクロ変数名:引き継ぎ情報名」の形式で同時に複数指定できます。ただし，同一マクロ変数名を複数指定した場合，最初に指定したマクロ変数の引き継ぎ情報だけが引き継がれます。

マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

全体で指定できる文字数は，最大2,048バイト（-jpオプションに指定された値を，ajsprint -aオプションで出力される「jpoif=?AJS2xxxxx?:引き継ぎ情報名;」形式に変換したあとのバイト数の合計が2,048以内）です。

引き継ぎ情報名に指定できる文字列を次に示します。

CMTMOUT：ジョブが打ち切り終了したかどうか

-Tw 待ち時間

待ち時間を変更します。

指定できる値は，1〜1,440（単位：分）です。

-eT {y|n}

実行間隔制御ジョブを起動条件として定義した場合，開始直後に満了させるかどうかを指定します。

y：開始直後に満了して，すぐに最初の実行を開始する。

n：開始直後には満了しないで，待ち時間に指定した時間を待ってから，最初の実行を開始する。

起動条件ではなく，通常のジョブネットに定義された実行間隔制御ジョブでは，-eTオプションは指定できません。指定した場合，メッセージKAVS0159-Wが出力され，オプション指定を無効としてコマンドの処理が続行されます。

JP1イベント送信ジョブ情報変更オプション

JP1イベント送信ジョブの定義情報を変更します。

-pf プラットフォーム種別

プラットフォーム種別を変更します。

指定できる文字を次に示します。

u：UNIX環境で実行します。

p：Windows環境で実行します。

-EH イベント送信先ホスト名

イベント送信先ホスト名を変更します。

指定できる文字数は，1〜255（単位：バイト）です。

-eM メッセージ

イベントに付加するメッセージを変更します。

指定できる文字数は，1〜1,023（単位：バイト）です。

-eI 送信イベントID

送信するイベントのイベントIDを変更します。

指定できる値は，16進数の値で，00000000〜00001FFF，7FFF8000〜7FFFFFFFです。

-eS イベント拡張属性重大度

イベント拡張属性の重大度を変更します。

指定できる文字列を次に示します。

em：「Emergency」を指定します。

al：「Alert」を指定します。

cr：「Critical」を指定します。

er：「Error」を指定します。

wr：「Warning」を指定します。

no：「Notice」を指定します。

in：「Information」を指定します。

db：「Debug」を指定します。

-Ef 任意のイベント拡張属性

イベントに付加された拡張属性を変更します。

「-Ef "任意の拡張属性名:¥"値¥""」の形式で指定します。

指定できる文字数は，「evsfr=任意の拡張属性名:"値";」の形式で，バイト数の合計が128バイトまでです。

値中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#¥"」，「#」は「##」と指定します。

-eK {y|n}

イベント到達確認をするかどうかを指定します。

指定できる文字を次に示します。

n：到達確認を行いません。

y：到達確認を行います。

-eP イベント到達確認間隔

JP1イベントが到達していなかった場合，到達確認を行う間隔を指定します。

ユニット定義でイベント到達確認を行わない指定がされている場合に，到達確認を行う指定に変更したい場合は，-eK yオプションと同時に指定してください。

-eK nオプションと同時には指定できません。

指定できる値は，10進数の値で，3〜600（単位：秒）です。

-eR イベント到達確認回数

JP1イベントが到達していなかった場合，到達確認を行う回数を指定します。

ユニット定義でイベント到達確認を行わない指定がされている場合に，到達確認を行う指定に変更したい場合は，-eK yオプションと同時に指定してください。

-eK nオプションと同時には指定できません。

指定できる値は，10進数の値で，0〜999（単位：回）です。

-jt {q|n}

キューイング属性の種別を変更します。

q：キューイング属性あり。

n：キューイング属性なし。

メール送信ジョブ情報変更オプション

メール送信ジョブの定義情報を変更します。

-pf プラットフォーム種別

プラットフォーム種別を変更します。

指定できる文字を次に示します。

p：Windows環境で実行します。

u：UNIX環境で実行します。

-MA メールアドレス

送信するメールのアドレスを変更します。

指定できる文字列を次に示します。

to:メールアドレス：メールを宛先に送信します。

cc:メールアドレス：メールのコピーを宛先に送信します。

bcc:メールアドレス：メールをブラインドカーボンコピーで宛先に送信します。

なお，「メールアドレス」に指定できる文字数は，1〜256（単位：バイト）です。「-MA メールアドレス」の形式で，20個まで同時に指定できます。

-MP プロファイル名

プロファイル名を変更します。

指定できる文字数は，1〜256（単位：バイト）です。

-MS 件名

送信するメールの件名を変更します。

指定できる文字数は，1〜256（単位：バイト）です。

-mF 添付ファイル名

送信するメールの添付ファイル名を変更します。

指定できる文字数は，1〜256（単位：バイト）です。「-mF "添付ファイル名"」の形式で，20件まで同時に指定できます。ファイル名はフルパスで指定します。

-mf 添付ファイルのリストファイル名

添付ファイルのリストファイル名を変更します。

指定できる文字数は，1〜256（単位：バイト）です。リストファイル名はフルパスで指定します。

-MT 本文

送信するメールの本文を変更します。

指定できる文字数は，1〜512（単位：バイト）です。

-mt 本文ファイル名

送信するメールの本文ファイル名を変更します。

指定できる文字数は，1〜256（単位：バイト）です。ファイル名はフルパスで指定します。

-jt {q|n}

キューイング属性の種別を変更します。

q：キューイング属性あり。

n：キューイング属性なし。

メッセージキュー送信ジョブ情報変更オプション

メッセージキュー送信ジョブの定義情報を変更します。

-pf プラットフォーム種別

プラットフォーム種別を変更します。

指定できる文字を次に示します。

p：Windows環境で実行します。

u：UNIX環境で実行します。

-QC 相関識別子

送信するメッセージに付加する相関識別子を変更します。

指定できる文字数は，1〜24（単位：バイト）です。ただし，指定できるのは，英（大文字だけ）数字だけです。

-QD メッセージ識別子

送信するメッセージに付加するメッセージ識別子を変更します。

指定できる文字数は，1〜24（単位：バイト）です。ただし，指定できるのは，英（大文字だけ）数字だけです。

-qE デッドレターキュー名

デッドレターキュー名を変更します。

指定できる文字数は，1〜48（単位：バイト）です。デッドレターキュー名はMQ文字列で指定します。

-qH 保持時間

送信するメッセージの保持時間を変更します。

指定できる値は，1〜9,999,999（単位：分）です。

-QM モデルキュー名

モデルキュー名を変更します。

指定できる文字数は，1〜48（単位：バイト）です。キュー名はMQ文字列で指定します。

-qd メッセージデータファイル名

メッセージデータファイル名を変更します。

指定できる文字数は，1〜256（単位：バイト）です。

-qF メッセージフォーマット名

メッセージフォーマット名を変更します。

指定できる文字数は，1〜8（単位：バイト）です。ただし，指定できるのは，英（大文字だけ）数字だけです。

-qM キューマネージャー名

メッセージを送信するキューマネージャー名を変更します。

指定できる文字数は，1〜48（単位：バイト）です。キューマネージャー名はMQ文字列で指定します。

-qp 接続キュー管理プログラム名

接続キュー管理プログラム名を変更します。

指定できる文字数は，1〜48（単位：バイト）です。プログラム名はMQ文字列で指定します。

-qR 優先度

送信するメッセージの優先度を変更します。

指定できる値は，0〜9です。

-qP 永続性

送信するメッセージの永続性を変更します。

指定できる文字を次に示します。

y：永続性あり。

n：永続性なし。

-QQ キュー名

メッセージを送信するキュー名を変更します。

指定できる文字数は，1〜48（単位：バイト）です。キュー名はMQ文字列で指定します。

-jt {q|n}

キューイング属性の種別を変更します。

q：キューイング属性あり。

n：キューイング属性なし。

MSMQ送信ジョブ情報変更オプション

MSMQ送信ジョブの定義情報を変更します。

-SA アプリケーション情報

送信するメッセージのアプリケーション情報を変更します。

指定できる値は，16進数の値で，0〜FFFFFFFFです。

-SH 保持時間

送信するメッセージの保持時間を変更します。

指定できる値を次に示します。

-1：INFINITE

n：0〜2,147,483,647（単位：秒）の値

-sJ メッセージのジャーナルキューへの格納指定

送信済みメッセージの，ジャーナルキューへの格納指定を変更します。

指定できる文字を次に示します。

y：ジャーナルキューに格納します。

n：ジャーナルキューに格納しません。

-SM メッセージラベル

送信するメッセージのメッセージラベルを変更します。

指定できる文字数は，1〜249（単位：バイト）です。

-sL 配信制限時間

送信するメッセージの配信制限時間を変更します。

指定できる値を次に示します。

-2：LONG_LIVED

-1：INFINITE

n：0〜2,147,483,647（単位：秒）の値

-sM 配信モード

送信メッセージの配信モードを変更します。

指定できる文字を次に示します。

h：高速モードで配信します。

r：回復可能モードで配信します。

-sP 優先順位

送信メッセージの優先順位を変更します。

指定できる値は，0〜7です。

-sl キューラベル名

メッセージ送信先のキューラベル名を変更します。

指定できる文字数は，1〜124（単位：バイト）です。

-SQ キューパス名

メッセージ送信先のキューパス名を変更します。

指定できる文字数は，1〜259（単位：バイト）です。

-SR 相互関係

送信するメッセージの相互関係を変更します。

指定できる文字数は，1〜20（単位：バイト）です。ただし，指定できる文字は，英（大文字だけ）数字だけです。

-sF 本文ファイル名

送信するメッセージの本文ファイル名を変更します。

指定できる文字数は，1〜259（単位：バイト）です。ファイル名はフルパスで指定します。

-sT 本文タイプ

送信するメッセージの，本文の内容の型を変更します。

指定できる値は，16進数の値で，0〜FFFFFFFFです。

-sU メッセージのデッドレターキューへの格納指定

送信済みメッセージの，デッドレターキューへの格納指定を変更します。

指定できる文字を次に示します。

y：デッドレターキューに格納します。

n：デッドレターキューに格納しません。

-jt {q|n}

キューイング属性の種別を変更します。

q：キューイング属性あり。

n：キューイング属性なし。

JP1/Cm2状態通知ジョブ情報変更オプション

JP1/Cm2状態通知ジョブの定義情報を変更します。

-pf プラットフォーム種別

プラットフォーム種別を変更します。

指定できる文字を次に示します。

p：Windows環境で実行します。

u：UNIX環境で実行します。

-CI HP NNM通知するメッセージ付加情報

HP NNMに通知するメッセージの付加情報を変更します。

指定できる文字数は，1〜256（単位：バイト）です。

-CC HP NNMに通知する状態

HP NNMに通知する状態を変更します。

指定できる文字列を次に示します。

un：Unknown

no：Normal

wa：Warning

mi：Minor

ma：Major

cr：Critical

re：Restricted

te：Testing

di：Disabled

-jt {q|n}

キューイング属性の種別を変更します。

q：キューイング属性あり。

n：キューイング属性なし。

ローカル電源制御ジョブ情報変更オプション

ローカル電源制御ジョブの定義情報を変更します。

-pf プラットフォーム種別

プラットフォーム種別を変更します。

指定できる文字を次に示します。

p：Windows環境で実行します。

u：UNIX環境で実行します。

-PT 電源制御種別

電源制御種別を変更します。

指定できる文字を次に示します。

f：電源をオフします。

r：シャットダウン後，再起動します。

s：シャットダウンします。

-Pf シャットダウン種別

シャットダウン種別を変更します。

指定できる文字を次に示します。

m：監視終了します。

r：制限終了します。

f：強制終了します。

p：計画終了します。

-jt {q|n}

キューイング属性の種別を変更します。

q：キューイング属性あり。

n：キューイング属性なし。

リモート電源制御ジョブ情報変更オプション

リモート電源制御ジョブの定義情報を変更します。

-pf プラットフォーム種別

プラットフォーム種別を変更します。

指定できる文字を次に示します。

p：Windows環境で実行します。

u：UNIX環境で実行します。

-PH 電源制御対象ホスト名

電源制御の対象とする，JP1/Power Monitorのエージェントホスト名を変更します。

指定できる文字数は，1〜255（単位：バイト）です。

-PF 電源制御種別

JP1/Power Monitorのエージェントホストの，電源制御種別を変更します。

指定できる文字を次に示します。

o：電源をオンします。

m：監視終了します。

r：制限終了します。

f：強制終了します。

p：計画終了します。

s：強制停止します。

-PN 次回電源オン時刻の設定

JP1/Power Monitorのエージェントホストの，次回電源オン時刻の設定を変更します。

指定できる文字および値を次に示します。

n：次回電源オン時刻を指定しません。

a：JP1/Power Monitorのエージェントホストに設定されている，次回電源オン時刻を有効にします。

c:[MM/DD.]hh:mm：「c:[MM/DD.]hh:mm」の形式で指定します。指定できる値を次に示します。

MM：1〜12（単位：月）

DD：1〜31（単位：日）

hh：0〜23（単位：時）

mm：0〜59（単位：分）

-PR 再起動

JP1/Power Monitorのエージェントホストのシャットダウン後の，再起動の設定を変更します。

指定できる文字を次に示します。

y：再起動します。

n：再起動しません。

-PW 電源オフの終了待ち

JP1/Power Monitorのエージェントホストの電源オフの終了まで，リモート電源制御ジョブの完了を待つかどうかの設定を変更します。

指定できる文字を次に示します。

y：電源オフの終了を待ちます。

n：電源オフの終了を待ちません。

電源オフの終了とは，エージェントホスト上のJP1/Power Monitorがシャットダウンの開始をJP1/Power Monitorのマネージャーホストに報告することを指します。

-PP 電源制御対象ホストのプラットフォーム種別

リモート電源制御ジョブを実行するホストのプラットフォーム種別を変更します。

指定できる文字を次に示します。

p：Windows環境で実行します。

u：UNIX環境で実行します。

-jt {q|n}

キューイング属性の種別を変更します。

q：キューイング属性あり。

n：キューイング属性なし。

カスタムイベントジョブ情報変更オプション

カスタムイベントジョブの定義情報を変更します。

-jp マクロ変数指定

マクロ変数の指定を変更します。

「-jp マクロ変数名:引き継ぎ情報名」の形式で同時に複数指定できます。ただし，同一マクロ変数名を複数指定した場合，最初に指定したマクロ変数の引き継ぎ情報だけが引き継がれます。

マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

全体で指定できる文字数は，最大2,048バイト（-jpオプションに指定された値を，ajsprint -aオプションで出力される「jpoif=?AJS2xxxxx?:引き継ぎ情報名;」形式に変換したあとのバイト数の合計が2,048以内）です。

引き継ぎ情報名に指定できる文字列を次に示します。

CMTMOUT：ジョブが打ち切り終了したかどうか

OBJECT01〜OBJECT10：連携プログラムが設定する値

-cp 定義パラメーター

カスタムイベントジョブのユニット定義パラメーターを「任意の指定項目名=値」形式で変更します。

指定できる文字数は，2〜20,479（単位：バイト）です。複数同時に指定した場合，指定した入力値すべての文字数の合計が，最大「20,479から-cpオプションの指定数を引き，1を足した値（単位：バイト）」です。例えば，-cpオプションを一つのユニットに同時に5個指定した場合，値として指定できる文字数の合計は最大「20479-5+1=20475」（単位：バイト）です。

注意事項

ジョブの定義内容を変更できるのは，次のどちらかのユーザーです。

そのジョブを定義したときに，またはその属性を変更したときに，更新権限を与えられたユーザー。

Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザー。

ただし，環境設定パラメーターADMACLIMITをデフォルトから変更して「yes」を設定している場合は，Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザーであっても，更新権限が必要です。

ジョブネットを実行している間には，このコマンドを実行しないことを推奨します（操作対象のジョブが他で使用中の場合，このコマンドは異常終了します。また，このコマンドでジョブの定義内容を変更している間は，JP1/AJS3 - Viewでジョブを操作・更新したり，操作中のジョブを実行したりできません）。

実行登録されているジョブネットのジョブの定義内容を変更する場合は，あらかじめジョブネットの実行登録を解除しておくことを推奨します。ジョブネットの実行登録解除には，ajsleaveコマンドを使ってください。

ユニットに不適切なオプションを指定した場合，このコマンドは異常終了します。

リリース登録されているルートジョブネット（リリース先ジョブネット）を指定して変更した場合は，「適用中」状態のジョブネット定義配下のジョブの定義が変更されます。

戻り値

0

正常終了。

4〜124で4の倍数値

異常終了。

補足事項

次のオプションについて各情報を未定義（デフォルトの状態）にするためには，オプションに対する値として「""」を指定してください。

ジョブ共通情報変更オプション

UNIX／PC／QUEUEジョブ情報変更オプション

判定ジョブ情報変更オプション

JP1イベント受信監視ジョブ情報変更オプション

ファイル監視ジョブ情報変更オプション

メール受信監視ジョブ情報変更オプション

メッセージキュー受信監視ジョブ情報変更オプション

MSMQ受信監視ジョブ情報変更オプション

ログファイル監視ジョブ情報変更オプション

Windowsイベントログ監視ジョブ情報変更オプション

実行間隔制御ジョブ情報変更オプション

JP1イベント送信ジョブ情報変更オプション

メール送信ジョブ情報変更オプション

メッセージキュー送信ジョブ情報変更オプション

MSMQ送信ジョブ情報変更オプション

JP1/Cm2状態通知ジョブ情報変更オプション

ローカル電源制御ジョブ情報変更オプション

リモート電源制御ジョブ情報変更オプション

使用例1

ジョブ（net1/job1）の標準出力ファイルを，/dev/nullに変更します。

ajschgjob -so /dev/null /net1/job1

使用例2

判定ジョブ（net1/jdg1）の判定条件を，「終了コードが0以上10未満」に変更します。

ajschgjob -ej ri -el 0 -lP ge -eh 10 -uP lt /net1/jdg1

ajschgnet

形式

ajschgnet
     [-F サービス名]
     [スケジュール情報変更オプション]
     [関連情報変更オプション]
     [起動条件情報変更オプション]
     [ジョブネットコネクタ情報変更オプション]
     [-S]
     [-R]
     [-L|-E]
     [-T]
     [-N]
     ジョブネット名，起動条件ユニット名，またはジョブグループ名...

機能

ジョブネットの定義内容（スケジュール定義），および起動条件ユニットの定義内容を変更します。

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Editor権限

引数

-F サービス名

処理対象とする，スケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

-S

ジョブネットがサスペンド状態の場合，実行登録済みのジョブネットであっても，ジョブネットやジョブの実行順序を変更できるようにします。

-R

指定したジョブネット，またはジョブグループに含まれる，すべてのジョブネットの定義内容を変更します。

このオプションを，-L，-E，-T，-Nオプションと同時に指定した場合，各オプションの指定内容に従って定義内容を変更します。

-L

実行登録していないジョブネットの定義内容を変更します。

このオプションを，-T，-Nオプションと同時に指定した場合，実行登録していないジョブネットについて，各オプションの指定内容に従って定義内容を変更します。-Eオプションと同時には指定できません。

-E

実行登録済みジョブネットの定義内容を変更します。

このオプションを，-T，-Nオプションと同時に指定した場合，実行登録済みジョブネットについて，各オプションの指定内容に従って定義内容を変更します。-Lオプションと同時には指定できません。

-T

ルートジョブネットの定義内容を変更します。

このオプションを，-E，-Lオプションと同時に指定した場合，各オプションの指定内容に従って，ルートジョブネットの定義内容を変更します。-Nオプションと同時に指定した場合，-Nオプションは無効になります。

-N

ジョブネットの定義内容を変更します。

このオプションを，-E，-Lオプションと同時に指定した場合，各オプションの指定内容に従って，ジョブネットの定義内容を変更します。-Tオプションと同時に指定した場合，このオプションは無効になります。

ジョブネット名，起動条件ユニット名，またはジョブグループ名

定義内容を変更するジョブネット名，起動条件ユニット名，または-R，-L，-E，-T，-Nオプションと同時にジョブネット名，起動条件ユニット名，またはジョブグループ名を完全名で指定します。

指定できる文字数は，1〜930（単位：バイト）です。

ジョブネット名，またはジョブグループ名は，複数指定できます。

なお，ジョブネット名，またはジョブグループ名に，論理ホスト名を指定できます。実行IDは指定できません。

スケジュール情報変更オプション

ジョブネットに定義されたスケジュールを変更します（スケジュールを変更した場合，コマンドの実行終了時にスケジュールが再計算されます）。

-DD ジョブグループ名

カレンダー情報を変更する場合に，使用したいカレンダー情報が定義されているジョブグループ名を指定します。

指定できる文字数は，1〜930（単位：バイト）です。

-dd [N,]{[[年/]月/]{[+|*|@]日|[+|*|@]b[-日]|[+]{sun|su|mon|mo|tue|tu|wed|we|thu|th|fri|fr|sat|sa}[:{n |b}]}|en|ud|undefine}

ジョブネットの実行開始日を変更します。

144個まで同時に指定できます。

すべて未定義にする場合は，「-dd 0, ud」または「-dd 0, undefine」を指定します。

N

ジョブネットの実行開始日時を複数定義している場合に，対応するルール番号を指定します。

指定できる値は，0〜144です。

省略した場合，ルール番号として1が仮定されます（ルール番号が1であるスケジュールを変更すると仮定されます）。

年

実行開始日の西暦年を指定します。

指定できる値は，1994〜環境設定パラメーターSCHEDULELIMITの値（単位：西暦年）です。環境設定パラメーターSCHEDULELIMITの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2(123) SCHEDULELIMIT」を参照してください。

省略した場合，ジョブネットを実行登録した年が仮定されます。

月

実行開始日の月を指定します。

指定できる値は，1〜12（単位：月）です。

省略した場合，ジョブネットを実行登録した月が仮定されます。

+

実行開始日を，基準日からの相対日数で指定します。

*

実行開始日を，基準日から運用日だけの日数で指定します。

@

実行開始日を，基準日から休業日だけの日数で指定します。

日

実行開始日を指定します。

指定できる値を次に示します。

絶対日指定の場合

年月日指定：1〜指定年月の最終日（単位：日）です。

月日指定：1〜指定月の最終日（単位：日）です。ただし，2月の場合は，1〜29です。

日指定：1〜31（単位：日）です。

相対日，運用日，休業日指定の場合

1〜35（単位：日）です。

「+（相対日）」，「*（運用日）」，「@（休業日）」を省略した場合，ジョブネットを実行登録した月の絶対日が仮定されます。

b

その月の最終日をジョブネットの開始日にします。

-日

月末から何日前を，ジョブネットの実行開始日にするかを指定します。

指定できる値を次に示します。

絶対日指定の場合

年月日指定：0〜指定年月の最終日−1（単位：日）です。

月日指定：0〜指定月の最終日−1（単位：日）です。ただし，2月の場合は，0〜28です。

日指定：0〜30（単位：日）です。

相対日，運用日，休業日指定の場合

0〜34（単位：日）です。

「+（相対日）」，「*（運用日）」，「@（休業日）」と同時に指定できます。

sun|su|mon|mo|tue|tu|wed|we|thu|th|fri|fr|sat|sa

日曜，月曜，火曜，水曜，木曜，金曜，または土曜をジョブネットの実行開始日に指定します。

n

月初めを基準に何週目の曜日かを指定します。

指定できる値は，1〜5（単位：週）です。

省略した場合，実行登録操作をした日，およびajsscheduleコマンドの実行操作をした日から次の曜日を開始日として扱います。なお，開始年月の［年］または［月］のどちらかを指定している場合に，この指定を省略すると，実行登録操作時，およびajsscheduleコマンド実行時に第1週が仮定されます。

en

定義済みの実行開始日をジョブネットの実行登録日に変更します。

ud|undefine

ジョブネットのスケジュールをすべて未定義にします。

このオプションを指定する場合，「N（ジョブネットのルール番号）」の値に0を指定してください。

また，このオプションを指定すると，-dd，-tt，-VV，-WW，-KK，-yy，-ss，-hh，-wt，-wc，-ct，-cc，-ceオプションは無効になります。

-tt [N,][+]時:分

ジョブネットの実行開始時刻を変更します。

144個まで同時に指定できます。

N

ジョブネットの実行開始日時を複数定義している場合に，対応するルール番号を指定します。

指定できる値は，1〜144です。

省略した場合，ルール番号として1が仮定されます（ルール番号が1であるスケジュールを変更すると仮定されます）。

+

「時：分」で指定する時刻を相対時刻として扱います。

省略した場合，指定する時刻が絶対時刻として扱われます。

時:分

ジョブネットの開始時刻を指定します。

時に指定できる値は，0〜47（単位：時）です。

分に指定できる値は，0〜59（単位：分）です。

-VV [N,]{時:分|M分|U分|C分}

ジョブネットの開始遅延時刻を変更します。

144個まで同時に指定できます。

N

ジョブネットの開始遅延日時を複数定義している場合に，対応するルール番号を指定します。

指定できる値は，1〜144です。

省略した場合，ルール番号として1が仮定されます（ルール番号が1であるスケジュールを変更すると仮定されます）。

時:分

絶対時刻で指定します。

時に指定できる値は，0〜47（単位：時）です。

分に指定できる値は，0〜59（単位：分）です。

M分

ルートジョブネットの実行開始時刻からの相対分で指定します。

指定できる値は，1〜2,879（単位：分）です。

U分

上位ジョブネットの実行開始時刻からの相対分で指定します。

指定できる値は，1〜2,879（単位：分）です。

C分

自ジョブネットの実行開始時刻からの相対分で指定します。

指定できる値は，1〜2,879（単位：分）です。

-WW [N,]{時:分|M分|U分|C分}

ジョブネットの終了遅延時刻を変更します。

144個まで同時に指定できます。

N

ジョブネットの終了遅延時刻を複数定義している場合に，対応するルール番号を指定します。

指定できる値は，1〜144です。

省略した場合，ルール番号として1が仮定されます（ルール番号が1であるスケジュールを変更すると仮定されます）。

時:分

絶対時刻で指定します。

時に指定できる値は，0〜47（単位：時）です。

分に指定できる値は，0〜59（単位：分）です。

M分

ルートジョブネットの実行開始時刻からの相対分で指定します。

指定できる値は，1〜2,879（単位：分）です。

U分

上位ジョブネットの実行開始時刻からの相対分で指定します。

指定できる値は，1〜2,879（単位：分）です。

C分

自ジョブネットの実行開始時刻からの相対分で指定します。

指定できる値は，1〜2,879（単位：分）です。

-KK [N,]リンクするルール番号

スケジュールを複数定義している場合に，上位ジョブネットのルール番号にリンクするルール番号を変更します。

144個まで同時に指定できます。ルートジョブネットには指定できません。

N

ジョブネットのスケジュールのルール番号を指定します。

指定できる値は，1〜144です。

省略した場合，ルール番号として1が仮定されます（ルール番号が1であるスケジュールを変更すると仮定されます）。

リンクするルール番号

上位ジョブネットの，どのルール番号と対応するかを指定します。

-yy [N,] 処理サイクル数,{y|m|w|d}

ジョブネットの処理サイクルを変更します。

144個まで同時に指定できます。

N

対応するジョブネットのルール番号を指定します。

指定できる値は，1〜144です。

省略した場合，ルール番号として1が仮定されます（ルール番号が1であるスケジュールを変更すると仮定されます）。

処理サイクル数,{y|m|w|d}

処理サイクルの数と処理サイクルの単位を変更します（例えば，6か月ごとに処理したい場合は，「-yy 6,m」と指定します）。

y

年の単位で処理します。処理サイクル数に指定できる値は，1〜9（単位：年）です。

m

月の単位で処理します。処理サイクル数に指定できる値は，1〜12（単位：月）です。

w

週の単位で処理します。処理サイクル数に指定できる値は，1〜5（単位：週）です。

実行開始日を運用日，または休業日で定義している場合は，指定できません。指定した場合，1週を7運用日，または7休業日としてスケジュールが算出されますが，日単位で指定することを推奨します（例えば，「1,w」の代わりに，「7,d」と指定することを推奨します）。

d

日の単位で処理します。処理サイクル数に指定できる値は，1〜31（単位：日）です。

-ss [N,]{af|be|no|ca}

ジョブネットの実行予定日がJP1/AJS3のカレンダー上で休業日であった場合の，実行日の振り替え方法を変更します。

144個まで同時に指定できます。

N

対応するジョブネットのルール番号を指定します。

指定できる値は，1〜144です。

省略した場合，ルール番号として1が仮定されます（ルール番号が1であるスケジュールを変更すると仮定されます）。

af

実行予定日よりあとの日に振り替えて，ジョブネットを実行します。

be

実行予定日より前の日に振り替えて，ジョブネットを実行します。

no

スケジューラーサービスが起動している場合に限り，実行予定日が休業日であってもジョブネットを強制的に実行します。

ca

実行予定日が休業日の場合，ジョブネットを実行しません。

-hh [N,] 振り替え猶予日数

-ssオプションに「af（実行予定日よりあとの日に振り替え）」，または「be（実行予定日よりも前に振り替え）」を指定した場合に，実行日を振り替える期間を指定します。

144個まで同時に指定できます。

N

ジョブネットのルール番号を指定します。

指定できる値は，1〜144です。

省略した場合，ルール番号として1が仮定されます（ルール番号が1であるスケジュールを変更すると仮定されます）。

振り替え猶予日数

指定できる値は，1〜31（単位：日）です（例えば，実行予定日を含めて5日の間，1日ずつあとの日方向に実行日を見つけるように指定したい場合は，「-ss af -hh 5」と指定します）。

-wt [N,]{no|時:分|相対分|un}

ジョブネットがイベント待ち状態になってから，イベント待ち状態を解除するまでの時間を変更します。

144個まで同時に指定できます。

-wcオプションにnoを指定した場合，このオプションに指定できるのはnoだけです。

N

対応するジョブネットのルール番号を指定します。

指定できる値は，1〜144です。

省略した場合，ルール番号として1が仮定されます（ルール番号が1であるスケジュールを変更すると仮定されます）。

no

起動条件を使用しません。

時:分

待ち時間を絶対時刻で指定します。

時に指定できる値は，0〜47（単位：時）です。

分に指定できる値は，0〜59（単位：分）です。

相対分

ジョブネットの実行開始予定時刻からの相対分で指定します。

指定できる値は，1〜2,879（単位：分）です。

un

待ち時間を無制限にします。

-wc [N,]{no|イベント待ち有効回数|un}

イベント起動ジョブネットの実行終了後，再度イベントを待つ回数を変更します。

144個まで同時に指定できます。

-wtオプションにnoを指定した場合，このオプションに指定できるのはnoだけです。

N

対応するジョブネットのルール番号を指定します。

指定できる値は，1〜144です。

省略した場合，ルール番号として1が仮定されます（ルール番号が1であるスケジュールを変更すると仮定されます）。

no

起動条件を使用しません。

イベント待ち有効回数

イベントを待つ回数を指定します。

指定できる値は，1〜999（単位：回）です。

un

待ち回数を無制限にします。

-pp 年/月/日

ジョブネットの実行有効期日を変更します。

年

期日の西暦年を指定します。

指定できる値は，1994〜環境設定パラメーターSCHEDULELIMITの値（単位：西暦年）です。環境設定パラメーターSCHEDULELIMITの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2(123) SCHEDULELIMIT」を参照してください。

月

期日の月を指定します。

指定できる値は，1〜12（単位：月）です。

日

期日の日を指定します。

指定できる値は，1〜31（単位：日）です。

-ll 保存世代数

ジョブネットの実行結果を保存する世代数を変更します。

指定できる値は，1〜99（単位：世代）です。ただし，システム設定オプションを有効にしておくと，最大999（単位：世代）まで拡張できます。

ルートジョブネットだけに指定できます。

-nn 優先順位の値

ジョブネットの実行優先順位を変更します。

指定できる値は，1〜5です。

優先順位がいちばん低いのが1，いちばん高いのが5です。

-bb{y|w|a|n}

ジョブネットの保留属性を変更します。ネストジョブネットにwまたはaを指定した場合，nが仮定されます。

y

ジョブネットの実行を保留します。

w

前回のジョブネットの終了結果が警告終了，または異常終了の場合に保留します。

a

前回のジョブネットの終了結果が異常終了の場合に保留します。

n

ジョブネットの実行を保留しません。

-ej 排他ジョブネット名

同じ日に実行させたくないジョブネット名（同一階層上のジョブネット名）を変更します。

指定できる文字数は，1〜30（単位：バイト）です。

自ジョブネット名は指定できません。

-ct [N,]{no|be|af|db|da}

ジョブネットの起算方法を変更します。

144個まで同時に指定できます。

N

対応するジョブネットのルール番号を指定します。

指定できる値は，1〜144です。

省略した場合，ルール番号として1が仮定されます（ルール番号が1であるスケジュールを変更すると仮定されます）。

no

起算しません。

同一のルール番号を対象に，このオプションと同時に-ccオプション（起算日数の指定）または-ceオプション（起算猶予日数の指定）を指定すると，メッセージKAVS0159-Wが出力され，-ccオプションまたは-ceオプションの指定値は無視されます。

be

-ssオプションに指定した振り替え日を起点とし，実行予定日を前日以前の運用日に振り替えます。

af

-ssオプションに指定した振り替え日を起点とし，実行日を翌日以降の運用日に振り替えます。

db

-ssオプションに指定した振り替え日を起点とし，実行日を前日以前に振り替えます。このオプションの場合，休業日も振り替えの対象になります。

同一のルール番号を対象に，このオプションと同時に-ceオプション（起算猶予日数の指定）を指定すると，メッセージKAVS0159-Wが出力され，-ceオプションの指定値は無視されます。

da

-ssオプションに指定した振り替え日を起点とし，実行日を翌日以降に振り替えます。このオプションの場合，休業日も振り替えの対象になります。

同一のルール番号を対象に，このオプションと同時に-ceオプション（起算猶予日数の指定）を指定すると，メッセージKAVS0159-Wが出力され，-ceオプションの指定値は無視されます。

-cc [N,]起算日数

ジョブネットの起算日数を変更します。

144個まで同時に指定できます。

N

対応するジョブネットのルール番号を指定します。

指定できる値は，1〜144です。

省略した場合，ルール番号として1が仮定されます（ルール番号が1であるスケジュールを変更すると仮定されます）。

起算日数

指定できる値は，1〜31（単位：日）です。

-ce [N,]起算猶予日数

ジョブネットの起算猶予日数を変更します。

144個まで同時に指定できます。

N

対応するジョブネットのルール番号を指定します。

指定できる値は，1〜144です。

省略した場合，ルール番号として1が仮定されます（ルール番号が1であるスケジュールを変更すると仮定されます）。

起算猶予日数

指定できる値は，1〜31（単位：日）です。

-cd {no|un|n}

イベント起動待ちや，実行待ち状態などの待ち状態を打ち切る日数を変更します。ルートジョブネットだけに指定できます。

no

打ち切る日数の設定を解除します。

設定を解除すると，打ち切るまでの時間はシステムオプションに設定された値が有効になります。

un

打ち切らず無制限に待ち続けます。

n

打ち切り日数を指定します。

指定できる値は，1〜2（単位：日）です。

-de {y|n}

上位ジョブネットのスケジュールとの依存関係を変更します。

ルートジョブネットには指定できません。

y

上位ジョブネットのスケジュールに依存します。スケジュールルールの変更とは同時に指定できません。

n

上位ジョブネットのスケジュールに依存しません。

-ms {sch|mlt}

ジョブネットを多重起動する場合のスケジューリング方式を変更します。

ルートジョブネットだけに指定できます。

sch

スケジュールスキップ方式で起動します。

mlt

多重スケジュール方式で起動します。

-mp {y|n}

ジョブネットの多重起動に関する設定を変更します。ルートジョブネットだけに指定できます。

y

多重起動を許可します。

n

多重起動を禁止します。

-ah リモートジョブネット実行エージェントホスト名

リモートジョブネット実行エージェントホスト名を変更します。

指定できる文字数は，1〜255（単位：バイト）です。

-ex ジョブ実行エージェントホスト名

ジョブ実行エージェントホスト名を変更します。

指定できる文字数は，1〜255（単位：バイト）です。

-fd 実行所要時間

終了遅延監視するジョブネットまたはリモートジョブネットの実行所要時間を変更します。

指定できる値は，1〜2,879（単位：分）です。

関連情報変更オプション

ジョブネットやジョブの実行順序関係を変更します。ジョブネットにだけ指定できます。

-AAオプション（関連設定オプション）と-BBオプション（関連解除オプション）は，それぞれ20個まで同時に指定できます。

-AA 先行ユニット名，後続ユニット名 [,{seq|con}]

関連設定する（ユニットを関連づける）場合に，先行ユニット名，および後続ユニット名を指定します。さらに，接続種別を指定します。

先行ユニット名および後続ユニット名に指定できる文字数は，それぞれ1〜30（単位：バイト）です。

関連設定の対象となる先行ユニットおよび後続ユニットに対して，関連線がすでに設定されている場合，コマンドは戻り値0で正常終了します。

seq

順接続します。

con

判定ジョブと従属ユニットとを判定接続します。

なお，次の場合は関連設定できません。

先行ユニット名と後続ユニット名に同じユニット名を指定する場合。

先行ユニット名または後続ユニット名に指定したユニットがない場合。

先行ユニット名にリカバリーユニットを指定して，後続ユニット名に通常のユニットを指定する場合。

すでに関連設定されているユニットに対して，関連を逆に設定する場合。

同一の先行・後続ユニットに対して関連設定と関連設定解除を同時に指定する場合。

ジョブグループ，マネージャージョブグループ，マネージャージョブネット，およびルートジョブネットを指定する場合。

後続ユニットが判定ジョブの場合に，先行ユニットが二つ以上になる場合。

後続ユニットがORジョブの場合に，先行ユニットがイベントジョブまたはカスタムイベントジョブ以外の場合。

判定接続の場合に，先行ユニットに判定ジョブ以外のユニットを指定する場合。

判定ジョブと従属ユニットの判定接続が1対1にならない場合。

先行ユニット名，または後続ユニット名に起動条件ユニット名を指定した場合。

後続ユニットがリカバリー判定ジョブの場合に，先行ユニットがリカバリーユニットではない場合。

-BB 先行ユニット名，後続ユニット名

関連解除する（ユニットの関連づけを解除する）場合に，先行ユニット名，および後続ユニット名を指定します。

指定できる文字数は，それぞれ1〜30（単位：バイト）です。

関連解除の対象となる先行ユニットおよび後続ユニットに対して，関連線が存在しない場合，コマンドは戻り値0で正常終了します。

起動条件情報変更オプション

起動条件の属性を変更します。

-rc {and|or}

起動条件の成立条件を指定します。

and

条件がすべて成立した時点で，ジョブネットが起動されます。

or

条件の一つが成立した時点で，ジョブネットが起動されます。

-ab {exec|hold|stop}

起動条件付きジョブネットを実行時に，実行世代のジョブネットが異常終了した場合の，それ以降のジョブネットの動作を定義します。

exec

実行世代のジョブネットの実行を開始します。

hold

実行世代のジョブネットの開始を保留します。

stop

起動条件の成立を監視している監視世代のジョブネットを停止します。

-mS {m|w|s}

起動条件の監視開始時に，すでに「監視中」状態の監視世代があった場合の動作を定義します。

m

すでに「監視中」状態である世代とは別に，新たな「監視中」状態の監視世代が生成されます。この場合，1回のイベント発生によって「監視中」状態の世代数分の起動条件が成立するため，注意してください。

w

「監視中」状態の監視世代の終了を待ちます。実行打ち切り時間を設定している場合は，その状態で実行打ち切り時間に到達すると「繰り越し未実行」状態になります。

s

監視開始をスキップして，「繰り越し未実行」状態になります。

-gs {y|n}

ジョブネット（実行世代）を多重起動しないように設定していて，「実行中」状態の実行世代がある場合に起動条件が成立したとき，実行世代を滞留させるかどうかを定義します。

y

繰り越さないで滞留させます。

n

繰り越して滞留させません。

ジョブネットコネクタ情報変更オプション

ジョブネットコネクタの属性を変更します。

-lr 接続先のジョブネット名

ジョブネットコネクタの接続先のジョブネットとなるユニット（ルートジョブネットまたはプランニンググループ）の完全名を指定します。

指定できる文字数は，1〜930（単位：バイト）です。

このオプションは，未登録のジョブネットコネクタにだけ指定できます。

-cx ルートジョブネットの実行順序制御のスケジューラーサービス間連携

ルートジョブネットの実行順序を制御する場合に，スケジューラーサービス間連携させるかどうかを指定します。

このオプションは，未登録のジョブネットコネクタでだけ指定できます。

このオプションの値を「y」から「n」を指定した場合，-chオプション（接続ホスト名），-csオプション（接続サービス名）は未定義状態になります。

y

スケジューラーサービス間連携します。

別のホストまたは別のスケジューラーサービスに定義したジョブネットコネクタと連携します。

n

スケジューラーサービス間連携しません。

同一スケジューラーサービスに定義したジョブネットコネクタとだけ連携します。

-ch 接続ホスト名

接続するジョブネットコネクタが定義されているホストの名称を指定します。指定できる文字数は，1〜255（単位：バイト）です。半角スペース，タブ文字，改行文字は指定できません。

-cxオプション（ルートジョブネットの実行順序制御のスケジューラーサービス間連携）に「y」を指定している場合だけ指定できます。

-cs 接続サービス名

接続するジョブネットコネクタが定義されているスケジューラーサービスの名称を指定します。指定できる文字数は，1〜30（単位：バイト）です。このオプションの値に「""」を指定して，スケジューラーサービス名を定義していない状態（デフォルトの状態）にすることはできません。

-cxオプション（ルートジョブネットの実行順序制御のスケジューラーサービス間連携）に「y」を指定している場合だけ指定できます。

注意事項

ジョブネットの定義内容を変更できるのは，次のどちらかのユーザーです。

そのジョブネットを定義したときに，またはその属性を変更したときに，更新権限を与えられたユーザー。

Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザー。

ただし，環境設定パラメーターADMACLIMITをデフォルトから変更して「yes」を設定している場合は，Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザーであっても，更新権限が必要です。

ジョブネットを実行している間には，このコマンドを実行しないことを推奨します（操作対象のジョブネットが他で使用中の場合，このコマンドは異常終了します。また，このコマンドでジョブネットの定義内容を変更している間は，JP1/AJS3 - Viewでユニットを操作・更新したり，操作中のジョブネットやジョブを実行したりできません）。

実行登録済みのジョブネットの定義内容を変更する場合は，ジョブネットの実行登録をあらかじめ解除しておくことを推奨します。ジョブネットの実行登録解除には，ajsleaveコマンドを使ってください。ただし，操作対象のジョブネットをサスペンド状態にしておき，このコマンドに-Sオプションを指定すれば，ジョブネットの実行登録を解除しなくても，ジョブネットやジョブの実行順序を変更できます。

スケジュールを変更した場合，それ以前に実施した計画一時変更は無効になります。

実行開始日を，変更する日より過去に戻した場合，過去の実行分は無効になります。

関連情報を変更しようとしたジョブネットがサスペンド状態変更処理中の場合，このコマンドは異常終了します。

コマンドを使用してジョブネットを定義する場合，ユニットの実行順序の整合性はチェックしません。

ユニットの実行順序がループするように関連づけたジョブネットは，実行時に「順序不正」でエラーになります。

各情報を未定義（デフォルトの状態）にするには，オプションに対する値に，「""」を指定してください。

-tt，-VV，-WW，-KK，-yy，-ss，-hh，-wt，-wc，-ct，-cc，-ceオプションに，ジョブネットのスケジュール定義にないルール番号を指定してコマンドを実行した場合，コマンドは正常終了しますが，スケジュールは追加されません。スケジュールを追加したい場合は，-ddオプションと同時に指定してください。

リリース登録されているルートジョブネット（リリース先ジョブネット）を変更した場合は，「適用中」状態のジョブネット定義が変更されます。

スケジュール情報の変更は，業務量が少ない時間帯に実行してください。スケジュール情報変更オプションを指定した場合，このコマンドを実行中は，スケジュール情報を変更するジョブネットと同一のスケジューラーサービスに実行登録されているルートジョブネットの実行を抑止するため，業務に影響を及ぼすおそれがあります。ただし，定義を変更する前に「監視中」状態になっている起動条件付きジョブネットは，起動条件が成立すると実行されます。

-ddオプションに2/29を指定する場合は，2/29が存在する年を指定してください。

戻り値

0

正常終了。

4〜124で4の倍数値

異常終了。

補足事項

スケジュール情報変更オプション，関連情報変更オプション，および起動条件情報変更オプションについて各情報を未定義（デフォルトの状態）にするためには，オプションに対する値として「""」を指定してください。

使用例1

ジョブネット（net1）の実行開始日時を，2009年10月の毎週金曜日の17:00（絶対時刻）に変更します。また，処理サイクルを毎週に変更します。

ajschgnet -dd 2009/10/fr -tt 17:00 -yy 1,w net1

使用例2

二つのジョブ（net1/job1とnet1/job2）の関連を設定します（関連づけます）。

ajschgnet -AA job1,job2 net1

使用例3

ジョブネットコネクタ（/net2/netconl）に，ルートジョブネット（/net1）と接続するように接続先のジョブネット名を設定します。

ajschgnet -lr /net1 /net2/netconl

使用例4

ルートジョブネット（/JOBNET1）の起動条件（.CONDITION）を次のように変更します。

起動条件の監視開始時に，すでに「監視中」状態の監視世代があった場合は，監視世代の終了を待つ

ajschgnet -F AJSROOT1 -mS w /JOBNET1/.CONDITION

「実行中」状態の実行世代がある場合に起動条件が成立したときは，繰り越して実行世代を滞留させない

ajschgnet -F AJSROOT1 -gs n /JOBNET1/.CONDITION

ajschgstat

形式

ajschgstat
     [-F サービス名]
     [-t 変更後の状態]
     [-v 変更前の状態]
     [-c 終了コード]
     [-h 実行先ホスト名]
     [-B 実行登録番号]
     [-R]
     [-E]
     [-J]
     [-X {yes|no|auto}]
     ジョブ名，ジョブネット名，またはジョブグループ名...

機能

ジョブの状態，およびジョブネットコネクタの状態を変更します。ジョブの状態を変更する場合は，ジョブ状態変更に伴って，そのジョブが含まれるジョブネットの状態も変更されます。

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Operator権限

引数

-F サービス名

処理対象とする，スケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

-t 変更後の状態

ジョブおよびジョブネットコネクタを，どの状態に変更するかを指定します。このオプションは，判定ジョブには指定できません。

指定できる状態と，その意味を表3-6に示します。

また，変更できる組み合わせ（どの状態から，どの状態に変更できるか）について，ジョブの場合を表3-7に，ジョブネットコネクタの場合を表3-8に示します。

表3‒6　変更後の状態一覧

状態

意味

normal

正常終了

fail

起動失敗

ジョブネットコネクタには指定できません。

warning

警告検出終了

abnormal

異常検出終了

bypass

計画未実行

ジョブネットコネクタには指定できません。

exit

終了コード，およびジョブのしきい値に従った状態変更

正常終了，警告検出終了，異常検出終了のどれかに変更されます。

ORジョブ，イベントジョブ，カスタムイベントジョブ，アクションジョブ，およびジョブネットコネクタには指定できません。

表3‒7　変更できる組み合わせ（ジョブの場合）

変更前

変更後

正常終了

起動失敗

警告検出終了

異常検出終了

計画未実行

先行終了待ち

×

×

×

×

×

保留中

×

×

×

×

×

実行待ち

△

△

△

△

×

キューイング

○

○

○

○

×

実行中

○

×

○

○

×

正常終了

−

○

○

○

○

起動失敗

○

−

○

○

○

警告検出終了

○

○

−

○

○

異常検出終了

○

○

○

−

○

強制終了

○

○

○

○

○

終了状態不明

○

○

○

○

○

未実行終了

○

○

○

○

○

計画未実行

○

○

○

○

−

異常検出実行中

○

×

×

×

×

（凡例）

○：変更できる。

△：キューレスジョブの場合，変更できる。キューレスジョブ以外の場合，変更できない。

×：変更できない。

−：対象外。

表3‒8　変更できる組み合わせ（ジョブネットコネクタの場合）

変更前

変更後

正常終了

警告検出終了

異常検出終了

未計画

×

×

×

先行終了待ち

×

×

×

未実行終了

○

○

○

計画未実行

○

○

○

実行中

○

○

○

警告検出実行中

○

○

○

異常検出実行中

○

○

○

正常終了

−

○

○

警告検出終了

○

−

○

異常検出終了

○

○

−

強制終了

○

○

○

終了状態不明

○

○

○

閉塞

○

○

○

（凡例）

○：変更できる。

×：変更できない。

−：対象外。

-v 変更前の状態

ジョブの現在の状態を指定します。

このオプションに指定したジョブの状態と，現在のジョブの状態が一致する場合に限り，ジョブの状態を変更できます。このオプションは，判定ジョブには指定できません。

指定できる状態と，状態の意味を次の表に示します。

表3‒9　変更前の状態一覧

状態

意味

queuing

キューイング

running

実行中，または異常検出実行中

normal

正常終了

fail

起動失敗

warning

警告検出終了

abnormal

異常検出終了

unknown

終了状態不明

unexec

未実行終了

bypass

計画未実行

abend

起動失敗，異常検出終了，強制終了，終了状態不明，または未実行終了

exec-wait

実行待ち

noend

キューイング，実行中，または異常検出実行中

-c 終了コード

ジョブの終了コードを指定します。

Windowsの場合

指定できる値は，−2,147,483,648〜2,147,483,647です。

UNIXの場合

指定できる値は，0〜255です。

このオプションは，現在のジョブの状態が終了状態である場合，またはジョブの状態を終了状態に変更する場合にだけ有効です（終了状態とは，正常終了，起動失敗，警告検出終了，異常検出終了，終了状態不明，未実行終了，または計画未実行のどれかを指します）。ジョブネットコネクタの状態変更時には指定できません。

このオプションに指定する終了コードの値に従ってジョブの終了結果を設定する場合，-tオプションにexitを指定してください。ただし，判定ジョブには-tオプションを指定できません。終了コードだけ変更できます。

このオプションを省略し，実行中のジョブに対して-tオプションで終了状態を設定した場合は，終了コードとして0が仮定されます。

-h 実行先ホスト名

ジョブの実行先ホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

-B 実行登録番号

状態を変更したいジョブを含むジョブネットの実行登録番号を「YYYYMMDDNNN」の形式で指定します。「YYYYMMDDNNN」の内容を次に示します。

YYYY：実行年

MM：実行月

DD：実行日

NNN：実行年月日の実行登録順序番号

このオプションを省略した場合，操作対象のジョブを含むルートジョブネットの実行登録番号が仮定されます（ルートジョブネットが実行中の場合は，現世代の実行登録番号が仮定されます。実行中でない場合は，履歴情報上の直前世代の実行登録番号が仮定されます）。

実行登録番号の詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　4.5.13 コマンド実行時の世代の指定方法」を参照してください。

-R

指定したユニットに含まれるすべてのジョブの状態またはジョブネットコネクタの状態を変更します。

このオプションを，-E，-Jオプションと同時に指定した場合，各オプションの指定内容に従って，ジョブまたはジョブネットコネクタの状態を変更します。

-E

実行登録済みのジョブネット中のジョブの状態またはジョブネットコネクタの状態を変更します。

-J

ジョブの状態を変更します。

-X {yes|no|auto}

プランニンググループの下にあるユニットの中から，現在運用中のユニットを自動的に選択して操作するかどうかを指定します。ただし，ジョブグループ配下のユニットに対しては，どの値を指定しても自動的に選択しません。また，ルートジョブネット名も省略できません。

yes

自動的に選択して操作する場合に指定します。

コマンドに指定するユニット名は，プランニンググループの下のルートジョブネット名を省略して指定します。

no

自動的に選択して操作しない場合に指定します。

指定したユニットに対して操作します。プランニンググループの下のルートジョブネット名を省略して指定することはできません。

auto

ユニット名の指定方法に従って，自動的に選択して操作するかしないかを決定する場合に指定します。

自動的に選択して操作する場合

プランニンググループの下のルートジョブネット名を省略してユニット名を指定します。

自動的に選択して操作しない場合

プランニンググループの下のルートジョブネット名を省略しないでユニット名を指定します。この場合，指定したユニットが操作対象になります。ただし，プランニンググループの下のルートジョブネット名を省略して指定したパス名と同じ名称のユニットがある場合，省略したものとして扱われ，操作対象のユニットが自動選択されます。

ジョブ名，ジョブネット名，またはジョブグループ名

状態を変更したいジョブ名，または-R，-E，-Jオプションと同時にジョブ名，ジョブネット名，ジョブグループ名を指定します。

指定できる文字数は，1〜930（単位：バイト）です。

ジョブ名，ジョブネット名，またはジョブグループ名は複数指定できます。

なお，ジョブ名に，実行IDを指定できます。ただし，実行IDを指定した場合，-Bオプションは無効になります。実行IDの指定方法については，「1.1 コマンドの記述形式」を参照してください。

論理ホスト名は指定できません。

注意事項

コマンドを実行できるのは，次のどちらかのユーザーです。

状態を変更するユニットに対して，操作権限を与えられたユーザー。

Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザー。

ただし，環境設定パラメーターADMACLIMITをデフォルトから変更して「yes」を設定している場合は，Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザーであっても，操作権限が必要です。

スケジューラーサービスが起動していない場合，このコマンドは異常終了します。

JP1/AJS3 - Viewやajschgstatコマンドで，実行中のジョブを終了状態に変更した場合は，変更した状態に合わせて後続ユニットが実行されます。ただし，異常終了のジョブを正常終了に変更しても，後続ユニットは実行されません。

JP1/AJS3 - Viewやajschgstatコマンドで，実行中のジョブを終了状態に変更した場合は，ジョブ終了のイベントやメッセージ，ログ情報が出力されますが，終了したジョブに対して状態変更を行った場合は，ジョブ終了のイベントやメッセージ，ログ情報は出力されません。

JP1/AJS3 - Viewやajschgstatコマンドで，実行中のジョブを終了状態に変更した場合，実行中であったジョブ自体は継続して実行されています。このとき，エージェント管理制御では，実際にジョブが終了するまでジョブの実行多重度には実行中としてカウントします。

ジョブの状態を変更したあとに，実際のキューイングジョブ数および実行中のジョブ数を確認する場合は，ajsagtshowコマンドおよびjpqagtshowコマンドを使用します。これらのコマンドの詳細については，「3. 通常の運用で使用するコマンド　ajsagtshow」，および「4. 特別な運用で使用するコマンド　jpqagtshow」を参照してください。

リモートジョブネット下のユニットに対しては，操作できません。

状態を変更しようとしたジョブがサスペンド状態の場合，このコマンドは異常終了します。

起動条件に定義したイベントジョブおよびカスタムイベントジョブや判定ジョブの状態は変更できません。

プランニンググループの下にあるユニットの中から操作するユニットを自動的に選択する指定をした場合に，自動的に選択されたユニットに操作権限がないと，エラーになります。

-Xオプションが省略された場合，環境変数AJSAUTOJUDGEの指定値に従って，プランニンググループの下にあるユニットの操作対象が決定されます。

プランニンググループの下にあるユニット名の指定方法については，「3. 通常の運用で使用するコマンド　ajsplan」の「補足事項」を参照してください。

サスペンド状態のジョブネットコネクタに対しては，操作できません。

戻り値

0

正常終了。

4〜124で4の倍数値

異常終了。

使用例

異常検出終了したジョブ（job1）の状態を正常終了に変更します。なお，このジョブは，ルートジョブネット（net1）中にあり，環境変数AJSPATHにジョブグループ名が設定されているものとします（環境変数AJSPATHにジョブグループ名が設定されている場合は，コマンド実行時にジョブグループ名の指定を省略できます）。

ajschgstat -t normal -v abnormal net1/job1

ajschkdef

形式

ajschkdef
     [-F サービス名]
     [{-s|-a}]
     [-O][-M][-C][-P][-H][-D][-U][-A]
     [-p 実行エージェントプロファイル名]
     [-e ユニット属性プロファイル名]
     [-u 登録ユーザー名]
     [-o 出力ファイル名]
     [-R]
     [-L]
     [-T]
     [-N]
     [-J]
     ジョブ名，ジョブネット名，またはジョブグループ名...

機能

定義内容の事前チェックの実行開始，実行状態表示を行います。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

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

UNIXの場合

/opt/jp1ajs2/bin/

引数

-F サービス名

定義内容の事前チェック対象となるユニットが定義されているスケジューラーサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

省略した場合は，環境変数AJSCONFの値が仮定されます。環境変数AJSCONFが設定されていない場合は，デフォルトスケジューラーサービス名が仮定されます。

論理ホストのスケジューラーサービス名を指定する場合は，環境変数JP1_HOSTNAMEに論理ホスト名を指定してください。

環境変数JP1_HOSTNAMEを指定していない場合，自ホスト名が仮定されます。

-s

定義内容の事前チェックの実行を開始します。

-a

定義内容の事前チェックの実行状態を標準出力ファイルに出力します。出力する実行状態の状態名称を次の表に示します。

実行状態

出力する状態名称

意味

未実行

stop

定義内容の事前チェックは実行できる

定義内容の事前チェック結果格納ファイルは更新完了

実行中

run

定義内容の事前チェックは実行できない

定義内容の事前チェック結果格納ファイルは更新中

-O，-M，-C，-P，-H，-D，-U，-A

定義内容の事前チェックでチェックする項目を指定します。

同時に複数のチェック項目を指定することもできます。各オプションのチェック内容，およびチェック順序（チェック順序は，関連線どおりとは限りません）を次の表に示します。

チェック順序

オプション

チェック項目

1

-O

実行順序

2

-M

ジョブネット詳細定義※1

3

-C

実行エージェント制限

4

-P

空ジョブ定義

5

-H

実行エージェント名

6

-U

ユーザーマッピング※2

7

-D

ジョブ詳細定義

8

-A

実行ファイル権限※2

注※1

ジョブネットの場合，ジョブネットコネクタの接続関係，および待ち合わせ条件で設定した待ち合わせ対象ユニットについてもチェックします。ジョブの場合，ジョブネット詳細定義のうち，待ち合わせ条件だけチェックします。

注※2

実行ユーザー固定機能を使用している場合，ユニット属性プロファイルの設定内容に従って，固定されているJP1ユーザーでチェックします。

なお，オプションの指定順に関係なく，上記の表の順にチェックされます。また，-Dオプション（ジョブ詳細定義）または-Aオプション（実行ファイル権限）を指定した場合，ファイルの権限チェックにジョブ実行OSユーザーの情報が必要なため，「ユーザーマッピング」も前提としてチェックされます。また，エージェントでのチェック項目である-Pオプション（空ジョブ定義）以降（チェック順序の4〜8）のオプションを指定した場合，「実行エージェント名」も前提としてチェックされます。

省略した場合は，すべてのオプション（-O，-M，-C，-P，-H，-D，-U，-A）が仮定されます。

各オプションとも，-aオプションと同時には指定できません。

-p 実行エージェントプロファイル名

実行エージェント制限のチェックを行う際に，適用する実行エージェントプロファイルを絶対パスで指定します。

指定できる文字数は，1〜255（単位：バイト）です。

指定するフォルダに空白文字を含む場合は，パスを「"（ダブルクォーテーションマーク）」で囲んでください。

このオプションは，-Cオプションと同時に指定します。-Cオプションを指定して，このオプションを省略した場合，-Fオプションで指定したスケジューラーサービス用の実行エージェントプロファイルが適用されます。

-e ユニット属性プロファイル名

実行ユーザー固定機能のチェックを行う際に，適用するユニット属性プロファイルを絶対パスで指定します。

指定できる文字数は，1〜255（単位：バイト）です。

指定するフォルダに空白文字を含む場合は，パスを「"（ダブルクォーテーションマーク）」で囲んでください。

このオプションは，-U，-D，または-Aオプションと同時に指定します。-Uオプションを指定して，このオプションを省略した場合，-Fオプションで指定したスケジューラーサービス用のユニット属性プロファイルが仮定されます。-Fオプションを省略した場合は，デフォルトスケジューラーサービスのユニット属性プロファイルが仮定されます。

-u 登録ユーザー名

本番運用で実際にジョブネットを実行登録するJP1ユーザーを指定します。

指定できる文字数は，1〜31（単位：バイト）です。

ジョブ定義で実行ユーザー種別が登録ユーザーのときに，指定したJP1ユーザーでユーザーマッピングのチェックを行います。

省略した場合は，このコマンドの実行ユーザーが仮定されます。

このオプションは，-aオプションと同時には指定できません。

-o 出力ファイル名

定義内容の事前チェック結果格納ファイル名を絶対パスで指定します。定義内容の事前チェック結果格納ファイル名の形式は，「出力例」を参照してください。

指定できる文字数は，1〜255（単位：バイト）です。

指定した出力ファイルと同じ名称のファイルがある場合は上書きします。

ディレクトリのパスがない場合はエラーになります。

省略した場合は，環境設定パラメーターAJSCHK_CHECKFILEに指定したファイル名が仮定されます。環境設定パラメーターAJSCHK_CHECKFILEの指定がない場合は環境設定パラメーターAJSCHK_CHECKFILEのデフォルト値が仮定されます。

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

このオプションは，-aオプションと同時には指定できません。

-R

指定したユニット配下のすべてのジョブネットまたはジョブを，定義内容の事前チェック対象（チェックの起点）とします。このオプションを，-L，-T，-N，-Jオプションと同時に指定した場合，各オプションの指定内容に従って，該当するジョブネットおよびジョブを，定義内容の事前チェック対象（チェックの起点）とします。

ジョブグループ配下のすべてのジョブネットおよびジョブをチェックするためには，このオプションを-Tオプションと同時に指定してください。

このオプションは，-aオプションと同時には指定できません。

-L

実行登録していないジョブネットおよびジョブに対して定義内容の事前チェックを実行します。

このオプションを，-T，-N，-Jオプションと同時に指定した場合，未登録のジョブネットについて，各オプションの指定内容に従って定義内容の事前チェックを実行します。

このオプションは，-aオプションと同時には指定できません。

-T

ルートジョブネットに対して定義内容の事前チェックを実行します。

このオプションは，-a，-Jオプションと同時には指定できません。

-N

ジョブネットに対して定義内容の事前チェックを実行します。

このオプションは，-a，-Jオプションと同時には指定できません。

-J

ジョブに対して定義内容の事前チェックを実行します。

このオプションは，-a，-T，-Nオプションと同時には指定できません。

ジョブ名，ジョブネット名，またはジョブグループ名

定義内容の事前チェックを実行するジョブ名，ジョブネット名，またはジョブグループ名を指定します。

指定したユニットの配下のユニットが，定義内容の事前チェック対象（チェックの起点）となります。

指定できる文字数は，1〜930（単位：バイト）です。

ジョブ名，ジョブネット名，またはジョブグループ名は，複数指定できます。ルートジョブグループ「/」も指定できます。ただし，ジョブグループ名を指定する場合は，-Rオプションを指定する必要があります。

なお，ジョブ名，ジョブネット名，またはジョブグループ名に，論理ホスト名，スケジューラーサービス名，および実行IDは指定できません。

このオプションは，-aオプションと同時には指定できません。

注意事項

定義内容の事前チェックは，本番業務が実行中でない時間帯に実行してください。本番業務の実行中に定義内容の事前チェックを実行した場合，次に示す現象が発生するおそれがあります。

スケジューラーデータベースへのアクセス競合によって，業務実行性能が劣化する

システムへの負荷が一時的に集中したため，ジョブ実行処理でエラーが発生する

定義内容の事前チェックの実行中は，このコマンドで新たに定義内容の事前チェックを開始することはできません。定義内容の事前チェックを複数回実行する場合は，このコマンドに-aオプションを指定し，定義内容の事前チェックが実行中でないことを確認してから，実行してください。

JP1/AJS3 Check Managerサービスが起動していない場合，このコマンドは異常終了します。JP1/AJS3 Check Agentサービスが起動していない場合は，そのエージェントに対してはチェックしませんが，JP1/AJS3 Check Agentサービスが起動しているほかのエージェントに対してはチェックを継続します。

マネージャー側のJP1/AJS3サービスが起動していない状態で定義内容の事前チェックを実施すると，定義内容の事前チェック結果が正しく出力されない場合があります。

定義内容の事前チェックを実行中に，チェック対象ユニット（配下のユニットを含む）を追加・削除したり，定義内容を変更したりしないでください。チェック結果が正しく出力されない場合があります。

定義内容の事前チェックを実行中に，チェック対象ユニット（配下のユニットを含む）に定義した実行エージェントの設定を変更しないでください。定義内容の事前チェック実行中に実行エージェントの設定を変更すると，チェック結果が正しく出力されない場合があります。

定義内容の事前チェック対象外のユニットが指定された場合，スキップしたことを示すメッセージは出力されません。

-Rオプションを指定した場合，指定したユニットを含む配下のユニットが定義内容の事前チェック対象となります。この場合，定義内容の事前チェック対象となったユニットを階層ごとに繰り返してチェックするので，同じユニットが複数回チェックされます。

-Rオプションを指定した場合，ジョブに対してはジョブ実行エージェント名の定義内容にかかわらず，上位ジョブネットの実行エージェント名を仮定してチェックします。ジョブ実行エージェント名に上位ユニットの実行エージェントを仮定しないでチェックする場合は，-Tオプションまたは-Nオプションを同時に指定して定義内容の事前チェックを実施してください。

-Rオプションを指定して，ジョブを事前チェック対象として実行順序のチェックを実施すると，実行順序をジョブ単体にチェックします。このため，-Rオプションを指定し，判定ジョブをチェック対象として事前チェックを実施すると，判定ジョブの従属ジョブが存在しても「判定ジョブに対して従属ジョブが定義されていません」というエラーが出力される場合があります。この場合は，-Rオプションを指定しないでジョブネットを指定して定義内容の事前チェックを実施するか，または-Rオプションと同時に-Tオプション，または-Nオプションを指定して定義内容の事前チェックを実施してください。

大量のユニットをチェック中に-aオプションで運用状態を確認すると，結果の表示が遅くなる場合があります。

物理ホストでユニットの定義内容を事前にチェックする場合は，環境変数JP1_HOSTNAMEを削除してください。

定義内容の事前チェック結果格納ファイルが出力されない場合は，統合トレースログを確認し，内容に従って対処してください。

ユニット詳細定義の［実行エージェント］に，解決できないホスト名を設定している実行エージェントが指定されているようなユニットを指定して定義内容の事前チェックを実施すると，定義内容の事前チェック結果格納ファイル出力までの時間が長くなります。

ジョブネットコネクタおよび接続先のジョブネットの定義内容を事前チェックする場合は，ジョブネットコネクタを定義内容の事前チェックの対象に指定して実行してください。

マクロ変数名を指定した場合は，チェックされません。

UNIXジョブの-Dオプション（ジョブ詳細定義）および-Aオプション（実行ファイル権限）のチェックは，ユーザーマッピングのチェック結果が正常であることが前提です。ユーザーマッピングのチェックがエラーになると，ジョブ実行ユーザーがスーパーユーザー権限を持つOSユーザー（rootユーザー）であると仮定して，ジョブ詳細定義および実行ファイル権限のチェックが実施されます。このため，ユーザーマッピングのチェックがエラーとなった場合，ジョブ実行OSユーザーがrootユーザー以外だと，正しくチェックできません。ジョブ実行OSユーザーがrootユーザー以外の場合，ユーザーマッピングのエラー原因を取り除いてから，ジョブ詳細定義または実行ファイル権限のチェックを再実行する必要があります。

チェック対象のジョブの実行先ホスト名（エージェントホスト名）にはエイリアスホスト名を使用しないでください。エイリアスホスト名を使用するとチェック結果が正しく出力されない場合があります。

-Oオプション（実行順序）は，実行順序関係がループして関連定義されているユニットが存在するかどうかをチェックする機能です。ループ箇所の特定や，ループ箇所が存在するユニットのすべてをチェックする機能ではありません。

戻り値

0

正常終了。

0以外の値

異常終了。

使用例

次の条件で，定義内容の事前チェックを行います。

登録ユーザー名：USER1

/GROUP1/NET1配下のすべての未登録のジョブを対象にチェックします。

すべてのチェック条件を指定します。

ajschkdef -F AJSROOT1 -s -u USER1 -RLJ /GROUP1/NET1

出力例

使用例に基づき，定義内容の事前チェックを行った結果，/GROUP1/NET1/JOB1でManager側に実行エージェントが登録されていないエラー，/GROUP1/NET1/JOB2で空ジョブ定義エラー，/GROUP1/NET1/JOB3で指定された実行エージェントが許可されていないエラーが検出された場合の出力例を次の図に示します。

出力項目の説明

(1)CHECKUNIT=ユニット完全名［，ユニット完全名...］

定義内容の事前チェックの実行時に指定したユニット名をユニット完全名の形式で出力します。複数指定した場合は，コンマ区切りで複数出力します。

(2)CHECKSERVICE=スケジューラーサービス名

定義内容の事前チェックの実行時に指定したスケジューラーサービス名を出力します。

(3)CHECKAGTPROFNAME=実行エージェントプロファイル名

定義内容の事前チェックの実行時に指定した実行エージェントプロファイル名を出力します。実行エージェントプロファイルが無効になっている場合，実行エージェントプロファイル名は空文字になります。

(4)CHECKUSER=登録ユーザー名

定義内容の事前チェックの実行時に指定した登録ユーザー名を出力します。

(5)CHECKUNITPROFNAME=ユニット属性プロファイル名

定義内容の事前チェックの実行時に使用したユニット属性プロファイル名を出力します。実行ユーザー固定機能を使用していない場合，空文字を出力します。

(6)CHECKOPT=指定オプション

定義内容の事前チェックの実行時に指定したオプション（-O/-M/-C/-P/-H/-D/-U/-A/-R/-L/-T/-N/-J）をコンマ区切りで出力します。

(7)CHECKSTARTTIME=実行開始日時

定義内容の事前チェックの実行日時を「YYYY/MM/DD hh:mm:ss」の形式で出力します。

(8)空行

(9)チェック結果情報（ユニット名,パス名,エラー区分,エラー詳細）

定義内容の事前チェック実行の結果，エラーを検出したユニットについてチェック結果情報をコンマ区切りの一覧形式で出力します。

ユニット名

チェックの結果エラーが検出されたユニットのユニット名を出力します。

パス名

チェックの結果エラーが検出されたユニットのパス名（親ユニット完全名）を出力します。

エラー区分

チェックの結果エラーが検出されたエラーの区分を出力します。

出力するエラー区分については次の表を参照してください。

エラー詳細

チェックの結果エラーが検出されたエラー区分ごとのエラー内容の詳細を出力します。

出力するエラー詳細については，次の表を参照してください。

開始時に指定した

チェック項目

エラー区分

(下段は言語種別が英語の場合)

エラー詳細

実行順序

実行順序がループして関連定義されています

08-10以前

（なし）

08-50以降

unit=ユニット名※1

The execution order is looped in the relation definitions.

判定ジョブに対して従属ジョブが定義されていません

08-10以前

（なし）

08-50以降

unit=ユニット名;ユニット名;...※2

A dependent job has not been defined for a judgment job.

従属ジョブに条件接続以外の関連定義がされています

08-10以前

（なし）

08-50以降

unit=ユニット名;ユニット名;...※3

A relation definition other than a conditional connection has been defined for a dependant job.

実行エージェント名

Agent側からManagerのホスト名が解決できません

MANAGER_HOST=

マネージャーホスト名

The host name of the Manager cannot be resolved from the Agent side.

Agent側からManagerホストのIPアドレス解決ができません※4

MANAGER_IP=

マネージャーホストのIPアドレス

The host IP address of the Manager cannot be resolved from the Agent side.※4

Manager側で実行エージェントが登録されていません

EXEC_AGENT=

実行エージェント名

The exec-agent has not been registered on the Manager side.

Manager側から実行ホスト名が解決できません

AGENT_HOST=

実行ホスト名

The target host name cannot be resolved from the Manager side.

ジョブネット詳細定義

接続範囲の指定が接続先のジョブネットと異なります

unit=接続先のジョブネット名※5

The specified connection range is different from the jobnet for the connection destination.

指定したホストに接続できません

nchn=接続ホスト名

Cannot connect to the specified host.

指定したスケジューラーサービスは存在しません

ncsv=接続サービス名

Specified Scheduler service not exist.

接続先のジョブネットが指定されていません

（なし）

Jobnet name for the connection destination is not specified.

接続先のジョブネットの指定が不正です

ncr=接続先のジョブネット名

The specification of jobnet for the connection destination is not collect.

接続先のジョブネットが実行順序制御する設定になっていません

unit=接続先のジョブネット名※5

The jobnet for the connection destination is not configured for controlling the execution order.

接続先のジョブネットに指定した接続ホスト名で接続できません

unit=接続先のジョブネット名※5

Cannot connect with the connection host name specified in the jobnet for the connection destination.

接続先のジョブネットに指定した接続サービス名が誤っています

unit=接続先のジョブネット名※5

The connection service name specified in the jobnet for the connection destination is incorrect.

接続先のジョブネットに指定したジョブネットコネクタ名が誤っています

unit=接続先のジョブネット名※5

The jobnet connector name specified at jobnet for the connection destination is wrong.

指定した待ち合わせ対象ユニットが存在しません

unit=待ち合わせ対象ユニット名

Specified unit whose end is being waited for does not exist.

待ち合わせ対象ユニットの指定が不正です

unit=待ち合わせ対象ユニット名

The specification of unit whose end is being waited for is not collect.

ジョブ詳細定義

指定したファイル・ディレクトリは存在しません

sc=スクリプトファイル名(実行ファイル名)

ev=環境変数ファイル名

wkp=作業用パス名

si=標準入力ファイル名

so=標準出力ファイル名

se=標準エラー出力ファイル名

ts1=転送元ファイル名

td1=転送先ファイル名

ts2=転送元ファイル名

td2=転送先ファイル名

ts3=転送元ファイル名

td3=転送先ファイル名

ts4=転送元ファイル名

td4=転送先ファイル名

The specified file or directory does not exist.

指定したファイル・ディレクトリに対する権限がありません

sc=スクリプトファイル名(実行ファイル名)

ev=環境変数ファイル名

wkp=作業用パス名

si=標準入力ファイル名

so=標準出力ファイル名

se=標準エラー出力ファイル名

ts1=転送元ファイル名

td1=転送先ファイル名

ts2=転送元ファイル名

td2=転送先ファイル名

ts3=転送元ファイル名

td3=転送先ファイル名

ts4=転送元ファイル名

td4=転送先ファイル名

You do not have permission to access the specified file or directory.

プラットフォーム種別の指定が不正です

pfm=プラットフォーム種別

The specified platform type is invalid.

イベントIDに指定した値の形式が不正です

evwid=イベントID

The format of the value specified for the event ID is invalid.

検索前時間に範囲外の値を指定しています

evesc=検索前時間

The value specified for "Find event before exec." is outside the valid range.

監視対象ファイル名の形式が不正です

flwf=監視対象ファイル名

The format of the name of the file to be monitored is invalid.

ユーザーマッピング※6

ユーザーマッピングの指定に誤りがあります

JP1_USER=JP1ユーザー名

The specified user mapping is invalid.

実行元ホストのマッピングが不正です

JP1_USER=JP1ユーザー名

Mapping of an execution host is invalid.

OSユーザーのマッピングが不正です

OS_USER=OSユーザー名

Mapping of a OS user is invalid.

指定したユーザーは存在しません

un=実行ユーザー名

The specified user does not exist.

実行ファイル権限

指定したスクリプトファイルまたは実行ファイルに対して実行権限がありません

OS_USER=OSユーザー名

FILE_AUTH=ファイル権限※7

You do not have permission to execute the specified script file or executable file.

空ジョブ定義

スクリプトファイル，実行ファイル，またはイベントIDの指定がありません

（なし）

The script file or executable file or event ID is not specified.

実行エージェント制限

指定した実行エージェントが実行エージェントプロファイルで許可されていません

EXEC_AGENT=実行エージェント名

The specified exec-agent is not enabled on the exec-agent profile.

注※1

実行順序関係がループして関連定義されているユニット名を一つだけ出力します。

注※2

従属ユニットが条件接続されていない判定ジョブ名を出力します。

エラー個所が複数ある場合は，「;（セミコロン）」で区切ってすべてのユニット名を出力します。

注※3

条件接続以外の関連定義がされている従属ユニット名を出力します。

エラー個所が複数ある場合は「;（セミコロン）」で区切ってすべてのユニット名を出力します。

注※4

エージェントとマネージャー間の通信で，NAT（ネットワークアドレス変換）を使用している場合は，マネージャーホスト名から解決されたIPアドレスがエージェントホストとマネージャーホストで異なるため，このエラーが出力されます。設定に問題がなければエラーを無視してください。

注※5

［接続範囲］で［別サービス］を指定している場合は，「ホスト名:スケジューラーサービス名:ユニット名」を出力します。

注※6

ユーザーマッピングのチェックがエラーとなった場合，ジョブ実行ユーザーがスーパーユーザー権限を持つOSユーザー（rootユーザー）であると仮定して-Dオプション（ジョブ詳細定義）および-Aオプション（実行ファイル権限）のチェックが実施されます。このため，ジョブ実行OSユーザーがrootユーザー以外の場合，ユーザーマッピングのエラーを取り除いたあとにジョブ詳細定義または実行ファイル権限のチェックを再実行してください。

注※7

ファイル権限については，次の表を参照してください。

ファイル権限はaugo形式で出力します（例：0644）。

アクセス権種別

値

値の説明

特別なアクセス権(a)

1000

プログラムコードをスワップに維持

2000

実行時にグループIDを設定

4000

実行時にユーザーIDを設定

同じUIDのユーザー(u)

100

実行

200

書き込み

400

読み込み

同じGIDのグループ(g)

10

実行

20

書き込み

40

読み込み

その他のユーザー(o)

1

実行

2

書き込み

4

読み込み

(10)空行

(11)CHECKENDTIME=実行終了日時

定義内容の事前チェックの終了日時を「YYYY/MM/DD hh:mm:ss」の形式で出力します。

(12)NUMBER OF CHECKUNITS=チェックが完了したユニット数/チェックの対象となったユニット数，NUMBER OF ERRORS=チェックの結果エラーを検出した項目の数

定義内容の事前チェックの結果出力サマリーを表示します。サマリーとしては，チェックしたユニット数と，チェックの結果エラーを検出した項目の数が出力されます。エラーを検出しなかった場合は0が出力されます。

-Oまたは-Mオプションを指定した場合，チェックしたユニット数には，ジョブネットおよびジョブネットコネクタがカウントされます。-C，-P，-H，-U，-D，-Aオプションのどれかを指定した場合，ジョブがカウントされます。

チェックの対象となったユニット数とチェックが完了したユニット数が異なる場合は，次の要因が考えられます。

チェック中に定義内容の事前チェックプロセスのエラーが発生した

チェック中に定義内容の事前チェックプロセスのエラーが発生した場合は，統合トレースログにエラー内容が出力されます。

チェック対象ユニットの接続が接続元制限機能によって拒否された

［接続範囲］に［別サービス］を指定したジョブネットコネクタをチェック対象にして，接続先ホストで接続元制限機能を有効にしている場合，チェックが完了したユニット数は接続を拒否されたユニット数分少なくなります。

JP1/AJS3のマネージャーホストとエージェントホストが異なるマシンの場合は，まずマネージャーホストの統合トレースログを参照してください。マネージャーホストの統合トレースログにエラーが出力されていない場合は，エージェントホストの統合トレースログを参照してください。

(1)から(7)の定義内容の事前チェック実行情報と，(11)から(12)の実行終了日時，サマリーは，一回の実行で一回だけ出力されます。(9)のチェック結果情報は，検出されたエラーの個数分出力されます。

ajschkstart（UNIX限定）

形式

JP1/AJS3 - Managerの場合

ajschkstart
     [-m]
     [-a]

JP1/AJS3 - Agentの場合

ajschkstart
     [-a]

機能

JP1/AJS3 Check Managerサービス，またはJP1/AJS3 Check Agentサービスを起動します。

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1ajs2/bin/

引数

-m

JP1/AJS3 Check Managerサービスを開始します。

-a

JP1/AJS3 Check Agentサービスを開始します。

戻り値

0

正常終了。

0以外の値

異常終了。

注意事項

このコマンドはUNIXだけで実行できます。Windowsでは実行できません。

オプションをすべて省略した場合，次のオプションが仮定されます。

JP1/AJS3 - Managerの場合：-m，-a

JP1/AJS3 - Agentの場合：-a

補足事項

Windowsの場合は，サービスコントロールマネージャから起動します。

使用例

JP1/AJS3 - Managerで，JP1/AJS3 Check ManagerサービスおよびJP1/AJS3 Check Agentサービスを開始します。

ajschkstart -m -a

ajschkstop（UNIX限定）

形式

JP1/AJS3 - Managerの場合

ajschkstop
     [-m]
     [-a]

JP1/AJS3 - Agentの場合

ajschkstop
     [-a]

機能

JP1/AJS3 Check Managerサービス，またはJP1/AJS3 Check Agentサービスを停止します。

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1ajs2/bin/

引数

-m

JP1/AJS3 Check Managerサービスを停止します。

-a

JP1/AJS3 Check Agentサービスを停止します。

戻り値

0

正常終了。

0以外の値

異常終了。

注意事項

このコマンドはUNIXだけで実行できます。Windowsでは実行できません。

オプションをすべて省略した場合，次のオプションが仮定されます。

JP1/AJS3 - Managerの場合：-m，-a

JP1/AJS3 - Agentの場合：-a

チェック実行中の場合，チェックの終了を待たないで終了します。

このコマンドでJP1/AJS3 Check Agentサービスを停止する場合，JP1/Baseの物理ホストの通信設定に従って自ホストに対してTCP/IP通信接続を行い，JP1/AJS3 Check Agentサービスを停止します。そのため，自ホスト名（hostnameコマンドの結果）に対応するIPアドレスで通信できるホストが別ホストとなる環境では，別ホストのJP1/AJS3 Check Agentサービスを停止するおそれがあります。

自ホスト名（hostnameコマンドの結果）に対応するIPアドレスで通信できるホストが別ホストとなる環境では，自ホスト名から自ホストのIPアドレスが解決できるようにhostsファイル，DNSファイル，jp1hostsファイル，またはjp1hosts2ファイルを設定してから，コマンドを実行してください。

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

補足事項

Windowsの場合は，サービスコントロールマネージャから停止します。

使用例

JP1/AJS3 - Managerで，JP1/AJS3 Check ManagerサービスおよびJP1/AJS3 Check Agentサービスを停止します。

ajschkstop -m -a

ajschktrsetsz

形式

ajschktrsetsz
     [-s サイズ]

機能

JP1/AJS3 Check ManagerサービスまたはJP1/AJS3 Check Agentサービスのトレースログファイルサイズを変更します。

引数を指定しないで実行した場合は，現在設定されているトレースログファイルのサイズを標準出力ファイルに出力します。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

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

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

UNIXの場合

/opt/jp1ajs2/bin/

引数

-s サイズ

トレースログファイルのサイズを指定します。

指定できる値は，64〜2,097,151（単位：キロバイト）です。

注意事項

このコマンドでトレースログファイルのサイズを小さくした場合，サイズ変更前のトレースログファイルの内容は削除されます。

オプションと値との間は，必ず1バイト以上の空白で区切ってください。

使用例

JP1/AJS3 Check ManagerサービスまたはJP1/AJS3 Check Agentサービスのトレースログファイルサイズを4,096キロバイト確保します。

ajschktrsetsz -s 4096

ajscopy

形式

ajscopy
     [-F サービス名]
     [-m 許可モード]
     [-c|-v]
     [-S]
     [-R]
     [-L|-E]
     [-T]
     [-G|-N|-J]
     -o 出力先ユニット名
     入力元ユニット名...

機能

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

上位ユニット属性継承機能を設定しているユニットの配下にユニットをコピーした場合，コピーしたユニットの所有者やJP1資源グループは，上位ユニット属性継承機能によって設定されます。上位ユニット属性継承機能の詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　6.4.1(4)(a) 上位ユニット属性継承機能の概要」を参照してください。

ユニットを移動または名称変更した場合，ユニットの所有者やJP1資源グループは，移動元または名称変更元と同じユニットの所有者やJP1資源グループになります。

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Editor権限

JP1_AJS_Operator権限（コピー対象ユニットとその下のユニットだけ実行できます）

JP1_AJS_Guest権限（コピー対象ユニットとその下のユニットだけ実行できます）

引数

-F サービス名

処理対象とする，スケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

-m 許可モード

ジョブ実行のJP1ユーザーの設定を変更したあと，コピー，移動，または名称変更する場合に，許可モードを指定します。

指定できる値は，8進数で4けたの値です。

表記上の左から1番目を1けた，2番目を2けた...とした場合の，各けたの意味を次に示します。

1けた目

ジョブ実行時のユーザーの扱いを指定します。

0〜3：ジョブネットを登録したJP1ユーザーを，ジョブ実行時のユーザーとします。

4〜7：ジョブを所有するJP1ユーザーを，ジョブ実行時のユーザーとします。

2〜4けた目

0〜7の任意の値を指定します。

省略した場合，コピー元，移動元，または名称変更前の値と同じ値が仮定されます。

なお，このオプションは，-oオプションにジョブを定義した場合だけに有効です。

-c

ユニットをコピーします。

-v

ユニットを移動，または名称変更します。

このオプションは-Eオプションと同時には指定できません。

-S

ジョブネットがサスペンド状態の場合，実行登録済みのジョブネットであっても，ジョブネット下にユニットをコピーできるようにします。また，サスペンド中に追加したユニットの名称を変更できるようにします。ただし，ジョブネットがサスペンド状態でも，次の場合はユニットのコピーおよび名称変更はできません。

実行中のジョブネットの場合

-R

指定したユニットに含まれるすべてのジョブグループ，ジョブネット，およびジョブを，入力元ユニットとします。

このオプションを，-G，-N，-J，-L，-E，-Tオプションと同時に指定した場合，各オプションの指定内容に従って，入力元ユニットとします。

-L

ジョブグループ，実行登録していないジョブネット，およびジョブを入力元ユニットとします。

このオプションは-Gオプションと同時には指定できません。

-E

実行登録済みのジョブネット，およびジョブを入力元ユニットとします。

このオプションは，-v，-Gオプションと同時には指定できません。

-T

ルートジョブネットを入力元ユニットとします。

このオプションは，-G，-Jオプションと同時には指定できません。

-G

ジョブグループを入力元ユニットとします。

このオプションは，-L，-E，-T，-N，-Jオプションと同時には指定できません。

-N

ジョブネットを入力元ユニットとします。

このオプションは，-G，-Jオプションと同時には指定できません。

このオプションを-Tオプションと同時に指定した場合，このオプションは無効になります。

-J

ジョブを入力元ユニットとします。

このオプションは-G，-N，-Tオプションと同時には指定できません。

-o 出力先ユニット名

コピー，移動先のユニット名，または名称変更後のユニット名を指定します。

指定できる文字数は，1〜930（単位：バイト）です。

コピー，移動する場合

既存のジョブグループ名，またはジョブネット名を指定した場合，そのユニット中にコピー，または移動します。

名称変更する場合

既存のジョブ名，マネージャージョブグループ名，およびマネージャージョブネット名は指定できません。

なお，出力先ユニット名として，論理ホスト名，スケジューラーサービス名，および実行IDは指定できません。

入力元ユニット名

コピー，移動元のユニット名，または名称変更前のユニット名を指定します。

入力元ユニット名に起動条件ユニットは指定できません。

指定できる文字数は，1〜930（単位：バイト）です。

なお，入力元ユニット名として，論理ホスト名および実行IDは指定できません。

注意事項

ユニットをコピーできるのは，次のどちらかのユーザーです。

ユニットのコピー元（配下を含む）に対する参照権限，およびコピー先に対する更新権限を与えられたユーザー。

Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザー。

ただし，環境設定パラメーターADMACLIMITをデフォルトから変更して「yes」を設定している場合は，Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザーであっても，参照権限および更新権限が必要です。

ユニットを移動または名称変更できるのは，次のユーザーのどれかです。

ユニットの移動元および移動先に対して，更新権限を与えられたユーザー。

名称変更するユニットに更新権限を与えられたユーザー。

Administrators権限，またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザー。

ただし，環境設定パラメーターADMACLIMITをデフォルトから変更して「yes」を設定している場合は，Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザーであっても，更新権限が必要です。

コピー，移動，および名称変更する場合に共通の注意事項

出力先ユニット名，および入力元ユニット名に指定したユニット（ジョブグループを除く）が他でオープンしている場合，このコマンドは異常終了します。

実行登録済みのジョブネット（リモートジョブネットを除く）の場合，そのジョブネットを含むユニット，またはそのジョブネットに含まれるユニットを移動したり，名称変更したりできません。また，実行登録済みのジョブネットの中にユニットをコピーしたり移動したりできません。ただし，リモートジョブネット以外のユニットの場合，操作対象のジョブネットをサスペンド状態にしておき，このコマンドに-Sオプションを指定すれば，ジョブネットの実行登録を解除しなくても，操作対象のジョブネットにユニットをコピーしたり，追加したユニットの名称を変更したりできます。

入力元ユニットと出力先ユニットに同じ名称を指定できません。

出力先ユニットには，新規のユニット名を指定してください（既存のユニット名を指定した場合，名称を変更しようとしたユニットは，既存の出力先ユニット中に移動します）。ただし，入力元ユニット名を複数指定した場合，出力先ユニット名に新規のユニット名を指定できません。

出力先ユニット名に指定したユニット，および入力元ユニット名に指定したユニットがサスペンド状態変更処理中の場合，このコマンドは異常終了します。

コピー，または移動する場合の注意事項

ジョブネットの中にジョブグループをコピーしたり，移動したりできません。

ユニットのコピー中にエラーが発生した場合，途中までコピーしたユニットをすべて消去します。このコマンドは異常終了します。

ジョブネットの中にプランニンググループをコピーしたり，移動したりできません。

プランニンググループの中にはジョブネット，リモートジョブネット以外のユニットをコピーしたり，移動したりできません。

実行登録済みのルートジョブネットを含むプランニンググループは，移動したり名称変更したりできません。

ジョブネットコネクタの接続先のジョブネットであるルートジョブネットをルートジョブネットとしてコピーまたは移動した場合，ジョブネットコネクタ名などの実行順序制御情報はそのままコピーまたは移動されます。一方，ネストジョブネットとしてコピーまたは移動した場合，定義情報はデフォルト（実行順序制御しない）の状態になります。

ジョブネットコネクタの接続先のジョブネットとして定義されているプランニンググループをコピーまたは移動した場合，ジョブネットコネクタ名などの実行順序制御情報はそのままコピーまたは移動されます。

リリース登録されているルートジョブネット（リリース先ジョブネット）をコピーした場合は，「適用中」状態のジョブネット定義がコピーされます。また，移動した場合は，リリース登録されているすべてのジョブネット定義が移動します。

リリース登録されているルートジョブネット（リリース先ジョブネット）配下には，ジョブネットコネクタまたは起動条件をコピーおよび移動できません。

開始直後に満了するように定義した実行間隔制御ジョブを，起動条件配下から通常のジョブネットにコピーまたは移動すると，開始直後には満了しない設定に変更されます。

戻り値

0

正常終了。

4〜124で4の倍数値

異常終了。

補足事項

コピー，または移動したユニットは，JP1/AJS3 - Viewの［ジョブネットエディタ］ウィンドウの左上から右下方向にかけて空いている場所に自動的に配置されます。

使用例

ジョブネット（net1）をジョブグループ（grp1）にコピーします。

ajscopy -c -o grp1 net1

ajsdefine

形式

ajsdefine
     [-F サービス名]
     [-S]
     [{-x|-t}]
     [{-i|-e|-f}]
     [-p]
     [-d 定義先ユニット名]
     [ユニット定義ファイル名...]

機能

ユニット定義ファイルに記述されたパラメーターで，ユニットを定義します。

ユニット定義ファイルの詳細については，「5.1 ユニット定義ファイルの作成」を参照してください。

上位ユニット属性継承機能を設定しているユニットの配下にユニットを定義した場合，定義したユニットの所有者やJP1資源グループは，上位ユニット属性継承機能によって設定されます。上位ユニット属性継承機能の詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　6.4.1(4)(a) 上位ユニット属性継承機能の概要」を参照してください。

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Editor権限

引数

-F サービス名

処理対象とする，スケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

-S

ジョブネットがサスペンド状態の場合，実行登録済みのジョブネットであっても，ネストジョブネットやジョブの定義を更新できるようにします。ただし，ジョブネットがサスペンド状態でも，次の場合は定義の更新は行えません。

ルートジョブネットの定義を更新する場合

ルートジョブネットの定義を含むジョブグループの定義を更新する場合

実行中のジョブネットの場合

-x

ユニット定義ファイルに記述したパラメーターで，ユニットを定義します。

-t

ユニット定義ファイルに記述したパラメーターについて，シンタックスチェックだけ実施します。

-i

ユニットの定義先に，ユニット定義ファイルに記述したユニットと同一名称のユニットがある場合，メッセージおよび了解を求めるプロンプトを表示します。このプロンプトに対して，「y」を入力すると強制的に更新※します。なお，ユニット定義ファイル中の記述で，同一階層に同一名称のユニット名の指定がある場合は，エラーとします。

注※

強制的に更新するユニットおよびその配下ユニットを削除してから，ユニット定義ファイルに記述したユニットを作成します。

-e

ユニットの定義先に，ユニット定義ファイルに記述したユニットと同一名称のユニットがある場合，エラーとします。なお，ユニット定義ファイル中の記述で，同一階層に同一名称のユニット名の指定がある場合は，エラーとします。情報は更新されません。

-f

ユニットの定義先に，ユニット定義ファイルに記述したユニットと同一名称のユニットがある場合でも，強制的に更新※します。なお，ユニット定義ファイル中の記述で，同一階層に同一名称のユニット名の指定がある場合は，エラーとします。

注※

強制的に更新するユニットおよびその配下ユニットを削除してから，ユニット定義ファイルに記述したユニットを作成します。

-p

上位ユニット属性継承機能が有効な場合でも，ユニット属性プロファイルの設定を無視してユニットを定義します。

ajsprintコマンドで出力したユニット定義ファイルをそのまま復元したい場合に指定してください。

-d 定義先ユニット名

ユニットの定義先となる，ジョブグループ名，またはジョブネット名を指定します。

指定できる文字数は，1〜930（単位：バイト）です。論理ホスト名，および実行IDは指定できません。ネスト数が許容最大数（デフォルトは30，環境設定パラメーターDEFLENTYPEに「sjis」が設定されている場合は10）を超えるジョブグループやジョブネットは指定できません。

省略した場合，ルートジョブグループ「/」が仮定されます（ユニットはルートジョブグループ「/」中に作成されます）。

ユニット定義ファイル名

ユニット定義パラメーター（ユニットの属性）を定義したファイル名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

ユニット定義ファイル名は複数指定できます。ただし，総称名は指定できません。

あるユニット定義ファイルの記述内容が不適切である場合，そのファイルの処理は中断しますが，その他のファイルの処理は続行します。

省略した場合，標準入力からユニット定義パラメーターを入力します。

注意事項

ユニットを定義できるのは，次のどちらかのユーザーです。

ユニットの定義先に対して更新権限を与えられたユーザー。

Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザー。

ただし，環境設定パラメーターADMACLIMITをデフォルトから変更して「yes」を設定している場合は，Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザーであっても，更新権限が必要です。

ユニットの定義中にエラーが発生した場合，定義中のユニットを削除し，コマンドは異常終了します。-iオプションまたは-fオプションを指定して強制的にユニットを更新する場合，更新対象のユニットを定義したあとにエラーが発生すると，更新対象のユニットが削除された状態でコマンドは異常終了します。

ジョブグループやジョブネットを-iオプションまたは-fオプションを指定して強制的に更新しても，強制的に更新したジョブグループを参照しているジョブネットや，強制的に更新したジョブネットを排他スケジュールに指定しているジョブネットのスケジュールは再計算されません。

-iオプションまたは-fオプションを指定してユニットを強制的に更新すると，計画実行登録または未来世代数を指定して確定実行登録した次のジョブネットが「閉塞」状態になったり，実行予定が作成されなかったりするおそれがあります。

更新するジョブグループを「他のジョブグループのカレンダーを参照する」に指定したジョブネット

更新するジョブネットを「排他スケジュール」に指定したジョブネット

そのため，次のどちらかの作業を実施してください。

計画実行登録または確定実行登録したジョブネットを登録解除したあと，-iオプションまたは-fオプションを指定してajsdefineコマンドを実行する。

ajsdefineコマンドではなく，ajscalendarコマンド，ajschangeコマンド，またはajschgnetコマンドでユニット定義を変更する。

定義先ユニット名に指定したジョブネットが次のどちらかの場合，このコマンドは異常終了します。

定義先ユニット名に指定したジョブネットが実行登録中であり，サスペンド状態でない

定義先ユニット名に指定したジョブネットがJP1/AJS - Viewで排他編集されている

ジョブネットの中にジョブグループを定義できません。

ジョブ，マネージャージョブグループ，およびマネージャージョブネットにはユニットを定義できません。

実行登録済みのルートジョブネットの情報や，そのルートジョブネットを含むジョブグループおよびプランニンググループの情報は更新できません。

実行登録済みのジョブネット，そのジョブネットの上位，そのジョブネット中，およびそのジョブネットの下位には，ユニットを定義できません。ただし，ルートジョブネット，そのルートジョブネットを含むジョブグループ，およびリモートジョブネット以外のユニットの場合，操作対象のジョブネットをサスペンド状態にしておき，このコマンドに-Sオプションを指定すれば，ジョブネットの実行登録を解除しなくても，情報を更新できます（操作対象のユニットが実行中の場合，-Sオプションを指定しても情報は更新できません）。

定義先ユニット名に指定したジョブネットがサスペンド状態変更処理中の場合，このコマンドは異常終了します。

ジョブネットの中にプランニンググループを定義できません。

プランニンググループの中にはジョブネット，リモートジョブネット以外のユニットを定義できません。

コマンドを使用してジョブネットを定義する場合，ユニットの実行順序の整合性はチェックしません。ユニットの実行順序がループするように関連づけたジョブネット，または従属ユニットが関連づけられていない判定ジョブは，実行時に「順序不正」でエラーになります。

リリース登録されているルートジョブネット（リリース先ジョブネット）にユニットを定義した場合は，「適用中」状態のジョブネット定義中に定義されます。

リリース登録されているルートジョブネット（リリース先ジョブネット）には，ジョブネットコネクタおよび起動条件は定義できません。

ユニット定義ファイルが大きい場合，メモリー不足でコマンドが異常終了することがあります。その場合には，ユニット定義ファイルを200メガバイト以下となるように分割してください。

戻り値

0

正常終了。

4〜124で4の倍数値

異常終了。

補足事項

定義するユニットにウィンドウ上の位置を指定しなかった場合，JP1/AJS3 - Viewの［ジョブネットエディタ］ウィンドウの左上から右下方向にかけて空いている場所に自動的に配置されます。

使用例

ユニット定義ファイル（/tmp/unit_def）に記述したパラメーターで，ジョブグループ（/group1）に，ユニットを定義します。

ajsdefine -d /group1 /tmp/unit_def

ajsdelete

形式

ajsdelete
     [-F サービス名]
     [-i]
     [-S]
     [-R]
     [-L]
     [-T]
     [-G|-N|-J]
     ジョブ名，ジョブネット名，またはジョブグループ名...

機能

ユニットを削除します。なお，関連設定しているジョブネットやジョブを削除した場合でも，前後関連の整合性を保証します。

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Editor権限

引数

-F サービス名

処理対象とする，スケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

-i

ユニットを削除する前に，メッセージおよび了解を求めるプロンプトを表示します。

-S

ジョブネットがサスペンド状態の場合，実行登録済みのジョブネットであっても，ネストジョブネットやジョブを削除できるようにします。ただし，ジョブネットがサスペンド状態でも，次の場合は定義の削除は行えません。

ルートジョブネットを削除する場合

ルートジョブネットを含むジョブグループを削除する場合

実行中のジョブネットの場合

-R

指定したジョブグループ，またはジョブネット中のすべてのユニットについて，各オプションの指定内容に従ってユニットを削除します。

このオプションを，-L，-T，-G，-N，-Jオプションと同時に指定した場合，各オプションの指定内容に従って，ユニットを削除します。

-L

ジョブグループ，実行登録していないジョブネット，およびジョブを削除します。

このオプションを，-T，-N，-Jオプションと同時に指定した場合，未実行登録のジョブネットについて，各オプションの指定内容に従ってユニットを削除します。-Gオプションと同時には指定できません。

-T

ルートジョブネットを削除します。

このオプションを-Lオプションと同時に指定した場合，-Lオプションの指定内容に従ってルートジョブネットを削除します。-Nオプションと同時に指定した場合，-Nオプションは無効になります。-G，-Jオプションと同時には指定できません。

-G

ジョブグループを削除します。

このオプションは，-L，-T，-N，-Jオプションと同時には指定できません。

-N

ジョブネットおよびリカバリージョブネットを削除します。

このオプションを-Lオプションと同時に指定した場合，-Lオプションの指定内容に従ってジョブネット，およびリカバリージョブネットを削除します。-Tオプションと同時に指定した場合，このオプションは無効になります。-G，-Jオプションと同時には指定できません。

-J

ジョブを削除します。

このオプションは，-T，-G，-Nオプションと同時には指定できません。

ジョブ名，ジョブネット名，またはジョブグループ名

削除するジョブ名，ジョブネット名，またはジョブグループ名を指定します。

指定できる文字数は，1〜930（単位：バイト）です。

ジョブ名，ジョブネット名，またはジョブグループ名は，複数指定できます。ただし，ルートジョブグループ「/」は指定できません。

なお，ジョブ名，ジョブネット名，またはジョブグループ名に，論理ホスト名および実行IDは指定できません。

注意事項

ユニットを削除できるのは，次のどちらかのユーザーです。

削除するユニットに対して更新権限を与えられたユーザー。

Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザー。

ただし，環境設定パラメーターADMACLIMITをデフォルトから変更して「yes」を設定している場合は，Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザーであっても，更新権限が必要です。

実行登録済みのルートジョブネットやそのルートジョブネットを含むジョブグループを削除する場合は，削除する前にルートジョブネットの実行登録を解除しておいてください（実行登録された状態では，削除できません）。ただし，ルートジョブネット，そのルートジョブネットを含むジョブグループ，およびリモートジョブネット以外のユニットの場合，操作対象のジョブネットをサスペンド状態にしておき，このコマンドに-Sオプションを指定すれば，ジョブネットの実行登録を解除しなくても，削除できます（操作対象のユニットが実行中の場合，-Sオプションを指定しても削除できません）。

リリース登録されているルートジョブネット（リリース先ジョブネット）を削除した場合は，リリース登録されているすべてのジョブネット定義が削除されます。リリース登録されているルートジョブネット配下のユニットを削除した場合は，「適用中」状態のジョブネット定義が削除されます。

操作対象のジョブネットやジョブがサスペンド状態変更処理中の場合，このコマンドは異常終了します。

戻り値

0

正常終了。

4〜124で4の倍数値

異常終了。

使用例

ジョブグループ（/group1）に含まれるユニットのうち，実行登録されていないジョブネットだけを，応答で確認したあとに削除します。

ajsdelete -iRLN /group1

ajsembdbaddarea

形式

ajsembdbaddarea
     -r {table|index|table2|index2}
     -s 組み込みDBファイルシステム領域サイズ
     [-id 組み込みDBセットアップ識別子]
     -d データベース拡張領域格納ディレクトリ名称

形式1（テーブル領域「AJS2DATA」を拡張）

ajsembdbaddarea
     -r table
     -s 組み込みDBファイルシステム領域サイズ
     [-id 組み込みDBセットアップ識別子]
     -d データベース拡張領域格納ディレクトリ名称

形式2（インデクス領域「AJS2INDX」を拡張）

ajsembdbaddarea
     -r index
     -s 組み込みDBファイルシステム領域サイズ
     [-id 組み込みDBセットアップ識別子]
     -d データベース拡張領域格納ディレクトリ名称

形式3（テーブル領域「AJS2DATA2」を拡張）

ajsembdbaddarea
     -r table2
     -s 組み込みDBファイルシステム領域サイズ
     [-id 組み込みDBセットアップ識別子]
     -d データベース拡張領域格納ディレクトリ名称

形式4（インデクス領域「AJS2INDX2」を拡張）

ajsembdbaddarea
     -r index2
     -s 組み込みDBファイルシステム領域サイズ
     [-id 組み込みDBセットアップ識別子]
     -d データベース拡張領域格納ディレクトリ名称

機能

組み込みDBのデータベース領域（テーブル領域またはインデクス領域）を拡張します。

組み込みDBが稼働中の場合だけ実行できます。

JP1/AJS3の稼働状態に関係なく実行できます。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

JP1/AJS3 - Managerインストール先フォルダ¥tools¥

UNIXの場合

/opt/jp1ajs2/tools/

引数

-r table|index|table2|index2

拡張するデータベース領域種別を指定します。

table

テーブル領域「AJS2DATA」を拡張します。

index

インデクス領域「AJS2INDX」を拡張します。

table2

テーブル領域「AJS2DATA2」を拡張します。

バックアップ強化機能を有効にしていない場合は指定できません。

index2

インデクス領域「AJS2INDX2」を拡張します。

バックアップ強化機能を有効にしていない場合は指定できません。

-s 組み込みDBファイルシステム領域サイズ

組み込みDBファイルシステム領域として割り当てる容量をメガバイト単位で指定します。

指定できる値は，1〜2,047※です。

注※

-rオプションにtable2を指定した場合，-sオプションに指定できる値は，50〜2,047です。

-d データベース拡張領域格納ディレクトリ名称

拡張するデータベース領域を格納するディレクトリ名称を120バイト以内で指定します。存在しないディレクトリを指定した場合はエラーとなります。

ディレクトリ名称はフルパスで指定してください。指定するディレクトリに空白文字を含む場合は，パスを「""」で囲んでください。

ネットワークドライブ上のディスクを指定しないでください。

また，クラスタ運用時には，共有ディスク上のディレクトリを指定してください。

指定したディレクトリには，-sオプションで指定したサイズの容量を確保してください。

-id 組み込みDBセットアップ識別子

組み込みDBを識別するセットアップ識別子を「_JFn」（nは0〜9またはA〜Z）の4文字で指定します。ajsembdbbuildコマンドの-idオプションで指定した値を指定してください。

jajs_setupコマンド，jajs_setup_clusterコマンド，およびjajs_migrateコマンドで作成された組み込みDBに対して操作を行う場合，ajsembdbidlistコマンドで操作対象となる組み込みDBのセットアップ識別子を確認してください。ajsembdbidlistコマンドについては，「2. セットアップコマンド　ajsembdbidlist」を参照してください。

このオプションを省略した場合は，_JF0が仮定されます。

注意事項

このコマンドはスクリプトで実装されています。このため，オプションに不当に長い文字列や不正な文字列や値を指定すると，予期しないエラーが発生することがあります。オプション指定値は，DBMSおよびJP1/AJS3で規定されている範囲内の文字列または数値を指定してください。

クラスタ運用時，このコマンドは実行系ホスト（ajsembdbbuildコマンドの-ehオプションに指定したホスト）で実行してください。

テーブル領域およびインデクス領域は，それぞれの領域で最大15回まで拡張できます。

ajsembdbaddareaコマンドを同一の組み込みDBに対して同時に複数実行しないでください。

戻り値

0

正常終了。

0以外の値

異常終了。

補足事項

このコマンドを実行すると，-dオプションに指定したディレクトリ下に，次に示す命名規則に従ったファイルが作成されます。

ajsRRRRRRIIIIYYYYMMDDhhmmss

RRRRRR：拡張した資源名（-rオプション指定値）

IIII：組み込みDBセットアップ識別子（-idオプション指定値）

YYYY：年

MM：月

DD：日

hh：時

mm：分

ss：秒

（例）「2009年3月2日21時40分12秒」に次のオプション指定で実行した場合

ajsembdbaddarea -r index -s 2000 -d K:¥rdarea -id _JF0
K:¥rdarea¥ajsindex_JF020090302214012

エラー時の対処

コマンドエラー発生時は，次に示す表に従って対処してください。

メッセージID

現象

対処方法

KAVS0996-E

指定したオプションに誤りがあります。

オプションの指定内容を見直してください。

KAVS2101-E

組み込みDBは停止中です。

組み込みDBを起動してから再実行してください。

KAVS2102-E

組み込みDBは起動・停止処理中です。

組み込みDBの起動をajsembdbstatus -s ustコマンドで確認してから再実行してください。

KAVS2104-E

組み込みDBがセットアップされていません。

組み込みDBをセットアップしてから再実行してください。

KAVS2116-E

指定したオプションに誤りがあります。

メッセージに出力されているオプションを見直して再実行してください。

KAVS2117-E

コマンド実行時にエラーが発生しました。

保守情報に出力されているメッセージを参照してください。

KAVS8404-E

バックアップ強化機能が無効です。

-rオプションの指定内容を見直して再実行してください。

ajsembdbaddlog

形式

ajsembdbaddlog
     -s 組み込みDBファイルシステム領域サイズ
     -r {sys|spd}
     [-id 組み込みDBセットアップ識別子]
     -d 拡張領域格納ディレクトリ名称
     [-du 拡張領域格納ディレクトリ名称]

形式1（システムログファイルを拡張）

ajsembdbaddlog
     -s 組み込みDBファイルシステム領域サイズ
     -r sys
     [-id 組み込みDBセットアップ識別子]
     -d 拡張領域格納ディレクトリ名称

形式2（シンクポイントダンプファイルを拡張）

ajsembdbaddlog
     -s 組み込みDBファイルシステム領域サイズ
     -r spd
     [-id 組み込みDBセットアップ識別子]
     -d 拡張領域格納ディレクトリ名称

形式3（二重化したシステムログファイルを拡張）

ajsembdbaddlog
     -s 組み込みDBファイルシステム領域サイズ
     -r sys
     [-id 組み込みDBセットアップ識別子]
     -d 拡張領域格納ディレクトリ名称
     -du 拡張領域格納ディレクトリ名称

形式4（二重化したシンクポイントダンプファイルを拡張）

ajsembdbaddlog
     -s 組み込みDBファイルシステム領域サイズ
     -r spd
     [-id 組み込みDBセットアップ識別子]
     -d 拡張領域格納ディレクトリ名称
     -du 拡張領域格納ディレクトリ名称

機能

組み込みDBのシステムファイル（システムログファイルまたはシンクポイントダンプファイル）を拡張します。

組み込みDB停止中で，該当する組み込みDBにスケジューラーデータベースを作成しているすべてのスケジューラーサービスが停止中の場合だけ実行できます。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

JP1/AJS3 - Managerインストール先フォルダ¥tools¥

UNIXの場合

/opt/jp1ajs2/tools/

引数

-s 組み込みDBファイルシステム領域サイズ

組み込みDBファイルシステム領域として割り当てる容量をメガバイト単位で指定します。

指定できる値は，-rオプションに指定する値によって異なります。

-rオプションにsysを指定する場合

1〜2,047

-rオプションにspdを指定する場合

1〜1,024

-r sys | spd

拡張するシステムファイル種別を指定します。

sys

システムログファイルを拡張します。

spd

シンクポイントダンプファイルを拡張します。

-id 組み込みDBセットアップ識別子

組み込みDBを識別するセットアップ識別子を「_JFn」（nは0〜9またはA〜Z）の4文字で指定します。ajsembdbbuildコマンドの-idオプションで指定した値を指定してください。

jajs_setupコマンド，jajs_setup_clusterコマンド，およびjajs_migrateコマンドで作成された組み込みDBに対して操作を行う場合，ajsembdbidlistコマンドで操作対象となる組み込みDBのセットアップ識別子を確認してください。ajsembdbidlistコマンドについては，「2. セットアップコマンド　ajsembdbidlist」を参照してください。

このオプションを省略した場合は，_JF0が仮定されます。

-d 拡張領域格納ディレクトリ名称

拡張する領域を格納するディレクトリ名称を120バイト以内で指定します。存在しないディレクトリを指定した場合はエラーとなります。

ディレクトリ名称はフルパスで指定してください。指定するディレクトリに空白文字を含む場合は，パスを「""」で囲んでください。

ネットワークドライブ上のディスクを指定しないでください。

また，クラスタ運用時には，共有ディスク上のディレクトリを指定してください。

指定したディレクトリには，-sオプションで指定したサイズの容量を確保してください。

-du 拡張領域格納ディレクトリ名称

組み込みDBのシステムファイルを二重化している場合に指定します。

-dオプションで指定したディレクトリとは別のディレクトリを指定してください。その他の指定内容の詳細は，-dオプションと同じです。

注意事項

このコマンドはスクリプトで実装されています。このため，オプションに不当に長い文字列や不正な文字列や値を指定すると，予期しないエラーが発生することがあります。オプション指定値は，DBMSおよびJP1/AJS3で規定されている範囲内の文字列または数値を指定してください。

このコマンドを同時に複数実行しないでください。同時に複数実行した場合，次に示す現象が起こるおそれがあります。

不当なメッセージを出力したり，本来出力するはずのメッセージを出力しなかったりするなど，メッセージ出力が不正になる。

このコマンドが，不当にエラーになる。

システムログファイルおよびシンクポイントダンプファイルは30個まで作成できます。組み込みDB環境を初めて構築したときには，システムログファイルは12個作成されるため，最大18個まで追加できます。また，シンクポイントダンプファイルは3個作成されるため，最大27個まで追加できます。

クラスタ運用時，このコマンドは実行系ホスト（ajsembdbbuildコマンドの-ehオプションに指定したホスト）で実行してください。また，コマンド実行後に組み込みDB運用ディレクトリ¥CONF下にあるajs2ファイルを待機系ホストにコピーしてください。

戻り値

0

正常終了。

0以外の値

異常終了。

補足事項

このコマンドを実行すると，-dオプションおよび-duオプションに指定したディレクトリ下に，次に示す形式のファイル名称で領域が作成されます。

ajsRRRIIIIYYYYMMDDhhmmss{D}

RRR：拡張したシステムファイル種別（-rオプション指定値）

IIII：組み込みDBセットアップ識別子（-idオプション指定値）

YYYY：年

MM：月

DD：日

hh：時

mm：分

ss：秒

D：-duオプション指定時'D'

（例）「2009年3月2日21時57分30秒」に次のオプション指定で実行した場合

ajsembdbaddlog -r sys -s 2000 -d L:¥sysarea1 -du M:¥sysarea2 -id _JF0
L:¥sysarea1¥ajssys_JF020090302215730
M:¥sysarea2¥ajssys_JF020090302215730D

エラー時の対処

コマンドエラー発生時は，次に示す表に従って対処してください。

メッセージID

現象

対処方法

KAVS0996-E

指定したオプションに誤りがあります。

オプションの指定内容を見直してください。

KAVS2102-E

組み込みDBは起動・停止処理中です。

組み込みDBの起動をajsembdbstatus -s ustコマンドで確認してから再実行してください。

KAVS2104-E

組み込みDBがセットアップされていません。

組み込みDBをセットアップしてから再実行してください。

KAVS2116-E

指定したオプションに誤りがあります。

メッセージに出力されているオプションを見直して再実行してください。

KAVS2117-E

コマンド実行時にエラーが発生しました。

保守情報に出力されているメッセージを参照してください。

ajsembdbbackup

形式

ajsembdbbackup
     [-mh 論理ホスト名]
     [-i 組み込みDB運用ディレクトリ]
     -d データ領域名称
     -b バックアップファイル格納ディレクトリ
     [-s]
     [-id 組み込みDBセットアップ識別子]

機能

組み込みDBのバックアップを取得します。

組み込みDBが起動状態であるとき使用できます。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

JP1/AJS3 - Managerインストール先フォルダ¥tools¥

UNIXの場合

/opt/jp1ajs2/tools/

引数

-mh 論理ホスト名

このオプションは指定不要になりました。このオプションで指定していた論理ホスト名は無視されます。

-i 組み込みDB運用ディレクトリ

組み込みDBの運用ディレクトリを指定します。ディレクトリは絶対パスで指定してください。Windows版の場合，指定する絶対パスに空白文字を含む場合はパスを「"（ダブルクォーテーションマーク）」で囲んでください。ajsembdbbuildコマンドの-iオプションで指定したディレクトリと同じディレクトリを指定してください。UNIXのセットアップでajsembdbbuildコマンドの-iオプションを省略した場合は，このオプションを省略できます。

省略時は/opt/jp1ajs2/embdb/_JF0が仮定されます。

このオプションは，08-00よりも前のバージョン互換のためのオプションです。通常は，-idオプションを指定してください。

-idオプションと同時に指定した場合，-iオプションに指定した値が有効になります。

-d データ領域名称

組み込みDBのデータ領域名称を指定します。ディレクトリは絶対パスで指定してください。Windows版の場合，指定する絶対パスに空白文字を含む場合はパスを「"（ダブルクォーテーションマーク）」で囲んでください。ajsembdbbuildコマンドの-dオプションで指定した場合は次のように指定してください。

Windowsの場合

[-dオプションで指定したディレクトリ名称]¥ajssys02

UNIXの場合

[-dオプションで指定したディレクトリ名称]/ajssys02

jajs_setupコマンドまたはjajs_migrateコマンドで作成された組み込みDBに対して操作を行う場合，ajsembdbidlistコマンドで操作対象となる組み込みDBの格納ディレクトリを確認してください。ajsembdbidlistコマンドについては，「2. セットアップコマンド　ajsembdbidlist」を参照してください。

Windowsの場合

[ajsembdbidlistコマンドで確認したディレクトリ名称]¥dbarea¥ajssys02

UNIXの場合

/var/opt/jp1ajs2/embdb/_JFn※/dbarea/ajssys02

jajs_setup_clusterコマンドで構築された論理ホスト環境の組み込みDBに対して操作を行う場合，-dオプションに指定された値を指定してください。

Windowsの場合

[-dオプションで指定したディレクトリ名称]¥jp1ajs2¥embdb¥_JFn※¥dbarea¥ajssys02

UNIXの場合

[-dオプションで指定したディレクトリ名称]/jp1ajs2/embdb/_JFn※/dbarea/ajssys02

jajs_setupコマンドで構築された論理ホスト環境の組み込みDBに対して操作を行う場合，-Dオプションに指定された値を指定してください。

Windowsの場合

[-Dオプションで指定したディレクトリ名称]¥jp1ajs2¥embdb¥_JFn※¥dbarea¥ajssys02

UNIXの場合

[-Dオプションで指定したディレクトリ名称]/jp1ajs2/embdb/_JFn※/dbarea/ajssys02

注※

このコマンドの-idオプションに指定する値を指定してください。-idオプションを省略する場合，_JF0を指定してください。

-b バックアップファイル格納ディレクトリ

バックアップファイルを格納するディレクトリを指定します。ディレクトリは絶対パスで指定してください。Windows版の場合，指定する絶対パスに空白文字を含む場合はパスを「"（ダブルクォーテーションマーク）」で囲んでください。

指定したディレクトリは，事前に作成しておいてください。ディレクトリがない場合はエラーになります。

指定したディレクトリには，次のファイルが格納されます。

バックアップファイル

処理出力結果ファイル

ファイル名称は自動的に決定します。名称は，次の規則によって決定されます。

-sオプション指定あり

バックアップファイル：BACK_XXXXYYZZVVWW.bk

出力結果ファイル：BACK_XXXXYYZZVVWW.log

-sオプション指定なし

バックアップファイル：BACK_MST_XXXXYYZZVVWW.bk

出力結果ファイル：BACK_MST_XXXXYYZZVVWW.log

XXXX：西暦

YY：月

ZZ：日

VV：時間

WW：分

バックアップファイル格納ディレクトリは，組み込みDBのデータベースモデルの規模によって次の表に示すとおり必要な空き容量が異なります。

表3‒10　組み込みDBのデータベースモデルと必要な空き容量

データベースモデル

必要な空き容量

大規模

約6,700メガバイト

中規模

約1,400メガバイト

小規模

約200メガバイト

ajsembdbaddareaコマンドでデータベース領域を拡張している場合は，拡張した容量を合計した容量が必要になります。また，データベース領域の自動増分機能を有効にしている場合は，自動増分による拡張後の容量が必要になります。

自動増分機能については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　23.2 データベース領域の見積もり」を参照してください。

-s

運用中にバックアップを取得する場合に指定してください。

バックアップを取得した場合，リストアする際にアンロードログファイルが必要になるため，アンロードログファイルが出力されているかどうかを確認してください。アンロードログファイルは，ajsembdboplogコマンドで自動ログアンロード機能の動作状態がACTIVEになっている場合に出力されます。ajsembdboplogコマンドについては，「3. 通常の運用で使用するコマンド　ajsembdboplog」を参照してください。

-id 組み込みDBセットアップ識別子

組み込みDBを識別するセットアップ識別子を「_JFn」（nは0〜9またはA〜Z）の4文字で指定します。ajsembdbbuildコマンドの-idオプションで指定した値を指定してください。

jajs_setupコマンド，jajs_setup_clusterコマンド，およびjajs_migrateコマンドで作成された組み込みDBに対して操作を行う場合，ajsembdbidlistコマンドで操作対象となる組み込みDBのセットアップ識別子を確認してください。ajsembdbidlistコマンドについては，「2. セットアップコマンド　ajsembdbidlist」を参照してください。

このオプションを省略した場合は，_JF0が仮定されます。

-iオプションと同時に指定した場合，-iオプションが優先されます。

注意事項

障害の発生している組み込みDBのバックアップは取得しないでください。障害の発生している状態でバックアップを取得した場合，そのバックアップファイルを回復に使用すると問題が発生することがあります。

このコマンドは，組み込みDB稼働中に実行してください。

ジョブ実行中にこのコマンドを実行すると，コマンドが異常終了する場合があります。その場合は，ジョブ実行による負荷が低い時間帯に再実行してください。

-sオプションを指定してバックアップを取得した場合，ajsembdbrstrコマンドは，入力情報としてアンロードログファイルが必要になります。

-sオプションを指定しないでバックアップを取得する場合，データベースの更新がないことを確認して実行してください。

データベースの更新時にバックアップを取得しようとするとエラーが発生することがあります。

システムログファイルの状態を監視するには，ajsembdbstatusコマンドの-lオプションを使用してください。

ajsembdbstatusコマンドの詳細については，「3. 通常の運用で使用するコマンド　ajsembdbstatus」を参照してください。

コマンドの実行結果は，ログファイルに出力されます。格納先は，次の場所になります。

Windowsで，インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥log

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

「システムで保護されたフォルダ」とは，次のフォルダを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

Windowsで，インストール先フォルダが上記以外の場合

JP1/AJS3 - Managerインストール先フォルダ¥log

UNIXの場合

/var/opt/jp1ajs2/log

ファイル名はajsembdbbackup.logです。このファイルは，上書きしないためファイルサイズが無限に大きくなります。必要に応じて退避，削除を行ってください。

このファイルがない場合は，ajsembdbbackupコマンドを実行すると，新たに作成されます。

-sオプションを指定しない場合は，バックアップファイルだけで回復できます。JP1/AJS3との同期を取ってバックアップを取得する場合には，-sを指定しないで実行してください。

-sオプションを指定して取得したバックアップファイルを使って回復を行う場合は，アンロードログファイルを使用しなければ回復できないため注意が必要です。

ajsembdbbackupコマンドを実行中，警告メッセージKFPS01278-W，KFPS01279-Wが出力される場合があります。ただし，メッセージKFPS01278-Wに「code=1601-0」が出力される場合，またはメッセージKFPS01279-Wに「code=1607-0」が出力される場合はバックアップ動作に影響はないため，問題ありません。

このコマンドを同時に複数実行しないでください。同時に複数実行した場合は，次に示す現象が起こるおそれがあります。

不当なメッセージが出力されたり，本来出力されるはずのメッセージが出力されなかったりなど，メッセージの出力が不正になる

このコマンドが不当にエラーになる

このコマンドは，バックアップ強化機能が有効な組み込みDBに対しては実行できません。実行した場合はコマンドがエラーとなります。

戻り値

0

正常終了。

0以外の値

異常終了。

エラー発生時の対処

ajsembdbbackupコマンド実行時にエラーが発生した場合は次の表に従って対処してください。

表3‒11　ajsembdbbackupコマンドエラー発生時の対処

メッセージ

原因

対処

KFPS01280-E AJSEMBDBBACKUP:EmbedDB SYNC END （4） AJSEMBDBBACKUP:[ERROR]pdlogsync -d sys -w -t 180

スケジューラーデータベースが更新中のため，DBのバックアップを取得できる状態にできません。

実行中のジョブが終了するのを待って再実行してください。

KAVS0996-E

引数に誤りがあります。

オプションの指定が不足しています。

-iオプションに指定したパスが組み込みDB運用ディレクトリではありません。または，読み取り権限がありません。

指定している引数を見直して，再実行してください。

KFPR26012-E

-dオプションに指定したパスが誤っています。または，指定したパスに読み取り権限がありません。

指定しているパスおよび権限を見直して，再実行してください。AJS管理者で運用している場合は，AJS管理者に対して権限があるか見直してください。

KFPR16003-E

-bオプションに指定したパスが誤っています。または，指定したパスに書き込み権限がありません。

指定しているパスおよび権限を見直して，再実行してください。AJS管理者で運用している場合は，AJS管理者に対して権限があるか見直してください。

KFPR26006-E

Invalid parameter AAA exists at -m option in command line

-mhオプションに指定したホスト名称が不正です。

ホスト名称および指定している引数を見直して，再実行してください。

KFPS01984-E

-iオプションに指定したパスが絶対パスで指定されていません。

指定しているパスを見直して，再実行してください。

Bad directory specified in -i option

-iオプションに指定したパスが，組み込みDBの運用ディレクトリでないか，権限がありません。または，セットアップが正常に行われていません。

-iオプションに正しい組み込みDBの運用ディレクトリを指定してください。または，権限を見直して再実行してください。組み込みDBの運用ディレクトリの指定に問題がない場合は，組み込みDBの再セットアップを行ってください。AJS管理者で運用している場合は，AJS管理者に対して権限があるか見直してください。

KAVS2104-E

-idオプションで指定したセットアップ識別子が不正か，組み込みDBがセットアップされていません。

-idオプションで指定したセットアップ識別子の値が正しいことを確認してください。

KAVS8409-E

バックアップ強化機能が有効な組み込みDBに対してajsembdbbackupコマンドは実行できません。

バックアップ強化機能が有効な組み込みDBのバックアップを取得する場合は，jajs_dbbackupコマンドを使用してください。

ajsembdbcancel

形式

ajsembdbcancel
     -u サーバ名，またはプログラム名称
     -p プロセスID
     [-id 組み込みDBセットアップ識別子]

機能

実行中の組み込みDBの操作コマンドの処理を中断させます。

中断したコマンドはエラーとなります。発生するエラーの詳細については，各コマンドのエラーメッセージまたはログを参照してください。

このコマンドは，組み込みDBが稼働中の場合だけ実行できます。JP1/AJS3の稼働状態には関係なく実行できます。

格納先ディレクトリ

Windowsの場合

JP1/AJS3 - Managerインストール先フォルダ¥tools¥

UNIXの場合

/opt/jp1ajs2/tools/

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-u サーバ名，またはプログラム名称

組み込みDB操作コマンドで動作しているサーバ名，またはプログラム名称を指定します。

組み込みDB操作コマンド実行中に，ajsembdbstatusコマンドを-s prcオプション指定で実行すると出力される，組み込みDB操作コマンドに対応したプログラム名称（PROGRAM），またはサーバ名（SVID）を指定してください。

これらのPROGRAM，またはSVIDは対応する組み込みDB操作コマンドが実行中の場合にだけ表示されます。

各コマンドのPROGRAM，またはSVIDを次に示します。

コマンド名

SVID※

PROGRAM

ajsembdbbuild，ajsembdbstart

0minitx

−

ajsembdbaddarea

−

pdmod

ajsembdbrorg

0mrorgx

−

ajsembdbreclaim

0mrorgx

−

ajsembdbstatus

0mdbstx

−

ajsembdbbackup

0bcpyx

−

ajsembdbrstr

0brstrx

−

（凡例）

−：該当しない。

注※

末尾のxは，0，1，2...と数値になります。

上記以外の組み込みDB操作コマンドについては，このコマンドで処理を中断できません。

-p プロセスID

ajsembdbstatusコマンドの-s prcオプション指定で出力される情報のPIDを指定します。

-id 組み込みDBセットアップ識別子

組み込みDBを識別するセットアップ識別子を「_JFn」（nは0〜9またはA〜Z）の4文字で指定します。ajsembdbbuildコマンドの-idオプションで指定した値を指定してください。

jajs_setupコマンド，jajs_setup_clusterコマンド，およびjajs_migrateコマンドで作成された組み込みDBに対して操作を行う場合，ajsembdbidlistコマンドで操作対象となる組み込みDBのセットアップ識別子を確認してください。ajsembdbidlistコマンドについては，「2. セットアップコマンド　ajsembdbidlist」を参照してください。

このオプションを省略した場合は，_JF0が仮定されます。

注意事項

このコマンドを実行した場合，次に示すメッセージが出力されます。

4432 16:49:20 unt1 _pd0canc KFPS05082-Q Utility server name=0mrorg0,utility server process id=5456 cancel process ? (y/n)

処理をキャンセルするかどうかの確認のメッセージであるため，問題ない場合は「y」を入力してください。

このコマンドはスクリプトで実装されています。このため，オプションに不当に長い文字列や不正な文字列や値を指定すると，予期しないエラーが発生することがあります。オプション指定値は，DBMSおよびJP1/AJS3で規定されている範囲内の文字列または数値を指定してください。

組み込みDB操作コマンドの実行中にajsembdbstatusコマンドの-s prcオプション指定を実行しても，-uオプションで指定できるプログラム名称が出力されない場合があります。これは，ajsembdbcancelコマンドでキャンセルできる処理が未開始であるか，またはすでに終了している状態であることを示します。

このコマンドを同時に複数実行しないでください。同時に複数実行した場合，次に示す現象が起こるおそれがあります。

不当なメッセージを出力したり，本来出力するはずのメッセージを出力しなかったりするなど，メッセージ出力が不正になる。

このコマンドが，不当にエラーになる。

戻り値

0

正常終了。

0以外の値

異常終了。

エラー時の対処

コマンドエラー発生時は，次に示す表に従って対処してください。

メッセージID

現象

対処方法

KAVS0996-E

指定したオプションに誤りがあります。

オプションの指定内容を見直してください。

KAVS2101-E

組み込みDBは停止中です。

組み込みDBを起動してから再実行してください。

KAVS2102-E

組み込みDBは起動・停止処理中です。

組み込みDBの起動をajsembdbstatusコマンドの-s ustオプション指定で確認してから再実行してください。

KAVS2104-E

組み込みDBがセットアップされていません。

組み込みDBをセットアップしてから再実行してください。

KAVS2116-E

指定したオプションに誤りがあります。

メッセージに出力されているオプションを見直して再実行してください。

KAVS2117-E

コマンド実行時にエラーが発生しました。

保守情報に出力されているメッセージを参照してください。

ajsembdboplog

形式

ajsembdboplog
     [-s|-r|-t|
      -g システムログファイルグループ名 -o 出力先ファイル名 [-f]|-w]
     [-id 組み込みDBセットアップ識別子]

形式1（自動ログアンロード機能の状態監視）

ajsembdboplog
     -s
     [-id 組み込みDBセットアップ識別子]

形式2（自動ログアンロード機能の再開始）

ajsembdboplog
     -r
     [-id 組み込みDBセットアップ識別子]

形式3（自動ログアンロード機能の停止）

ajsembdboplog
     -t
     [-id 組み込みDBセットアップ識別子]

形式4（システムログファイルのアンロード）

ajsembdboplog
     -g システムログファイルグループ名
     -o 出力先ファイル名
     [-f]
     [-id 組み込みDBセットアップ識別子]

形式5（システムログファイルのスワップ）

ajsembdboplog
     -w
     [-id 組み込みDBセットアップ識別子]

機能

システムログについて次に示す操作ができます。

自動ログアンロード機能を制御します。

指定したシステムログファイルグループを出力先のファイルへアンロードし，システムログファイルグループをアンロード済みにします。

システムログファイル（グループ）をスワップします（現用（出力先）を切り替えます）。

このコマンドは，-s，-r，-t，-wオプションを指定する場合は，組み込みDB稼働中だけ実行できます。その他の場合は，組み込みDBの稼働状態に関係なく実行できます。

また，JP1/AJS3の稼働状態には関係なく実行できます。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

JP1/AJS3 - Managerインストール先フォルダ¥tools¥

UNIXの場合

/opt/jp1ajs2/tools/

引数

-g システムログファイルグループ名

アンロードするシステムログファイルのグループ名を指定します。

システムログファイルグループ名は，ajsembdbstatusコマンドの-lオプション指定を実行して確認してください。

-o 出力先ファイル名

出力先のアンロードログファイルの名称を指定します。

ファイル名称は，絶対パスで指定してください。指定するディレクトリに空白文字を含む場合は，パスを「""」で囲んでください。

ネットワークドライブ上のディスクを指定しないでください。

アンロードログ出力ファイルを格納するディレクトリは，ajsembdbbuildコマンドで指定した規模によって容量が異なります。また，システムログ自動増分機能を使用している場合は，下記サイズに拡張したサイズを追加した値の容量が必要になります。

ajsembdbbuildのオプション

必要な空き容量

-l（大規模モデル）

約1,200メガバイト

-m（中規模モデル）

約230メガバイト

-s（小規模モデル）

約30メガバイト

jajs_setupコマンド，jajs_setup_clusterコマンドで構築された組み込みDB環境では，-s（小規模モデル）にシステムログ自動増分を適用して構築されています。

jajs_migrateコマンドで構築された組み込みDB環境では，jajs_migrateコマンドの-sオプションで指定した規模にシステムログ自動増分を適用して構築されています。jajs_migrateコマンドの-sオプションを省略した場合，s（小規模モデル）が仮定されます。

なお，アンロードするシステムログファイルがajsembdbaddlogコマンドで新たに追加したシステムログファイルの場合，ajsembdbaddlogコマンドの-sオプションで指定したサイズ分の空き容量が必要になります。また，システムログ自動増分機能を使用している場合は，上記サイズに拡張したサイズを追加した値の容量が必要になります。

システムログファイルのアンロードを実施するたびに，上記の容量が必要となります。

-f

システムログファイルを強制的にアンロードする場合に指定します。このオプションを指定した場合，現用のシステムログファイルグループまたはアンロード済みのシステムログファイルグループでもアンロードできます。ただし，システムログファイルグループの状態は変更されません。

このオプションは，組み込みDBでアンロードログファイルとバックアップを使用して運用している場合に使用します。組み込みDBで障害が発生した場合，障害発生直前のアンロードログが出力されていない場合があります。このような場合には，このオプションを指定してアンロードログファイルを取得してください。ただし，組み込みDBのシステムログファイルに問題が発生している場合にはコマンドがエラーとなり，アンロードログファイルが取得できない場合があるので注意が必要です。

-s

自動ログアンロード機能の動作状態を表示する場合に指定します。

-r

自動ログアンロード機能を再開始する場合に指定します。

再開始直後のアンロードログファイル作成ディレクトリは，前回動作時の情報が引き継がれます。

すでに自動ログアンロード機能が開始されている場合はエラーとなります。

-t

自動ログアンロード機能を停止する場合に指定します。

アンロード処理途中のシステムログファイルがある場合，そのアンロード処理は中断されます。このときに出力されたアンロードログファイルは不完全な状態になるため，回復には使用できません。

すでに自動ログアンロード機能が停止中である場合はエラーとなります。

-w

システムログファイルをスワップ（現用（出力先）を切り替える）場合に指定します。

-id 組み込みDBセットアップ識別子

組み込みDBを識別するセットアップ識別子を「_JFn」（nは0〜9またはA〜Z）の4文字で指定します。ajsembdbbuildコマンドの-idオプションで指定した値を指定してください。

jajs_setupコマンド，jajs_setup_clusterコマンド，およびjajs_migrateコマンドで作成された組み込みDBに対して操作を行う場合，ajsembdbidlistコマンドで操作対象となる組み込みDBのセットアップ識別子を確認してください。ajsembdbidlistコマンドについては，「2. セットアップコマンド　ajsembdbidlist」を参照してください。

このオプションを省略した場合は，_JF0が仮定されます。

注意事項

このコマンドはスクリプトで実装されています。このため，オプションに不当に長い文字列や不正な文字列や値を指定すると，予期しないエラーが発生することがあります。オプション指定値は，DBMSおよびJP1/AJS3で規定されている範囲内の文字列または数値を指定してください。

ajsembdboplogコマンドに-rまたは-tオプションを指定して実行する場合，組み込みDBで自動ログアンロード機能を有効にしておく必要があります。自動ログアンロード機能が有効でない環境でajsembdboplogに-rまたは-tオプションを指定して実行した場合，エラーとなります。

アンロードログファイルとバックアップを使用した運用中に自動ログアンロード機能を停止すると，バックアップとアンロードログファイルから回復するときに，自動ログアンロード機能を停止するまでに出力されたアンロードログファイルまでの回復しかできません。自動ログアンロード機能を停止した場合は，自動ログアンロード機能を再開始したときにバックアップを取得し直す必要があります。

アンロードログファイルとバックアップを使用した運用中に自動ログアンロード機能を停止すると，以降の組み込みDBのシステムログファイルグループがアンロード待ち状態になります。

この状態のまま運用を続けると，すべてのシステムログファイルグループがアンロード待ち状態になり，組み込みDBの運用ができなくなります。

このような状態を回避するために自動ログアンロード機能を停止した場合は，定期的にajsembdbstatusコマンドの-lオプション指定を実行してシステムログファイルグループの状態を確認し，ajsembdboplogコマンドの-gオプション指定を実行してシステムログファイルグループをアンロードする必要があります。

このコマンドを同時に複数実行しないでください。同時に複数実行した場合，次に示す現象が起こるおそれがあります。

不当なメッセージを出力したり，本来出力するはずのメッセージを出力しなかったりするなど，メッセージ出力が不正になる。

このコマンドが，不当にエラーになる。

戻り値

0

正常終了。

0以外の値

異常終了。

エラー時の対処

コマンドエラー発生時は，次に示す表に従って対処してください。

メッセージID

現象

対処方法

KAVS0996-E

指定したオプションに誤りがあります。

オプションの指定内容を見直してください。

KAVS2101-E

組み込みDBは停止中です。

組み込みDBを起動してから再実行してください。

KAVS2102-E

組み込みDBは起動・停止処理中です。

組み込みDBの起動をajsembdbstatusコマンドの-s ustオプション指定で確認してから再実行してください。

KAVS2104-E

組み込みDBがセットアップされていません。

組み込みDBをセットアップしてから再実行してください。

KAVS2105-E

指定したシステムログファイルグループは存在しません。

システムログファイルグループ名を確認して再実行してください。

KAVS2106-E

アンロードに失敗しました。

指定したシステムログファイルグループがアンロードできる状態であるかをajsembdbstatusコマンドの-lオプション指定で確認してください。アンロードできる状態である場合は，しばらく待ってから再実行してください。

KAVS2116-E

指定したオプションに誤りがあります。

メッセージに出力されているオプションを見直して再実行してください。

KAVS2117-E

コマンド実行時にエラーが発生しました。

保守情報に出力されているメッセージを参照してください。

出力例

自動ログアンロード機能の動作状態を確認する場合の出力例を次に示します。

ajsembdboplog -s -id _JF0

HOSTNAME : 127.0.0.1 (180252)
SERVER_NAME:ajs2
AUTO_LOG_UNLOAD  NOW_UNLOAD_LOG_GROUP  CREATE_DIR
         ACTIVE                  ****  K:/logback
CURRENT LOG GENERATION INFO.
LOG_GROUP GEN_NO.  SERVER_RUN_ID RUN_ID   UNLOAD_FILE_NAME
     log1        1 43c4ad0d      43c4acf3 ajs2_43c4ad0d0001_log1

HOSTNAME

「127.0.0.1」が表示されます。

（ ）内は，ajsembdbstatusコマンドを実行した時刻が時分秒（HHMMSS）で出力されます。

注意事項

次のどれかに該当する場合は，組み込みDBインストール先ディレクトリのホスト名が32文字以内で出力されます。クラスタ構成の場合は，初めに実行系に設定したホスト名が出力されます。

バージョンが09-50以前のWindows版JP1/AJS3 - Managerを使用していて，かつ論理ホストで組み込みDBを構築した場合

バージョンが09-50以前のUNIX版JP1/AJS3 - Managerを使用している場合

バージョンが09-50以前のJP1/AJS3 - Managerを10-00以降にバージョンアップインストールしていて，かつIPv6で通信するためのセットアップをしていない場合

SERVER_NAME

組み込みDBの識別子が4文字で出力されます。JP1/AJS3では，「ajs2」固定です。

AUTO_LOG_UNLOAD

自動ログアンロード機能の動作状態が出力されます。

ACTIVE：動作中

STOP：停止中

−：自動ログアンロード機能を使用できない状態

NOW_UNLOAD_LOG_GROUP

現在アンロード中のシステムログファイルのログファイルグループ名が出力されます。

アンロード中のシステムログファイルがない場合は「****」が出力されます。

CREATE_DIR

使用中のアンロードログファイル作成ディレクトリ名が出力されます。

LOG_GROUP

現用世代のシステムログファイルのログファイルグループ名が出力されます。

Gen No.

ログの世代番号が8けた以内の16進数で出力されます。

SERVER_RUN_ID

システムで使用する情報が出力されます。

RUN_ID

システムで使用する情報が出力されます。

UNLOAD_FILE_NAME

現用世代が自動ログアンロードされたときの作成ファイル名称が出力されます。

ajsembdbreclaim

形式

ajsembdbreclaim
     -m {manager|
         scheduler [-F スケジューラーサービス名]|
         agent}
     [-mh 論理ホスト名]
     [-t {d|f}]
     [-r {1|2}]

形式1（マネージャー下のスケジューラーサービス，およびエージェント管理のメンテナンス）

ajsembdbreclaim
     -m manager
     [-mh 論理ホスト名]
     -t f
     -r 2

形式2（マネージャー下のスケジューラーサービス，およびエージェント管理のインデクス領域のメンテナンス）

ajsembdbreclaim
     -m manager
     [-mh 論理ホスト名]
     -t d
     -r 2

形式3（マネージャー下のスケジューラーサービス，およびエージェント管理のページのメンテナンス）

ajsembdbreclaim
     -m manager
     [-mh 論理ホスト名]
     -t f
     -r 1

形式4（マネージャー下のスケジューラーサービス，およびエージェント管理のインデクス領域のページだけをメンテナンス）

ajsembdbreclaim
     -m manager
     [-mh 論理ホスト名]
     -t d
     -r 1

形式5（指定したスケジューラーサービスのメンテナンス）

ajsembdbreclaim
     -m scheduler
     [-F スケジューラーサービス名]
     [-mh 論理ホスト名]
     -t f
     -r 2

形式6（指定したスケジューラーサービスのインデクス領域のメンテナンス）

ajsembdbreclaim
     -m scheduler
     [-F スケジューラーサービス名]
     [-mh 論理ホスト名]
     -t d
     -r 2

形式7（指定したスケジューラーサービスのページのメンテナンス）

ajsembdbreclaim
     -m scheduler
     [-F スケジューラーサービス名]
     [-mh 論理ホスト名]
     -t f
     -r 1

形式8（指定したスケジューラーサービスのインデクス領域のページだけをメンテナンス）

ajsembdbreclaim
     -m scheduler
     [-F スケジューラーサービス名]
     [-mh 論理ホスト名]
     -t d
     -r 1

形式9（エージェント管理のメンテナンス）

ajsembdbreclaim
     -m agent
     [-mh 論理ホスト名]
     -t f
     -r 2

形式10（エージェント管理のインデクス領域のメンテナンス）

ajsembdbreclaim
     -m agent
     [-mh 論理ホスト名]
     -t d
     -r 2

形式11（エージェント管理のページのメンテナンス）

ajsembdbreclaim
     -m agent
     [-mh 論理ホスト名]
     -t f
     -r 1

形式12（エージェント管理のインデクス領域のページだけをメンテナンス）

ajsembdbreclaim
     -m agent
     [-mh 論理ホスト名]
     -t d
     -r 1

機能

JP1/AJS3が使用している組み込みDBの領域をメンテナンスします。

組み込みDBが稼働中の場合だけ実行できます。また，JP1/AJS3の稼働状態に関係なく実行できます。

格納先ディレクトリ

Windowsの場合

JP1/AJS3 - Managerインストール先フォルダ¥tools¥

UNIXの場合

/opt/jp1ajs2/tools/

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-m {manager | scheduler | agent}

メンテナンスの範囲を指定します。

manager

マネージャー（JP1/AJS3 - Manager）内の全スケジューラーサービス，およびエージェント管理をメンテナンスします。

このオプションは，-mhオプションと同時に指定できます。

scheduler

スケジューラーサービス単位でメンテナンスします。

このオプションは，-mh，-Fオプションと同時に指定できます。

agent

エージェント管理をメンテナンスします。

このオプションは，-mhオプションと同時に指定できます。

-F スケジューラーサービス名

メンテナンスを行うスケジューラーサービス名を指定します。

省略した場合は，デフォルトスケジューラーサービス名が仮定されます。

-mh 論理ホスト名

処理対象とするJP1論理ホスト名を指定します。指定できる文字数は，1〜32（単位：バイト）です。

省略した場合，環境変数JP1_HOSTNAMEが設定されていれば，設定値が仮定されます。環境変数JP1_HOSTNAMEが設定されていない場合は，物理ホスト名が仮定されます。

-t d | f

メンテナンスのモードを指定します。

d

インデクス格納領域をメンテナンスします。

f

インデクス，データ格納領域をメンテナンスします。

省略すると「f」が仮定されます。

運用方法によっては，データ格納領域よりもインデクス格納領域が先に満杯になることがあります。ajsembdbstatusコマンドの-db -dオプション指定の出力結果を参照して，データ格納領域でページがあまり解放できない状態で，インデクス格納領域のページが多く解放できる場合に-t dオプションを指定して実行すると効率良くメンテナンスできます。

-r 1 | 2

メンテナンスのレベルを指定します。

1

ページだけを解放します。

2

ページとセグメントを解放します。

省略すると「2」が仮定されます。

ajsembdbstatusコマンドの-db -dオプション指定の出力結果を参照して，解放できるページ数が多く，使用中のセグメント数が少ない場合に-r 1オプションを指定して実行すると，効率良くメンテナンスできます。

注意事項

このコマンドはスクリプトで実装されています。このため，オプションに不当に長い文字列や不正な文字列や値を指定すると，予期しないエラーが発生することがあります。オプション指定値は，DBMSおよびJP1/AJS3で規定されている範囲内の文字列または数値を指定してください。

次の場合，ajsembdbreclaimコマンドがタイムアウトエラーになることがあります。

ジョブやジョブネットの実行負荷が高い場合

コマンドやJP1/AJS3 - Viewでユニットを操作している場合

Web GUI（マネジメントポータル）から，スケジューラーサービスの使用状況または起動条件付きジョブネットの滞留状況の集計を実行している場合

タイムアウトエラーが発生した場合は，これらの場合を避けて，ajsembdbreclaimコマンドを再実行してください。

このコマンド実行中に何らかの障害（通信障害，ディスク障害など）が発生すると，コマンドが無応答になることがありますが，ジョブから自動で実行しているなどによって無応答になったコマンドを手動で強制終了できない場合は，組み込みDBのシステム共通定義pd_utl_exec_timeを指定することで，無応答になったコマンドの実行を打ち切ることができます。pd_utl_exec_timeについては，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　23.1.1 組み込みDB稼働環境と運用方法の検討」のシステム共通定義を参照してください。

ajsembdbreclaimコマンドを同じ組み込みDBに対して同時に複数実行すると，コマンドのどれかがメッセージKFPA11770-Iを出力して異常終了する場合があります。この場合，複数実行したコマンドのうちのどれかが正常終了していれば，対処は不要です。また，ajsembdbreclaimコマンドを同じ組み込みDBに対して同時に複数実行すると，ログの出力処理で競合して，出力結果の行と行の間に次のメッセージが出力される場合があります。

「プロセスはファイルにアクセスできません。別のプロセスが使用中です。」

出力結果の内容に問題はありませんので，このメッセージが出力された場合は，無視してください。

メンテナンスを長期間実施しないで，無効領域が大量に発生している状態でajsembdbreclaimコマンドを実行した場合，システムログを大量に使用することがあります。システムログが不足すると組み込みDBが異常終了します。必要なシステムログの容量を見積もり，不足する場合はシステムログを追加してから，ajsembdbreclaimコマンドを実行してください。無効領域の確認方法および，ajsembdbreclaimコマンド実行時に必要なシステムログの容量については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　9.1.1 データベース領域の解析」を参照してください。

ajsembdbreclaimコマンドを実行する場合は，自動メンテナンス機能によるメンテナンスと同時に実行しないようにしてください。

戻り値

0

正常終了。

0以外の値

異常終了。

エラー時の対処

コマンドエラー発生時は，次に示す表に従って対処してください。

メッセージID

現象

対処方法

KAVS0996-E

指定したオプションに誤りがあります。

オプションの指定内容を見直してください。

KAVS2101-E

組み込みDBは停止中です。

組み込みDBを起動してから再実行してください。

KAVS2102-E

組み込みDBは起動・停止処理中です。

組み込みDBの起動をajsembdbstatusコマンドの-s ustオプション指定で確認してから再実行してください。

KAVS2104-E

組み込みDBがセットアップされていません。

組み込みDBをセットアップしてから再実行してください。

KAVS2116-E

指定したオプションに誤りがあります。

メッセージに出力されているオプションを見直して再実行してください。

KAVS2117-E

コマンド実行時にエラーが発生しました。

保守情報に出力されているメッセージを参照してください。

ジョブやジョブネットの実行負荷が高いためにajsembdbreclaimコマンドがタイムアウトする場合は，負荷が低い時間帯に再実行してください。

コマンドやJP1/AJS3 - Viewからユニットを操作中のためにajsembdbreclaimコマンドがタイムアウトする場合は，ユニットの操作が完了してから再実行してください。

KAVS2123-E

組み込みDBのバージョンが不正です。

組み込みDBをJP1/AJS3の前提バージョンにバージョンアップしてください。

ajsembdbrorg

形式

ajsembdbrorg
     -k {unld|reld}
     [-F スケジューラーサービス名]
     [-mh 論理ホスト名]
     [-agent]
     -d アンロードファイル格納ディレクトリ名

形式1（組み込みDBのデータをアンロードデータファイルへ格納）

ajsembdbrorg
     -k unld
     [-F スケジューラーサービス名]
     [-mh 論理ホスト名]
     [-agent]
     -d アンロードファイル格納ディレクトリ名

形式2（組み込みDBのデータをアンロードデータファイルから復元）

ajsembdbrorg
     -k reld
     [-F スケジューラーサービス名]
     [-mh 論理ホスト名]
     [-agent]
     -d アンロードファイル格納ディレクトリ名

機能

組み込みDBのデータの取り出し，復元を行います。

組み込みDBが稼働中で，該当する組み込みDBにスケジューラーサービスを作成しているすべてのスケジューラーサービスが停止中の場合だけ実行できます。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

JP1/AJS3 - Managerインストール先フォルダ¥tools¥

UNIXの場合

/opt/jp1ajs2/tools/

引数

-k unld | reld

処理内容を指定します。

unld

指定したスケジューラーサービスのデータベースのデータをアンロードデータファイルへ格納します。

reld

指定したスケジューラーサービスのデータベースのデータをアンロードデータファイルから復元します。

-F スケジューラーサービス名

実行対象となるスケジューラーサービス名を指定します。

省略した場合，デフォルトスケジューラーサービス名が仮定されます。

-agentオプションと同時に指定した場合，このオプションは無効になります。

-mh 論理ホスト名

処理対象とするJP1論理ホスト名を指定します。指定できる文字数は，1〜32（単位：バイト）です。

省略した場合，環境変数JP1_HOSTNAMEが設定されていれば，設定値が仮定されます。環境変数JP1_HOSTNAMEが設定されていない場合は，物理ホスト名が仮定されます。

-agent

エージェント管理用のデータベースに対して処理を行います。

-Fオプションと同時に指定した場合，-Fオプションは無効になります。

-d アンロードファイル格納ディレクトリ名

アンロードファイル格納ディレクトリ名を指定します。

ディレクトリ名は絶対パスで指定してください。指定するディレクトリに空白文字を含む場合は，パスを「""」で囲んでください。

ネットワークドライブ上のディスクを指定しないでください。

指定するディレクトリは事前に用意してください。ディレクトリがない場合はエラーになります。

-kオプションにunldを指定した場合は，ここで指定したディレクトリにアンロードファイルが作成されます。

すでにファイルがある場合は，ファイルを削除してよいかどうかの応答メッセージが出力されます。

出力されるメッセージ：OK to Overwrite the unload file?(y/n):

ファイルを削除する場合は「y」を入力してください。

注意事項

このコマンドはスクリプトで実装されています。このため，オプションに不当に長い文字列や不正な文字列や値を指定すると，予期しないエラーが発生することがあります。オプション指定値は，DBMSおよびJP1/AJS3で規定されている範囲内の文字列または数値を指定してください。

このコマンドを実行する前に，該当する組み込みDBにスケジューラーデータベースを作成しているすべてのスケジューラーサービスを停止してください。また，JP1/AJS3サービスを含め，組み込みDBにアクセスしているサービスはすべて停止してください。サービスを停止しないでこのコマンドを実行した場合，長時間の待ち状態が発生するおそれがあります。

-kオプションにunldを指定した場合，-dオプションに指定するディレクトリには次に示す空き容量が必要になります。

ajsembdbbuildのオプション

必要な空き容量

-l（大規模モデル）

約6,700メガバイト

-m（中規模モデル）

約1,400メガバイト

-s（小規模モデル）

約200メガバイト

また，バックアップ強化機能が有効な場合は，-dオプションに指定するディレクトリには次に示す空き容量が必要になります。

ajsembdbbuildのオプション

必要な空き容量

-l（大規模モデル）

約7,200メガバイト

-m（中規模モデル）

約1,900メガバイト

-s（小規模モデル）

約700メガバイト

バックアップ強化機能の設定状況は，ajsembdbstatusコマンドで確認できます。ajsembdbstatusコマンドの詳細については，「3. 通常の運用で使用するコマンド　ajsembdbstatus」を参照してください。

なお，ajsembdbaddareaコマンドで領域を拡張している場合，およびデータベース自動増分機能を使用している場合は，上記サイズに拡張したサイズを追加した値の容量を確保しておく必要があります。

このコマンドを実行するたびに，上記の容量が必要です。

-k reld（復元）を行う場合は，ajsembdbreclaimコマンドを実行し，組み込みDBの領域のメンテナンスを行ってから実行してください。

このコマンド実行中に何らかの障害（通信障害，ディスク障害など）が発生すると，コマンドが無応答になることがありますが，無応答になったコマンドを手動で強制終了できない場合は，組み込みDBのシステム共通定義pd_utl_exec_timeを指定することで，無応答になったコマンドの実行を打ち切ることができます。pd_utl_exec_timeについては，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　23.1.1 組み込みDB稼働環境と運用方法の検討」のシステム共通定義を参照してください。

-Fオプションに同じスケジューラーサービス名を指定したajsembdbrorgコマンドを同時に複数実行しないでください。

-agentオプションを指定したajsembdbrorgコマンドを同じ組み込みDBに対して同時に複数実行しないでください。

-k reldオプションを指定して復元する環境は，-k unldオプションを指定して格納した環境と，バックアップ強化機能の設定が同じである必要があります。

例えば，バックアップ強化機能が有効な環境で-k unldオプションを指定して格納したデータを，バックアップ強化機能が無効な環境に-k reldオプションを指定して復元することはできません。

戻り値

0

正常終了。

0以外の値

異常終了。

エラー時の対処

コマンドエラー発生時は，次に示す表に従って対処してください。

メッセージID

現象

対処方法

KAVS0996-E

指定したオプションに誤りがあります。

オプションの指定内容を見直してください。

KAVS2101-E

組み込みDBは停止中です。

組み込みDBを起動してから再実行してください。

KAVS2102-E

組み込みDBは起動・停止処理中です。

組み込みDBの起動をajsembdbstatusコマンドの-s ustオプション指定で確認してから再実行してください。

KAVS2104-E

組み込みDBがセットアップされていません。

組み込みDBをセットアップしてから再実行してください。

KAVS2106-E

アンロードに失敗しました。

しばらくしてから再実行してください。

KAVS2107-E

リロードに失敗しました。

正しいアンロードデータファイルを指定してから再実行してください。

KAVS2113-E

指定したディレクトリが存在しません。

-dオプションに指定した引数を見直して再実行してください。

KAVS2116-E

指定したオプションに誤りがあります。

メッセージに出力されているオプションを見直して再実行してください。

KAVS2117-E

コマンド実行時にエラーが発生しました。

保守情報に出力されているメッセージを参照してください。

KFPL15047-E

-dオプションに指定したパス，またはパス配下のアンロードログファイルに権限がありません。

指定したパス，またはアンロードログファイルの権限を見直して，再実行してください。AJS管理者で運用している場合は，AJS管理者に対して権限があるか見直してください。

ajsembdbrstr

形式

ajsembdbrstr
     [-mh 論理ホスト名]
     [-M]
     [-i 組み込みDB運用ディレクトリ]
     -d データ領域名称
     -bf バックアップファイル
     [-l アンロードログファイル1,アンロードログファイル2,...|
      -ld アンロードログ格納ディレクトリ]
     -e 出力結果ファイル格納ディレクトリ
     [-id 組み込みDBセットアップ識別子]

機能

組み込みDBをバックアップ，またはバックアップとアンロードログファイルを使ってリストアします。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

JP1/AJS3 - Managerインストール先フォルダ¥tools¥

UNIXの場合

/opt/jp1ajs2/tools/

引数

-mh 論理ホスト名

このオプションは指定不要になりました。このオプションで指定していた論理ホスト名は無視されます。

-M

システム領域を回復する時に指定してください。

システム領域とは，組み込みDBのシステムの内部情報を格納している領域のことです。

組み込みDBのシステム領域を回復する場合には，システム領域を回復するための特別なモードで起動する必要があります。

このモードでは，データ領域の回復ができないので，システム領域の回復が完了したあと，一度ajsembdbstopコマンドを実行して組み込みDBを停止させ，再度ajsembdbstartコマンドにオプションを指定しないで再開始する必要があります。

システム領域とデータ領域を回復する場合，-M以外のオプション，バックアップファイル，アンロードログファイルは同じものを指定してください。

別々のものを指定した場合，データを破壊してしまう場合があるため十分注意してください。

次の場合，このオプションを指定してシステム領域を回復したあと，データ領域を回復してください。

組み込みDBサーバが障害によって停止し，再起動しても起動しない場合。

組み込みDBの障害を取り除いてください。

ajsembdbstartコマンドに-rオプションを指定して実施し，システム領域回復ができる状態で組み込みDBを起動してください。

ajsembdbrstrコマンドに-Mオプションを指定して実行し，組み込みDBのシステム領域を回復してください。

3.が正常に終了した場合，ajsembdbstopコマンドを実施し，システム領域を回復できる状態で起動している組み込みDBを停止させてください。

組み込みDBのajsembdbstartコマンドを実施し，通常の状態で組み込みDBを起動してください。

ajsembdbrstrコマンドを実行し，組み込みDBのデータ部分の回復を行ってください。

ajsembdbstartコマンドおよびajsembdbstopコマンドの詳細については，「3. 通常の運用で使用するコマンド　ajsembdbstart」および「3. 通常の運用で使用するコマンド　ajsembdbstop」を参照してください。

-i 組み込みDB運用ディレクトリ

組み込みDBの運用ディレクトリを指定します。ディレクトリは絶対パスで指定してください。Windows版の場合，指定する絶対パスに空白文字を含む場合はパスを「"（ダブルクォーテーションマーク）」で囲んでください。ajsembdbbuildコマンド-iオプションで指定したディレクトリと同じディレクトリを指定してください。UNIXのセットアップでajsembdbbuildコマンドの-iオプションを省略した場合は，このオプションを省略できます。

省略時は/opt/jp1ajs2/embdb/_JF0が仮定されます。

このオプションは，08-00よりも前のバージョン互換のためのオプションです。通常は，-idオプションを指定してください。

-idオプションと同時に指定した場合，-iオプションに指定した値が有効になります。

-d データ領域名称

組み込みDBのデータ領域名称を指定します。ディレクトリは絶対パスで指定してください。Windows版の場合，指定する絶対パスに空白文字を含む場合はパスを「"（ダブルクォーテーションマーク）」で囲んでください。ajsembdbbuildコマンドの-dオプションで指定した場合は次のように指定してください。

Windowsの場合

[-dオプションで指定したディレクトリ名称]¥ajssys02

UNIXの場合

[-dオプションで指定したディレクトリ名称]/ajssys02

jajs_setupコマンドまたはjajs_migrateコマンドで作成された組み込みDBに対して操作を行う場合，ajsembdbidlistコマンドで操作対象となる組み込みDBの格納ディレクトリを確認してください。ajsembdbidlistコマンドについては，「2. セットアップコマンド　ajsembdbidlist」を参照してください。

Windowsの場合

[ajsembdbidlistコマンドで確認したディレクトリ名称]¥dbarea¥ajssys02

UNIXの場合

/var/opt/jp1ajs2/embdb/_JFn※/dbarea/ajssys02

jajs_setup_clusterコマンドで構築された論理ホスト環境の組み込みDBに対して操作を行う場合，-dオプションに指定された値を指定してください。

Windowsの場合

[-dオプションで指定したディレクトリ名称]¥jp1ajs2¥embdb¥_JFn※¥dbarea¥ajssys02

UNIXの場合

[-dオプションで指定したディレクトリ名称]/jp1ajs2/embdb/_JFn※/dbarea/ajssys02

jajs_setupコマンドで構築された論理ホスト環境の組み込みDBに対して操作を行う場合，-Dオプションに指定された値を指定してください。

Windowsの場合

[-Dオプションで指定したディレクトリ名称]¥jp1ajs2¥embdb¥_JFn※¥dbarea¥ajssys02

UNIXの場合

[-Dオプションで指定したディレクトリ名称]/jp1ajs2/embdb/_JFn※/dbarea/ajssys02

注※

このコマンドの-idオプションに指定する値を指定してください。-idオプションを省略する場合，_JF0を指定してください。

-bf バックアップファイル

ajsembdbbackupコマンドで取得したバックアップファイルを指定します。

ディレクトリは絶対パスで指定してください。Windows版の場合，指定する絶対パスに空白文字を含む場合はパスを「"（ダブルクォーテーションマーク）」で囲んでください。

-l アンロードログファイル1，アンロードログファイル2...

組み込みDBで取得したアンロードログファイルを回復で使用する場合に指定します。このオプションは組み込みDB環境構築時のajsembdbbuildコマンドに-blオプションを指定した場合に指定してください。

アンロードログファイルは絶対パスで指定してください。Windows版の場合，指定する絶対パスに空白文字を含む場合はパスを「"（ダブルクォーテーションマーク）」で囲んでください。アンロードログファイルを指定する場合，指定する順番はアンロードログファイルを取得した順番に指定してください。また，2個以上の複数のアンロードログファイルを指定する場合も，-lから後ろのパスは「"（ダブルクォーテーションマーク）」で囲んでください。

バックアップ取得時に，-sオプションを指定していない場合は，アンロードログファイルの入力を省略できます。その場合は，バックアップ取得時点までデータベースを回復します。

-ld アンロードログ格納ディレクトリ

-lオプションと同様に，回復にアンロードログファイルを使用する場合に指定します。アンロードログファイルを格納しているディレクトリの名称を絶対パスで指定してください。

Windows版の場合，指定する絶対パスに空白文字を含む場合はパス全体を「"（ダブルクォーテーションマーク）」で囲んでください。

-e

リストアの出力結果ファイルを格納するディレクトリを指定してください。Windows版の場合，ディレクトリは絶対パスで指定してください。指定する絶対パスに空白文字を含む場合はパスを「"（ダブルクォーテーションマーク）」で囲んでください。指定したディレクトリは，事前に作成しておいてください。ディレクトリがない場合はエラーになります。

指定したディレクトリには，次のファイルが格納されます。

処理出力結果ファイル

ファイル名称は自動的に決定します。名称は，次の規則によって決定されます。

出力結果ファイル：RSTR_XXXXYYZZVVWW.log

XXXX：西暦

YY：月

ZZ：日

VV：時間

WW：分

-id 組み込みDBセットアップ識別子

組み込みDBを識別するセットアップ識別子を「_JFn」（nは0〜9またはA〜Z）の4文字で指定します。ajsembdbbuildコマンドの-idオプションで指定した値を指定してください。

jajs_setupコマンド，jajs_setup_clusterコマンド，およびjajs_migrateコマンドで作成された組み込みDBに対して操作を行う場合，ajsembdbidlistコマンドで操作対象となる組み込みDBのセットアップ識別子を確認してください。ajsembdbidlistコマンドについては，「2. セットアップコマンド　ajsembdbidlist」を参照してください。

このオプションを省略した場合は，_JF0が仮定されます。

-iオプションと同時に指定した場合，-iオプションが優先されます。

注意事項

組み込みDBの高度なセットアップ方法でデータベース環境を構築し，アンロードログ運用を行っている場合は，ajsembdbrstrコマンドを実行する前にajsembdboplogコマンドを-wオプションを指定して実行してください。現在使用中のシステムログファイルがアンロードされます。ajsembdbrstrコマンドがエラーになって再実行する場合は，ajsembdboplogコマンドの実行は不要です。

スケジューラーサービスを停止した状態で実行してください。

リストア実行時にエラーが発生した場合，データベースの回復が不完全である場合があります。エラーが発生した場合，そのままスケジューラーサービスを起動しないでください。

ajsembdbbackupコマンドのオプションに-sを指定してバックアップを取得した場合，ajsembdbrstrコマンドでのリストアでは，入力情報としてアンロードログファイルが必要になります。

ajsembdbbackupコマンドのオプションに-sを指定しないでバックアップを取得した場合，ajsembdbrstrコマンドでのリストアではアンロードログファイルを使用しないでバックアップファイルだけで回復できます。その場合，バックアップ取得時点までデータベースを回復できます。

リストアが正常終了したあと，バックアップを取得してください。

コマンドの実行結果は，ログファイルに出力されます。格納先は，次の場所になります。

Windowsで，インストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下の場合

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥log

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

「システムで保護されたフォルダ」とは，次のフォルダを指します。

・「システムドライブ¥Windows」配下

・「システムドライブ¥Program Files」配下

・「システムドライブ¥Program Files (x86)」配下

Windowsで，インストール先フォルダが上記以外の場合

JP1/AJS3 - Managerインストール先フォルダ¥log

UNIXの場合

/var/opt/jp1ajs2/log

ファイル名はajsembdbrstr.logです。このファイルは，上書きしないためファイルサイズが無限に大きくなります。必要に応じて退避，削除を行ってください。

このファイルがない場合は，ajsembdbrstrコマンドを実行すると，新たに作成されます。

ajsembdbrstrコマンド実行時にエラーが発生した場合は，組み込みDBのデータベース領域は閉塞状態になっています。この状態で再度ajsembdbrstrコマンドを実行するとエラーが発生します。その場合，次の組み込みDBのコマンドを実行して，データベース領域の閉塞状態を解除してください。

pdrels -r ALL -o

pdrelsコマンドを実行する場合は，実行するコマンドプロンプトで事前に環境変数を設定する必要があります。設定する環境変数については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　9.2.3(2) スクリプトを使用してデータベースを再編成する」の，設定が必要な環境変数を示した表を参照してください。

組み込みDBの環境を削除して，再構築したあとにデータを回復する場合は，ajsembdbsetupコマンドが完了した状態でajsembdbrstrコマンドを実行してください。

また，ajsembdbaddareaコマンドで組み込みDBのデータベース領域を拡張していた場合は，このコマンドの実行前に同様の拡張を行っておく必要があります。ただし，組み込みDBの高度なセットアップ方法でデータベース環境を構築し，アンロードログ運用を行っている場合は，ajsembdboplogコマンドを-wオプションを指定して実行したあとに実施してください。

拡張手順を次に示します。

Windowsの場合

次のフォルダを退避する。

組み込みDB運用フォルダ※¥CONF¥embrm

ajsembdbunsetコマンドを実行する。

ajsembdbbuildコマンドを実行する。

ajsembdbsetupコマンドを実行する。

手順1で退避したフォルダにあるaddareaファイルをaddarea.batにリネームして実行する。

ajsembdbrstrコマンドを実行する。

手順5でリネームしたファイル名をaddareaに戻す。

手順1で退避したフォルダを次のフォルダにリストアする。

組み込みDB運用フォルダ※¥CONF

手順1で退避したフォルダを削除する。

UNIXの場合

次のディレクトリを退避する。

組み込みDB運用ディレクトリ※/conf/embrm

ajsembdbunsetコマンドを実行する。

ajsembdbbuildコマンドを実行する。

ajsembdbsetupコマンドを実行する。

手順1で退避したディレクトリにあるaddareaファイルのパーミッションに実行権限を追加して実行する。

ajsembdbrstrコマンドを実行する。

手順1で退避したディレクトリを次のディレクトリにリストアする。

組み込みDB運用ディレクトリ※/conf

手順1で退避したディレクトリを削除する。

注※

組み込みDB運用フォルダおよび組み込みDB運用ディレクトリはajsembdbidlistコマンドで確認できます。ajsembdbidlistコマンドについては，「2. セットアップコマンド　ajsembdbidlist」を参照してください。

-lオプションを指定するとき，実際に指定したアンロードログファイルに更新情報が格納されていない場合，ajsembdbrstrコマンドがエラーとなります。

このコマンドを同時に複数実行しないでください。同時に複数実行した場合，コマンドが不当にエラーになるおそれがあります。

このコマンドは，バックアップ強化機能が有効な組み込みDBに対しては実行できません。実行した場合はコマンドがエラーとなります。

戻り値

0

正常終了。

0以外の値

異常終了。

エラー発生時の対処

ajsembdbrstrコマンド実行時にエラーが発生した場合は次の表に従って対処してください。

表3‒12　ajsembdbrstrコマンドエラー発生時の対処

メッセージ

原因

対処

KFPR26227-E

アンロードログファイルが指定されていません。

次の組み込みDBのコマンドを実行したあとに，-lオプションにアンロードログファイルを指定して，再実行してください。

pdrels -r ALL -o

KAVS0996-E

引数に誤りがあります。

オプションの指定が不足しています。

同時に指定できないオプションが指定されています。

-iオプションに指定したパスが組み込みDB運用ディレクトリではありません。または，読み取り権限がありません。

指定している引数を見直して，再実行してください。

KFPR00765-I Pdrstr terminated, return code=8またはKFPR00765-I Pdrstr terminated, return code=12

-mhオプションに指定したホスト名が誤っています。

-d,-bf,-e,-l,-ldオプションに指定したパスが誤っています。

-d,-bf,-e,-l,-ldオプションに指定したパスが絶対パスで指定されていません。

指定しているパスを見直し，次の組み込みDBのコマンドを実行したあとに，再実行してください。

pdrels -r ALL -o

KFPR26203-E

-eまたは-ldオプションに指定したパスに権限がありません。

指定したパスの権限を見直して，再実行してください。AJS管理者で運用している場合は，AJS管理者に対して権限があるか見直してください。

KFPS01984-E

-iオプションに指定したパスが絶対パスで指定されていません。

指定しているパスを見直して，再実行してください。

KFPH27006-E

-dオプションに指定したパスに権限がありません。

指定したパスの権限を見直して，再実行してください。AJS管理者で運用している場合は，AJS管理者に対して権限があるか見直してください。

KFPH27008-E

データベース領域が閉塞状態であるため，参照できません。

次の組み込みDBのコマンドを実行したあとに，再実行してください。

pdrels -r ALL -o

Bad directory specified in -i option

-iオプションに指定したパスが組み込みDBの運用ディレクトリでないか，権限がありません。または，セットアップが正常に行われていません。

-iオプションに正しい組み込みDBの運用ディレクトリを指定してください。または，権限を見直して再実行してください。組み込みDBの運用ディレクトリの指定に問題がない場合は，組み込みDBの再セットアップを行ってください。AJS管理者で運用している場合は，AJS管理者に対して権限があるか見直してください。

KAVS2104-E

-idオプションで指定したセットアップ識別子が不正か，組み込みDBがセットアップされていません。

-idオプションで指定したセットアップ識別子の値が正しいことを確認してください。

KAVS8409-E

バックアップ強化機能が有効なため実行できません。

バックアップ強化機能が有効な組み込みDBをリストアする場合は，jajs_dbrestoreコマンドを使用してください。

ajsembdbstart

形式

ajsembdbstart
     [-R|-Rf]
     [-r]
     [-id 組み込みDBセットアップ識別子]

形式1（組み込みDBの開始）

ajsembdbstart
     [-id 組み込みDBセットアップ識別子]

形式2（組み込みDBのシステム領域を回復する場合の開始）

ajsembdbstart
     -r
     [-id 組み込みDBセットアップ識別子]

形式3（組み込みDBの起動抑止解除と開始：UNIX限定）

ajsembdbstart
     -R [-r] [-id 組み込みDBセットアップ識別子]

形式4（組み込みDBの起動抑止解除：UNIX限定）

ajsembdbstart
     -Rf [-id 組み込みDBセットアップ識別子]

機能

組み込みDBを開始します。

組み込みDBが停止中で，該当する組み込みDBにスケジューラーデータベースを作成しているすべてのスケジューラーサービスが停止中の場合だけ実行できます。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

JP1/AJS3 - Managerインストール先フォルダ¥tools¥

UNIXの場合

/opt/jp1ajs2/tools/

引数

-r

ajsembdbrstrコマンドで組み込みDBのシステム領域を回復する場合に指定します。

-id 組み込みDBセットアップ識別子

組み込みDBを識別するセットアップ識別子を「_JFn」（nは0〜9またはA〜Z）の4文字で指定します。ajsembdbbuildコマンドの-idオプションで指定した値を指定してください。

jajs_setupコマンド，jajs_setup_clusterコマンド，およびjajs_migrateコマンドで作成された組み込みDBに対して操作を行う場合，ajsembdbidlistコマンドで操作対象となる組み込みDBのセットアップ識別子を確認してください。ajsembdbidlistコマンドについては，「2. セットアップコマンド　ajsembdbidlist」を参照してください。

このオプションを省略した場合は，_JF0が仮定されます。

-R

UNIX限定のオプションで，組み込みDBの起動抑止を解除したあと，起動処理を行います。

組み込みDBが停止している場合で，かつメッセージKFPS00715-Eで出力された要因コードに対する障害を取り除いた状態で指定してください。

-Rf

UNIX限定のオプションで，組み込みDBの起動抑止を解除します。

組み込みDBの起動処理は行いません。ただし，組み込みDBがバージョン10-00より前の方式で，組み込みDB環境を非クラスタ環境で構築している場合は，起動抑止状態が解除されたあと，自動的に組み込みDBの起動処理が行われます。

同時に-rオプションを指定しても無視されます。

注意事項

このコマンドはスクリプトで実装されています。このため，オプションに不当に長い文字列や不正な文字列や値を指定すると，予期しないエラーが発生することがあります。オプション指定値は，DBMSおよびJP1/AJS3で規定されている範囲内の文字列または数値を指定してください。

同一論理ホスト上では，次のコマンドと同時に実行できません。

ajsprofalterコマンド

ajsembdbstartコマンド

ajsembdbstopコマンド

ajsstartコマンド

ajsstopコマンド

jajs_hstdコマンド

jajs_hstd_stopコマンド

jajs_spmdコマンド

jajs_spmd_statusコマンド

jajs_spmd_stopコマンド

jajs_startコマンド（UNIX限定）

jajs_start.clusterコマンド（UNIX限定）

jajs_stopコマンド（UNIX限定）

jajs_stop.clusterコマンド（UNIX限定）

JP1/AJS3が起動中の場合， ajsembdbstopコマンドで停止したjajs_dbmdプロセスも起動します。ただし，組み込みDBがバージョン10-00より前の方式の場合は，jajs_dbmdプロセスは起動しません。

このコマンドを同時に複数実行しないでください。同時に複数実行した場合，次に示す現象が起こるおそれがあります。

不当なメッセージを出力したり，本来出力するはずのメッセージを出力しなかったりするなど，メッセージ出力が不正になる。

このコマンドが，不当にエラーになる。

Windowsの場合，組み込みDBのサービスが開始していることを確認してください。開始していない場合，このコマンドを実行すると，メッセージKAVS2117-Eが出力されてエラーとなり，メッセージKFPS01801-Eも出力されます。

戻り値

0

正常終了。

1

組み込みDBが起動・停止処理中である。

2

組み込みDBが稼働中である。

上記以外の値

異常終了。

エラー時の対処

コマンドエラー発生時は，次に示す表に従って対処してください。

メッセージID

現象

対処方法

KAVS0787-E

システム管理のデーモンが処理中です。

jajs_spmd_statusコマンドでサービスの状態を確認してから，コマンドを再実行してください。

KAVS0996-E

指定したオプションに誤りがあります。

オプションの指定内容を見直してください。

KAVS2102-E

組み込みDBは起動・停止処理中です。

組み込みDBの起動をajsembdbstatusコマンドの-s ustオプション指定で確認してから再実行してください。

KAVS2103-E

組み込みDBは起動中です。

組み込みDBはすでに起動されているため，特に対処はありません。

KAVS2104-E

組み込みDBがセットアップされていません。

組み込みDBをセットアップしてから再実行してください。

KAVS2116-E

指定したオプションに誤りがあります。

メッセージに出力されているオプションを見直して再実行してください。

KAVS2117-E

コマンド実行時にエラーが発生しました。

保守情報に出力されているメッセージを参照してください。

ajsembdbstatus

形式

ajsembdbstatus
     {-s [ust|prc|usta] |
      -db [-d] |
      -l |
      -c}
     [-id 組み込みDBセットアップ識別子]

形式1（組み込みDBの稼働状態の監視1）

ajsembdbstatus
     -s ust
     [-id 組み込みDBセットアップ識別子]

形式2（組み込みDBの稼働状態の監視2）

ajsembdbstatus
     -s usta
     [-id 組み込みDBセットアップ識別子]

形式3（組み込みDBのプロセスの状態の監視）

ajsembdbstatus
     -s prc
     [-id 組み込みDBセットアップ識別子]

形式4（組み込みDBのデータベース領域の監視）

ajsembdbstatus
     -db
     [-d]
     [-id 組み込みDBセットアップ識別子]

形式5（組み込みDBのシステムログの監視）

ajsembdbstatus
     -l
     [-id 組み込みDBセットアップ識別子]

形式6（組み込みDBの構成情報の出力）

ajsembdbstatus
     -c
     [-id 組み込みDBセットアップ識別子]

機能

組み込みDBを監視します。監視できる項目を次に示します。

組み込みDBの稼働状態

組み込みDBのプロセスの状態

組み込みDBのデータベース領域

組み込みシステムDBのログ

組み込みDBのデータベース領域を監視する（-dbオプションの指定）場合，または組み込みDBのプロセスの状態を監視する（-s prcオプションの指定）場合，組み込みDBが稼働中に実行してください。その他の場合には，稼働状態に関係なく実行できます。

また，JP1/AJS3の稼働状態には関係なく実行できます。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

JP1/AJS3 - Managerインストール先フォルダ¥tools¥

UNIXの場合

/opt/jp1ajs2/tools/

引数

-s {ust|prc|usta}

組み込みDBの状態について監視します。

ust

組み込みDBの起動・停止などの稼働状態を表示します。

prc

組み込みDBのプロセスの状態を表示します。

組み込みDBを操作するコマンドなどが，組み込みDBに対してアクセスしているかどうかを確認する場合に使用します。また，ajsembdbcancelコマンドで組み込みDBにアクセスしているコマンドを中断するときに必要な，サーバ名，またはプログラム名称を取得する場合に使用します。

usta

ustオプション指定時に表示する内容に加えて，組み込みDBの開始状態を表示します。

-db

組み込みDBのデータベース領域について監視します。

メンテナンス時期や，データベース領域の状態を確認する場合に使用します。

-d

データベースの情報を詳細に表示する場合に指定します。

このオプションを指定すると，ajsembdbreclaimコマンドで解放できるページ数を確認できます。

-l

組み込みDBのシステムログについて監視します。

組み込みDBのバックアップまたはリストア時に，システムログファイルの状態を確認する場合に使用します。

-c

組み込みDBの構成情報を出力します。

組み込みDBのバックアップまたはリストア時に，組み込みDBデータ領域ディレクトリを確認する場合や，クラスタ運用のセットアップ時に実行系と待機系の設定が正しいかどうかを確認する場合に使用します。なお，このオプションは，JP1/AJS3 10-00以降で構築された組み込みDBに対して実行した場合にだけ有効です。09-50以前に構築された組み込みDBに対して実行した場合は，メッセージKAVS2129-Iが出力され，コマンドは異常終了します。

-id 組み込みDBセットアップ識別子

組み込みDBを識別するセットアップ識別子を「_JFn」（nは0〜9またはA〜Z）の4文字で指定します。ajsembdbbuildコマンドの-idオプションで指定した値を指定してください。

jajs_setupコマンド，jajs_setup_clusterコマンド，およびjajs_migrateコマンドで作成された組み込みDBに対して操作を行う場合，ajsembdbidlistコマンドで操作対象となる組み込みDBのセットアップ識別子を確認してください。ajsembdbidlistコマンドについては，「2. セットアップコマンド　ajsembdbidlist」を参照してください。

このオプションを省略した場合は，_JF0が仮定されます。

注意事項

このコマンドはスクリプトで実装されています。このため，オプションに不当に長い文字列や不正な文字列や値を指定すると，予期しないエラーが発生することがあります。オプション指定値は，DBMSおよびJP1/AJS3で規定されている範囲内の文字列または数値を指定してください。

JP1/AJS3運用中の状態でajsembdbstatusコマンドに-dbオプションまたは-lオプションを指定して実行した場合，出力される情報が最新の状態とは限りません。コマンド実行時に最新の状態を取得したい場合は，ジョブの定義や実行など，ユニットに対して操作していない状態で実行してください。

ajsembdbstatusコマンドを同じ組み込みDBに対して同時に複数実行すると，ログの出力処理で競合して，出力結果の行と行の間に次のメッセージが出力される場合があります。

「プロセスはファイルにアクセスできません。別のプロセスが使用中です。」

出力結果の内容に問題はありませんので，このメッセージが出力された場合は，無視してください。

戻り値

0

正常終了。

1

組み込みDBが起動・停止処理中である。

2

組み込みDBが停止中である。

4，8，12

異常終了。

16

Windows

組み込みDBのサービスが停止状態である。

UNIX

pdprcdプロセスが停止している状態である。

エラー時の対処

コマンドエラー発生時は，次に示す表に従って対処してください。

メッセージID

現象

対処方法

KAVS0996-E

指定したオプションに誤りがあります。

オプションの指定内容を見直してください。

KAVS2101-E

組み込みDBは停止中です。

組み込みDBを起動してから再実行してください。

KAVS2102-E

組み込みDBは起動・停止処理中です。

組み込みDBの起動をajsembdbstatusコマンドの-s ustオプション指定で確認してから再実行してください。

KAVS2104-E

組み込みDBがセットアップされていません。

組み込みDBをセットアップしてから再実行してください。

KAVS2116-E

指定したオプションに誤りがあります。

メッセージに出力されているオプションを見直して再実行してください。

KAVS2117-E

コマンド実行時にエラーが発生しました。

保守情報に出力されているメッセージを参照してください。

出力例

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

ajsembdbstatus -s usta -id _JF0

HOSTNAME  : 127.0.0.1(144852)
SYSTEMID  : ajs2
UNITID    : unt1
ENTRYHOST : 127.0.0.1
PAIRHOST  :
UNIT-STAT FES-STAT SETUP-STAT
ONLINE    ******** SETUP
START-OPT : NORMAL

HOSTNAME

「127.0.0.1」が表示されます。

（ ）内は，ajsembdbstatusコマンドを実行した時刻が時分秒（HHMMSS）で出力されます。

注意事項

次のどれかに該当する場合は，組み込みDBインストール先ディレクトリのホスト名が32文字以内で出力されます。クラスタ構成の場合は，初めに実行系に設定したホスト名が出力されます。

バージョンが09-50以前のWindows版JP1/AJS3 - Managerを使用していて，かつ論理ホストで組み込みDBを構築した場合

バージョンが09-50以前のUNIX版JP1/AJS3 - Managerを使用している場合

バージョンが09-50以前のJP1/AJS3 - Managerを10-00以降にバージョンアップインストールしていて，かつIPv6で通信するためのセットアップをしていない場合

SYSTEMID

組み込みDBの識別子が4文字で出力されます。JP1/AJS3では，「ajs2」固定です。

UNITID

システム固有の識別子が4文字で出力されます。JP1/AJS3では，「unt1」固定です。

ENTRYHOST

「127.0.0.1」が表示されます。

注意事項

次のどれかに該当する場合は，ajsembdbstatusコマンドを実行したホスト名が出力されます。

バージョンが09-50以前のWindows版JP1/AJS3 - Managerを使用していて，かつ論理ホストで組み込みDBを構築した場合

バージョンが09-50以前のUNIX版JP1/AJS3 - Managerを使用している場合

バージョンが09-50以前のJP1/AJS3 - Managerを10-00以降にバージョンアップインストールしていて，かつIPv6で通信するためのセットアップをしていない場合

PAIRHOST

常に空白です。

UNIT-STAT

システムの状態が出力されます。

PAUSE：組み込みDBの再起動中断状態※

STOP：停止状態

STARTING：開始途中

ONLINE：稼働状態

STOPPING：停止途中

注※

組み込みDBが異常終了し，組み込みDBが独自に実施する再起動で回復できない状態です。

FES-STAT

常に「********」が出力されます。

SETUP-STAT

セットアップの状態が出力されます。

SETUP：

Windowsの場合はajsembdbbuildコマンド実行済みで組み込みDBのサービスが稼働中，UNIXの場合はajsembdbbuildコマンド実行済みであることを示します。

UNSETUP：

Windowsの場合は組み込みDBのサービスが停止中，UNIXの場合はajsembdbunsetコマンドに-rオプションを指定して実行した状態であることを示します。

START-OPT（-s ustaオプション指定時）

組み込みDBの開始状態が出力されます。

NORMAL：通常の組み込みDB開始状態

RECOVERY：組み込みDBのシステム領域を回復する場合の開始状態（ajsembdbstartコマンド-rオプション指定）

********：組み込みDBが開始していない

組み込みDBのプロセスの状態を確認する場合

ajsembdbstatus -s prc -id _JF0

HOSTNAME : 127.0.0.1(110440)
STATUS  PID  UID   GID   SVID  TIME    PROGRAM  C-PID        C-GRP
  L    856    0     0    ajs2  102826  ajsschd  3568(XXX.YYY...)
  L   1868    0     0    ajs2  102832  ajsflowd 3604(XXX.YYY...)
  L   2080    0     0    ajs2  102835  ajssubd  3792(XXX.YYY...)
  L   2116    0     0    ajs2  999999
  L   2136    0     0    ajs2  999999
 :

HOSTNAME

「127.0.0.1」が表示されます。

（ ）内は，ajsembdbstatusコマンドを実行した時刻が時分秒（HHMMSS）で出力されます。

注意事項

次のどれかに該当する場合は，組み込みDBインストール先ディレクトリのホスト名が32文字以内で出力されます。クラスタ構成の場合は，初めに実行系に設定したホスト名が出力されます。

バージョンが09-50以前のWindows版JP1/AJS3 - Managerを使用していて，かつ論理ホストで組み込みDBを構築した場合

バージョンが09-50以前のUNIX版JP1/AJS3 - Managerを使用している場合

バージョンが09-50以前のJP1/AJS3 - Managerを10-00以降にバージョンアップインストールしていて，かつIPv6で通信するためのセットアップをしていない場合

STATUS

組み込みDBが起動しているアクセス用のプロセスの状態が出力されます。

D：開始処理中または終了処理中

L：稼働中

PID

プロセスIDが10けた以内の10進数で出力されます。

UID

常に0が出力されます。

GID

常に0が出力されます。

SVID

プロセスのサーバ名が出力されます。JP1/AJS3で使用しているプロセスについては「ajs2」が出力されます。組み込みDBを操作するコマンドを実行すると，ajsembdbcancelコマンドの-uオプションに指定する情報が出力されることがあります。

TIME

組み込みDBとの接続時刻が時分秒（HHMMSS）で出力されます。

PROGRAM

JP1/AJS3のコマンドプロセス，またはデーモンプロセスの名称が30文字以内で出力されます。

組み込みDBを操作するコマンドを実行すると，実行したコマンド名称以外が出力されることがあります。ajsembdbcancelコマンドの-uオプションに指定する情報が出力されます。

C-PID

組み込みDBと接続していたJP1/AJS3デーモンプロセスまたはコマンドプロセスのプロセスIDが10けた以内の10進数で出力されます。（ ）内は，IPアドレスが15文字以内で出力されます。

接続していないプロセスについては出力されません。

C-GRP

常に空白です。

組み込みDBのデータベース領域の状態を確認する場合

ajsembdbstatus -db -id _JF0

 1684 hh:mm:ss unt1 _pd0dbst KFPK10300-I Pddbst started
 1684 hh:mm:ss unt1 _pd0dbst KFPK10301-I Pddbst terminated, return code=0
 pddbst 08-05(Object Option) ** RD Area Logical Analysis **  YYYY/MM/DD hh:mm:ss
 RD Area Name   : AJS2DATA
  Server        : ajs2
  Total Segment :        301   Segment Size :         10 Pages
  Unused Segment:        297   Page Size    :      30720 Bytes
  History1 Hold Status :      Hold Code :     0  Hold Time :
  History2 Hold Status :      Hold Code :     0  Hold Time :
------------------------------------------------------------------
 Table Name : AJS1ARROW
 Auth Id    : root
 Status     :
 Reference Pending Status :
 Check     Pending Status :
 Segment Reuse :         18 segments
  <Base row segment>
  Search Mode : INS
  Reuse Search Failure :          0/         0
       (1)Used(Full)    (2)Used(      Full)        Sum
  Segment   0%(  0%)          0(         0)          0
  Page      0%(  0%)          0(         0)          0
  Collect On Segment :          0

 Table Name : AJS1BODY
 Auth Id    : root
 Status     :
 Reference Pending Status :
 Check     Pending Status :
 Segment Reuse :         18 segments
  <Base row segment>
  Search Mode : INS
  Reuse Search Failure :          0/         0
          Used(Full)       Used(      Full)        Sum
  Segment   0%(  0%)          0(         0)          0
  Page      0%(  0%)          0(         0)          0
  Collect On Segment :          0

 Table Name : AJS1CAL
 Auth Id    : root
 Status     :
 Reference Pending Status :
 Check     Pending Status :
 Segment Reuse :         18 segments
  <Base row segment>
  Search Mode : INS
  Reuse Search Failure :          0/         0
          Used(Full)       Used(      Full)        Sum
  Segment   0%(  0%)          0(         0)          0
  Page      0%(  0%)          0(         0)          0
  Collect On Segment :          0

 Table Name : AJS1ENTRY
 Auth Id    : root
 Status     :
 Reference Pending Status :
 Check     Pending Status :
 Segment Reuse :         18 segments
  <Base row segment>
  Search Mode : INS
  Reuse Search Failure :          0/         0
          Used(Full)       Used(      Full)        Sum
  Segment   0%(  0%)          0(         0)          0
  Page      0%(  0%)          0(         0)          0
  Collect On Segment :          0

 Table Name : AJS1GEN
 Auth Id    : root
 Status     :
 Reference Pending Status :
 Check     Pending Status :
 Segment Reuse :         18 segments
  <Base row segment>
  Search Mode : INS
  Reuse Search Failure :          0/         0
          Used(Full)       Used(      Full)        Sum
  Segment   0%(  0%)          0(         0)          0
  Page      0%(  0%)          0(         0)          0
  Collect On Segment :          0

 Table Name : AJS1ID
 Auth Id    : root
 Status     :
 Reference Pending Status :
 Check     Pending Status :
 Segment Reuse :         18 segments
  <Base row segment>
  Search Mode : INS
  Reuse Search Failure :          0/         0
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0

 Table Name : AJS1PERF
 Auth Id    : root
 Status     :
 Reference Pending Status :
 Check     Pending Status :
 Segment Reuse :         18 segments
  <Base row segment>
  Search Mode : INS
  Reuse Search Failure :          0/         0
          Used(Full)       Used(      Full)        Sum
  Segment   0%(  0%)          0(         0)          0
  Page      0%(  0%)          0(         0)          0
  Collect On Segment :          0

 Table Name : AJS1RELS
 Auth Id    : root
 Status     :
 Reference Pending Status :
 Check     Pending Status :
 Segment Reuse :         18 segments
  <Base row segment>
  Search Mode : INS
  Reuse Search Failure :          0/         0
          Used(Full)       Used(      Full)        Sum
  Segment   0%(  0%)          0(         0)          0
  Page      0%(  0%)          0(         0)          0
  Collect On Segment :          0

 Table Name : AJS1SCH
 Auth Id    : root
 Status     :
 Reference Pending Status :
 Check     Pending Status :
 Segment Reuse :         18 segments
  <Base row segment>
  Search Mode : INS
  Reuse Search Failure :          0/         0
          Used(Full)       Used(      Full)        Sum
  Segment   0%(  0%)          0(         0)          0
  Page      0%(  0%)          0(         0)          0
  Collect On Segment :          0

 Table Name : AJS1STAT
 Auth Id    : root
 Status     :
 Reference Pending Status :
 Check     Pending Status :
 Segment Reuse :         48 segments
  <Base row segment>
  Search Mode : INS
  Reuse Search Failure :          0/         0
          Used(Full)       Used(      Full)        Sum
  Segment   0%(  0%)          0(         0)          0
  Page      0%(  0%)          0(         0)          0
  Collect On Segment :          0

 Table Name : AJS1UNIT
 Auth Id    : root
 Status     :
 Reference Pending Status :
 Check     Pending Status :
 Segment Reuse :         18 segments
  <Base row segment>
  Search Mode : INS
  Reuse Search Failure :          0/         0
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0

 Table Name : AJSAGTEXECCNT
 Auth Id    : root
 Status     :
 Reference Pending Status :
 Check     Pending Status :
 Segment Reuse :          3 segments
  <Base row segment>
  Search Mode : INS
  Reuse Search Failure :          0/         0
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0

 Table Name : AJSEXECAGT
 Auth Id    : root
 Status     :
 Reference Pending Status :
 Check     Pending Status :
 Segment Reuse :          3 segments
  <Base row segment>
  Search Mode : INS
  Reuse Search Failure :          0/         0
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0

 Table Name : AJSEXECAGTGRP
 Auth Id    : root
 Status     :
 Reference Pending Status :
 Check     Pending Status :
 Segment Reuse :          3 segments
  <Base row segment>
  Search Mode : INS
  Reuse Search Failure :          0/         0
          Used(Full)       Used(      Full)        Sum
  Segment   0%(  0%)          0(         0)          0
  Page      0%(  0%)          0(         0)          0
  Collect On Segment :          0

 Table Name : AJSLINKAGT
 Auth Id    : root
 Status     :
 Reference Pending Status :
 Check     Pending Status :
 Segment Reuse :          3 segments
  <Base row segment>
  Search Mode : INS
  Reuse Search Failure :          0/         0
          Used(Full)       Used(      Full)        Sum
  Segment   0%(  0%)          0(         0)          0
  Page      0%(  0%)          0(         0)          0
  Collect On Segment :          0

 3649 hh:mm:ss unt1 _pd0dbst KFPK10300-I Pddbst started
 3649 hh:mm:ss unt1 _pd0dbst KFPK10301-I Pddbst terminated, return code=0
 pddbst 08-05(Object Option) ** RD Area Logical Analysis **  YYYY/MM/DD hh:mm:ss
 RD Area Name   : AJS2DATA2
  Server        : ajs2
  Total Segment :        100   Segment Size :        100 Pages
  Unused Segment:        100   Page Size    :      30720 Bytes
  History1 Hold Status :      Hold Code :     0  Hold Time :
  History2 Hold Status :      Hold Code :     0  Hold Time :
------------------------------------------------------------------
 Table Name : AJS1JINF
 Auth Id    : root
 Status     :
 Reference Pending Status :
 Check     Pending Status :
 Segment Reuse :         70 segments
  <Base row segment>
  Search Mode : INS
  Reuse Search Failure :          0/         0
          Used(Full)       Used(      Full)        Sum
  Segment   0%(  0%)          0(         0)          0
  Page      0%(  0%)          0(         0)          0
  Collect On Segment :          0
  <BINARY segment>
  Search Mode : INS
  Reuse Search Failure :          0/         0
          Used(Full)       Used(      Full)        Sum
  Segment   0%(  0%)          0(         0)          0
  Page      0%(  0%)          0(         0)          0
  Collect On Segment :          0

 3952 hh:mm:ss unt1 _pd0dbst KFPK10300-I Pddbst started
 3952 hh:mm:ss unt1 _pd0dbst KFPK10301-I Pddbst terminated, return code=0
 pddbst 08-05(Object Option) ** RD Area Logical Analysis **  YYYY/MM/DD hh:mm:ss
 RD Area Name   : AJS2INDX
  Server        : ajs2
  Total Segment :        904   Segment Size :         10 Pages
  Unused Segment:        885   Page Size    :       4096 Bytes
  History1 Hold Status :      Hold Code :     0  Hold Time :
  History2 Hold Status :      Hold Code :     0  Hold Time :
------------------------------------------------------------------
 Index Name : AJS1ARROWINDEX1
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0

 Index Name : AJS1BODYINDEX1
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0

 Index Name : AJS1CALINDEX1
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0

 Index Name : AJS1ENTRYINDEX1
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0

 Index Name : AJS1GENINDEX1
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0

 Index Name : AJS1IDINDEX1
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0

 Index Name : AJS1PERFINDEX1
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0

 Index Name : AJS1PERFINDEX2
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0

 Index Name : AJS1RELSINDEX1
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0

 Index Name : AJS1RELSINDEX2
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0

 Index Name : AJS1RELSINDEX3
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0

 Index Name : AJS1SCHINDEX1
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0

 Index Name : AJS1STATINDEX1
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0

 Index Name : AJS1UNITINDEX1
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0

 Index Name : AJS1UNITINDEX2
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0

 Index Name : AJSAGTEXECCNTINDEX1
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0

 Index Name : AJSEXECAGTGRPINDEX1
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0

 Index Name : AJSEXECAGTINDEX1
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0

 Index Name : AJSLINKAGTINDEX1
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0

 3667 hh:mm:ss unt1 _pd0dbst KFPK10300-I Pddbst started
 3667 hh:mm:ss unt1 _pd0dbst KFPK10301-I Pddbst terminated, return code=0
 pddbst 08-05(Object Option) ** RD Area Logical Analysis **  YYYY/MM/DD hh:mm:ss
 RD Area Name   : AJS2INDX2
  Server        : ajs2
  Total Segment :       3000   Segment Size :         10 Pages
  Unused Segment:       2998   Page Size    :       4096 Bytes
  History1 Hold Status :      Hold Code :     0  Hold Time :
  History2 Hold Status :      Hold Code :     0  Hold Time :
------------------------------------------------------------------
 Index Name : AJS1JINFINDEX1
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0

 Index Name : AJS1JINFINDEX2
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0

RD Area Name

JP1/AJS3で使用している領域の名称が出力されます。

AJS2DATA，AJS2DATA2※：テーブル領域

AJS2INDX，AJS2INDX2※：インデクス領域

注※

AJS2DATA2，AJS2INDX2の情報は，バックアップ強化機能が有効な場合にだけ出力されます。

Server

常に「ajs2」が出力されます。

Total Segment

出力している領域の総セグメント数が出力されます。

Unused Segment

出力している領域の未使用セグメント数の合計が出力されます。

Segment Size

1セグメント内のページ数が出力されます。

Page Size

1ページのサイズがバイト単位で出力されます。

History1 Hold Status Code，Hold Code，Hold Time

システムが使用する情報です。

History2 Hold Status Code，Hold Code，Hold Time

システムが使用する情報です。

Table Name

JP1/AJS3で使用しているテーブル名が出力されます。

Index Name

JP1/AJS3で使用しているインデクス名が出力されます。

Auth Id

テーブルまたはインデクスの認可識別子が出力されます。JP1/AJS3では，通常「root」が出力されます。

Segment Reuse

空き領域の再利用機能の，再利用開始ポイントの設定値（セグメント数）が出力されます。空き領域の再利用機能を無効にしている場合は，「-（ハイフン）」が出力されます。

Collect On Segment

ajsembdbreclaimコマンドが実行中，またはajsembdbreclaimコマンドが正常終了しなかったことで，解放処理が途中の状態のセグメント数が出力されます。

Status，Reference Pending Status，Check Pending Status，Search Mode，Reuse Search Failure

システムで使用する情報です。

(1)Used(Full)

使用中セグメント数または使用中ページ数の比率が出力されます。（）内は，そのうちの満杯セグメントまたは満杯ページの比率が出力されます。

(2)Used( Full)

使用中セグメント数または使用中ページの数が出力されます。（）内は，そのうちの満杯セグメントまたは満杯ページの数が出力されます。

Sum

テーブルまたはインデクスに割り当てられているセグメント数またはページ数の合計が出力されます。

組み込みDBのデータベース領域の詳細を確認する場合

ajsembdbstatus -db -d -id _JF0

 3240 hh:mm:ss unt1 _pd0dbst KFPK10300-I Pddbst started
 3240 hh:mm:ss unt1 _pd0dbst KFPK10301-I Pddbst terminated, return code=0
 pddbst 08-05(Object Option) ** RD Area Logical Analysis **  YYYY/MM/DD hh:mm:ss
 RD Area Name   : AJS2DATA
  Server        : ajs2
  Total Segment :        301   Segment Size :         10 Pages
  Unused Segment:        297   Page Size    :      30720 Bytes
  History1 Hold Status :      Hold Code :     0  Hold Time :
  History2 Hold Status :      Hold Code :     0  Hold Time :
------------------------------------------------------------------
 Table Name : AJS1ARROW
 Auth Id    : root
 Status     :
 Reference Pending Status :
 Check     Pending Status :
 Segment Reuse :         18 segments
  <Base row segment>
  Search Mode : INS
  Reuse Search Failure :          0/         0
          Used(Full)       Used(      Full)        Sum
  Segment   0%(  0%)          0(         0)          0
  Page      0%(  0%)          0(         0)          0
  Collect On Segment :          0
  Collect Prearranged Page :          0
  Used Page Ratio       Page(Ratio)
             0% :          0(   0%)
         1- 10% :          0(   0%)
        11- 20% :          0(   0%)
        21- 30% :          0(   0%)
        31- 40% :          0(   0%)
        41- 50% :          0(   0%)
        51- 60% :          0(   0%)
        61- 70% :          0(   0%)
        71- 80% :          0(   0%)
        81- 90% :          0(   0%)
        91-100% :          0(   0%)
  Total                    0

 Table Name : AJS1BODY
 Auth Id    : root
 Status     :
 Reference Pending Status :
 Check     Pending Status :
 Segment Reuse :         18 segments
  <Base row segment>
  Search Mode : INS
  Reuse Search Failure :          0/         0
          Used(Full)       Used(      Full)        Sum
  Segment   0%(  0%)          0(         0)          0
  Page      0%(  0%)          0(         0)          0
  Collect On Segment :          0
  Collect Prearranged Page :          0
  Used Page Ratio       Page(Ratio)
             0% :          0(   0%)
         1- 10% :          0(   0%)
        11- 20% :          0(   0%)
        21- 30% :          0(   0%)
        31- 40% :          0(   0%)
        41- 50% :          0(   0%)
        51- 60% :          0(   0%)
        61- 70% :          0(   0%)
        71- 80% :          0(   0%)
        81- 90% :          0(   0%)
        91-100% :          0(   0%)
  Total                    0

 Table Name : AJS1CAL
 Auth Id    : root
 Status     :
 Reference Pending Status :
 Check     Pending Status :
 Segment Reuse :         18 segments
  <Base row segment>
  Search Mode : INS
  Reuse Search Failure :          0/         0
          Used(Full)       Used(      Full)        Sum
  Segment   0%(  0%)          0(         0)          0
  Page      0%(  0%)          0(         0)          0
  Collect On Segment :          0
  Collect Prearranged Page :          0
  Used Page Ratio       Page(Ratio)
             0% :          0(   0%)
         1- 10% :          0(   0%)
        11- 20% :          0(   0%)
        21- 30% :          0(   0%)
        31- 40% :          0(   0%)
        41- 50% :          0(   0%)
        51- 60% :          0(   0%)
        61- 70% :          0(   0%)
        71- 80% :          0(   0%)
        81- 90% :          0(   0%)
        91-100% :          0(   0%)
  Total                    0

 Table Name : AJS1ENTRY
 Auth Id    : root
 Status     :
 Reference Pending Status :
 Check     Pending Status :
 Segment Reuse :         18 segments
  <Base row segment>
  Search Mode : INS
  Reuse Search Failure :          0/         0
          Used(Full)       Used(      Full)        Sum
  Segment   0%(  0%)          0(         0)          0
  Page      0%(  0%)          0(         0)          0
  Collect On Segment :          0
  Collect Prearranged Page :          0
  Used Page Ratio       Page(Ratio)
             0% :          0(   0%)
         1- 10% :          0(   0%)
        11- 20% :          0(   0%)
        21- 30% :          0(   0%)
        31- 40% :          0(   0%)
        41- 50% :          0(   0%)
        51- 60% :          0(   0%)
        61- 70% :          0(   0%)
        71- 80% :          0(   0%)
        81- 90% :          0(   0%)
        91-100% :          0(   0%)
  Total                    0

 Table Name : AJS1GEN
 Auth Id    : root
 Status     :
 Reference Pending Status :
 Check     Pending Status :
 Segment Reuse :         18 segments
  <Base row segment>
  Search Mode : INS
  Reuse Search Failure :          0/         0
          Used(Full)       Used(      Full)        Sum
  Segment   0%(  0%)          0(         0)          0
  Page      0%(  0%)          0(         0)          0
  Collect On Segment :          0
  Collect Prearranged Page :          0
  Used Page Ratio       Page(Ratio)
             0% :          0(   0%)
         1- 10% :          0(   0%)
        11- 20% :          0(   0%)
        21- 30% :          0(   0%)
        31- 40% :          0(   0%)
        41- 50% :          0(   0%)
        51- 60% :          0(   0%)
        61- 70% :          0(   0%)
        71- 80% :          0(   0%)
        81- 90% :          0(   0%)
        91-100% :          0(   0%)
  Total                    0

 Table Name : AJS1ID
 Auth Id    : root
 Status     :
 Reference Pending Status :
 Check     Pending Status :
 Segment Reuse :         18 segments
  <Base row segment>
  Search Mode : INS
  Reuse Search Failure :          0/         0
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0
  Collect Prearranged Page :          0
  Used Page Ratio       Page(Ratio)
             0% :          9(  90%)
         1- 10% :          1(  10%)
        11- 20% :          0(   0%)
        21- 30% :          0(   0%)
        31- 40% :          0(   0%)
        41- 50% :          0(   0%)
        51- 60% :          0(   0%)
        61- 70% :          0(   0%)
        71- 80% :          0(   0%)
        81- 90% :          0(   0%)
        91-100% :          0(   0%)
  Total                   10

 Table Name : AJS1PERF
 Auth Id    : root
 Status     :
 Reference Pending Status :
 Check     Pending Status :
 Segment Reuse :         18 segments
  <Base row segment>
  Search Mode : INS
  Reuse Search Failure :          0/         0
          Used(Full)       Used(      Full)        Sum
  Segment   0%(  0%)          0(         0)          0
  Page      0%(  0%)          0(         0)          0
  Collect On Segment :          0
  Collect Prearranged Page :          0
  Used Page Ratio       Page(Ratio)
             0% :          0(   0%)
         1- 10% :          0(   0%)
        11- 20% :          0(   0%)
        21- 30% :          0(   0%)
        31- 40% :          0(   0%)
        41- 50% :          0(   0%)
        51- 60% :          0(   0%)
        61- 70% :          0(   0%)
        71- 80% :          0(   0%)
        81- 90% :          0(   0%)
        91-100% :          0(   0%)
  Total                    0

 Table Name : AJS1RELS
 Auth Id    : root
 Status     :
 Reference Pending Status :
 Check     Pending Status :
 Segment Reuse :         18 segments
  <Base row segment>
  Search Mode : INS
  Reuse Search Failure :          0/         0
          Used(Full)       Used(      Full)        Sum
  Segment   0%(  0%)          0(         0)          0
  Page      0%(  0%)          0(         0)          0
  Collect On Segment :          0
  Collect Prearranged Page :          0
  Used Page Ratio       Page(Ratio)
             0% :          0(   0%)
         1- 10% :          0(   0%)
        11- 20% :          0(   0%)
        21- 30% :          0(   0%)
        31- 40% :          0(   0%)
        41- 50% :          0(   0%)
        51- 60% :          0(   0%)
        61- 70% :          0(   0%)
        71- 80% :          0(   0%)
        81- 90% :          0(   0%)
        91-100% :          0(   0%)
  Total                    0

 Table Name : AJS1SCH
 Auth Id    : root
 Status     :
 Reference Pending Status :
 Check     Pending Status :
 Segment Reuse :         18 segments
  <Base row segment>
  Search Mode : INS
  Reuse Search Failure :          0/         0
          Used(Full)       Used(      Full)        Sum
  Segment   0%(  0%)          0(         0)          0
  Page      0%(  0%)          0(         0)          0
  Collect On Segment :          0
  Collect Prearranged Page :          0
  Used Page Ratio       Page(Ratio)
             0% :          0(   0%)
         1- 10% :          0(   0%)
        11- 20% :          0(   0%)
        21- 30% :          0(   0%)
        31- 40% :          0(   0%)
        41- 50% :          0(   0%)
        51- 60% :          0(   0%)
        61- 70% :          0(   0%)
        71- 80% :          0(   0%)
        81- 90% :          0(   0%)
        91-100% :          0(   0%)
  Total                    0

 Table Name : AJS1STAT
 Auth Id    : root
 Status     :
 Reference Pending Status :
 Check     Pending Status :
 Segment Reuse :         48 segments
  <Base row segment>
  Search Mode : INS
  Reuse Search Failure :          0/         0
          Used(Full)       Used(      Full)        Sum
  Segment   0%(  0%)          0(         0)          0
  Page      0%(  0%)          0(         0)          0
  Collect On Segment :          0
  Collect Prearranged Page :          0
  Used Page Ratio       Page(Ratio)
             0% :          0(   0%)
         1- 10% :          0(   0%)
        11- 20% :          0(   0%)
        21- 30% :          0(   0%)
        31- 40% :          0(   0%)
        41- 50% :          0(   0%)
        51- 60% :          0(   0%)
        61- 70% :          0(   0%)
        71- 80% :          0(   0%)
        81- 90% :          0(   0%)
        91-100% :          0(   0%)
  Total                    0

 Table Name : AJS1UNIT
 Auth Id    : root
 Status     :
 Reference Pending Status :
 Check     Pending Status :
 Segment Reuse :         18 segments
  <Base row segment>
  Search Mode : INS
  Reuse Search Failure :          0/         0
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0
  Collect Prearranged Page :          0
  Used Page Ratio       Page(Ratio)
             0% :          9(  90%)
         1- 10% :          1(  10%)
        11- 20% :          0(   0%)
        21- 30% :          0(   0%)
        31- 40% :          0(   0%)
        41- 50% :          0(   0%)
        51- 60% :          0(   0%)
        61- 70% :          0(   0%)
        71- 80% :          0(   0%)
        81- 90% :          0(   0%)
        91-100% :          0(   0%)
  Total                   10

 Table Name : AJSAGTEXECCNT
 Auth Id    : root
 Status     :
 Reference Pending Status :
 Check     Pending Status :
 Segment Reuse :          3 segments
  <Base row segment>
  Search Mode : INS
  Reuse Search Failure :          0/         0
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0
  Collect Prearranged Page :          0
  Used Page Ratio       Page(Ratio)
             0% :          9(  90%)
         1- 10% :          1(  10%)
        11- 20% :          0(   0%)
        21- 30% :          0(   0%)
        31- 40% :          0(   0%)
        41- 50% :          0(   0%)
        51- 60% :          0(   0%)
        61- 70% :          0(   0%)
        71- 80% :          0(   0%)
        81- 90% :          0(   0%)
        91-100% :          0(   0%)
  Total                   10

 Table Name : AJSEXECAGT
 Auth Id    : root
 Status     :
 Reference Pending Status :
 Check     Pending Status :
 Segment Reuse :          3 segments
  <Base row segment>
  Search Mode : INS
  Reuse Search Failure :          0/         0
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0
  Collect Prearranged Page :          0
  Used Page Ratio       Page(Ratio)
             0% :          9(  90%)
         1- 10% :          1(  10%)
        11- 20% :          0(   0%)
        21- 30% :          0(   0%)
        31- 40% :          0(   0%)
        41- 50% :          0(   0%)
        51- 60% :          0(   0%)
        61- 70% :          0(   0%)
        71- 80% :          0(   0%)
        81- 90% :          0(   0%)
        91-100% :          0(   0%)
  Total                   10

 Table Name : AJSEXECAGTGRP
 Auth Id    : root
 Status     :
 Reference Pending Status :
 Check     Pending Status :
 Segment Reuse :          3 segments
  <Base row segment>
  Search Mode : INS
  Reuse Search Failure :          0/         0
          Used(Full)       Used(      Full)        Sum
  Segment   0%(  0%)          0(         0)          0
  Page      0%(  0%)          0(         0)          0
  Collect On Segment :          0
  Collect Prearranged Page :          0
  Used Page Ratio       Page(Ratio)
             0% :          0(   0%)
         1- 10% :          0(   0%)
        11- 20% :          0(   0%)
        21- 30% :          0(   0%)
        31- 40% :          0(   0%)
        41- 50% :          0(   0%)
        51- 60% :          0(   0%)
        61- 70% :          0(   0%)
        71- 80% :          0(   0%)
        81- 90% :          0(   0%)
        91-100% :          0(   0%)
  Total                    0

 Table Name : AJSLINKAGT
 Auth Id    : root
 Status     :
 Reference Pending Status :
 Check     Pending Status :
 Segment Reuse :          3 segments
  <Base row segment>
  Search Mode : INS
  Reuse Search Failure :          0/         0
          Used(Full)       Used(      Full)        Sum
  Segment   0%(  0%)          0(         0)          0
  Page      0%(  0%)          0(         0)          0
  Collect On Segment :          0
  Collect Prearranged Page :          0
  Used Page Ratio       Page(Ratio)
             0% :          0(   0%)
         1- 10% :          0(   0%)
        11- 20% :          0(   0%)
        21- 30% :          0(   0%)
        31- 40% :          0(   0%)
        41- 50% :          0(   0%)
        51- 60% :          0(   0%)
        61- 70% :          0(   0%)
        71- 80% :          0(   0%)
        81- 90% :          0(   0%)
        91-100% :          0(   0%)
  Total                    0

 3711 hh:mm:ss unt1 _pd0dbst KFPK10300-I Pddbst started
 3711 hh:mm:ss unt1 _pd0dbst KFPK10301-I Pddbst terminated, return code=0
 pddbst 08-05(Object Option) ** RD Area Logical Analysis **  YYYY/MM/DD hh:mm:ss
 RD Area Name   : AJS2DATA2
  Server        : ajs2
  Total Segment :        100   Segment Size :        100 Pages
  Unused Segment:        100   Page Size    :      30720 Bytes
  History1 Hold Status :      Hold Code :     0  Hold Time :
  History2 Hold Status :      Hold Code :     0  Hold Time :
------------------------------------------------------------------
 Table Name : AJS1JINF
 Auth Id    : root
 Status     :
 Reference Pending Status :
 Check     Pending Status :
 Segment Reuse :         70 segments
  <Base row segment>
  Search Mode : INS
  Reuse Search Failure :          0/         0
          Used(Full)       Used(      Full)        Sum
  Segment   0%(  0%)          0(         0)          0
  Page      0%(  0%)          0(         0)          0
  Collect On Segment :          0
  Collect Prearranged Page :          0
  Used Page Ratio       Page(Ratio)
             0% :          0(   0%)
         1- 10% :          0(   0%)
        11- 20% :          0(   0%)
        21- 30% :          0(   0%)
        31- 40% :          0(   0%)
        41- 50% :          0(   0%)
        51- 60% :          0(   0%)
        61- 70% :          0(   0%)
        71- 80% :          0(   0%)
        81- 90% :          0(   0%)
        91-100% :          0(   0%)
  Total                    0
  <BINARY segment>
  Search Mode : INS
  Reuse Search Failure :          0/         0
          Used(Full)       Used(      Full)        Sum
  Segment   0%(  0%)          0(         0)          0
  Page      0%(  0%)          0(         0)          0
  Collect On Segment :          0
  Collect Prearranged Page :          0
  Used Page Ratio       Page(Ratio)
             0% :          0(   0%)
         1- 10% :          0(   0%)
        11- 20% :          0(   0%)
        21- 30% :          0(   0%)
        31- 40% :          0(   0%)
        41- 50% :          0(   0%)
        51- 60% :          0(   0%)
        61- 70% :          0(   0%)
        71- 80% :          0(   0%)
        81- 90% :          0(   0%)
        91-100% :          0(   0%)
  Total                    0

 4872 hh:mm:ss unt1 _pd0dbst KFPK10300-I Pddbst started
 4872 hh:mm:ss unt1 _pd0dbst KFPK10301-I Pddbst terminated, return code=0
 pddbst 08-05(Object Option) ** RD Area Logical Analysis **  YYYY/MM/DD hh:mm:ss
 RD Area Name   : AJS2INDX
  Server        : ajs2
  Total Segment :        904   Segment Size :         10 Pages
  Unused Segment:        885   Page Size    :       4096 Bytes
  History1 Hold Status :      Hold Code :     0  Hold Time :
  History2 Hold Status :      Hold Code :     0  Hold Time :
------------------------------------------------------------------
 Index Name : AJS1ARROWINDEX1
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0
  Collect Prearranged Page :          1
  Collect On Page :          0
  Used Page Ratio       Page(Ratio)
             0% :         10( 100%)
         1- 10% :          0(   0%)
        11- 20% :          0(   0%)
        21- 30% :          0(   0%)
        31- 40% :          0(   0%)
        41- 50% :          0(   0%)
        51- 60% :          0(   0%)
        61- 70% :          0(   0%)
        71- 80% :          0(   0%)
        81- 90% :          0(   0%)
        91-100% :          0(   0%)
  Total                   10

 Index Name : AJS1BODYINDEX1
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0
  Collect Prearranged Page :          1
  Collect On Page :          0
  Used Page Ratio       Page(Ratio)
             0% :         10( 100%)
         1- 10% :          0(   0%)
        11- 20% :          0(   0%)
        21- 30% :          0(   0%)
        31- 40% :          0(   0%)
        41- 50% :          0(   0%)
        51- 60% :          0(   0%)
        61- 70% :          0(   0%)
        71- 80% :          0(   0%)
        81- 90% :          0(   0%)
        91-100% :          0(   0%)
  Total                   10

 Index Name : AJS1CALINDEX1
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0
  Collect Prearranged Page :          1
  Collect On Page :          0
  Used Page Ratio       Page(Ratio)
             0% :         10( 100%)
         1- 10% :          0(   0%)
        11- 20% :          0(   0%)
        21- 30% :          0(   0%)
        31- 40% :          0(   0%)
        41- 50% :          0(   0%)
        51- 60% :          0(   0%)
        61- 70% :          0(   0%)
        71- 80% :          0(   0%)
        81- 90% :          0(   0%)
        91-100% :          0(   0%)
  Total                   10

 Index Name : AJS1ENTRYINDEX1
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0
  Collect Prearranged Page :          1
  Collect On Page :          0
  Used Page Ratio       Page(Ratio)
             0% :         10( 100%)
         1- 10% :          0(   0%)
        11- 20% :          0(   0%)
        21- 30% :          0(   0%)
        31- 40% :          0(   0%)
        41- 50% :          0(   0%)
        51- 60% :          0(   0%)
        61- 70% :          0(   0%)
        71- 80% :          0(   0%)
        81- 90% :          0(   0%)
        91-100% :          0(   0%)
  Total                   10

 Index Name : AJS1GENINDEX1
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0
  Collect Prearranged Page :          1
  Collect On Page :          0
  Used Page Ratio       Page(Ratio)
             0% :         10( 100%)
         1- 10% :          0(   0%)
        11- 20% :          0(   0%)
        21- 30% :          0(   0%)
        31- 40% :          0(   0%)
        41- 50% :          0(   0%)
        51- 60% :          0(   0%)
        61- 70% :          0(   0%)
        71- 80% :          0(   0%)
        81- 90% :          0(   0%)
        91-100% :          0(   0%)
  Total                   10

 Index Name : AJS1IDINDEX1
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0
  Collect Prearranged Page :          0
  Collect On Page :          0
  Used Page Ratio       Page(Ratio)
             0% :          9(  90%)
         1- 10% :          1(  10%)
        11- 20% :          0(   0%)
        21- 30% :          0(   0%)
        31- 40% :          0(   0%)
        41- 50% :          0(   0%)
        51- 60% :          0(   0%)
        61- 70% :          0(   0%)
        71- 80% :          0(   0%)
        81- 90% :          0(   0%)
        91-100% :          0(   0%)
  Total                   10

 Index Name : AJS1PERFINDEX1
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0
  Collect Prearranged Page :          1
  Collect On Page :          0
  Used Page Ratio       Page(Ratio)
             0% :         10( 100%)
         1- 10% :          0(   0%)
        11- 20% :          0(   0%)
        21- 30% :          0(   0%)
        31- 40% :          0(   0%)
        41- 50% :          0(   0%)
        51- 60% :          0(   0%)
        61- 70% :          0(   0%)
        71- 80% :          0(   0%)
        81- 90% :          0(   0%)
        91-100% :          0(   0%)
  Total                   10

 Index Name : AJS1PERFINDEX2
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0
  Collect Prearranged Page :          1
  Collect On Page :          0
  Used Page Ratio       Page(Ratio)
             0% :         10( 100%)
         1- 10% :          0(   0%)
        11- 20% :          0(   0%)
        21- 30% :          0(   0%)
        31- 40% :          0(   0%)
        41- 50% :          0(   0%)
        51- 60% :          0(   0%)
        61- 70% :          0(   0%)
        71- 80% :          0(   0%)
        81- 90% :          0(   0%)
        91-100% :          0(   0%)
  Total                   10

 Index Name : AJS1RELSINDEX1
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0
  Collect Prearranged Page :          1
  Collect On Page :          0
  Used Page Ratio       Page(Ratio)
             0% :         10( 100%)
         1- 10% :          0(   0%)
        11- 20% :          0(   0%)
        21- 30% :          0(   0%)
        31- 40% :          0(   0%)
        41- 50% :          0(   0%)
        51- 60% :          0(   0%)
        61- 70% :          0(   0%)
        71- 80% :          0(   0%)
        81- 90% :          0(   0%)
        91-100% :          0(   0%)
  Total                   10

 Index Name : AJS1RELSINDEX2
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0
  Collect Prearranged Page :          1
  Collect On Page :          0
  Used Page Ratio       Page(Ratio)
             0% :         10( 100%)
         1- 10% :          0(   0%)
        11- 20% :          0(   0%)
        21- 30% :          0(   0%)
        31- 40% :          0(   0%)
        41- 50% :          0(   0%)
        51- 60% :          0(   0%)
        61- 70% :          0(   0%)
        71- 80% :          0(   0%)
        81- 90% :          0(   0%)
        91-100% :          0(   0%)
  Total                   10

 Index Name : AJS1RELSINDEX3
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0
  Collect Prearranged Page :          1
  Collect On Page :          0
  Used Page Ratio       Page(Ratio)
             0% :         10( 100%)
         1- 10% :          0(   0%)
        11- 20% :          0(   0%)
        21- 30% :          0(   0%)
        31- 40% :          0(   0%)
        41- 50% :          0(   0%)
        51- 60% :          0(   0%)
        61- 70% :          0(   0%)
        71- 80% :          0(   0%)
        81- 90% :          0(   0%)
        91-100% :          0(   0%)
  Total                   10

 Index Name : AJS1SCHINDEX1
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0
  Collect Prearranged Page :          1
  Collect On Page :          0
  Used Page Ratio       Page(Ratio)
             0% :         10( 100%)
         1- 10% :          0(   0%)
        11- 20% :          0(   0%)
        21- 30% :          0(   0%)
        31- 40% :          0(   0%)
        41- 50% :          0(   0%)
        51- 60% :          0(   0%)
        61- 70% :          0(   0%)
        71- 80% :          0(   0%)
        81- 90% :          0(   0%)
        91-100% :          0(   0%)
  Total                   10

 Index Name : AJS1STATINDEX1
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0
  Collect Prearranged Page :          1
  Collect On Page :          0
  Used Page Ratio       Page(Ratio)
             0% :         10( 100%)
         1- 10% :          0(   0%)
        11- 20% :          0(   0%)
        21- 30% :          0(   0%)
        31- 40% :          0(   0%)
        41- 50% :          0(   0%)
        51- 60% :          0(   0%)
        61- 70% :          0(   0%)
        71- 80% :          0(   0%)
        81- 90% :          0(   0%)
        91-100% :          0(   0%)
  Total                   10

 Index Name : AJS1UNITINDEX1
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0
  Collect Prearranged Page :          0
  Collect On Page :          0
  Used Page Ratio       Page(Ratio)
             0% :          9(  90%)
         1- 10% :          1(  10%)
        11- 20% :          0(   0%)
        21- 30% :          0(   0%)
        31- 40% :          0(   0%)
        41- 50% :          0(   0%)
        51- 60% :          0(   0%)
        61- 70% :          0(   0%)
        71- 80% :          0(   0%)
        81- 90% :          0(   0%)
        91-100% :          0(   0%)
  Total                   10

 Index Name : AJS1UNITINDEX2
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0
  Collect Prearranged Page :          0
  Collect On Page :          0
  Used Page Ratio       Page(Ratio)
             0% :          9(  90%)
         1- 10% :          1(  10%)
        11- 20% :          0(   0%)
        21- 30% :          0(   0%)
        31- 40% :          0(   0%)
        41- 50% :          0(   0%)
        51- 60% :          0(   0%)
        61- 70% :          0(   0%)
        71- 80% :          0(   0%)
        81- 90% :          0(   0%)
        91-100% :          0(   0%)
  Total                   10

 Index Name : AJSAGTEXECCNTINDEX1
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0
  Collect Prearranged Page :          0
  Collect On Page :          0
  Used Page Ratio       Page(Ratio)
             0% :          9(  90%)
         1- 10% :          0(   0%)
        11- 20% :          0(   0%)
        21- 30% :          1(  10%)
        31- 40% :          0(   0%)
        41- 50% :          0(   0%)
        51- 60% :          0(   0%)
        61- 70% :          0(   0%)
        71- 80% :          0(   0%)
        81- 90% :          0(   0%)
        91-100% :          0(   0%)
  Total                   10

 Index Name : AJSEXECAGTGRPINDEX1
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0
  Collect Prearranged Page :          1
  Collect On Page :          0
  Used Page Ratio       Page(Ratio)
             0% :         10( 100%)
         1- 10% :          0(   0%)
        11- 20% :          0(   0%)
        21- 30% :          0(   0%)
        31- 40% :          0(   0%)
        41- 50% :          0(   0%)
        51- 60% :          0(   0%)
        61- 70% :          0(   0%)
        71- 80% :          0(   0%)
        81- 90% :          0(   0%)
        91-100% :          0(   0%)
  Total                   10

 Index Name : AJSEXECAGTINDEX1
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0
  Collect Prearranged Page :          0
  Collect On Page :          0
  Used Page Ratio       Page(Ratio)
             0% :          9(  90%)
         1- 10% :          1(  10%)
        11- 20% :          0(   0%)
        21- 30% :          0(   0%)
        31- 40% :          0(   0%)
        41- 50% :          0(   0%)
        51- 60% :          0(   0%)
        61- 70% :          0(   0%)
        71- 80% :          0(   0%)
        81- 90% :          0(   0%)
        91-100% :          0(   0%)
  Total                   10

 Index Name : AJSLINKAGTINDEX1
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0
  Collect Prearranged Page :          1
  Collect On Page :          0
  Used Page Ratio       Page(Ratio)
             0% :         10( 100%)
         1- 10% :          0(   0%)
        11- 20% :          0(   0%)
        21- 30% :          0(   0%)
        31- 40% :          0(   0%)
        41- 50% :          0(   0%)
        51- 60% :          0(   0%)
        61- 70% :          0(   0%)
        71- 80% :          0(   0%)
        81- 90% :          0(   0%)
        91-100% :          0(   0%)
  Total                   10

3729 hh:mm:ss unt1 _pd0dbst KFPK10300-I Pddbst started
 3729 hh:mm:ss unt1 _pd0dbst KFPK10301-I Pddbst terminated, return code=0
 pddbst 08-05(Object Option) ** RD Area Logical Analysis **  YYYY/MM/DD hh:mm:ss
 RD Area Name   : AJS2INDX2
  Server        : ajs2
  Total Segment :       3000   Segment Size :         10 Pages
  Unused Segment:       2998   Page Size    :       4096 Bytes
  History1 Hold Status :      Hold Code :     0  Hold Time :
  History2 Hold Status :      Hold Code :     0  Hold Time :
------------------------------------------------------------------
 Index Name : AJS1JINFINDEX1
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0
  Collect Prearranged Page :          1
  Collect On Page :          0
  Used Page Ratio       Page(Ratio)
             0% :         10( 100%)
         1- 10% :          0(   0%)
        11- 20% :          0(   0%)
        21- 30% :          0(   0%)
        31- 40% :          0(   0%)
        41- 50% :          0(   0%)
        51- 60% :          0(   0%)
        61- 70% :          0(   0%)
        71- 80% :          0(   0%)
        81- 90% :          0(   0%)
        91-100% :          0(   0%)
  Total                   10

 Index Name : AJS1JINFINDEX2
 Auth Id    : root
 Status     :
          Used(Full)       Used(      Full)        Sum
  Segment 100%(  0%)          1(         0)          1
  Page     10%(  0%)          1(         0)         10
  Collect On Segment :          0
  Collect Prearranged Page :          1
  Collect On Page :          0
  Used Page Ratio       Page(Ratio)
             0% :         10( 100%)
         1- 10% :          0(   0%)
        11- 20% :          0(   0%)
        21- 30% :          0(   0%)
        31- 40% :          0(   0%)
        41- 50% :          0(   0%)
        51- 60% :          0(   0%)
        61- 70% :          0(   0%)
        71- 80% :          0(   0%)
        81- 90% :          0(   0%)
        91-100% :          0(   0%)
  Total                   10

Collect Prearranged Page

ajsembdbreclaimコマンドで解放できる領域がページ数で出力されます。

この値を参照してajsembdbreclaimコマンドの実行時期を検討してください。

この値が0の場合，ajsembdbreclaimコマンドを実行しても領域が解放されません。目安としては，使用中であるページの3〜5割程度の値で実行することを推奨します。ただし，使用中のページが50ページ以下の場合，それほど効果が期待できません。また，使用ページ数が10,000を超えるような場合，2〜3割程度の値で実施することを推奨します。

Collect On Page

ajsembdbreclaimコマンドが実行中，またはajsembdbreclaimコマンドが正常終了しなかったことで，解放処理が途中の状態のページ数が出力されます。

Used Page Ratio，Page(Ratio)

テーブルまたはインデクスに割り当てられている領域（ページ）の詳細情報が出力されます。

パーセンテージが大きい範囲にあるページが多いほど格納効率がよく，少ないほど格納効率が悪くなっています。

また，（ ）内のパーセンテージは，小数点以下を切り上げているので，合計すると100%を超えることがあります。

組み込みDBのシステムログを確認する場合

ajsembdbstatus -l -id _JF0

HOSTNAME : 127.0.0.1(201942)
Group   Type Server   Gen No. Status  Run ID     Block No.   Ex-Status
log1    sys  ajs2          1 oc-d--u 433a0c53    1       ae  -x------
log2    sys  ajs2          0 os----- 00000000    0        0  -u------
log3    sys  ajs2          0 os----- 00000000    0        0  -u------
log4    sys  ajs2          0 os----- 00000000    0        0  -u------
log5    sys  ajs2          0 os----- 00000000    0        0  -u------
log6    sys  ajs2          0 os----- 00000000    0        0  -u------
log7    sys  ajs2          0 os----- 00000000    0        0  -u------
log8    sys  ajs2          0 os----- 00000000    0        0  -u------
log9    sys  ajs2          0 os----- 00000000    0        0  -u------
log10   sys  ajs2          0 os----- 00000000    0        0  -u------
log11   sys  ajs2          0 os----- 00000000    0        0  -u------
log12   sys  ajs2          0 os----- 00000000    0        0  -u------

HOSTNAME

「127.0.0.1」が表示されます。

（ ）内は，ajsembdbstatusコマンドを実行した時刻が時分秒（HHMMSS）で出力されます。

注意事項

次のどれかに該当する場合は，組み込みDBインストール先ディレクトリのホスト名が32文字以内で出力されます。クラスタ構成の場合は，初めに実行系に設定したホスト名が出力されます。

バージョンが09-50以前のWindows版JP1/AJS3 - Managerを使用していて，かつ論理ホストで組み込みDBを構築した場合

バージョンが09-50以前のUNIX版JP1/AJS3 - Managerを使用している場合

バージョンが09-50以前のJP1/AJS3 - Managerを10-00以降にバージョンアップインストールしていて，かつIPv6で通信するためのセットアップをしていない場合

Group

組み込みDBのシステムログファイルグループ名が8文字以内で出力されます。

Type

常に「sys」が出力されます。

Server

常に「ajs2」が出力されます。

Gen No.

システムログの世代番号が8けた以内の16進数で出力されます。組み込みDBで使用しているシステムログの順序性を表していて，1から順番に採番されます。最後尾のシステムログファイルグループを使い切った場合，先頭のシステムログファイルグループに戻って使用されます。この場合に，システムログの世代番号も更新されます。

Status

システムログファイルグループの状態が7文字で出力されます。

1文字目：

システムログファイルグループのオープン状態

o：オープン中

c：クローズ中

組み込みDBが起動中はo，停止中はcとなります。

2文字目：

システムログファイルグループの現在の状態

c：現用

s：待機中

n：予約

運用中では，現在使用しているシステムログファイルグループがc，それ以外のシステムログファイルグループがsとなります。

組み込みDBが停止中，またはシステムログファイルがあるディスクがマウントされていないなどでシステムログファイルにアクセスできない場合にnとなります。

3文字目：

システムログファイルグループのアンロード状態

u：アンロード待ち状態

（過去に現用として使用していたが，スワップしたため現用ではなくなりました）

システムログを使用しない運用（組み込みDB環境構築時にajsembdbbuildコマンドの-bsオプションおよび-brオプションを指定していない）の場合は対処不要です。

システムログを使用する運用（組み込みDB環境構築時にajsembdbbuildコマンドの-bsオプションまたは-brオプションを指定している）の場合はアンロードする必要がありますが，通常は自動ログアンロード機能によって自動的にアンロードされます。

-：アンロード済み状態

4文字目：

システムログファイルグループが上書きできるか，できないかの状態

d：上書きできません（組み込みDBの回復に必要なシステムログを含んでいます）

サーバ内のすべてのシステムログファイルがこの状態の場合，組み込みDBが停止します。この場合にはシステムログファイルを追加してください。

特大なジョブの一括定義などによって，発生する組み込みDBのトランザクションが長大である場合に発生することがあります。

-：上書きできます（組み込みDBの回復に必要なシステムログを含んでいません）

5文字目：

システムが使用する内部情報

6文字目：

システムログファイルグループの使用履歴

c：現用として使用しているシステムログファイルグループ

組み込みDBが停止中のときだけ表示されます。

7文字目：

システムが使用する内部情報

Run ID

システムで使用する情報が出力されます。

Block No.

システムログファイルの中の先頭ブロック番号と最終ブロック番号が8けたの16進数で出力されます。

Ex-Status

システムログファイルグループの拡張状態が8文字で出力されます。

1文字目：

システムが使用する内部情報

2文字目：

システムログファイルグループの自動拡張状態

u：システムログファイルの自動増分機能の拡張対象である状態

e：システムログファイルの拡張中状態

x：システムログファイルの自動増分機能の拡張対象外である状態

-：システムログファイルの自動増分機能を使用していない状態

3文字目：

システムログファイルグループの自動拡張可否

-：システムログファイルの自動増分機能で拡張できる

x：システムログファイルの自動増分機能で拡張できない

4文字目，5文字目，6文字目，7文字目，8文字目：

システムが使用する内部情報

組み込みDBの構成情報を確認する場合

ajsembdbstatus -c -id _JF1

HOSTNAME=lhost1
INSTALLDIR= "C:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JF1"
SETUPID=_JF1
RAWFILE= "ajssys01=¥¥.¥D:,ajssys11=¥¥.¥E:"
DATADIR=
WORKDIR=" C:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JF1¥dbarea"
EMBDBPORT=22221
DBMODEL=l
PHYSICALHOST=phost
SYSLOGCNF=single
UNLDDIR="C:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JF1¥unload"
EXTENDDB=no
EXTENDLOG=no
ENHANCEDBACKUP=yes

HOSTNAME

組み込みDBを構築した際に設定されたホスト名が出力されます。

INSTALLDIR

組み込みDBのインストール先ディレクトリが出力されます。

SETUPID

組み込みDBセットアップ識別子が出力されます。

RAWFILE

組み込みDBのデータ領域およびシステム領域にRAWファイルを使用している場合に，データ領域パーティションが出力されます。これは互換性のために出力している情報です。

DATADIR

組み込みDBのデータ領域ディレクトリが出力されます。システムログ運用をしている場合は，システム領域ディレクトリも出力されます。

WORKDIR

作業領域ディレクトリが表示されます。

EMBDBPORT

組み込みDBのポート番号が表示されます。

DBMODEL

データベースモデルが出力されます。

l：大規模

m：中規模

s：小規模

PHYSICALHOST

クラスタ構成の環境を構築している場合，実行系の物理ホスト名が出力されます。

SYSLOGCNF

システムログ運用の設定が表示されます。

single：システムファイルを二重化しない

dual：システムファイルを二重化する

none：システムログ運用が無効である

UNLDDIR

アンロードログファイルの作成先ディレクトリが出力されます。

システムログ運用をしていない場合は表示されません。

EXTENDDB

データベース領域の自動増分の設定が出力されます。

yes：自動増分する

no：自動増分しない

EXTENDLOG

システムログの自動増分の設定が出力されます。

yes：自動増分する

no：自動増分しない

ENHANCEDBACKUP

バックアップ強化機能の設定が出力されます。組み込みDB構築時のJP1/AJS3のバージョンが12-10より前の場合，この項目は出力されません。

yes：バックアップ強化機能が有効

no：バックアップ強化機能が無効

ajsembdbstop

形式

ajsembdbstop
     [-f [-q]]
     [-id 組み込みDBセットアップ識別子]

形式1（組み込みDBの正常停止）

ajsembdbstop
     [-id 組み込みDBセットアップ識別子]

形式2（組み込みDBの強制停止）

ajsembdbstop
     -f
     [-q]
     [-id 組み込みDBセットアップ識別子]

機能

組み込みDBを停止します。

組み込みDBが稼働中で，該当する組み込みDBにスケジューラーデータベースを作成しているすべてのスケジューラーサービスが停止中の場合だけ実行できます。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

JP1/AJS3 - Managerインストール先フォルダ¥tools¥

UNIXの場合

/opt/jp1ajs2/tools/

引数

-f

組み込みDBを強制停止します。

このオプションを指定して実行すると，組み込みDBへのアクセスの有無に関係なく強制的に組み込みDBを停止します。次回組み込みDBを起動したときに，起動処理に時間が掛かる場合があります。

-q

クラスタ環境を構築しているときに使用します。

このオプションは，フェールオーバーを行う場合に，組み込みDBを停止したいときに指定してください。

-id 組み込みDBセットアップ識別子

組み込みDBを識別するセットアップ識別子を「_JFn」（nは0〜9またはA〜Z）の4文字で指定します。ajsembdbbuildコマンドの-idオプションで指定した値を指定してください。

jajs_setupコマンド，jajs_setup_clusterコマンド，およびjajs_migrateコマンドで作成された組み込みDBに対して操作を行う場合，ajsembdbidlistコマンドで操作対象となる組み込みDBのセットアップ識別子を確認してください。ajsembdbidlistコマンドについては，「2. セットアップコマンド　ajsembdbidlist」を参照してください。

このオプションを省略した場合は，_JF0が仮定されます。

注意事項

組み込みDBを正常停止する前に，該当する組み込みDBにスケジューラーデータベースを作成しているすべてのスケジューラーサービスを停止してください。また，JP1/AJS3サービスを含め，組み込みDBにアクセスしているサービスもすべて停止してください。これらのサービスを停止しないで正常停止を実行した場合，組み込みDBを停止できないで長時間の待ち状態が発生するおそれがあります。

組み込みDBへのアクセスがある状態で，組み込みDBを強制停止した場合，実行中のジョブや，JP1/AJS3 - Viewからのアクセスなどが強制的に終了・切断されます。

このコマンドはスクリプトで実装されています。このため，オプションに不当に長い文字列や不正な文字列や値を指定すると，予期しないエラーが発生することがあります。オプション指定値は，DBMSおよびJP1/AJS3で規定されている範囲内の文字列または数値を指定してください。

同一論理ホスト上では，次のコマンドと同時に実行できません。

ajsprofalterコマンド

ajsembdbstartコマンド

ajsembdbstopコマンド

ajsstartコマンド

ajsstopコマンド

jajs_hstdコマンド

jajs_hstd_stopコマンド

jajs_spmdコマンド

jajs_spmd_statusコマンド

jajs_spmd_stopコマンド

jajs_startコマンド（UNIX限定）

jajs_start.clusterコマンド（UNIX限定）

jajs_stopコマンド（UNIX限定）

jajs_stop.clusterコマンド（UNIX限定）

JP1/AJS3が起動中の場合， jajs_dbmdプロセスも停止します。ただし，組み込みDBがバージョン10-00より前の方式の場合は，jajs_dbmdプロセスは停止しません。

このコマンドを同時に複数実行しないでください。同時に複数実行した場合，次に示す現象が起こるおそれがあります。

不当なメッセージを出力したり，本来出力するはずのメッセージを出力しなかったりするなど，メッセージ出力が不正になる。

このコマンドが，不当にエラーになる。

戻り値

0

正常終了。

1

組み込みDBが起動・停止処理中である。

2

組み込みDBが停止中である。

上記以外の値

異常終了。

エラー時の対処

コマンドエラー発生時は，次に示す表に従って対処してください。

メッセージID

現象

対処方法

KAVS0787-E

システム管理のデーモンが処理中です。

jajs_spmd_statusコマンドでサービスの状態を確認してから，コマンドを再実行してください。

KAVS0996-E

指定したオプションに誤りがあります。

オプションの指定内容を見直してください。

KAVS2101-E

組み込みDBは停止中です。

組み込みDBはすでに停止しているため，特に対処はありません。

KAVS2102-E

組み込みDBは起動・停止処理中です。

組み込みDBの起動をajsembdbstatusコマンドの-s ustオプション指定で確認してから再実行してください。

KAVS2104-E

組み込みDBがセットアップされていません。

組み込みDBをセットアップしてから再実行してください。

KAVS2116-E

指定したオプションに誤りがあります。

メッセージに出力されているオプションを見直して再実行してください。

KAVS2117-E

コマンド実行時にエラーが発生しました。

保守情報に出力されているメッセージを参照してください。

ajsentry

形式

ajsentry
     [-F サービス名]
     [{-s|-n|-f|-d[[年/]月/]日 -t 時[:分]|
          -p 予定情報ファイル名}][-g 未来予定世代数]
     [-o]
     [-w]
     [-c マクロ変数指定]...
     [-R]
     [-L]
     [-T]
     [-m {時:分|M分|unlimited} -k {回数|unlimited}]
     [-b[[年/]月/]日 -e[[年/]月/]日]
     [-h]
     ジョブネット名，またはジョブグループ名...

機能

定義済みのジョブネットを実行登録します。また，実行登録の際に指定したユニットに対して次の内容をチェックし，該当する場合はエラーになります。

起動条件付きジョブネットにジョブネットコネクタを作成していないか

接続先のジョブネットとして，起動条件付きジョブネットを指定していないか

接続先のジョブネットとして，配下にジョブネットコネクタが定義されているルートジョブネットを指定していないか

接続先のジョブネットとして指定したプランニンググループ配下のユニットに起動条件が設定されていないか

接続先のジョブネットとして指定したプランニンググループ配下にルートリモートジョブネットが定義されていないか

接続先のジョブネットとして指定したプランニンググループ配下にジョブネットコネクタが定義されていないか

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Operator権限

引数

-F サービス名

処理対象とする，スケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

-s

ジョブネットに定義されたスケジュールに従って，ジョブネットを実行します（ジョブネットを計画実行登録します）。

-fオプションと異なり，当日に実行予定があり，コマンド実行時刻がジョブネットの実行予定時刻を過ぎている場合でも，ジョブネットを実行します。

このオプションは，-n，-f，-d，-t，-p，-g，-w，-m，-kオプションと同時には指定できません。

-n

ジョブネットに定義されたスケジュールを無効にして，ジョブネットをすぐに実行します（ジョブネットを即時実行登録します）。なお，-m，-kオプションと同時に指定した場合だけ，起動条件の指定が有効になります。

このオプションは，-s，-f，-d，-t，-p，-g，-oオプションと同時には指定できません。

-f

実行登録時点での次回のスケジュールに従ってジョブネットを実行します（ジョブネットを計画実行登録します）。

-sオプションと異なり，当日に実行予定があっても，実行予定時刻が過ぎている場合は，ジョブネットを実行しません。

このオプションは，-s，-n，-d，-t，-p，-g，-w，-m，-kオプションと同時には指定できません。

-d [[年/]月/]日

ジョブネットに定義されたスケジュールに関係なく，指定された日付にジョブネットを実行します（ジョブネットを確定実行登録します）。

起動条件付きジョブネットは，起動条件監視をしないで，即時に実行されます。

このオプションは，-tオプションと同時に指定します。

-s，-n，-f，-p，-g，-w，-m，-kオプションと同時には指定できません。

年

指定できる値は，1994〜環境設定パラメーターSCHEDULELIMITの値（単位：西暦年）です。環境設定パラメーターSCHEDULELIMITの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2(123) SCHEDULELIMIT」を参照してください。

月

指定できる値は，1（または01）〜12（単位：月）です。

日

指定できる値は，1（または01）〜31（単位：日）です。

このオプションで年，または年/月の指定を省略した場合，次の値が仮定されます。

年：コマンドを実行した年

年/月：コマンドを実行した年と月

-t 時[:分]

ジョブネットに定義されたスケジュールに関係なく，指定された時刻にジョブネットを実行します（ジョブネットを確定実行登録します）。起動条件付きジョブネットは，起動条件監視をしないで，即時に実行されます。

このオプションは，-dオプションと同時に指定します。

-s，-n，-f，-p，-g，-w，-m，-kオプションと同時には指定できません。

時

指定できる値は，0（または00）〜47（単位：時）です。

分

指定できる値は，0（または00）〜59（単位：分）です。省略した場合，0が仮定されます。

-p 予定情報ファイル名

ジョブネットの実行スケジュールが定義されている，予定情報ファイル名を指定します（ジョブネットを確定実行登録します）。予定情報ファイルは，ajsscheduleコマンドで作成できます。

指定できる文字数は，1〜255（単位：バイト）です。ファイル名は，フルパスで指定します。

このオプションは，-s，-n，-f，-d，-t，-w，-m，-kオプションと同時には指定できません。

-pオプションを指定する場合，ジョブネット名には予定情報ファイル作成時に指定したルートジョブネット名だけを指定してください。総称名指定や-Rオプションと同時に指定して，予定情報ファイル中のルートジョブネット名と異なるルートジョブネット名が指定された場合，このコマンドは異常終了します。

-g 未来予定世代数

確定スケジュールの，次回以降の実行予定世代数を指定します。

指定できる値は，1〜99（単位：世代）です。

このオプションは，-s，-n，-f，-d，-t，-w，-m，-kオプションと同時には指定できません。

-o

その日に実行予定のジョブネットで，実行開始予定時間がスケジューラーサービスの起動時間より前のジョブネットは，スケジューラーサービスの起動時に実行しません。

このオプションは-w，-m，-k，-n，-hオプションと同時には指定できません。また，このオプションはサービス起動モードがウォームスタートまたはディザスターリカバリースタートの場合に有効となります。

-w

即時実行登録した場合，ジョブネットの実行が終了したあと，コマンドを終了します。

このオプションは，ルートジョブネットを即時実行登録する場合に指定できます。

このオプションを指定しても，ジョブネットの実行終了を待たずにコマンドが終了する場合を次に示します。

ジョブネット実行中にスケジューラーサービスが停止した場合

終了待ちを指定した世代が繰り越し未実行になった場合

終了待ちを指定した世代が削除された場合（実行登録解除，または即時実行登録・確定実行登録の世代が実行中止になった場合など）

終了待ちを指定した世代が未計画になった場合

このオプションは，-nオプションと同時に指定してください。-m，-kオプションと同時には指定できません。

-c マクロ変数指定

ルートジョブネット配下のジョブで使用しているマクロ変数に設定する情報を指定します。ジョブ実行時，指定したマクロ変数の引き継ぎ情報に展開して実行されます。

「-c マクロ変数名:引き継ぎ情報」の形式で同時に32個まで指定できます。ただし，同一マクロ変数名を複数指定した場合，最初に指定したマクロ変数の引き継ぎ情報だけが引き継がれます。複数指定した場合に指定できる文字数は，「マクロ変数名＋引き継ぎ情報＋4」の値が4,085バイト以内です。

マクロ変数名

「AJS2xxxxx」（xxxxxは任意の文字列）の形式で指定します。前後の?は不要です。英大文字，数字，「.（ピリオド）」が指定できます。

指定できる文字数は，62バイト（64−前後の?の2バイト）以内です。

引き継ぎ情報

任意の文字列を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

-R

指定したジョブグループに含まれるすべてのユニットを実行登録します。

このオプションを，-L，-Tオプションと同時に指定した場合，各オプションの指定内容に従って，ジョブネットを実行登録します。

-Tオプションを同時に指定しない場合，すべてのユニットが実行登録の対象になるため，ルートジョブネット以外のユニットに対する実行登録処理は異常終了します。

-L

実行登録していないジョブネットを実行登録します。

-T

ルートジョブネットだけを実行登録します。

-m {時:分|M分|unlimited}

起動条件の成立待ち時間を指定します。

このオプションは，-n，-kオプションと同時に指定します。-wオプションと同時には指定できません。

時:分

絶対時刻で指定します。

時に指定できる値は，0（または00）〜47（単位：時）です。

分に指定できる値は，0（または00）〜59（単位：分）です。

M分

ジョブネットの実行開始予定時刻からの相対分で指定します。

指定できる値は，1（または01）〜2,879（単位：分）です。

unlimited

条件の成立の待ち時間を無制限にします。

-k {回数|unlimited}

起動条件の成立を待つ回数を指定します。

このオプションは，-n，-mオプションと同時に指定します。-wオプションと同時には指定できません。

回数

指定できる値は，1〜999（単位：回）です。

unlimited

条件の成立待ち回数を無制限にします。

-b [[年/]月/]日

ジョブネットに定義されたスケジュールに従ってジョブネットを実行する期間の開始日を指定します（ジョブネットを確定実行登録します）。指定された開始日は，基準時刻に従います。

年

指定できる値は，1994〜環境設定パラメーターSCHEDULELIMITの値（単位：西暦年）です。環境設定パラメーターSCHEDULELIMITの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2(123) SCHEDULELIMIT」を参照してください。

月

指定できる値は，1（または01）〜12（単位：月）です。

日

指定できる値は，1（または01）〜31（単位：日）です。

このオプションで，年，または年/月の指定を省略した場合，次の値が仮定されます。

年：コマンドを実行した年

年/月：コマンドを実行した年と月

このオプションは，-eオプションと同時に指定します。

-s，-n，-f，-d，-t，-p，-w，-m，-kオプションと同時には指定できません。

-e [[年/]月/]日

ジョブネットに定義されたスケジュールに従ってジョブネットを実行する期間の終了日を指定します（ジョブネットを確定実行登録します）。指定された終了日は，基準時刻に従います。

年

指定できる値は，1994〜環境設定パラメーターSCHEDULELIMITの値（単位：西暦年）です。環境設定パラメーターSCHEDULELIMITの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2(123) SCHEDULELIMIT」を参照してください。

月

指定できる値は，1（または01）〜12（単位：月）です。

日

指定できる値は，1（または01）〜31（単位：日）です。

このオプションで，年，または年/月の指定を省略した場合，次の値が仮定されます。

年：コマンドを実行した年

年/月：コマンドを実行した年と月

このオプションは，-bオプションと同時に指定します。

-s，-n，-f，-d，-t，-p，-w，-m，-kオプションと同時には指定できません。

-h

実行登録時に，ルートジョブネットの実行を保留します。

実行登録時に作成される世代のうち，最初の実行世代に保留属性が設定されます。

-pオプションで予定情報ファイル名を指定して実行登録する場合は，最初に作成された世代に保留属性が設定されます。そのため，予定情報ファイルを編集していて予定情報が日付順に並んでいない場合，意図しない世代に保留属性が設定されるおそれがあるので注意が必要です。

ジョブネット名，またはジョブグループ名

実行登録するジョブネット名，または-R，-L，-Tオプションと同時にジョブネット名，またはジョブグループ名を指定します。

指定できる文字数は，1〜930（単位：バイト）です。

ジョブネット名，またはジョブグループ名は，複数指定できます。ただし，ジョブネット名を指定する場合，指定できるのはルートジョブネット名だけです。なお，マネージャージョブグループ名とマネージャージョブネット名は指定できません。

ジョブネット名，またはジョブグループ名に，論理ホスト名を指定できます。実行IDは指定できません。

注意事項

ジョブネットを実行登録できるのは，次のどちらかのユーザーです。

実行登録するジョブネットに含まれるすべてのユニットを定義したときに，または属性を変更したときに，操作権限を与えられたユーザー

Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザー

ただし，環境設定パラメーターADMACLIMITをデフォルトから変更して「yes」を設定している場合は，Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザーであっても，操作権限が必要です。

スケジューラーサービスが起動していない場合，このコマンドは異常終了します。

ジョブネットの次回予定の実行登録方法と異なる実行登録方法では，ジョブネットを実行登録できません。また，次回予定が計画実行登録済みのジョブネットに対して，さらに計画実行登録はできません。これらの場合，コマンドは異常終了します。

ジョブネットに次回実行予定がある場合，ジョブネットを計画実行登録できません。コマンドは異常終了します。

即時実行登録では次回予定がないため，すでにジョブネットが即時実行登録済みであっても，再度実行登録できます。

実行登録しようとしたジョブネットがサスペンド状態の場合，このコマンドは異常終了します。

ajsentryコマンドの-wオプションとajsplanコマンドの-wオプションの同時実行数の合計は50個までです。50個を超えて実行した場合，コマンドは異常終了します。

プランニンググループの下のルートジョブネットは，-pオプション，または-bおよび-eオプションでの指定の確定実行登録だけできます。ほかの登録方法でコマンドを実行した場合，このコマンドは異常終了します。

-wオプションを指定して，ジョブネットの実行が終了したあとでajsentryコマンドを終了させる場合，ajsentryコマンドの戻り値でジョブネットの実行結果を取得することはできません。ジョブネットの実行結果は，別途ajsshowコマンドを使用して取得してください。

-n，-f，-d，-t，-p，-gオプションを指定しなかった場合，-sオプションが指定されたものとして処理されます。

ジョブネットコネクタを使ってルートジョブネットの実行順序を制御している場合，ジョブネットコネクタを定義したルートジョブネットと接続先のジョブネット間に接続関係が成立する世代がなくても，ジョブネットを実行登録します。

リリース登録されているルートジョブネット（リリース先ジョブネット）を即時実行登録した場合は，「適用中」状態のジョブネット定義の内容で即時実行されます。

戻り値

0

正常終了。

1〜3または

4〜124で4の倍数値

異常終了。

使用例1

ジョブネット（net1）を，計画実行登録します（ジョブネットに定義されたスケジュールに従って実行します）。

ajsentry -s net1

使用例2

ジョブネット（net1）にマクロ変数（AJS2ENV）と値（/tmp/unit_data）を設定して即時登録します。

ajsentry -n -c AJS2ENV:/tmp/unit_data net1

使用例3

ジョブネット（net1）を確定実行登録します。

特定の日時（2009/7/1 20時）を確定実行登録する場合

ajsentry -d 2009/07/01 -t 20 /net1

特定の期間（予定情報ファイルで指定している実行予定）を確定実行登録する場合

ajsentry -p 予定情報ファイル名 /net1

ajsexport

形式

ajsexport
     -o パッケージファイル名
     エクスポートユニット名

機能

このコマンドは，JP1/AJS3が提供するパッケージング機能用のコマンドです。パッケージング機能用のバッチファイルまたはシェルスクリプトだけで使用できます。

通常のユニットを退避する場合は，ajsprintコマンドまたはajsbackupコマンドを使用してください。

指定したユニット以下のすべてのユニットを1ファイルにまとめてパッケージファイルにエクスポートします（パッケージファイルは，ajsimportコマンドでインポートできます）。

環境設定パラメーターAJSPRINTNETSCHPRFによって，上位ジョブネットのスケジュールに依存する指定があり，かつスケジュールルールを持つネストジョブネットのユニット定義情報を出力する場合に，次のどちらかの出力方法を指定できます。

スケジュールルールを有効にし，上位ジョブネットのスケジュールに依存しない。

スケジュールルールを削除し，上位ジョブネットのスケジュールに依存する。

環境設定パラメーターAJSPRINTNETSCHPRFの設定方法については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2(79) AJSPRINTNETSCHPRF」を参照してください。

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Editor権限

JP1_AJS_Operator権限

JP1_AJS_Guest権限

引数

-o パッケージファイル名

ユニットのパッケージング先ファイル名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

エクスポートユニット名

パッケージングするユニットを次の形式で指定します。

形式

スケジューラーサービス名:/ユニットの完全名

指定方法

指定できる文字数は，1〜930（単位：バイト）です。

ユニットの完全名の最終要素名にだけ，総称名が指定できます。

指定時の注意事項

ルートジョブグループ「/」はエクスポートできません。

注意事項

ユニットをエクスポートできるのは，次のどちらかのユーザーです。

エクスポートするユニットに対して，参照権限を与えられたユーザー。

Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザー。

ただし，環境設定パラメーターADMACLIMITをデフォルトから変更して「yes」を設定している場合は，Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザーであっても，参照権限が必要です。

ユニット名が同じ複数のユニット定義情報をエクスポートする場合は，異なるパッケージファイルを指定してからエクスポートしてください。

操作対象がリリース登録したルートジョブネット（リリース先ジョブネット）の場合は，「適用中」状態のジョブネット定義がエクスポートされます。ただし，エクスポートされるユニット定義情報にリリース情報は含まれません。

戻り値

0

正常終了。

4〜124で4の倍数値

異常終了。

ajsfxbcstatus

形式

ajsfxbcstatus

機能

次の情報を出力します。

一斉配信先の宛先エージェントとしてセットアップされているかどうかを出力します。セットアップされている場合は，セットアップ時に指定された一斉配信エージェントのIPアドレスまたはホスト名を出力します。

一斉配信エージェントとしてセットアップされているかどうかを出力します。セットアップされている場合は，管理している宛先エージェントのIPアドレスおよびホスト名の一覧を出力します。出力する順番はIPアドレスの昇順です。

実行権限

なし

格納先ディレクトリ

Windowsの場合

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

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

UNIXの場合

/opt/jp1ajs2/bin/

引数

なし

戻り値

0

一斉配信エージェントおよび一斉配信先の宛先エージェントのどちらにもセットアップされていない。

1

一斉配信先の宛先エージェントとしてセットアップされている。

2

一斉配信エージェントとしてセットアップされている。

3

一斉配信エージェントおよび一斉配信先の宛先エージェントとしてセットアップされている。

4以上の値

異常終了。

出力例

一斉配信エージェントおよび一斉配信先の宛先エージェントとしてセットアップされている場合の出力例と出力内容の意味を次に示します。

---------- Destination Agent ----------
Setup Status:yes
Broadcast Agent:192.168.1.10

---------- Broadcast Agent ----------
Setup Status:yes
Destination Agent List:
Registered Date      Last Update Date     Destination     HostName
2016/04/02 09:05:01  2016/04/03 08:04:50  192.168.1.1     Agent01
2016/04/01 13:05:01  2016/04/03 08:04:51  192.168.1.2     Agent02
2016/04/01 13:15:01  2016/04/03 08:04:51  192.168.1.3     Agent03
2016/04/03 00:05:01  2016/04/03 08:04:52  2001:db8::1e    Agent04

Destination Agent

一斉配信先の宛先エージェントとしての情報を出力します。

Setup Status

一斉配信先の宛先エージェントとしてセットアップされているかどうかを示します。セットアップされている場合は「yes」を，セットアップされていない場合は「no」を出力します。

Broadcast Agent

セットアップ時に指定された一斉配信エージェントのIPアドレスまたはホスト名を示します。一斉配信先の宛先エージェントとしてセットアップされていない場合は，出力しません。

Broadcast Agent

一斉配信エージェントとしての情報を出力します。

Setup Status

一斉配信エージェントとしてセットアップされているかどうかを示します。セットアップされている場合は「yes」を，セットアップされていない場合は「no」を出力します。

Destination Agent List

管理対象の宛先エージェントの情報を出力します。一斉配信エージェントとしてセットアップされていない場合は，出力しません。

Registered Date

管理している宛先エージェントが最初に登録された日時を，「YYYY/MM/DD hh:mm:ss」の形式で示します。

Last Update Date

管理している宛先エージェントから最後に生存通知を受信した日時を，「YYYY/MM/DD hh:mm:ss」の形式で示します。

Destination

管理している宛先エージェントのIPアドレスを示します。

HostName

管理している宛先エージェントのホスト名を示します。

ajsgtroot

形式

ajsgtroot
     [-F サービス名]
     [-e]
     [-b]
     [-h]
     [-T]

機能

スケジューラーサービスの運用環境情報を標準出力ファイルに出力します。

実行権限

なし

引数

-F サービス名

処理対象とする，スケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

省略した場合，デフォルトスケジューラーサービス名が仮定されます。

-e

エラー情報ディレクトリ名を出力します。

-b

退避ディレクトリ名を出力します。

-h

使用中の履歴情報ファイル名を出力します。

ただし，JP1/AJS3サービスが起動していない場合，履歴情報ファイル1の名称を出力します。

-T

一時ファイル用ディレクトリ名を出力します。

戻り値

0

正常終了。

4〜124で4の倍数値

異常終了。

使用例

エラー情報ディレクトリ名を出力します。

ajsgtroot -e

出力例

/var/opt/jp1ajs2/jobinf

ajsimport

形式

ajsimport
     [-f]
     [-S]
     -i パッケージファイル名
     [インポートユニット名]

機能

このコマンドは，JP1/AJS3が提供するパッケージング機能用のコマンドです。パッケージング機能用のバッチファイルまたはシェルスクリプトだけで使用できます。

通常のユニットの回復には，ajsdefineコマンドまたはajsrestoreコマンドを使用してください。

ajsexportコマンドで作成されたパッケージファイルをインポートします。

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Editor権限

引数

-f

ユニットのインポート先に，同じ名称のユニットがある場合も，強制的に更新します。

省略した場合，同じ名称のユニットがある場合，エラーになります。情報は更新されません。

-S

ジョブネットがサスペンド状態の場合，実行登録済みのジョブネットであっても，インポートユニット名にそのジョブネット名を指定できるようにします。ただし，ジョブネットがサスペンド状態でも，次の場合は定義の更新は行えません。

ルートジョブネットの定義を更新する場合

ルートジョブネットの定義を含むジョブグループの定義を更新する場合

実行中のジョブネットの場合

-i パッケージファイル名

インポートするパッケージファイル名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

インポートユニット名

インポートするユニットを次の形式で指定します。

形式

スケジューラーサービス名:/ユニットの完全名

指定方法

インポートユニット名の指定は任意です。

省略した場合は，ajsexportコマンドの「エクスポートユニット名」に指定した名称でインポートされます。

指定できる文字数は，1〜930（単位：バイト）です。

指定時の注意事項

総称名は指定できません。

注意事項

ユニットをインポートできるのは，次のどちらかのユーザーです。

インポート先のユニットに対して，更新権限を与えられたユーザー。

Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザー。

ただし，環境設定パラメーターADMACLIMITをデフォルトから変更して「yes」を設定している場合は，Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザーであっても，更新権限が必要です。

実行登録済みジョブネット（リモートジョブネットを除く）にインポートする場合，インポート先のジョブネットをサスペンド状態にしておき，このコマンドに-Sオプションを指定してください。

インポートユニット名に指定したジョブネットがサスペンド状態変更処理中の場合，このコマンドは異常終了します。

ジョブネットの中にプランニンググループをインポートできません。

プランニンググループの中にはジョブネット，リモートジョブネット以外のユニットをインポートできません。

実行登録済みのルートジョブネットの情報や，そのルートジョブネットを含むジョブグループおよびプランニンググループの情報は更新できません。

戻り値

0

正常終了。

4〜124で4の倍数値

異常終了。

ajsintrpt

形式

ajsintrpt
     [-F サービス名]
     [-B 実行登録番号]
     [-R]
     [-E]
     [-T]
     [-X {yes|no|auto}]
     ジョブネット名，またはジョブグループ名...

機能

現在実行中のジョブが終了したあと，ジョブネットの実行を中断します。

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Operator権限

引数

-F サービス名

処理対象とする，スケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

-B 実行登録番号

実行を中断するジョブネットの，実行登録番号を「YYYYMMDDNNN」の形式で指定します。「YYYYMMDDNNN」の内容を次に示します。

YYYY：実行予定年

MM：実行予定月

DD：実行予定日

NNN：実行予定年月日の実行登録順序番号

実行登録番号の詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　4.5.13 コマンド実行時の世代の指定方法」を参照してください。

-R

指定したジョブグループおよびジョブネットに含まれるすべてのジョブネットの実行を中断します。

このオプションを，-E，-Tオプションと同時に指定した場合，各オプションの指定内容に従って，ジョブネットの実行を中断します。

-E

実行登録済みのジョブネットの実行を中断します。

-T

ルートジョブネットの実行を中断します。

-X {yes|no|auto}

プランニンググループの下にあるユニットの中から，現在運用中のユニットを自動的に選択して操作するかどうかを指定します。ただし，ジョブグループ配下のユニットに対しては，どの値を指定しても自動的に選択しません。また，ルートジョブネット名称も省略できません。

yes

自動的に選択して操作する場合に指定します。

コマンドに指定するユニット名は，プランニンググループの下のルートジョブネット名を省略して指定します。

no

自動的に選択して操作しない場合に指定します。

指定したユニットに対して操作します。プランニンググループの下のルートジョブネット名を省略して指定することはできません。

auto

ユニット名の指定方法に従って，自動的に選択して操作するかしないかを決定する場合に指定します。

自動的に選択して操作する場合

プランニンググループの下のルートジョブネット名を省略してユニット名を指定します。

自動的に選択して操作しない場合

プランニンググループの下のルートジョブネット名を省略しないでユニット名を指定します。この場合，指定したユニットが操作対象になります。ただし，プランニンググループの下のルートジョブネット名を省略して指定したパス名と同じ名称のユニットがある場合，省略したものとして扱われ，操作対象のユニットが自動選択されます。

ジョブネット名，またはジョブグループ名

実行を中断するジョブネット名，または-R，-E，-Tオプションと同時にジョブネット名，またはジョブグループ名を指定します。

指定できる文字数は，1〜930（単位：バイト）です。

ジョブネット名，またはジョブグループ名は，複数指定できます。ただし，ジョブネットを指定する場合，指定できるのはルートジョブネット名だけです。なお，マネージャージョブグループ名とマネージャージョブネット名は指定できません。

ジョブネット名，またはジョブグループ名に，論理ホスト名および実行IDを指定できます。ただし，実行IDを指定した場合，-Bオプションは無効になります。実行IDの指定方法については，「1.1 コマンドの記述形式」を参照してください。

注意事項

ジョブネットの実行を中断できるのは，次のどちらかのユーザーです。

中断するジョブネットに含まれるすべてのユニットを定義したときに，または属性を変更したときに，操作権限を与えられたユーザー

Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザー

ただし，環境設定パラメーターADMACLIMITをデフォルトから変更して「yes」を設定している場合は，Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザーであっても，操作権限が必要です。

スケジューラーサービスが起動していない場合，このコマンドは異常終了します。

中断しようとしたジョブネットがサスペンド状態の場合，このコマンドは異常終了します。

プランニンググループの下にあるユニットの中から操作するユニットを自動的に選択する指定をした場合に，自動的に選択されたユニットに操作権限がないと，エラーになります。

-Xオプションが省略された場合，環境変数AJSAUTOJUDGEの指定値に従って，プランニンググループの下にあるユニットの操作対象が決定されます。

プランニンググループの下にあるユニット名の指定方法については，「3. 通常の運用で使用するコマンド　ajsplan」の「補足事項」を参照してください。

このコマンドを実行すると，JP1/AJS3内で通信やデータベースの更新が実施されます。そのため，連続で多数実行するとJP1/AJS3全体に高い負荷が掛かり，処理の遅延など，運用に影響を与えるおそれがあります。連続して実行する場合は，2〜3秒の間隔を空けて実行するようにしてください。特に，イベントジョブ，カスタムイベントジョブ，またはイベントジョブおよびカスタムイベントジョブを使用したジョブネットに対して実行する場合には制限があるため，注意が必要です。イベントジョブおよびカスタムイベントジョブの制限値については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　付録B.8 イベント・アクション制御の制限値」を参照してください。

戻り値

0

正常終了。

4〜124で4の倍数値

異常終了。

補足事項

「監視中」の世代を中断した場合は，「監視中」の世代が「監視打ち切り終了」になります。「実行中」および「実行中」の世代の終了を待っている「起動条件待ち」の世代は中断されません。

実行を中断されたジョブネットは，ajsrerunコマンドで再実行できます。

このコマンドは，指定したユニットの中断をスケジューラーサービスに依頼すると終了します。指定したユニットの終了を待ちません。

使用例

ジョブネット（net1）の実行を中断します。

ajsintrpt net1

ajskill

形式

ajskill
     [-F サービス名]
     [-B 実行登録番号]
     [-R]
     [-E]
     [{-T|-J}]
     [-X {yes|no|auto}]
     ジョブ名，ジョブネット名，またはジョブグループ名...

機能

実行中のジョブ，またはジョブネットの実行を強制終了します。

ジョブネットを強制終了すると，ジョブネット中（ネストジョブネットを含む）のすべてのジョブは実行を打ち切られます。ジョブネット中のほかのジョブは新たに起動されません。

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Operator権限

引数

-F サービス名

処理対象とする，スケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

-B 実行登録番号

強制終了するジョブ，またはジョブネットの実行登録番号を「YYYYMMDDNNN」の形式で指定します。「YYYYMMDDNNN」の内容を次に示します。

YYYY：実行年

MM：実行月

DD：実行日

NNN：実行年月日の実行登録順序番号

実行登録番号の詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　4.5.13 コマンド実行時の世代の指定方法」を参照してください。

-R

指定したユニットに含まれるすべてのジョブ，およびジョブネットを強制終了します。

このオプションを，-E，-T，-Jオプションと同時に指定した場合，各オプションの指定内容に従って，実行中のジョブ，またはジョブネットの実行を強制終了します。

-E

実行登録済みのジョブネットを強制終了します。

-T

ルートジョブネットを強制終了します。

-J

ジョブを強制終了します。

-X {yes|no|auto}

プランニンググループの下にあるユニットの中から，現在運用中のユニットを自動的に選択して操作するかどうかを指定します。ただし，ジョブグループの下にあるユニットに対しては，どの値を指定しても自動的に選択しません。また，ルートジョブネット名称も省略できません。

yes

自動的に選択して操作する場合に指定します。

コマンドに指定するユニット名は，プランニンググループの下のルートジョブネット名を省略して指定します。

no

自動的に選択して操作しない場合に指定します。

指定したユニットに対して操作します。プランニンググループの下のルートジョブネット名を省略して指定することはできません。

auto

ユニット名の指定方法に従って，自動的に選択して操作するかしないかを決定する場合に指定します。

自動的に選択して操作する場合

プランニンググループの下のルートジョブネット名を省略してユニット名を指定します。

自動的に選択して操作しない場合

プランニンググループの下のルートジョブネット名を省略しないでユニット名を指定します。この場合，指定したユニットが操作対象になります。ただし，プランニンググループの下のルートジョブネット名を省略して指定したパス名と同じ名称のユニットがある場合，省略したものとして扱われ，操作対象のユニットが自動選択されます。

ジョブ名，ジョブネット名，またはジョブグループ名

強制終了するジョブ名，ジョブネット名，または-R，-E，-T，-Jオプションと同時にジョブ名，ジョブネット名，またはジョブグループ名を指定します。

指定できる文字数は，1〜930（単位：バイト）です。

ジョブ名，ジョブネット名，またはジョブグループ名は複数指定できます。ただし，ジョブネットを指定する場合，指定できるのはルートジョブネット名だけです。なお，マネージャージョブグループ名とマネージャージョブネット名は指定できません。

ジョブ名，ジョブネット名，またはジョブグループ名に，論理ホスト名および実行IDを指定できます。ただし，実行IDを指定した場合，-Bオプションは無効になります。実行IDの指定方法については，「1.1 コマンドの記述形式」を参照してください。

注意事項

ジョブを強制終了できるのは，次のどちらかのユーザーです。

そのジョブとそのジョブを含むすべてのジョブネットを定義したときに，またはそれらの属性を変更したときに，操作権限を与えられたユーザー。

Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザー。

ただし，環境設定パラメーターADMACLIMITをデフォルトから変更して「yes」を設定している場合は，Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザーであっても， 操作権限が必要です。

ジョブネットを強制終了できるのは，次のどちらかのユーザーです。

そのジョブネットに含まれるすべてのジョブとそのジョブネットを定義したときに，またはそれらの属性を変更したときに，操作権限を与えられたユーザー。

Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザー。

ただし，環境設定パラメーターADMACLIMITをデフォルトから変更して「yes」を設定している場合は，Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザーであっても， 操作権限が必要です。

スケジューラーサービスが起動していない場合，このコマンドは異常終了します。

強制終了しようとしたジョブ，またはジョブネットが実行中でない場合，このコマンドは異常終了します。

強制終了の対象となるのは，JP1/AJS3が起動したプロセスだけです。ただし，JP1/AJS3が起動したプロセスであっても，プロセスの状態によっては強制終了できない場合もあります。

リモートジョブネット下のユニットに対しては，操作できません。

強制終了しようとしたジョブ，ジョブネットがサスペンド状態の場合，このコマンドは異常終了します。

プランニンググループの下にあるユニットの中から操作するユニットを自動的に選択する指定をした場合に，自動的に選択されたユニットに操作権限がないと，エラーになります。

-Xオプションが省略された場合，環境変数AJSAUTOJUDGEの指定値に従って，プランニンググループの下にあるユニットの操作対象が決定されます。

プランニンググループの下にあるユニット名の指定方法については，「3. 通常の運用で使用するコマンド　ajsplan」の「補足事項」を参照してください。

ジョブネットコネクタは強制終了できません。

強制終了できるのは，次の状態のユニットだけです。

キューイングおよび実行中のジョブ

キューレスジョブの場合は，「実行待ち」状態のジョブも強制終了できます。

実行中，警告検出実行中，異常検出実行中，および監視中のルートジョブネット

このコマンドを実行すると，JP1/AJS3内で通信やデータベースの更新が実施されます。そのため，連続で多数実行するとJP1/AJS3全体に高い負荷が掛かり，処理の遅延など，運用に影響を与えるおそれがあります。連続して実行する場合は，2〜3秒の間隔を空けて実行するようにしてください。特に，イベントジョブ，カスタムイベントジョブ，またはイベントジョブおよびカスタムイベントジョブを使用したジョブネットに対して実行する場合には制限があるため，注意が必要です。イベントジョブおよびカスタムイベントジョブの制限値については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　付録B.8 イベント・アクション制御の制限値」を参照してください。

戻り値

0

正常終了。

4〜124で4の倍数値

異常終了。

補足事項

特定のジョブを強制終了した場合でも，そのジョブが含まれるジョブネット（仮にジョブネット「A」と呼びます）中のほかのジョブやジョブネットの実行はスケジュールに従って実行されます。ほかのジョブやジョブネットの実行開始を防ぐために，ジョブネット「A」の実行を前もって中断しておくことを推奨します。ジョブネットの実行は，ajsintrptコマンドで中断できます。

UNIXの場合，SIGKILLによる強制終了であるため，シグナルを捕捉するようなアプリケーションでも強制終了できます。

「監視中」の世代を強制終了した場合は，「監視中」の世代が「監視打ち切り終了」になります。「実行中」および「実行中」の世代の終了を待っている「起動条件待ち」の世代は強制終了されません。

このコマンドは，指定したユニットの強制終了をスケジューラーサービスに依頼すると終了します。指定したユニットの終了を待ちません。

使用例

ジョブ（job1）を強制終了します。なお，このジョブはルートジョブネット（net1）中にあり，環境変数AJSPATHにジョブグループ名が設定されているものとします（環境変数AJSPATHにジョブグループ名が設定されている場合は，コマンド実行時にジョブグループ名の指定を省略できます）。

ajskill net1/job1

ajsleave

形式

ajsleave
     [-F サービス名]
     [-B 実行登録番号
        |-b [[年/]月/]日 [-e [[年/]月/]日]
        |-v [[年/]月/]日 [-w [[年/]月/]日]]
     [-R]
     [-E]
     [-T]
     ジョブネット名，またはジョブグループ名...

機能

ジョブネットの実行登録を解除します。

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Operator権限

引数

-F サービス名

処理対象とする，スケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

-B 実行登録番号

実行登録を解除するジョブネットの，実行登録番号を指定します。

指定できる実行登録番号と，実行登録番号の意味を次の表に示します。

表3‒13　実行登録番号一覧

実行登録番号

意味

all

ジョブネットのすべての実行登録情報

schedule

予定情報

result

結果情報

YYYYMMDDNNN※

指定した実行予定，または実行結果

YYYYMMDD※

指定した年月日の実行予定，または実行結果

注※

内容を次に示します。

YYYY：実行予定年

MM：実行予定月

DD：実行予定日

NNN：実行予定年月日の実行登録順序番号

実行登録番号の詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　4.5.13 コマンド実行時の世代の指定方法」を参照してください。

このオプションを省略した場合，「-B all」が仮定されます。

このオプションは，-b，-e，-v，-wオプションと同時に指定できません。

-b [[年/]月/]日

登録解除する期間の開始日を暦日で指定します。

開始時刻は基準時刻です。

年

指定できる値は，1994〜環境設定パラメーターSCHEDULELIMITの値（単位：西暦年）です。環境設定パラメーターSCHEDULELIMITの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2(123) SCHEDULELIMIT」を参照してください。

月

指定できる値は，1（または01）〜12（単位：月）です。

日

指定できる値は，1（または01）〜31（単位：日）です。

このオプションで，年，または年/月の指定を省略した場合，次の値が仮定されます。

年：コマンドを実行した年

年/月：コマンドを実行した年と月

このオプションは，-B，-v，-wオプションと同時に指定できません。

-e [[年/]月/]日

登録解除する期間の終了日を暦日で指定します。

終了日は開始日と同じ日，または開始日以降の日を指定します。

省略した場合，-bオプションに指定した日が仮定されます。

なお，終了時刻は基準時刻に23時間59分59秒を加えた時刻です。

年

指定できる値は，1994〜環境設定パラメーターSCHEDULELIMITの値（単位：西暦年）です。環境設定パラメーターSCHEDULELIMITの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2(123) SCHEDULELIMIT」を参照してください。

月

指定できる値は，1（または01）〜12（単位：月）です。

日

指定できる値は，1（または01）〜31（単位：日）です。

このオプションで，年，または年/月の指定を省略した場合，次の値が仮定されます。

年：コマンドを実行した年

年/月：コマンドを実行した年と月

このオプションは，-bオプションと同時に指定します。-B，-v，-wオプションと同時に指定できません。

-v [[年/]月/]日

登録解除する期間の開始日を実行日で指定します。

開始時刻は基準時刻です。

年

指定できる値は，1994〜環境設定パラメーターSCHEDULELIMITの値（単位：西暦年）です。環境設定パラメーターSCHEDULELIMITの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2(123) SCHEDULELIMIT」を参照してください。

月

指定できる値は，1（または01）〜12（単位：月）です。

日

指定できる値は，1（または01）〜31（単位：日）です。

このオプションで，年，または年/月の指定を省略した場合，次の値が仮定されます。

年：コマンドを実行した年

年/月：コマンドを実行した年と月

このオプションは，-B，-b，-eオプションと同時に指定できません。

-w [[年/]月/]日

登録解除する期間の終了日を実行日で指定します。

終了日は開始日と同じ日，または開始日以降の日を指定します。

省略した場合，-vオプションに指定した日が仮定されます。

なお，終了時刻は基準時刻に23時間59分59秒を加えた時刻です。

年

指定できる値は，1994〜環境設定パラメーターSCHEDULELIMITの値（単位：西暦年）です。環境設定パラメーターSCHEDULELIMITの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2(123) SCHEDULELIMIT」を参照してください。

月

指定できる値は，1（または01）〜12（単位：月）です。

日

指定できる値は，1（または01）〜31（単位：日）です。

このオプションで，年，または年/月の指定を省略した場合，次の値が仮定されます。

年：コマンドを実行した年

年/月：コマンドを実行した年と月

このオプションは，-vオプションと同時に指定します。-B，-b，-eオプションと同時に指定できません。

-R

指定したジョブグループに含まれるすべてのユニットの実行登録を解除します。

このオプションを，-E，-Tオプションと同時に指定した場合，各オプションの指定内容に従って，ジョブネットの実行登録を解除します。

-Tオプションを同時に指定しない場合，すべてのユニットが登録解除の対象になるため，ルートジョブネット以外のユニットに対する登録解除処理は異常終了します。

-E

実行登録されているジョブネットの実行登録を解除します。

-T

ルートジョブネットの実行登録を解除します。

ジョブネット名，またはジョブグループ名

実行登録を解除するジョブネット名，または-R，-E，-Tオプションと同時にジョブネット名，またはジョブグループ名を指定します。

指定できる文字数は，1〜930（単位：バイト）です。

ジョブネット名，またはジョブグループ名は，複数指定できます。ただし，ジョブネット名を指定する場合，指定できるのはルートジョブネット名だけです。なお，マネージャージョブグループ名とマネージャージョブネット名は指定できません。

ジョブネット名，またはジョブグループ名に，論理ホスト名および実行IDを指定できます。ただし，実行IDを指定した場合，-Bオプションは無効になります。実行IDの指定方法については，「1.1 コマンドの記述形式」を参照してください。

注意事項

ジョブネットの実行登録を解除できるのは，次のどちらかのユーザーです。

そのジョブネットに含まれるすべてのジョブとジョブネットを定義したときに，またはそれらの属性を変更したときに，操作権限を与えられたユーザー

Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザー

ただし，環境設定パラメーターADMACLIMITをデフォルトから変更して「yes」を設定している場合は，Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザーであっても，操作権限が必要です。

スケジューラーサービスが起動していない場合，このコマンドは異常終了します。

実行登録を解除できるのは，ルートジョブネットだけです。

実行登録を解除しようとしたジョブネットが実行中の場合，このコマンドは異常終了します。

実行登録を解除しようとしたジョブネットがサスペンド状態の場合，このコマンドは異常終了します。

戻り値

0

正常終了。

4〜124で4の倍数値

異常終了。

補足事項

環境設定パラメーターROOTJOBNETSCHEDULERANGEに設定した値によって，-b，-e，-v，-wオプションの指定方法が異なる場合があります。48時間制の場合と24時間制の場合に分けて，-b，-e，-v，-wオプションの指定方法を説明します。

ルートジョブネットのスケジュール定義が48時間制の場合

ルートジョブネットのスケジュールの指定が48時間になっている場合，実行日と暦日が異なる場合があります。

例えば，基準時刻が7時0分になっている場合，/jobnet001の実行開始日時を，2009年7月2日32時0分のスケジュールで登録した場合，暦日は7月3日，実行日が7月2日です（暦日は，1日を24時間で考えたときの，ジョブネットの開始予定日であるため，2009年7月2日の32時は，2009年7月3日の8時ということになります）。この場合，暦日は-b，-eオプションで，実行日は-v，-wオプションでそれぞれ指定するので，次のどちらかを指定すれば，登録解除できます。

暦日の場合

   ajsleave -b 2009/7/3 -e 2009/7/3 /jobnet001

実行日の場合

   ajsleave -v 2009/7/2 -w 2009/7/2 /jobnet001

ただし，環境設定パラメーターSCHEDULELIMITに設定した西暦年12月31日24時0分以降のスケジュールを登録解除したい場合は，-b，-eオプションを使用できません。この場合，-v，-wオプションを使用してください。これは，暦日として環境設定パラメーターSCHEDULELIMITに設定した西暦年12月31日24時0分以降のスケジュールを指定しようとすると，指定できる最終年の翌年1月1日0時0分以降を指定することになり，実行予定年として指定できる値（1994〜環境設定パラメーターSCHEDULELIMITの値（単位：西暦年））の範囲外になるからです。環境設定パラメーターSCHEDULELIMITの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2(123) SCHEDULELIMIT」を参照してください。

ルートジョブネットのスケジュール定義が24時間制の場合

ルートジョブネットのスケジュールの指定が24時間になっている場合，実行日と暦日は同じです。

例えば，基準時刻が7時0分になっている場合，/jobnet001の実行開始日時を，2009年7月2日32時0分のスケジュールで登録した場合，暦日は7月3日，実行日が7月3日です。この場合，暦日は-b，-eオプションで，実行日は-v，-wオプションでそれぞれ指定するので，次のどちらかを指定すれば，登録解除できます。

暦日の場合

   ajsleave -b 2009/7/3 -e 2009/7/3 /jobnet001

実行日の場合

   ajsleave -v 2009/7/3 -w 2009/7/3 /jobnet001

使用例

ジョブネット（net1）の実行登録を解除します。

ajsleave net1

ajslogprint

形式

ajslogprint
     [-b 抽出開始日]
     [-e 抽出終了日]
     [-k ログ種別]
     [-F サービス名]
     [-u ユニット名]
     [-m メッセージID]
     スケジューラーログファイル名

機能

スケジューラーログから，指定した条件に合うログレコードを抽出し，出力します。

実行権限

なし

引数

-b 抽出開始日

ログレコードを抽出する範囲（期間）の開始日を指定します。

指定する形式は，[YYYY/]MM/DDです。

YYYY

指定できる値は，1994〜2099（単位：西暦年）です。省略した場合は，コマンドを実行した年が仮定されます。

MM

指定できる値は，1（または01）〜12（単位：月）です。

DD

指定できる値は，1（または01）〜31（単位：日）です。

このオプションを指定した場合，環境設定パラメーターAJSLOGOUTPUTYEARまたはHOSTLOGOUTPUTYEARに「no」を指定した状態で出力されたログレコード（年の情報を含まないログレコード）は，抽出対象になりません。

このオプションを省略した場合は，ログの先頭から抽出します。

-e 抽出終了日

ログレコードを抽出する範囲（期間）の終了日を指定します。

指定する形式は，[YYYY/]MM/DDです。

YYYY

指定できる値は，1994〜2099（単位：西暦年）です。省略した場合は，コマンドを実行した年が仮定されます。

MM

指定できる値は，1（または01）〜12（単位：月）です。

DD

指定できる値は，1（または01）〜31（単位：日）です。

このオプションを指定した場合，環境設定パラメーターAJSLOGOUTPUTYEARまたはHOSTLOGOUTPUTYEARに「no」を指定した状態で出力されたログレコード（年の情報を含まないログレコード）は，抽出対象になりません。

このオプションを省略した場合は，ログの最後まで抽出します。

-k ログ種別

抽出対象のログ種別を指定します。

指定できるログ種別は，マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング　付録C.1 スケジューラーサービスが出力するログ」を参照してください。

このオプションを省略した場合は，すべてのログ種別が抽出対象になります。

-F サービス名

抽出対象のスケジューラーサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

このオプションを省略した場合は，すべてのスケジューラーサービスが抽出対象になります。

-u ユニット名

抽出対象のユニット名をフルパスで指定します。

指定できる文字数は，1〜930（単位：バイト）です。

このオプションを指定した場合，指定したユニット名を含まないログレコードは抽出対象になりません。また，指定したユニットだけが抽出対象になり，配下のユニットは抽出対象になりません。

このオプションを省略した場合は，すべてのユニットが抽出対象になります。

-m メッセージID

抽出対象のメッセージIDを指定します。

指定できる文字数は，1または10（単位：バイト）です。

スケジューラーサービスまたはユニットへの操作ログ種別（「C」で始まるログ種別）で，操作が正常に終了したログだけを抽出する場合は0を指定します。

その他の，特定のメッセージを含むログを抽出する場合は，メッセージID（KAVSxxxx-Zの形式）を指定します。

このオプションを省略した場合は，すべてのメッセージが抽出対象になります。

スケジューラーログファイル名

スケジューラーログファイル名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

スケジューラーログファイル名には，複数のファイル名を指定できません。

注意事項

-k，-F，-u，-mオプションを指定すると，指定したオプションに該当する条件をand条件で抽出します。

サービス名，ユニット名，メッセージID，およびスケジューラーログファイル名には，正規表現を指定できません。

2面にわたるスケジューラーログファイルからログレコードを抽出する場合は，一つのファイルにマージしてからコマンドを実行してください。

不正な形式のログレコードが見つかった場合は，メッセージKAVS0476-Eを出力して次の行から処理を続行します。

JP1/AJS3 - Viewからコマンドを実行する場合に指定できる引数

JP1/AJS3 - Viewからこのコマンドを実行する場合，次に示す引数を指定できます。

項番

引数

必須または任意

1

-b 抽出開始日

−

2

-e 抽出終了日

−

3

-k ログ種別

−

4

-F サービス名

○

5

-u ユニット名

−

6

-m メッセージID

−

7

スケジューラーログファイル名

○

（凡例）

○：必須

−：任意

これ以外のオプションは，JP1/AJS3 - Viewからこのコマンドを実行する場合には指定できません。

JP1/AJS3 - ViewからJP1/AJS3のコマンドを実行する方法については，マニュアル「JP1/Automatic Job Management System 3 操作ガイド　10.4 JP1/AJS3 - ViewからJP1/AJS3のコマンドを実行する」を参照してください。

戻り値

0

正常終了。

4

結果の報告。

・引数の指定が不正である

・条件に合うログがない

・スケジューラーログファイルの形式に誤りがある

・スケジューラーログファイル名が指定されていない

・スケジューラーログファイル名が長過ぎる

12

メモリー不足が発生した。

24

指定したスケジューラーログファイルにアクセスできない。

36

スケジューラーログファイルの読み込み中にエラーが発生した。

120

致命的なエラーが発生した（システムコールでエラー）。

使用例1

2009/10/1から2010/3/31の間で，/net1に対するすべての操作のログレコードをスケジューラーサービス「AJSROOT1」のスケジューラーログから抽出して出力する。

Windowsの場合

ajslogprint -b 2009/10/01 -e 2010/03/31 -u /net1 "C:¥Program Files¥HITACHI¥JP1AJS2¥log¥schedule¥AJSROOT1¥ajs-log1.log"

UNIXの場合

ajslogprint -b 2009/10/01 -e 2010/03/31 -u /net1 /var/opt/jp1ajs2/log/schedule/AJSROOT1/ajs-log1.log

使用例2

2009/10/1から2010/3/31の間で，ユニットの作成（C304）の操作のログレコードをスケジューラーサービス「AJSROOT1」のスケジューラーログから抽出して出力する。

Windowsの場合

ajslogprint -b 2009/10/01 -e 2010/03/31 -k C304 "C:¥Program Files¥HITACHI¥JP1AJS2¥log¥schedule¥AJSROOT1¥ajs-log1.log"

UNIXの場合

ajslogprint -b 2009/10/01 -e 2010/03/31 -k C304 /var/opt/jp1ajs2/log/schedule/AJSROOT1/ajs-log1.log

ajsname

形式

ajsname
     [-F サービス名]
     [-V]
     [-R]
     [{-L|-E}]
     [-T]
     [{-G|-N|-J}]
     [-I]
     ジョブ名，ジョブネット名，またはジョブグループ名...

機能

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

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Editor権限

JP1_AJS_Operator権限

JP1_AJS_Guest権限

引数

-F サービス名

処理対象とする，スケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

-V

リモートジョブネット中のユニット名を出力しません。

-R

指定したユニットに含まれるすべてのユニット名を出力します。

このオプションを，-L，-E，-T，-G，-N，-Jオプションと同時に指定した場合，各オプションの指定内容に従って，ユニット名を出力します。

-L

実行登録していないジョブネット名を出力します。

このオプションは，-E，-Gオプションと同時には指定できません。

-E

実行登録済みのジョブネット名を出力します。

このオプションは，-L，-Gオプションと同時には指定できません。

-T

ルートジョブネット名を出力します。

このオプションは-G，-Jオプションと同時には指定できません。

-G

ジョブグループ名を出力します。

このオプションは，-L，-E，-T，-N，-Jオプションと同時には指定できません。

-N

ジョブネット名を出力します。

このオプションは，-G，-Jオプションと同時には指定できません。

-J

ジョブ名を出力します。

このオプションは，-T，-G，-Nオプションと同時には指定できません。

-I

トラブルシュート時にエラーメッセージに出力されたユニットIDを指定して，ユニット完全名を出力するときに指定します。トラブルシュート以外では，使用しないでください。

-V，-R，-E，-L，-T，-G，-N，-Jオプションと同時には指定できません。

ジョブ名，ジョブネット名，またはジョブグループ名

標準出力ファイルに出力するジョブ名，ジョブネット名，ジョブグループ名，または-R，-L，-E，-T，-G，-N，-Jオプションと同時にジョブ名，ジョブネット名，ジョブグループ名を指定します。

指定できる文字数は，1〜930（単位：バイト）です。

ジョブ名，ジョブネット名，またはジョブグループ名は複数指定できます。

なお，ジョブ名，ジョブネット名，またはジョブグループ名に，論理ホスト名および実行IDは指定できません。

-Iオプションを指定する場合は，ユニット名の代わりにユニットIDを10進数で指定します。

注意事項

ユニット名を出力できるのは，次のどちらかのユーザーです。

ユニットに含まれるすべてのユニットを定義したときに，またはそれらの属性を定義したときに，参照権限を与えられたユーザー。

Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザー。

ただし，環境設定パラメーターADMACLIMITをデフォルトから変更して「yes」を設定している場合は，Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザーであっても，参照権限が必要です。

操作対象がリリース登録したルートジョブネット（リリース先ジョブネット）の場合は，「適用中」状態のジョブネット定義内のユニット名が出力されます。

戻り値

0

正常終了。

4〜124で4の倍数値

異常終了。

使用例1

ジョブネット（/GRP/net1）中のすべてのジョブ名を標準出力ファイルに出力します。

ajsname -RJ /GRP/net1

出力例1

/GRP/net1/job1
/GRP/net1/job2
/GRP/net1/n1/job
/GRP/net1/n2/job

使用例2

ユニットIDが10のユニット完全名を出力します。

ajsname -I 10

出力例2

/group

ajsplan

形式

ajsplan
     [-F サービス名]
     [[-d [[年/]月/]日][-t 時[:分]][-p][-i]
          |[-b 日][-c 分][-p][-i]
          |-q[-p|-w][-i]|-p|-u]
     [-h|-r]
     [-n {優先順位の値|none}]
     [-s {none|時:分|M分|U分|C分}]
     [-e {none|時:分|M分|U分|C分}]
     [-f {none|分}]
     [-B 実行登録番号]
     [-j|-m {時:分|M分|unlimited}
          -k {回数|unlimited}]
     [-l {y|n}]
     [-xw {enable|disable} -xn 待ち合わせ対象ユニット名]
     [-R]
     [-E]
     [-T]
     [-N|-J]
     [-X {yes|no|auto}]
     ジョブ名，ジョブネット名，またはジョブグループ名...

機能

実行登録済みのジョブネットの，次回の実行スケジュールを一時的に変更します（変更した内容で実行したあとは，ジョブネットに定義されたスケジュールに従って実行します）。

ルートジョブネットの実行順序を制御している場合に，ジョブネットコネクタの接続先ジョブネットの実行順序制御方式を一時的に変更します（ルートジョブネット，プランニンググループだけ）。

ジョブを一時的に保留，保留解除，実行中止，または実行中止解除します（変更した内容で実行したあとは，ジョブに定義された属性に従って実行します）。

ジョブおよびジョブネットに待ち合わせ条件を設定している場合に，待ち合わせ条件を一時的に有効または無効にします（変更した内容で実行したあとは，ジョブに定義された属性に従って実行します）。

この機能は，データベース構成が標準構成のときだけ使用できます。

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Operator権限

引数

-F サービス名

処理対象とする，スケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

-d [[年/]月/]日

一時的に変更する次回の実行開始日を指定します。

このオプションは，ジョブには指定できません。ルートジョブネットで-pオプションと同時に指定し，次回のスケジュールを前倒しに変更した場合，変更前の次回実行予定は取り消されます。-pオプションを指定しないで，次回のスケジュールを前倒しに変更した場合，実行予定の追加になります。

なお，ネストジョブネットの場合は，-pオプションの指定の有無に関係なく，実行予定日時の変更だけになります。

年

指定できる値は，1994〜環境設定パラメーターSCHEDULELIMITの値（単位：西暦年）です。環境設定パラメーターSCHEDULELIMITの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2(123) SCHEDULELIMIT」を参照してください。

月

指定できる値は，1（または01）〜12（単位：月）です。

日

指定できる値は，1（または01）〜31（単位：日）です。

このオプションで，年，または年/月の指定を省略した場合，次の値が仮定されます。

年：コマンドを実行した年

年/月：コマンドを実行した年と月

このオプションを省略して-tオプションを指定した場合，一時変更の操作対象となる世代のジョブネットに次回実行予定があるときは，その次回実行予定日（年/月/日）が仮定されます。次回実行予定がないときは，エラーになります。

-t 時[:分]

一時的に変更する次回の実行開始時刻を，絶対時刻で指定します。

このオプションは，ジョブには指定できません。ルートジョブネットで-pオプションと同時に指定し，次回のスケジュールを前倒しに変更した場合，変更前の次回実行予定は取り消されます。-pオプションを指定しないで，次回のスケジュールを前倒しに変更した場合，実行予定の追加になります。

なお，ネストジョブネットの場合は，-pオプションの指定の有無に関係なく，実行予定日時の変更だけになります。

-iオプションと同時に指定した場合，指定したジョブネット中のジョブネットの次回実行開始日時も相対的に変更されます。

時

指定できる値は，0（または00）〜47（単位：時）です。

分

指定できる値は，0（または00）〜59（単位：分）です。省略した場合，0が仮定されます。

このオプションを省略して-dオプションを指定した場合，一時変更の操作対象となる世代のジョブネットに実行予定があるときは，その実行予定時刻（時：分）が仮定されます。

実行予定がないときは，エラーになります。

なお，JP1/AJS3 - Viewからもジョブネットの実行開始日時を一時的に変更できます。JP1/AJS3 - Viewでの操作方法については，マニュアル「JP1/Automatic Job Management System 3 操作ガイド　9.3.1 ジョブネットの実行開始日時を変更する」を参照してください。

-p

ジョブネットやジョブの次回実行予定を取り消します。

次回実行予定をすでに一時変更している場合は，-uオプションで変更前の状態に戻したあと，このコマンドを実行してください。

ルートジョブネットでこのオプションを，-d，-t，-b，-cまたは-qオプションと同時に指定し，次回スケジュールを前倒しに変更した場合，次回実行予定は取り消されます。

なお，ネストジョブネットの場合，このオプションを，-d，-t，-b，-cまたは-qオプションと同時に指定しても有効にはなりません。

-b 日

一時的に変更する実行開始日を，一時変更の操作対象となる世代の実行予定日からの相対日で指定します。

実行予定がないときは，エラーになります。

指定できる値は，−99〜99（単位：日）です。ただし，0は指定できません。

このオプションを省略して-cオプションを指定した場合，相対日として0日が仮定されます。

このオプションは，ジョブには指定できません。ルートジョブネットで-pオプションと同時に指定し，次回のスケジュールを前倒しに変更した場合，変更前の次回実行予定は取り消されます。-pオプションを指定しないで，次回のスケジュールを前倒しに変更した場合，実行予定の追加になります。

なお，ネストジョブネットの場合は，-pオプションの指定の有無に関係なく，実行予定日時の変更だけになります。

-iオプションと同時に指定した場合，指定したジョブネット中のジョブネットの次回実行開始日時も相対的に変更されます。

-c 分

一時的に変更する実行開始時刻を，一時変更の操作対象となる世代の実行予定時刻からの相対分で指定します。

実行予定がないときは，エラーになります。

指定できる値は，−2,879〜2,879（単位：分）です。ただし，0は指定できません。

このオプションは，ジョブには指定できません。ルートジョブネットで-pオプションと同時に指定し，次回のスケジュールを前倒しに変更した場合，変更前の次回実行予定は取り消されます。-pオプションを指定しないで，次回のスケジュールを前倒しに変更した場合，実行予定の追加になります。

なお，ネストジョブネットの場合は，-pオプションの指定の有無に関係なく，実行予定日時の変更だけになります。

-iオプションと同時に指定した場合，指定したジョブネット中のジョブネットの次回実行開始日時も相対的に変更されます。

-q

ジョブネットの次回実行予定を，ルートジョブネットのスケジュール定義に関係なく，コマンドを投入した時点での日時で即時実行します。ただし，このオプションをネストジョブネットに指定した場合，ルートジョブネットの実行日の基準時刻に変更します。

ルートジョブネットで-pオプションと同時に指定した場合，変更前の次回実行予定は取り消されます。-pオプションを同時に指定しないで次回のスケジュールを前倒しに変更した場合は，実行予定の追加になります。また，-pオプションを指定した場合や-pオプションを同時に指定しないで次回のスケジュールを先送りに変更した場合は，実行予定の移動になります。

なお，ネストジョブネットの場合は，-pオプションの指定の有無に関係なく，実行予定日時の変更だけになります。

-iオプションと同時に指定した場合，指定したジョブネット中のジョブネットの次回実行開始日時も相対的に変更されます。

なお，JP1/AJS3 - Viewからも実行予定があるジョブネットを即時実行できます。JP1/AJS3 - Viewでの操作の詳細については，マニュアル「JP1/Automatic Job Management System 3 操作ガイド　9.4 実行予定があるジョブネットをすぐに実行する」を参照してください。

-w

ジョブネットの実行が終了したあと，コマンドを終了します。

このオプションは，ルートジョブネットを即時実行登録する場合にだけ指定してください。保留したり，計画一時変更したりする場合には，指定できません。

このオプションを指定しても，ジョブネットの実行終了を待たずにコマンドが終了する場合を次に示します。

ジョブネット実行中にスケジューラーサービスが停止した場合

終了待ちを指定した世代が繰り越し未実行になった場合

終了待ちを指定した世代が削除された場合（実行登録解除，または即時実行登録・確定実行登録の世代が実行中止になった場合など）

終了待ちを指定した世代が未計画になった場合（計画実行登録したジョブネットのスケジュールが変更されたり，カレンダーが変更されたりして，次回実行予定が未計画になった場合など）

このオプションはルートジョブネットだけに指定できます。-qオプションと同時に指定します。-m，-kオプションと同時には指定できません。

-i

指定したジョブネット中のジョブネットに対して，実行開始日時を相対的に変更します。

このオプションは，ジョブネットだけに指定できます。-d，-t，-b，-c，または-qオプションと同時に指定してください。

-u

-d，-t，-b，-c，-q，-pオプションで一時的に変更したスケジュールを，変更前の情報に戻します。

一時変更を複数実行した場合，最初の変更の前の情報に戻されます。

-h

ジョブネットやジョブの，次回の実行を一時的に保留します。

-r

ジョブネットやジョブの保留を一時的に解除します。

-n {優先順位の値|none}

ジョブネットの実行優先順位を一時的に変更します。

このオプションはジョブには指定できません。

優先順位の値

指定できる値は，1〜5です。

優先順位がいちばん低いのが1，いちばん高いのが5です。

none

ジョブネットに定義された実行優先順位に戻します。

-s {none|時:分|M分|U分|C分}

次回の開始遅延時刻を指定します。

ジョブネットだけに指定できます。

none

開始遅延を監視しません。

時:分

時：分を絶対時刻で指定します。

時に指定できる値は，0（または00）〜47（単位：時）です。

分に指定できる値は，0（または00）〜59（単位：分）です。

M分

ルートジョブネットの実行開始時刻からの相対分で指定します。

指定できる値は，1（または01）〜2,879（単位：分）です。

U分

上位ジョブネットの実行開始時刻からの相対分で指定します。

指定できる値は，1（または01）〜2,879（単位：分）です。

C分

自ジョブネットの実行開始時刻からの相対分で指定します。

指定できる値は，1（または01）〜2,879（単位：分）です。

-e {none|時:分|M分|U分|C分}

次回の終了遅延時刻を指定します。

このオプションはジョブには指定できません。

none

終了遅延を監視しません。

時:分

時：分を絶対時刻で指定します。

時に指定できる値は，0（または00）〜47（単位：時）です。

分に指定できる値は，0（または00）〜59（単位：分）です。

M分

ルートジョブネットの実行開始時刻からの相対分で指定します。

指定できる値は，1（または01）〜2,879（単位：分）です。

U分

上位ジョブネットの実行開始時刻からの相対分で指定します。

指定できる値は，1（または01）〜2,879（単位：分）です。

C分

自ジョブネットの実行開始時刻からの相対分で指定します。

指定できる値は，1（または01）〜2,879（単位：分）です。

-f {none|分}

次回のジョブネットまたはリモートジョブネットの実行所要時間による終了遅延監視時間を指定します。

このオプションはジョブには指定できません。

none

実行所要時間による終了遅延を監視しません。

分

実行所要時間による終了遅延を監視します。

指定できる値は，1（または01）〜2,879（単位：分）です。

-B 実行登録番号

次回実行予定を一時変更するジョブネットの実行登録番号を「YYYYMMDDNNN」の形式で指定します。「YYYYMMDDNNN」の内容を次に示します。

YYYY：実行予定年

MM：実行予定月

DD：実行予定日

NNN：実行予定年月日の実行登録順序番号

実行登録番号の詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　4.5.13 コマンド実行時の世代の指定方法」を参照してください。

-j

ジョブネットに設定された起動条件を無効にします。

このオプションはルートジョブネットだけに指定できます。-m，-kオプションと同時には指定できません。

-m {時:分|M分|unlimited}

起動条件の成立待ち時間を指定します。

このオプションはルートジョブネットだけに指定できます。-kオプションと同時に指定してください。-w，-jオプションと同時には指定できません。

時:分

絶対時刻で指定します。

時に指定できる値は，0（または00）〜47（単位：時）です。

分に指定できる値は，0（または00）〜59（単位：分）です。

M分

ジョブネットの実行開始予定時刻からの相対分で指定します。

指定できる値は，1（または01）〜2,879（単位：分）です。

unlimited

条件の成立の待ち時間を無制限にします。

-k {回数|unlimited}

起動条件の成立待ち回数を指定します。

このオプションはルートジョブネットだけに指定できます。-mオプションと同時に指定してください。-w，-jオプションと同時には指定できません。

回数

指定できる値は，1〜999（単位：回）です。

unlimited

条件の成立待ち回数を無制限にします。

-l {y|n}

ルートジョブネットまたはプランニンググループのユニット定義で，実行順序制御をすると設定している場合だけ，実行順序制御方式を一時的に変更します。

y：ジョブネットコネクタと同期して実行します。

n：ジョブネットコネクタと非同期に実行します。

このオプションは，ジョブネットコネクタの接続先のジョブネットおよび接続先のプランニンググループだけに指定できます。

-xw {enable|disable}

ジョブおよびジョブネットに待ち合わせ条件を設定している場合に，待ち合わせ条件を一時的に有効または無効にします。

enable

待ち合わせ条件を有効にします。

disable

待ち合わせ条件を無効にします。

このオプションは，待ち合わせ条件付きユニットにだけ指定できます。

待ち合わせ条件を変更する待ち合わせ対象ユニットは，-xnオプションで指定します。-xnオプションと同時に指定してください。

データベース構成が標準構成のときだけ使用できます。

このオプションは複数指定できません。複数の待ち合わせ条件付きユニットを操作したい場合は，このコマンドを複数回実行してください。

このオプションは，-R，-E，-T，-N，-J，-B，-X，-F以外のオプションとは同時に指定できません。

-xn 待ち合わせ対象ユニット名

-xwオプションで待ち合わせ条件の有効／無効を変更する待ち合わせ対象ユニット名を指定します。ユニット名だけを指定しても，環境変数AJSPATHの値は補完されません。

-xwオプションと同時に指定してください。

データベース構成が標準構成のときだけ使用できます。

待ち合わせ対象ユニット名に指定できる文字数は，1〜930（単位：バイト）です。正規表現で指定できます。

このオプションは複数指定できません。複数の待ち合わせ対象ユニットを操作したい場合は，このコマンドを複数回実行するか，待ち合わせ対象ユニット名を正規表現で指定してください。待ち合わせ対象ユニット名を正規表現で指定した場合，合致するすべての待ち合わせ対象ユニットの待ち合わせ条件の有効／無効を変更します。

このオプションは，-R，-E，-T，-N，-J，-B，-X，-F以外のオプションとは同時に指定できません。

なお，次の場合はエラーになります。

存在しない待ち合わせ対象ユニット名を指定した場合

待ち合わせ条件が設定されていないユニットを指定した場合

コマンドの実行中に待ち合わせ対象ユニット名が削除された場合

正規表現で合致する待ち合わせ対象ユニットが一つもない場合

-R

指定したユニットに含まれるすべてのジョブネット，およびジョブを一時的に変更します。

このオプションを，-E，-T，-N，-Jオプションと同時に指定した場合，各オプションの指定内容に従って，ジョブネット，またはジョブを一時的に変更します。

-E

実行登録済みのジョブネットのスケジュールを一時的に変更します。

-T

ルートジョブネットのスケジュールを一時的に変更します。

-N

ジョブネットのスケジュールを一時的に変更します。

-Jオプションと同時には指定できません。

-J

ジョブの状態を一時的に変更します。

-Nオプションと同時には指定できません。

-X {yes|no|auto}

プランニンググループの下にあるユニットの中から，現在運用中のユニットを自動的に選択して操作するかどうかを指定します。ただし，ジョブグループの下にあるユニットに対しては，どの値を指定しても自動的に選択しません。また，ルートジョブネット名も省略できません。

yes

自動的に選択して操作する場合に指定します。

コマンドに指定するユニット名は，プランニンググループの下のルートジョブネット名を省略して指定します。

no

自動的に選択して操作しない場合に指定します。

指定したユニットに対して操作します。プランニンググループの下のルートジョブネット名を省略して指定することはできません。

auto

ユニット名の指定方法に従って，自動的に選択して操作するかしないかを決定する場合に指定します。

自動的に選択して操作する場合

プランニンググループの下のルートジョブネット名を省略してユニット名を指定します。

自動的に選択して操作しない場合

プランニンググループの下のルートジョブネット名を省略しないでユニット名を指定します。この場合，指定したユニットが操作対象になります。ただし，プランニンググループの下のルートジョブネット名を省略して指定したパス名と同じ名称のユニットがある場合，省略したものとして扱われ，操作対象のユニットが自動選択されます。

ジョブ名，ジョブネット名，またはジョブグループ名

スケジュールや状態を一時変更するジョブ名，ジョブネット名，または-R，-N，-E，-Tオプションと同時にジョブ名，ジョブネット名，またはジョブグループ名を指定します。

指定できる文字数は，1〜930（単位：バイト）です。

ジョブ名，ジョブネット名，またはジョブグループ名は，複数指定できます。なお，マネージャージョブグループ名とマネージャージョブネット名は指定できません。

ジョブ名，ジョブネット名，またはジョブグループ名に，論理ホスト名および実行IDを指定できます。ただし，実行IDを指定した場合，-Bオプションは無効になります。実行IDの指定方法については，「1.1 コマンドの記述形式」を参照してください。

注意事項

ジョブネットのスケジュールを一時的に変更できるのは，次のどちらかのユーザーです。

スケジュールを変更するジョブネットに含まれるすべてのユニットを定義したときに，または属性を変更したときに，操作権限を与えられたユーザー

Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザー

ただし，環境設定パラメーターADMACLIMITをデフォルトから変更して「yes」を設定している場合は，Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザーであっても，操作権限が必要です。

ジョブの状態を一時的に変更できるのは，次のどちらかのユーザーです。

状態を変更するジョブを含むすべてのジョブネットの操作権限を与えられたユーザー

Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザー

ただし，環境設定パラメーターADMACLIMITをデフォルトから変更して「yes」を設定している場合は，Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザーであっても，操作権限が必要です。

スケジューラーサービスが起動していない場合，このコマンドは異常終了します。

次のようにジョブネットやジョブが一時変更できない状態の場合，このコマンドは異常終了します。

-d，-t，-b，-c，-q，-p，-u，-h，-r，-s，-j，-m，-kオプションは，ジョブネットやジョブが「実行中」，「起動条件待ち」状態など，実行している場合は一時変更できません。ただし，-pオプションは，起動条件が成立した「起動条件待ち」状態のルートジョブネットに対しては一時変更できます。-h，-rオプションは，「起動条件待ち」状態のルートジョブネットに対しては一時変更できます。

-d，-t，-b，-c，-q，-p，-uオプションは，ルートジョブネットが終了状態や，再実行して「開始時刻待ち」状態などで実行が開始していなくても，一時変更できません。

-d，-t，-b，-cオプションは「未計画」状態のジョブネットに対して，-dオプションと-tオプションを同時に指定しなければ一時変更できません。

-pオプションは「未計画」状態のジョブネットに対して一時変更できません。ただし，「未計画」状態のジョブは一時変更できます。

-d，-t，-b，-c，-q，-p，-u，-s，-e，-j，-m，-kオプションは，実行IDや実行登録番号を指定しない場合，終了状態のジョブネットやジョブを一時変更できません。

実行が終了したジョブネットまたはジョブに対して一時変更した場合は，そのユニットを再実行したときに変更が有効になります。一時的に保留属性を設定または解除した場合の詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　4.5.6 ジョブネットやジョブの保留属性を一時変更する」を参照してください。

リモートジョブネット下のユニットに対しては，操作できません。

リモートジョブネットに対して実行優先順位を一時的に変更しても，変更内容は実行先のエージェントでは有効になりません。

ルートジョブネットのスケジュールを一時変更する場合，変更後の実行日と実行開始日時の関係に注意してください。

実行日については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　3.3.1 ルートジョブネットの時間制とスケジュールルール」，またはマニュアル「JP1/Automatic Job Management System 3 導入ガイド　3.3.2 スケジュール情報の定義」を参照してください。

48時間制スケジュールを採用していて，ルートジョブネットのスケジュールを24:00以降に変更する場合，-tオプションに，絶対時刻で24:00以降を指定することで，当日のスケジュールとして扱えます。相対時刻でルートジョブネットのスケジュールを24:00以降に指定すると，翌日のスケジュールとして扱われます。

ルートジョブネットのスケジュール定義に48時間制スケジュールを採用し，基準時刻に0:00以外の時刻が設定されている場合，指定した日時とJP1/AJS3運用上の日時にずれが生じたり，時刻の並びが非連続になったりと，運用が複雑になるため注意が必要です。詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　3.3.2 スケジュール情報の定義」を参照してください。

一時変更しようとしたジョブネット，ジョブがサスペンド状態の場合，このコマンドは異常終了します。

プランニンググループの下にあるユニットの中から操作するユニットを自動的に選択する指定をした場合に，自動的に選択されたユニットに操作権限がないと，エラーになります。

-Xオプションが省略された場合，環境変数AJSAUTOJUDGEの指定値に従って，プランニンググループの下にあるユニットの操作対象が決定されます。

保留されていないユニットに対して，-rオプションで保留解除を行った場合，このコマンドは正常終了します。

リリース登録されているルートジョブネット（リリース先ジョブネット）に対して，次の操作はできません。

「適用中」状態のジョブネット定義の実行開始日時をリリース日時以降に変更する，または日時変更を解除して実行開始日時をリリース日時以降にする

「リリース待ち」状態のジョブネット定義の実行開始日時をリリース日時より前に変更する，または日時変更を解除して実行開始日時をリリース日時より前にする

ajsplanコマンドの-wオプションとajsentryコマンドの-wオプションの同時実行数の合計は50個までです。50個を超えて実行した場合，コマンドは異常終了します。

戻り値

0

正常終了。

4〜124で4の倍数値

異常終了。

補足事項

即時実行登録したジョブネットのスケジュールや，ジョブの状態も一時変更できます。

プランニンググループの下にあるユニット名の指定方法を，次の定義例を用いて説明します。

プランニンググループ定義例

「/net1/job1」の名称のユニットを変更し，「/net1」という名称のプランニンググループの下に「net1-1」と「net1-2」いう名称でルートジョブネットを作成しています。「net1-1」と「net1-2」の下には，「job1」の名称のジョブと「net1-2」の名称のネストジョブネットを作成します。

-Xオプションにyesが指定されている場合

コマンドに指定するユニット名は，プランニンググループの下のルートジョブネット名を省略して指定します。

プランニンググループの下にあるルートジョブネットの中から現在運用中のユニットを自動的に選択して操作します。

（例）ユニット名に「/net1」を指定する。

ajsplan  -h -X yes /net1

解説

この場合，「/net1/net1-1」と「/net1/net1-2」の二つの中から，現在運用中のユニットを自動的に選択して操作します。

また，プランニンググループの下のルートジョブネットより下のユニットの場合は，ルートジョブネットより下のパス名が同じユニットの中から現在運用中のユニットを選択して操作します。

（例）ユニット名に「/net1/job1」を指定する。

ajsplan  -h -X yes /net1/job1

解説

この場合，「/net1/net1-1/job1」と「/net1/net1-2/job1」の二つの中から，現在運用中のユニットを自動的に選択して操作します。

-Xオプションにnoが指定されている場合

プランニンググループの下のユニット名を指定する場合，ルートジョブネット名を省略しないで指定します。

（例）ユニット名に「/net1/net1-1/job1」を指定する。

ajsplan  -h -X no /net1/net1-1/job1

解説

この場合，指定したユニット「/net1/net1-1/job1」に対して操作します。

-Xオプションにautoが指定されている場合

ユニット名の指定方法に従って，自動的に選択して操作するかしないかを決定します。

自動的に選択して操作する場合

指定方法は，-Xオプションにyesを指定した場合と同じです。ただし，プランニンググループの下のルートジョブネット名を省略して指定したパス名のユニットが見つからない場合は，ルートジョブネット名を省略しないで指定したものとして扱われ，指定したユニットに対して操作します。

（例1）ユニット名に「/net1」を指定する。

ajsplan  -h -X auto /net1

解説

この場合，ユニット名が省略されたものとして処理されるため，「/net1/net1-1」と「/net1/net1-2」の二つの中から，現在運用中のユニットを一つ自動的に選択して操作します。

（例2）ユニット名に「/net1/net1-2」を指定する。

ajsplan  -X auto /net1/net1-2

解説

この場合，ユニット名が省略されたものとして処理されるため，「/net1/net1-1/net1-2」と「/net1/net1-2/net1-2」の二つの中から，現在運用中のユニットを一つ自動的に選択して操作します。

「/net1/net1-2」に対して操作したい場合は，次のどちらかを指定します。

-Xオプションにnoを指定する。

環境変数AJSAUTOJUDGEにNOを指定し，-Xオプションを指定しない。

自動的に選択して操作しない場合

指定方法は，-Xオプションにnoを指定した場合と同じです。ただし，プランニンググループの下のルートジョブネット名を省略して指定したパス名と，同じ名称のユニットがある場合，省略したものとして扱われ，操作するユニットを自動選択します。

（例）ユニット名に「/net1/net1-1」を指定する。

ajsplan  -X auto /net1/net1-1

解説

この場合，ユニット名が省略されたものとして処理しようとしますが，プランニンググループ下のルートジョブネット名を省略したユニット名に，該当するユニットがないため，「/net1/net1-1」に対して操作します。

-Xオプションを指定しなかった場合

環境変数AJSAUTOJUDGEの指定値に従って，プランニンググループの下にあるユニットの操作対象を決定します。

環境変数AJSAUTOJUDGEにYESが設定されている

指定方法は，-Xオプションにyesを指定した場合と同じです。

環境変数AJSAUTOJUDGEにNOが設定されている

指定方法は，-Xオプションにnoを指定した場合と同じです。

環境変数AJSAUTOJUDGEにAUTOが設定されているまたは環境変数AJSAUTOJUDGEの設定なし

指定方法は，-Xオプションにautoを指定した場合と同じです。

プランニンググループの詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　11.1 プランニンググループを使用したルートジョブネットの計画切り替え」を参照してください。

使用例1

ジョブネット（net1）の開始時刻を17:00に一時変更します。

ajsplan -t 17:00 net1

使用例2

待ち合わせ条件付きユニットのjob1（/RootJobNet1/job1）に設定している，待ち合わせ対象ユニットjob2（/RootJobNet2/job2）との待ち合わせを，一時的に無効にします。

ajsplan -xw disable -xn /RootJobNet2/job2 /RootJobNet1/job1

なお，job1（/RootJobNet1/job1）の待ち合わせ条件をすべて無効にする場合は，次のように指定します。

ajsplan -xw disable -xn * /RootJobNet1/job1

ajsplanout

形式

ajsplanout
     [-F サービス名]
     [-b 出力開始日付]
     [-d|-c]
     [-R]
     [-E]
     [-T]
     ジョブネット名またはジョブグループ名...

機能

ルートジョブネットおよびルートジョブネット配下のジョブネットや，ジョブの実行予定に対して行われた一時変更情報を標準出力に出力します。

実行権限

ルートジョブネットに，次に示すJP1権限レベルのどれかを与えられたユーザー

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Editor権限

JP1_AJS_Operator権限

JP1_AJS_Guest権限

引数

-F サービス名

処理対象とする，スケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

-b 出力開始日付

一時変更情報を出力する開始日付（年／月／日）をYYYY/MM/DDの形式で指定します。

指定できる日付は，1994/1/1〜2099/12/31です。

このオプションを省略した場合は，現在の日付以降の一時変更情報が出力対象になります。

-d

一時変更情報を出力します。

このオプションは，-cオプションと同時には指定できません。

-dオプションと-cオプションの両方が省略された場合は，-dオプションが仮定されます。

-c

一時変更情報をコマンドラインで出力します。

このオプションは，-dオプションと同時には指定できません。

-dオプションと-cオプションの両方が省略された場合は，-dオプションが仮定されます。

-R

指定したユニットに含まれるすべてのユニットに対して，一時変更情報を出力します。

このオプションを，-E，-Tオプションと同時に指定した場合，各オプションの指定内容に従って，一時変更情報を出力します。

-Tオプションを同時に指定しない場合は，すべてのユニット種別が一時変更情報の出力対象になるため，ルートジョブネット以外のユニットに対する一時変更情報の出力処理は異常終了します。

-E

実行登録済みユニットの一時変更情報を出力します。

-T

ルートジョブネットの一時変更情報を出力します。

ジョブネット名またはジョブグループ名

一時変更情報を出力するジョブネット名，または-R，-E，-Tオプションと同時にジョブグループ名を指定します。

指定できる文字数は，1〜930（単位：バイト）です。

ジョブネット名またはジョブグループ名は，複数指定できます。ただし，ジョブネット名を指定する場合は，指定できるのはルートジョブネット名だけです。なお，マネージャージョブグループ名とマネージャージョブネット名は指定できません。

注意事項

このコマンドを実行できるのは，次のどちらかのユーザーです。

指定するルートジョブネットに対して，参照権限を与えられたユーザー。

Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザー。

ただし，環境設定パラメーターADMACLIMITをデフォルトから変更して「yes」を設定している場合は，Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザーであっても，参照権限が必要です。

JP1/AJS3 - Viewの［一時変更情報の一覧］ダイアログボックスで，一時変更が再操作されていた場合，再操作対象となった一時変更は出力されません。再操作した一時変更情報だけが出力されます。

戻り値

0

正常終了。

4〜124で4の倍数値

異常終了。

使用例1

ルートジョブネット（net1）およびルートジョブネット配下のユニットの，現在日以降の実行予定に対して行われた一時変更情報を，標準出力に出力します。

ajsplanout -d /net1

使用例2

ルートジョブネット（net1）およびルートジョブネット配下のユニットの，2011/08/01以降の実行予定に対して行われた一時変更情報を標準出力に出力します。

ajsplanout -d -b 2011/08/01 /net1

使用例3

ルートジョブネット（net1）およびルートジョブネット配下のユニットの，2011/08/01以降の実行予定に対して行われた一時変更情報を，再実行可能なコマンドラインの形式で標準出力に出力します。

ajsplanout -c -b 2011/08/01 /net1

出力例1

-dオプションを指定したときの出力例を，次に示します。

出力項目の内容

出力対象のルートジョブネットに一時変更情報がある場合

(1)〜(8)を出力します。

出力対象のルートジョブネットに複数の一時変更情報がある場合は，タイトル行を含まない(3)〜(8)の情報を繰り返し出力します。

出力対象のルートジョブネットに一時変更情報がない場合

(1)と(2)を出力したあとにメッセージKAVS4670-Iを出力し，コマンドは異常終了します。

(1) ルートジョブネット名

出力対象のルートジョブネット名を完全名で出力します。

(2) 一時変更情報出力日時

ajsplanoutコマンドが一時変更情報を出力した日時（スケジューラーサービスローカル日時）をYYYY/MM/DD HH:MM:SSの形式で出力します。

(3) 再操作

一時変更の再操作が行われている場合，「操作済」を出力します。

一時変更の再操作が行われていない場合，「-」を出力します。

(4) 開始予定日

実行登録番号（YYYYMMDDNNN）の開始予定日（YYYYMMDD）部分をYYYY/MM/DDの形式で出力します。

MMおよびDDが1けたの場合，0を前に付けて表示します（例2012/01/01）。ajsentryコマンドの-d，-tオプションで実行日を追加した場合，および［デイリースケジュール］ウィンドウまたは［マンスリースケジュール］ウィンドウで確定実行スケジュールを追加した場合，「****/**/**」を出力します。

(5) 実行通番

実行登録番号（YYYYMMDDNNN）の通番（NNN）部分を出力します。

ajsentryコマンドの-d，-tオプションで実行日を追加した場合，および［デイリースケジュール］ウィンドウまたは［マンスリースケジュール］ウィンドウで確定実行スケジュールを追加した場合，「***」を出力します。

(6) 操作日時

一時変更操作が実行された日時をYYYY/MM/DD HH:MM:SSの形式で出力します。

(7) 操作ユーザー

一時変更操作を実行したユーザー名を出力します。

(8) コマンドライン

実行された一時変更操作を，再実行可能なコマンドライン形式で出力します。

TZ環境変数を設定して実行予定を追加した一時変更操作に対しては，コマンドラインの先頭にTZ環境変数の設定値を付けて出力します。

再実行する環境によっては，コマンドラインをそのまま実行することができない場合があります。その場合は，環境に合わせてコマンドラインを変更してください。

出力例2

-cオプションを指定したときの出力例を，次に示します。

出力項目の内容

一時変更情報出力日時と，実行された一時変更操作を，再実行可能なコマンドライン形式で出力します。一時変更情報出力日時とコマンドラインに出力される内容は，出力例1の(2)および(8)を参照してください。

ルートジョブネット名やタイトル行は，出力されません。また，ルートジョブネットに一時変更情報がない場合は，一時変更情報出力日時だけを出力したあとにメッセージKAVS4670-Iを出力し，コマンドは異常終了します。

ajsprint

形式

ajsprint
     [-F サービス名]
     {-a|-c 年[/月[/日]]|-d|-f フォーマット指示子|-v}
     [-t フォーマット指示子]
     [-s {yes|no}]
     [-J|-N|-G]
     [-R]
     [-L|-E]
     [-T]
     ジョブ名，ジョブネット名，またはジョブグループ名...

機能

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

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Editor権限

JP1_AJS_Operator権限

JP1_AJS_Guest権限

引数

-F サービス名

処理対象とする，スケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

-a

指定したユニット，およびそのユニットに含まれるユニットのユニット定義情報を，ajsdefineコマンドで利用できる形式で出力します。

このオプションを指定した場合，引数としてルートジョブグループ「/」は指定できません。

このオプションは-tオプションと同時には指定できません。

環境設定パラメーターAJSPRINTNETSCHPRFによって，上位ジョブネットのスケジュールに依存する指定があり，かつスケジュールルールを持つネストジョブネットのユニット定義情報を出力する場合に，次のどちらかの出力方法を指定できます。

スケジュールルールを有効にし，上位ジョブネットのスケジュールに依存しない。

スケジュールルールを削除し，上位ジョブネットのスケジュールに依存する。

環境設定パラメーターAJSPRINTNETSCHPRFの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2(79) AJSPRINTNETSCHPRF」を参照してください。

-c 年[/月[/日]]

カレンダー情報（運用日，休業日の区別）の出力対象年月日を指定します。

このオプションは-tオプションと同時に指定できます。-J，-N，-L，-E，-Tオプションと同時には指定できません。

年

指定できる値は，1994〜2099（単位：西暦年）です。

月

指定できる値は，1〜12（単位：月）です。

日

指定できる値は，1〜31（単位：日）です。

なお，指定方法によって，出力形式を次の3種類の中から選べます（後述の「使用例1」も参照してください）。

年/月/日

その日の分を出力します。

年/月

基準日※から1か月分を出力します。

年

1月〜12月の各月について，基準日※から12か月分を出力します。

注※

基準日は，ajscalendarコマンドで指定できます。

このオプションを指定した場合，引数として指定できるユニットはジョブグループ名だけです（ジョブ名やジョブネット名を指定した場合，何も出力されません）。

ジョブグループ配下にジョブグループを定義した場合，そのジョブグループのカレンダー情報と，上位のすべてのジョブグループのカレンダー情報がマージされます。カレンダー情報のマージ例を次に示します。

（例）

-d

カレンダー情報を配布する際に必要な，カレンダー情報パラメーターを出力します。

このオプションを指定した場合，引数として指定できるユニットはジョブグループ名だけです（ジョブ名やジョブネット名を指定した場合，何も出力されません）。ルートジョブグループ「/」も指定できます。

出力する情報は，運用日と休業日のユニット定義パラメーターです。ファイルに出力することで，カレンダー情報ファイルとしてajscalendarコマンドの-dfオプションに指定できます。ユニット定義パラメーターの形式については，「5.1 ユニット定義ファイルの作成」を参照してください。

このオプションは，-J，-N，-L，-E，-T，-tオプションと同時には指定できません。

-f フォーマット指示子

フォーマット指示子で指定した情報を出力します。

フォーマット指示子は，%と1バイトの英字，または%と2バイトの英字で指定します。フォーマット指示子の詳細については，後述の「補足事項」を参照してください。

「"（ダブルクォーテーションマーク）」で囲んだフォーマット指示子以外の文字は，指定したとおりに出力されます。

このオプションは-tオプションと同時に指定できます。

-v

配下のユニットでマクロ変数を使用しているユニットを探索し，見つかったユニットの「ユニットの完全名」，「定義項目名（ユニット定義パラメーター名）」，および「定義情報中のマクロ変数名」を一覧形式で出力します。この三つの情報を1行データとして，複数見つかった場合その数分の行が出力されます。1ユニット中の1定義項目中に複数のマクロ変数が定義されていた場合もそれぞれ1行データとして複数行に分けて出力されます。

出力形式を次に示します（後述の「使用例3」も参照してください）。

情報1 情報2 情報3

情報1：ユニットの完全名

情報2：ユニット定義パラメーター名

情報3：定義情報中のマクロ変数名

各情報は，半角の空白文字で区切って出力されます。

配下のユニットでマクロ変数を使用しているユニットがない場合，何も出力しないでコマンドは正常終了します。

このオプションは，-a，-c，-d，-f，-tオプションと同時には指定できません。

-t フォーマット指示子

フォーマット指示子で指定した情報をタイトル行に出力します。

フォーマット指示子は，%と1バイトの英字，または%と2バイトの英字で指定します。フォーマット指示子の詳細については，後述の「補足事項」を参照してください。

「"（ダブルクォーテーションマーク）」で囲んだフォーマット指示子以外の文字は，指定したとおりに出力されます。

このオプションは，-c，-fオプションと同時に指定できます。-aオプションと同時には指定できません。

-s {yes|no}

-fオプションまたは-aオプション指定時に出力されるユニット定義情報の中の，関連線情報の出力順序を固定するかどうかを指定します。関連線情報は，-fオプション指定時はフォーマット指示子%arの出力内容として，-aオプション指定時はarパラメーターとして出力されます。

yes

ユニットの関連線情報の出力順序を固定します。関連線情報は，次のルールで出力されます。

先行ユニット名の文字コードの昇順で出力する。

先行ユニットが同一の場合，後続ユニット名の文字コードの昇順で出力する。

no

ユニットの関連線情報の出力順序を固定しません。関連線情報の出力順序は，ユニットの作成順序に影響されます。

このオプションを省略した場合は，環境設定パラメーターAJSPRINTSORTUNITINFに設定した値（yesまたはno）で動作します。-sオプションも環境設定パラメーターAJSPRINTSORTUNITINFも省略した場合，noが仮定されます。

-sオプションと環境設定パラメーターAJSPRINTSORTUNITINFの設定値が異なる場合は，-sオプションの設定値が優先されます。

環境設定パラメーターAJSPRINTSORTUNITINFの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2(109) AJSPRINTSORTUNITINF」を参照してください。

-s yesオプションは，環境を移行したときや定義済みのユニットをカスタマイズしたときなど，二つのユニットの定義情報を比較するような場合に使用します。例えば，次のような場合です。

環境を移行する際に，移行前の環境でajsprintコマンドを実行してユニット定義情報を出力し，移行後の環境でajsdefineコマンドを実行してユニット定義情報を取り込む場合

定義済みのジョブネットをコピーして別のジョブネットを作成したあとに，コピーしたジョブネットの定義をカスタマイズする場合

このような比較を行う場合，-sオプションにyesを指定して定義情報を出力することで，元になるジョブネットも，ajsdefineコマンドで新規に作成したりコピーして作成したりしたジョブネットも，一律で関連線情報がユニット名の昇順に出力されるため，意図しない差分の発生を防止できます。

-sオプションの使用例については，後述の「使用例4」およびマニュアル「JP1/Automatic Job Management System 3 運用ガイド　13.1.8 JP1/AJS3 - Viewで定義済みのユニットを編集して，編集前後の定義内容を比較したい」を参照してください。

-J

ジョブの定義内容を出力します。

このオプションは，-c，-d，-Tオプションと同時には指定できません。

-N

ジョブネットの定義内容を出力します。

このオプションは，-c，-dオプションと同時には指定できません。

-G

ジョブグループの定義内容を出力します。

このオプションは，-L，-E，-Tオプションと同時には指定できません。

-R

指定したユニットに含まれるすべてのジョブグループ，ジョブネット，およびジョブの定義内容を，階層ごとに繰り返して出力します。

このオプションを，-L，-E，-Tオプションと同時に指定した場合，各オプションの指定内容に従って，ユニットの定義内容を出力します。

このオプションは，-aオプションと同時に指定しないことを推奨します。-aオプションと同時に指定すると，その出力結果をajsdefineコマンドのユニット定義情報に指定した場合に，正しくユニットが定義できない場合があります。

-L

実行登録していないジョブネットの定義内容を出力します。

このオプションは，-c，-d，-Gオプションと同時には指定できません。

-E

実行登録済みジョブネットの定義内容を出力します。

このオプションは，-c，-d，-Gオプションと同時には指定できません。

-T

ルートジョブネットの定義内容を出力します。

このオプションは-c，-d，-J，-Gオプションと同時には指定できません。

ジョブ名，ジョブネット名，またはジョブグループ名

定義内容を出力するジョブ名，ジョブネット名，またはジョブグループ名を指定します。

指定できる文字数は，1〜930（単位：バイト）です。

ジョブ名，ジョブネット名，またはジョブグループ名は，複数指定できます。ただし，-c，および-dオプションを指定した場合，指定できるのはジョブグループ名だけです。

-aオプションを指定した場合，ルートジョブグループ「/」は指定できません。

-dオプションを指定した場合，ルートジョブグループ「/」は指定できます。

なお，ジョブ名，ジョブネット名，またはジョブグループ名に，論理ホスト名を指定できます。実行IDは指定できません。

注意事項

ユニットの定義内容を出力できるのは，次のどちらかのユーザーです。

定義内容を出力するユニットを定義したときに，または属性を変更したときに，参照権限を与えられたユーザー

Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザー

ただし，環境設定パラメーターADMACLIMITをデフォルトから変更して「yes」を設定している場合は，Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザーであっても，参照権限が必要です。

-aオプションを指定してユニットのユニット定義情報を出力した場合，定義されている内容がパラメーターの省略値と等しいと，そのパラメーターの出力を行いません。パラメーターの出力が行われない場合，次の表に示す省略値が定義されています。各パラメーターの詳細については，「5.2 定義情報の形式およびパラメーター」を参照してください。

表3‒14　パラメーターの省略値

ユニット種別

パラメーター

省略値

ジョブグループ

gty

n

ジョブネット

wt

N,no

wc

N,no

cftd

N,no

rg

1

ha

n

cd

no

de

y

ms

sch

mp

n

mm

and

nmg

n

ega

none

uem

n

起動条件

ab

exec

mcs

m

cgs

y

UNIX／PCジョブ

soa

new

sea

new

jd

cod

abr

n

ha

n

eu

ent

jty

q

mm

and

nmg

n

ega

none

uem

n

QUEUEジョブ

jd

cod

abr

n

ha

n

eu

ent

mm

and

nmg

n

ega

none

uem

n

判定ジョブ

ej

gt

ejm

ge

eju

le

フレキシブルジョブ

jd

cod

abr

n

ha

n

eu

ent

mm

and

nmg

n

ega

none

uem

n

HTTP接続ジョブ

htknd

GET

htspt

diff

jd

cod

abr

n

ha

n

eu

def

mm

and

nmg

n

ega

none

uem

n

JP1イベント受信監視ジョブ

evtmc

n

ha

n

eu

ent

evesc

no

ets

kl

mm

and

nmg

n

ega

none

uem

n

ファイル監視ジョブ

flwc

c

flwi

60

flco

n

ha

n

eu

ent

ets

kl

mm

and

nmg

n

ega

none

uem

n

メール受信監視ジョブ

pfm

p

mlsav

y

ha

n

eu

ent

ets

kl

mm

and

nmg

n

ega

none

uem

n

メッセージキュー受信監視ジョブ

ha

n

eu

ent

ets

kl

mm

and

nmg

n

ega

none

uem

n

MSMQ受信監視ジョブ

ha

n

eu

ent

ets

kl

mm

and

nmg

n

ega

none

uem

n

ログファイル監視ジョブ

lfdft

s

lfsrc

n

lfcre

n

ha

n

eu

ent

ets

kl

mm

and

nmg

n

ega

none

uem

n

Windowsイベントログ監視ジョブ

ntnsr

y

ntncl

y

ntnei

y

ha

n

eu

ent

ets

kl

mm

and

nmg

n

ega

none

uem

n

実行間隔制御ジョブ

etn

n

ha

n

eu

ent

ets

kl

mm

and

nmg

n

ega

none

uem

n

JP1イベント送信ジョブ

pfm

p

ha

n

eu

ent

evsrt

n

evspl

10

evsrc

0

jty

q

mm

and

nmg

n

ega

none

uem

n

メール送信ジョブ

pfm

p

ha

n

eu

ent

jty

q

mm

and

nmg

n

ega

none

uem

n

メッセージキュー送信ジョブ

mqprm

n

pfm

p

ha

n

eu

ent

jty

q

mm

and

nmg

n

ega

none

uem

n

MSMQ送信ジョブ

msmod

h

msjnl

n

msunr

n

ha

n

eu

ent

jty

q

mm

and

nmg

n

ega

none

uem

n

JP1/Cm2状態通知ジョブ

cmsts

un

pfm

p

ha

n

eu

ent

jty

q

mm

and

nmg

n

ega

none

uem

n

ローカル電源制御ジョブ

pwlt

f

pwlf

f

pfm

p

ha

n

eu

ent

jty

q

mm

and

nmg

n

ega

none

uem

n

リモート電源制御ジョブ

pwrn

a

pwrr

n

pwrw

n

pwrp

p

pfm

p

ha

n

eu

ent

jty

q

mm

and

nmg

n

ega

none

uem

n

UNIX／PCカスタムジョブ

jd

cod

abr

n

ha

n

eu

ent

soa

new

sea

new

mm

and

nmg

n

ega

none

uem

n

ジョブネットコネクタ

mm

and

nmg

n

ega

none

uem

n

カスタムイベントジョブ

ha

n

eu

ent

ets

kl

mm

and

nmg

n

ega

none

uem

n

出力対象がリリース登録したルートジョブネット（リリース先ジョブネット）の場合は，「適用中」状態のジョブネット定義だけが出力されます。

JP1/AJS3 - Viewからコマンドを実行する場合に指定できる引数

JP1/AJS3 - Viewからこのコマンドを実行する場合，次に示す引数を指定できます。

項番

引数

必須または任意

1

-F サービス名

○

2

-a

−

3

-c 年[/月[/日]]

−

4

-d

−

5

-f フォーマット指示子

−

6

-v

−

7

-s {yes|no}

−

8

-t フォーマット指示子

−

9

-J

−

10

-N

−

11

-G

−

12

-R

−

13

-L

−

14

-E

−

15

-T

−

16

ジョブ名，ジョブネット名，またはジョブグループ名

○

（凡例）

○：必須

−：任意

これ以外のオプションは，JP1/AJS3 - Viewからこのコマンドを実行する場合には指定できません。

JP1/AJS3 - ViewからJP1/AJS3のコマンドを実行する方法については，マニュアル「JP1/Automatic Job Management System 3 操作ガイド　10.4 JP1/AJS3 - ViewからJP1/AJS3のコマンドを実行する」を参照してください。

戻り値

0

正常終了。

4〜124で4の倍数値

異常終了。

補足事項

あるサーバ（サーバA）で定義した情報（ジョブグループ，ジョブネット，ジョブ，カレンダー情報など）を，別のサーバ（サーバB）に移行する手順とコマンド指定例を説明します。この手順は，開発用のサーバで定義した情報を，実際の運用で使用するサーバに移行する場合などに利用してください。

サーバAでajsprintコマンドを実行し，定義情報をファイルに出力する（退避する）。

ajsprint "/*" > 一時ファイル名

サーバBでajsdefineコマンドを実行し，手順1で退避した情報を回復する。

ajsdefine -d / 一時ファイル名

注意事項

この方法では，ルートジョブグループに定義したカレンダー情報などは退避・回復できません。ルートジョブグループに定義したカレンダー情報を退避・回復する手順については，後述の「使用例2」を参照してください。

ユニットの定義内容を出力するフォーマット指示子を表3-15に示します。-fオプションには，表に記載されているすべてのフォーマット指示子を指定できます。-tオプションには，※1が付いているフォーマット指示子だけが指定できます。

また，ユニット種別によっては，指定できるフォーマット指示子が限定されます。ユニット種別に指定できないフォーマット指示子を指定した場合，フォーマット指示子に対応する情報は出力されません。フォーマット指示子ごとに，どのユニット種別に対して指定できるかを略号で示します。ユニット種別の略号については，「5.2.1 属性定義情報の記述方法」のtyパラメーターを参照してください。

その他のフォーマット指示子を表3-16に示します。

フォーマット指示子の出力形式を表3-17に示します。

許可モードの表示内容を表3-18に示します。

表3‒15　ユニットの出力に関するフォーマット指示子

フォーマット指示子

出力情報

ユニット種別の略号※3

%JN※1

ユニットの完全名

930バイト以内の文字列

mg，g，mn，rc，n，rm，j，pj，qj，jdj，cj，cpj，orj，cmsj，evsj，evwj，flwj，lfwj，mlsj，mlwj，mqsj，mqwj，mssj，mswj，ntwj，pwlj，pwrj，tmwj，hln，nc，fxj，htpj，cewj

%jn※1

ユニット名

30バイト以内の文字列

mg，g，mn，rc，n，rm，j，pj，qj，jdj，cj，cpj，orj，cmsj，evsj，evwj，flwj，lfwj，mlsj，mlwj，mqsj，mqwj，mssj，mswj，ntwj，pwlj，pwrj，tmwj，hln，nc，fxj，htpj，cewj

%ap※1

AJSCONF=，AJSPATH=で表される内容

%JNで表される内容のうち，最右端の「/」より右の部分を除いた内容。

mg，g，mn，rc，n，rm，j，pj，qj，jdj，cj，cpj，orj，cmsj，evsj，evwj，flwj，lfwj，mlsj，mlwj，mqsj，mqwj，mssj，mswj，ntwj，pwlj，pwrj，tmwj，hln，nc，fxj，htpj，cewj

%TY※1

ユニットの種別

mgroup：マネージャージョブグループ

group：ジョブグループ

mnet：マネージャージョブネット

condn：起動条件（.CONDITION）

net：ジョブネット

rnet：リカバリージョブネット

rmnet：リモートジョブネット

rrnet：リカバリーリモートジョブネット

job：UNIXジョブ

rjob：リカバリーUNIXジョブ

pjob：PCジョブ

rpjob：リカバリーPCジョブ

qjob：QUEUEジョブ

rqjob：リカバリーQUEUEジョブ

jdjob：判定ジョブ

rjdjob：リカバリー判定ジョブ

orjob：ORジョブ

rorjob：リカバリーORジョブ

fxjob：フレキシブルジョブ

rfxjob：リカバリーフレキシブルジョブ

htpjb：HTTP接続ジョブ

rhtpjb：リカバリーHTTP接続ジョブ

cmsjb：JP1/Cm2状態通知ジョブ

rcmsjb：リカバリーJP1/Cm2状態通知ジョブ

evwjb：JP1イベント受信監視ジョブ

revwjb：リカバリーJP1イベント受信監視ジョブ

flwjb：ファイル監視ジョブ

rflwjb：リカバリーファイル監視ジョブ

mlwjb：メール受信監視ジョブ

rmlwjb：リカバリーメール受信監視ジョブ

mqwjb：メッセージキュー受信監視ジョブ

rmqwjb：リカバリーメッセージキュー受信監視ジョブ

mswjb：MSMQ受信監視ジョブ

rmswjb：リカバリーMSMQ受信監視ジョブ

lfwjb：ログファイル監視ジョブ

rlfwjb：リカバリーログファイル監視ジョブ

ntwjb：Windowsイベントログ監視ジョブ

rntwjb：リカバリーWindowsイベントログ監視ジョブ

tmwjb：実行間隔制御ジョブ

rtmwjb：リカバリー実行間隔制御ジョブ

cewjb：カスタムイベントジョブ

rcewjb：リカバリーカスタムイベントジョブ

evsjb：JP1イベント送信ジョブ

revsjb：リカバリーJP1イベント送信ジョブ

mlsjb：メール送信ジョブ

rmlsjb：リカバリーメール送信ジョブ

mqsjb：メッセージキュー送信ジョブ

rmqsjb：リカバリーメッセージキュー送信ジョブ

mssjb：MSMQ送信ジョブ

rmssjb：リカバリーMSMQ送信ジョブ

pwljb：ローカル電源制御ジョブ

rpwljb：リカバリーローカル電源制御ジョブ

pwrjb：リモート電源制御ジョブ

rpwrjb：リカバリーリモート電源制御ジョブ

cuujb：カスタムUNIXジョブ

rcuujb：リカバリーカスタムUNIXジョブ

cupjb：カスタムPCジョブ

rcupjb：リカバリーカスタムPCジョブ

netcn：ジョブネットコネクタ

mg，g，mn，rc，n，rm，j，pj，qj，jdj，cj，cpj，orj，cmsj，evsj，evwj，flwj，lfwj，mlsj，mlwj，mqsj，mqwj，mssj，mswj，ntwj，pwlj，pwrj，tmwj，hln，nc，fxj，htpj，cewj

%ow※1

所有者名

31バイト以内の文字列。指定がない場合，何も出力されない。

mg，g，mn，rc，n，rm，j，pj，qj，jdj，cj，cpj，orj，cmsj，evsj，evwj，flwj，lfwj，mlsj，mlwj，mqsj，mqwj，mssj，mswj，ntwj，pwlj，pwrj，tmwj，hln，nc，fxj，htpj，cewj

%gr※1

JP1資源グループ名

63バイト以内の文字列。指定がない場合，何も出力されない。

mg，g，mn，rc，n，rm，j，pj，qj，jdj，cj，cpj，orj，cmsj，evsj，evwj，flwj，lfwj，mlsj，mlwj，mqsj，mqwj，mssj，mswj，ntwj，pwlj，pwrj，tmwj，hln，nc，fxj，htpj，cewj

%ud※1

最終更新日時※2

mg，g，mn，rc，n，rm，j，pj，qj，jdj，cj，cpj，orj，cmsj，evsj，evwj，flwj，lfwj，mlsj，mlwj，mqsj，mqwj，mssj，mswj，ntwj，pwlj，pwrj，tmwj，hln，nc，fxj，htpj，cewj

%cm

コメント

80バイト以内の文字列。指定がない場合，何も出力されない。

mg，g，mn，rc，n，rm，j，pj，qj，jdj，cj，cpj，orj，cmsj，evsj，evwj，flwj，lfwj，mlsj，mlwj，mqsj，mqwj，mssj，mswj，ntwj，pwlj，pwrj，tmwj，hln，nc，fxj，htpj，cewj

%mh

マネージャーホスト名

255バイト以内の文字列。指定がない場合，何も出力されない。

mg，mn

%mu

マネージャーユニット名

961バイト以内の文字列。指定がない場合，何も出力されない。

mg，mn

%en

指定したユニットに含まれるユニット名

30バイト以内の文字列

g，rc，n，rm

%eN

指定したユニットに含まれる，種別記号付きのユニット名

35バイト以内の記号付き文字列。両端の記号が各シンボルの種類を表す。

<ジョブグループ名>

(ジョブネット名)

(リモートジョブネット名)R

[UNIXジョブ名]

<マネージャージョブグループ名>M

(マネージャージョブネット名)M

{QUEUEジョブ名}

[PCジョブ名]P

!起動条件付きジョブネット名!

[判定ジョブ名]J

[ORジョブ名]O

[JP1イベント受信監視ジョブ名]E

[ファイル監視ジョブ名]F

[メール受信監視ジョブ名]M

[メッセージキュー受信監視ジョブ名]Q

[MSMQ受信監視ジョブ名]S

[ログファイル監視ジョブ名]L

[Windowsイベントログ監視ジョブ名]N

[実行間隔制御ジョブ名]T

[JP1イベント送信ジョブ名]e

[メール送信ジョブ名]m

[メッセージキュー送信ジョブ名]q

[MSMQ送信ジョブ名]s

[JP1/Cm2状態通知ジョブ名]C

[ローカル電源制御ジョブ名]W

[リモート電源制御ジョブ名]w

[カスタムUNIXジョブ名]U

[カスタムPCジョブ名]u

(ジョブネットコネクタ名)C

[フレキシブルジョブ]c

[HTTP接続ジョブ]H

リカバリーユニットの場合，括弧が二重になる。

（例）

[[リカバリーUNIXジョブ名]]

g，rc，n，rm

%Ce

ルートジョブネットの実行順序制御のスケジューラーサービス間連携

y：スケジューラーサービス間連携する

n：スケジューラーサービス間連携しない

g，n，nc

%Ch

接続ホスト名

255バイト以内の文字列。指定がない場合，何も出力されない。

g，n，nc

%Cs

接続サービス名

30バイト以内の文字列。指定がない場合，何も出力されない。

g，n，nc

%et

指定したユニットに含まれるユニットの種別

%TYを参照のこと。

g，rc，n，rm

%eH

指定したユニットに含まれるユニットを画面に表示するときの水平位置

0〜16,000（単位：ピクセル）の値

g，rc，n，rm

%eV

指定したユニットに含まれるユニットを画面に表示するときの垂直位置

0〜10,000（単位：ピクセル）の値

g，rc，n，rm

%sH

指定したユニットに含まれるユニットを画面に表示するときに，水平方向に並べる個数

1〜100（単位：個）の値

g，rc，n，rm

%sV

指定したユニットに含まれるユニットを画面に表示するときに，垂直方向に並べる個数

1〜100（単位：個）の値

g，rc，n，rm

%op

運用日（特定日指定）※2

g

%cl

休業日（特定日指定）※2

g

%w0〜%w6

週間標準値

%w0：日曜日

%w1：月曜日

%w2：火曜日

%w3：水曜日

%w4：木曜日

%w5：金曜日

%w6：土曜日

o：運用日

x：休業日

-：なし

g

%sd

基準日

1〜31：日

xx:n：曜日（xxは，su，mo，tu，we，th，fr，sa）と週（nは，1〜5）

-：なし

g

%md

月区分

this：当月

next：翌月

-：なし

g

%st

基準時刻

hh:mm：時刻（hhは，0〜23（単位：時）。mmは，0〜59（単位：分））

**:**：なし

g

%Sd

ジョブネットの実行開始日※2

n，rm

%St

ジョブネットの実行開始時刻※2

n，rm

%sy

ジョブネットの開始遅延時刻※2

n，rm

%ey

ジョブネットの終了遅延時刻※2

n，rm

%ln

リンク番号

N，n：Nは，スケジュールを複数定義している場合のルール番号で1〜144の値。nはリンク番号で1〜144の値。ルール番号とリンク番号が同じ数値の場合は，何も出力されない。

-,-：なし（関係するジョブネットに，出力するリンク番号がない場合）

n，rm

%cy

処理サイクル

N,n,X：Nは，スケジュールを複数定義している場合のルール番号で1〜144の値。nは，Xに対応する1〜31（単位：年，月，週，または日）の値。Xは，処理サイクルの種別で，y，m，w，d。

n,y：年の場合（nは，1〜9）

n,m：月の場合（nは，1〜12）

n,w：週の場合（nは，1〜5）

n,d：日の場合（nは，1〜31）

-,-,-：なし

n，rm

%sh

振り替え方法

N,XXXX：Nは，スケジュールを複数定義している場合のルール番号で1〜144の値。XXXXは，振り替え方法で，before，after，cancel，none。

before：前日に振り替え

after：翌日に振り替え

cancel：実行しない

none：振り替えなしで実行

n，rm

%hd

振り替え猶予日数

N,XX：Nは，スケジュールを複数定義している場合のルール番号で1〜144の値。XXは，振り替え猶予日数で，1〜31（単位：日）の値

n，rm

%Wt

イベント待ち時間

{N,t,HH:MM|N,r,MMMM|N,u|N,-}：Nは，スケジュールを複数定義している場合のルール番号で1〜144の値。t，r，u，-は，イベント待ち時間の種別。HH:MM（HHは，0〜47（単位：時）。MMは，0〜59（単位：分）），およびMMMM（1〜2,879（単位：分））は，イベント待ち時間。

t：絶対時刻指定

r：相対分指定

u：無制限

-：なし

n，rm

%Wc

イベント待ち回数

{N,w,n|N,u|N,-}：Nは，スケジュールを複数定義している場合のルール番号で1〜144の値。w，u，-は，イベント待ち回数の種別。nは，イベント待ち回数で0〜999（単位：回）の値。

w：イベント待ち回数を指定している。

u：イベント待ち回数は無制限。

-：なし

n，rm

%Cf

起算情報

{N,m,C|-,c|-}：Nは，スケジュールを複数定義している場合のルール番号で1〜144の値。mは，起算方法の種別で，a，b，db，da，またはn。Cは，起算日数で1〜31（単位：日）の値。cは，起算猶予日数で1〜31（単位：日）の値。-は，なし。

mがnの場合，Cまたはcではなく，-が出力される。

mがdbまたはdaの場合，cではなく，-が出力される。

b：前日以前の運用日に振り替える。

a：翌日以降の運用日に振り替える。

db：前日以前に振り替える。

da：翌日以降に振り替える。

n：なし

n，rm

%Ej

排他ジョブネット名

30バイト以内の文字列。指定がない場合，何も出力されない。

n，rm

%ed

ジョブネットの実行有効期日※2

n，rm

%rg

保存世代数

1〜99（単位：世代）の値。ただし，システム設定オプションを有効にしておくと，最大999（単位：世代）まで出力できる。

n，rm

%Ni

ジョブネットの実行優先順位

1〜5の値。指定がない場合，-。

n，rm

%jc

カレンダー情報

930バイト以内の文字列。指定がない場合，何も表示されない。

n，rm

%cd

イベント待ち打ち切り日数

1day：1日間待つ。

2days：2日間待つ。

unlimited：無制限に待つ。

-：なし

n，rm

%de

上位ジョブネットのスケジュールとの依存関係

yes：依存する。

no：依存しない。

n，rm

%ms

スケジューリング方式

skip：スケジュールスキップ方式

multi：多重スケジュール方式

n，rm

%mp

多重起動属性

yes：許可する。

no：許可しない。

n，rm

%ha

保留属性

yes：保留する。

no：保留しない。

ifAbend：異常時に保留する。

ifAbendW：異常警告時に保留する。

n，rm，j，pj，qj，jdj，cj，cpj，cmsj，evsj，evwj，flwj，lfwj，mlsj，mlwj，mqsj，mqwj，mssj，mswj，ntwj，pwlj，pwrj，tmwj，fxj，htpj，cewj

%Rh

リモートジョブネットに定義された実行マネージャー名

255バイト以内の文字列。指定がない場合，何も出力されない。

rm

%ar

ユニットの実行順序関係

先行ユニット名,後続ユニット名,接続種別：各ユニットは，30バイト以内の文字列。接続種別は，s，またはc。指定がない場合，-,-。

s：順接続

c：条件接続

n，rm

%CO

起動条件

and：and接続

or：or接続

rc

%eU

ジョブ実行時のJP1ユーザー

ent：登録者で実行する。

def：定義者で実行する。

j，pj，qj，cj，cpj，cmsj，evsj，evwj，flwj，lfwj，mlsj，mlwj，mqsj，mqwj，mssj，mswj，ntwj，pwlj，pwrj，tmwj，fxj，htpj，cewj

%cn

カスタムジョブ名

16バイト以内の文字列。指定がない場合，何も出力されない。

cj，cpj

%Te

コマンドテキスト

1,023バイト以内の文字列。指定がない場合，何も出力されない。

j，cj，cpj

%sc

スクリプトファイル名（UNIXの場合），または実行ファイル名（Windowsの場合）

511バイト以内の文字列。指定がない場合，何も出力されない。

j，pj，qj，cj，cpj，fxj

%pm

パラメーター

1,023バイト以内の文字列。指定がない場合，何も出力されない。

j，pj，qj，cj，cpj，fxj

%wk

作業用パス名

511バイト以内の文字列。指定がない場合，何も出力されない。

j，pj

%ev

環境変数ファイル名

511バイト以内の文字列。指定がない場合，何も出力されない。

j，pj

%En

環境変数

20,479バイト以内の文字列。指定がない場合，何も出力されない。

複数の環境変数が指定されている場合，環境変数は「;（セミコロン）」で区切って出力されます。

j，pj，cj，cpj，fxj

%si

標準入力ファイル名

511バイト以内の文字列。指定がない場合，何も出力されない。

j，pj

%so

標準出力ファイル名

511バイト以内の文字列。指定がない場合，何も出力されない。

j，pj，cj，cpj，htpj

%se

標準エラー出力ファイル名

511バイト以内の文字列。指定がない場合，何も出力されない。

j，pj，cj，cpj，htpj

%oa

標準出力ファイルの情報更新オプション

new：新しい標準出力ファイルに情報を出力する。

add：既存の標準出力ファイルに情報を追加する。

j，pj

%ea

標準エラー出力ファイルの情報更新オプション

new：新しい標準エラー出力ファイルに情報を出力する。

add：既存の標準エラー出力ファイルに情報を追加する。

j，pj

%Et

実行打ち切り時間

1〜1,440（単位：分）の値

j，pj，cj，cpj，cmsj，evsj，evwj，flwj，lfwj，mlsj，mlwj，mqsj，mqwj，mssj，mswj，ntwj，pwlj，pwrj，tmwj，htpj，cewj

%pr

ジョブネットまたはジョブの実行優先順位

1〜5の値。指定がない場合，-。

n，rm，j，pj，qj，cj，cpj，htpj

%rh

実行エージェント名または実行エージェントグループ名

255バイト以内の文字列。指定がない場合，何も出力されない。

フレキシブルジョブの場合，中継エージェントとなる実行エージェント名または実行エージェントグループ名が出力される。

n，rm，j，pj，cj，cpj，cmsj，evsj，evwj，flwj，lfwj，mlsj，mlwj，mqsj，mqwj，mssj，mswj，ntwj，pwlj，pwrj，tmwj，fxj，htpj，cewj

%un

実行ユーザー名

63バイト以内の文字列。指定がない場合，何も出力されない。

j，pj，cj，cpj，htpj

%jd

終了判定

normal：常に正常

abnorm：常に異常

code：終了コード

exist：ファイルが作成されている場合，正常

modify：ファイルが更新されている場合，正常

j，pj，qj，cj，cpj，fxj，htpj

%wt

警告終了しきい値

0〜2,147,483,647の値。指定がない場合，-。

j，pj，qj，cj，cpj，fxj，htpj

%Th

異常終了しきい値

0〜2,147,483,647の値

j，pj，qj，cj，cpj，fxj，htpj

%jf

終了判定ファイル名

511バイト以内の文字列。指定がない場合，何も出力されない。

j，pj，cj，cpj，fxj，htpj

%Ab

異常終了時の自動リトライ

y：異常終了時に自動リトライする。

n：異常終了時に自動リトライしない。

j，pj，qj，cj，cpj，fxj，htpj

%rs

自動リトライする終了コードの下限

1〜4,294,967,295の値。省略した場合，-。その場合，実行時には終了判定の「異常しきい値＋1」が仮定される。

異常終了時に自動リトライしない場合，何も出力されない。

j，pj，qj，cj，cpj，fxj，htpj

%re

自動リトライする終了コードの上限

1〜4,294,967,295の値。省略した場合，-。その場合，実行時には最大値の「4,294,967,295」が仮定される。

異常終了時に自動リトライしない場合，何も出力されない。

j，pj，qj，cj，cpj，fxj，htpj

%rc

最大リトライ回数

1〜12（単位：回）の値。

異常終了時に自動リトライしない場合，何も出力されない。

j，pj，qj，cj，cpj，fxj，htpj

%ri

リトライ間隔

1〜10（単位：分）の値。

異常終了時に自動リトライしない場合，何も出力されない。

j，pj，qj，cj，cpj，fxj，htpj

%qu

キュー名

63バイト以内の文字列。指定がない場合，何も出力されない。

qj

%qm

キューマネージャーホスト名

255バイト以内の文字列。指定がない場合，何も出力されない。

qj

%rq

ジョブ名

63バイト以内の文字列。指定がない場合，何も出力されない。

qj

%s1〜%s4

転送元ファイル名

511バイト以内の文字列。指定がない場合，何も出力されない。

%s1：転送元ファイル1の名称

%s2：転送元ファイル2の名称

%s3：転送元ファイル3の名称

%s4：転送元ファイル4の名称

j，pj，qj

%d1〜%d4

転送先ファイル名

511バイト以内の文字列。指定がない場合，何も出力されない。

%d1：転送先ファイル1の名称

%d2：転送先ファイル2の名称

%d3：転送先ファイル3の名称

%d4：転送先ファイル4の名称

j，pj，qj

%T1〜%T4

転送先ファイルのジョブ実行終了後の削除オプション

save：保存する。

delete：削除する。

j，pj

%ej

判定方法

greater：判定値より大。

greater equal：判定値以上。

less：判定値より小。

less equal：判定値以下。

equal：判定値と等しい。

not equal：判定値と等しくない。

range in：判定値の範囲内。

range out：判定値の範囲外。

exist：ファイルが作成されている。

not exist：ファイルが作成されていない。

variable greater：変数が判定値より大。

variable greater equal：変数が判定値以上。

variable less：変数が判定値より小。

variable less equal：変数が判定値以下。

variable equal：変数が判定値と等しい。

variable not equal：変数が判定値と等しくない。

variable range in：変数が判定値の範囲内。

variable range out：変数が判定値の範囲外。

string equal：変数が判定文字列と等しい。

string part equal：変数が判定文字列を含む。

string not equal：変数が判定文字列と等しくない。

string part not equal：変数が判定文字列を含まない。

string not null：変数の値がある。

string null：変数の値がない。

jdj

%eC

終了判定コード

0〜4,294,967,295の値

jdj

%el

下限の終了判定コード

0〜4,294,967,295の値

判定方法が「判定値の範囲内」または「判定値の範囲外」の場合に出力される。

jdj

%eh

上限の終了判定コード

0〜4,294,967,295の値

判定方法が「判定値の範囲内」または「判定値の範囲外」の場合に出力される。

jdj

%ef

終了判定ファイル名

260バイト以内の文字列。指定がない場合，何も出力されない。

jdj

%jV

変数名

64バイト以内の文字列。指定がない場合，何も出力されない。

jdj

%jT

変数の判定文字列

511バイト以内の文字列。指定がない場合，何も出力されない。

jdj

%jI

変数の判定数値

0〜2,147,483,647の値。

jdj

%jS

下限の変数判定数値

0〜2,147,483,647の値。

判定方法が「変数が判定値の範囲内」または「変数が判定値の範囲外」の場合に出力される。

jdj

%jG

上限の変数判定数値

0〜2,147,483,647の値。

判定方法が「変数が判定値の範囲内」または「変数が判定値の範囲外」の場合に出力される。

jdj

%lP

終了コードまたは変数判定数値の境界条件（下限）

greater：判定値より大。

greater equal：判定値以上。

判定方法が「判定値の範囲内」，「判定値の範囲外」，「変数が判定値の範囲内」，または「変数が判定値の範囲外」の場合に出力される。

jdj

%uP

終了コードまたは変数判定数値の境界条件（上限）

less：判定値より小。

less equal：判定値以下。

判定方法が「判定値の範囲内」，「判定値の範囲外」，「変数が判定値の範囲内」，または「変数が判定値の範囲外」の場合に出力される。

jdj

%CI

HP NNMに通知する状態付加情報

256バイト以内の文字列。指定がない場合，何も出力されない。

cmsj

%CC

HP NNMに通知する状態

un：Unknown

no：Normal

wa：Warning

mi：Minor

ma：Major

cr：Critical

re：Restricted

te：Testing

di：Disabled

cmsj

%ED

イベント詳細情報

1,024バイト以内の文字列。指定がない場合，何も出力されない。

evwj

%Eg

イベント発行元グループID

−1〜9,999,999,999の値。指定がない場合，********。

evwj

%EG

イベント発行元グループ名

20バイト以内の文字列。指定がない場合，********。

evwj

%EH

イベント発行元ホスト名，イベント送信先ホスト名

255バイト以内の文字列。指定がない場合，何も出力されない。

evsj，evwj

%EI

監視イベントID

17バイト以内の文字列。指定がない場合，********。

evwj

%eI

送信イベントID

8バイト以内の文字列。指定がない場合，********。

evsj

%Ei

イベント発行元IPアドレス

15バイト以内の文字列。指定がない場合，********。

evwj

%eM

イベントメッセージ情報（送信）

1,023バイト以内の文字列。指定がない場合，何も出力されない。

evsj

%EM

イベントメッセージ情報（受信）

1,024バイト以内の文字列。指定がない場合，何も出力されない。

evwj

%Ep

イベント発行元プロセスID

10バイト以内の文字列。指定がない場合，********。

evwj

%eS

イベント拡張属性重大度（送信）

em：Emergencyを設定する。

al：Alertを設定する。

cr：Criticalを設定する。

er：Errorを設定する。

wr：Warningを設定する。

no：Noticeを設定する。

in：Informationを設定する。

db：Debugを設定する。

evsj

%ES

イベント拡張属性重大度（受信）

em：Emergencyを条件一致とする。

al：Alertを条件一致とする。

cr：Criticalを条件一致とする。

er：Errorを条件一致とする。

wr：Warningを条件一致とする。

no：Noticeを条件一致とする。

in：Informationを条件一致とする。

db：Debugを条件一致とする。

evwj

%Ef

任意のイベント拡張属性（送信）

128バイト以内の文字列。指定がない場合，何も出力されない。

evsj

%ET

終了判定条件

n：常に正常終了

a：常に異常終了

n,ファイル名：メッセージが指定したファイルの内容と一致する場合に正常終了

a,ファイル名：メッセージが指定したファイルの内容と一致する場合に異常終了

d,ファイル名：詳細情報が指定したファイルの内容と一致する場合に正常終了

b,ファイル名：詳細情報が指定したファイルの内容と一致する場合に異常終了

なお，ファイル名は，256バイト以内の文字列。

evwj

%Eu

イベント発行元ユーザーID

−1〜9,999,999,999の値。指定がない場合，********。

evwj

%EU

イベント発行元ユーザー名

20バイト以内の文字列。指定がない場合，********。

evwj

%EF

任意のイベント拡張属性（受信）

2,048バイト以内の文字列。指定がない場合，何も出力されない。

evwj

%FC

監視条件

c：ファイルの作成を監視する。

d：ファイルの削除を監視する。

s：ファイルのサイズ変更を監視する。

m：ファイルの最終更新時刻の変更を監視する。

flwj

%FF

監視対象ファイル名

255バイト以内の文字列。指定がない場合，何も出力されない。

flwj

%FI

監視時間間隔

1〜600（単位：秒）の値

flwj

%FO

監視対象ファイルがある場合の扱い

y：条件成立（正常終了）

n：監視継続

flwj

%Lw

ファイル未作成時エラーオプション

yes：エラーとする。

no：エラーとしない。

lfwj

%Ld

ログファイルの出力データ形式

s：シーケンシャルファイル（一つのログファイルに追加書き込みし続けるファイル。ログファイルが一定の容量に達すると，別のファイル名で新たにログファイルを作成して書き込むファイル）

s2：シーケンシャルファイル（ファイル名を変更して保存，またはファイルをいったん削除したあと，同じ名称のファイルを作成して新たにログを書き込むファイル）

w1：ラップアラウンド（ログファイルが一定の容量に達すると，ラップアラウンドして再び先頭からデータを上書きする形式のファイル）

w2：ラップアラウンド（ログファイルが一定の容量に達してラップアラウンドするとき，データを削除して再び先頭からデータを書き込む形式のファイル）

lfwj

%LF

ログファイル名

256バイト以内の文字列。指定がない場合，何も出力されない。

lfwj

%LL

ヘッダー指定

l：行数（0〜99,999（単位：行）の値）

s：サイズ（0〜9,999,999（単位：行）の値）

-：なし

lfwj

%LM

ログ情報以外のデータ（AND/ORの区別は出力しない）

1,024バイト以内の文字列。指定がない場合，何も出力されない。

lfwj

%Lm

ログ情報以外のデータ

1,024バイト以内の文字列。指定がない場合，何も出力されない。

ANDは:（コロン），ORは改行が出力されます。

（出力例）「"AAA"かつ"BBB"または"CCC"」の場合

"AAA":"BBB"

"CCC"

lfwj

%LX

イベントデータの最大長

2〜512（単位：バイト）の値

lfwj

%LR

ログデータのレコード形式

v：可変長レコード（3〜4バイトの文字列）を行の区切りとする。

f：固定長レコード（1〜9,999,999バイトの文字列）を行の区切りとする。

lfwj

%LI

ファイル検索時間間隔

1〜86,400（単位：秒）の値

lfwj

%Ls

検索開始オプション

yes：先頭データから入力する。

no：先頭データから入力しない。

lfwj

%LD

トラップするデータ（AND/ORの区別は出力しない）

2,048バイト以内の文字列。指定がない場合，何も出力されない。

lfwj

%LT

トラップするデータ

2,048バイト以内の文字列。指定がない場合，何も出力されない。

ANDは:（コロン），ORは改行が出力されます。

（出力例）「"AAA"かつ"BBB"または"CCC"」の場合

"AAA":"BBB"

"CCC"

lfwj

%MA

「"メールアドレス"」，または「xxx:"メールアドレス"」（メール送信ジョブの場合だけ）

to:"メールアドレス"：メールを宛先に送信する。

cc:"メールアドレス"：メールのコピーを宛先に送信する。

bcc:"メールアドレス"：メールをブラインドカーボンコピーで宛先に送信する。

なお，メールアドレスは256バイト以内の文字列。

mlsj，mlwj

%ML

メール受信リスト名

255バイト以内の文字列。指定がない場合，何も出力されない。

mlwj

%MP

プロファイル名

256バイト以内の文字列。指定がない場合，何も出力されない。

mlsj，mlwj

%Ms

メールの保存

yes：メールを保存する。

no：メールを保存しない。

mlwj

%MS

件名

256バイト以内の文字列。指定がない場合，何も出力されない。

mlsj，mlwj

%MF

添付ファイル保存先フォルダ名

256バイト以内の文字列。指定がない場合，何も出力されない。

mlwj

%mF

添付ファイル名

256バイト以内の文字列。指定がない場合，何も出力されない。

mlsj

%mf

添付ファイルリスト名

256バイト以内の文字列。指定がない場合，何も出力されない。

mlsj，mlwj

%Mt

本文保存先ファイル名

256バイト以内の文字列。指定がない場合，何も出力されない。

mlwj

%MT

本文

512バイト以内の文字列。指定がない場合，何も出力されない。

mlsj，mlwj

%mt

本文ファイル名

256バイト以内の文字列。指定がない場合，何も出力されない。

mlsj

%QC

相関識別子

24バイト以内の文字列。指定がない場合，-。

mqsj，mqwj

%QD

メッセージ識別子

24バイト以内の文字列。指定がない場合，-。

mqsj，mqwj

%qE

デッドレターキュー名

48バイト以内の文字列。指定がない場合，-。

mqsj

%qH

保持時間

1〜9,999,999（単位：分）の値。指定がない場合，-。

mqsj

%QM

モデルキュー名

48バイト以内の文字列。指定がない場合，-。

mqsj，mqwj

%qd

メッセージデータファイル名

256バイト以内の文字列。指定がない場合，何も出力されない。

mqsj

%qF

メッセージフォーマット名

8バイト以内の文字列。指定がない場合，-。

mqsj

%qM

キューマネージャー名

48バイト以内の文字列。指定がない場合，-。

mqsj

%qp

接続キュー管理プログラム名

48バイト以内の文字列。指定がない場合，-。

mqsj

%qR

優先度

0〜9の値。指定がない場合，-。

mqsj

%qP

永続性

yes：永続性あり。

no：永続性なし。

mqsj

%QQ

キュー名

48バイト以内の文字列。指定がない場合，-。

mqsj，mqwj

%QS

メッセージ格納ファイル名

256バイト以内の文字列。指定がない場合，何も出力されない。

mqwj

%SA

アプリケーション情報

0〜FFFFFFFFの値。指定がない場合，-。

mssj，mswj

%SH

保持時間

−1〜2,147,483,647（単位：秒）の値

mssj

%sJ

メッセージのジャーナルキューへの格納指定

yes：格納する。

no：格納しない。

mssj

%SM

メッセージラベル

249バイト以内の文字列。指定がない場合，-。

mssj，mswj

%sL

配信制限時間

−2〜2,147,483,647（単位：秒）の値

mssj

%sM

配信モード

h：高速モード

r：回復可能モード

mssj

%sP

優先順位

0〜7の値

mssj

%sl

キューラベル名

124バイト以内の文字列。指定がない場合，-。

mssj

%SQ

キューパス名

259バイト以内の文字列。指定がない場合，何も出力されない。

mssj，mswj

%SR

相互関係

20バイト以内の文字列。指定がない場合，-。

mssj，mswj

%SF

メッセージ格納ファイル名

256バイト以内の文字列。指定がない場合，何も出力されない。

mswj

%sF

本文ファイル名

259バイト以内の文字列。指定がない場合，何も出力されない。

mssj

%sT

本文タイプ

0〜FFFFFFFFの値。指定がない場合，-。

mssj

%sU

メッセージのデッドレターキューへの格納指定

yes：格納する。

no：格納しない。

mssj

%NJ

分類の判定条件

yes：判定する。

no：判定しない。

ntwj

%NC

分類

255バイト以内の文字列。指定がない場合，何も出力されない。

ntwj

%ND

説明

1,024バイト以内の文字列。指定がない場合，何も出力されない。

ntwj

%Nj

イベントIDの判定条件

yes：判定する。

no：判定しない。

ntwj

%NI

イベントID

16バイト以内の文字列。指定がない場合，-。

ntwj

%NE

イベントの種類

v：詳細イベントを監視する。

i：情報イベントを監視する。

w：警告イベントを監視する。

e：エラーイベントを監視する。

c：重大イベントを監視する。

s：成功の監査イベントを監視する。

f：失敗の監査イベントを監視する。

ntwj

%NL

ログ種別

sys：システムログを監視する。

sec：セキュリティログを監視する。

app：アプリケーションログを監視する。

dns：DNS Serverログを監視する。

dir：Directory Serviceログを監視する。

frs：ファイル複製サービスログを監視する。

oth：%Nt（任意のログ種別）に指定したログ種別を監視する。

ntwj

%Nt

任意のログ種別

255バイト以内の文字列。指定がない場合，何も出力されない。

ntwj

%Ns

ソースの判定条件

yes：判定する。

no：判定しない。

ntwj

%NS

ソース

255バイト以内の文字列。指定がない場合，-。

ntwj

%jp

マクロ変数指定

2,048バイト以内の文字列。指定がない場合，何も出力されない。

evwj，flwj，lfwj，mlwj，mqwj，mswj，ntwj，tmwj，cewj

%Mp

プラットフォーム種別

U：UNIX環境で実行する。

P：WindowsおよびWindowsと互換がある環境で実行する。

cmsj，evsj，mlsj，mlwj，mqsj，pwlj

%PT

実行種別

f：電源をオフする。

r：シャットダウン後，再起動する。

s：シャットダウンする。

pwlj

%Pf

終了要求種別

m：監視終了

r：制限終了

f：強制終了

p：計画終了

pwlj

%PH

対象ホスト名

255バイト以内の文字列。指定がない場合，何も出力されない。

pwrj

%PF

要求種別

o：電源をオンする。

m：監視終了する。

r：制限終了する。

f：強制終了する。

p：計画終了する。

s：強制停止する。

pwrj

%PN

次回の電源オン時刻の設定

n：次回の電源オン時刻を設定しない。

a：エージェントに設定されている次回の電源オン時刻を有効にする。

c：{[mm/dd.]hh:mm}

　次回の電源投入時刻

　mm：1〜12（単位：月）

　dd：1〜31（単位：日）

　hh：0〜23（単位：時）

　mm：0〜59（単位：分）

pwrj

%PR

再起動

yes：再起動する。

no：再起動しない。

pwrj

%PW

電源オフの終了待ち

yes：JP1/Power Monitorのエージェントホストの電源オフの終了を待つ。

no：電源オフの終了を待たない。

電源オフの終了とは，エージェントホスト上のJP1/Power Monitorがシャットダウンの開始をJP1/Power Monitorのマネージャーホストに報告することを指します。

pwrj

%PM

電源制御を実行するプラットフォーム種別

U：UNIX環境で実行する。

P：WindowsおよびWindowsと互換がある環境で実行する。

pwrj

%Tw

待ち時間

1〜1,440（単位：分）の値。

tmwj

%Tn

開始直後に満了するか

y：満了する

n：満了しない

tmwj

%gt

ジョブグループの種別

n：ジョブグループ

p：プランニンググループ

ジョブグループまたはプランニンググループ以外の場合，何も出力されない。

g

%Ed

作成日時

mg，g，mn，rc，n，rm，j，pj，qj，jdj，cj，cpj，orj，cmsj，evsj，evwj，flwj，lfwj，mlsj，mlwj，mqsj，mqwj，mssj，mswj，ntwj，pwlj，pwrj，tmwj，hln，nc，fxj，htpj，cewj

%jt

ジョブのキューイング属性の種別

q：キューイング属性あり

n：キューイング属性なし

j，pj，evsj，mlsj，mqsj，mssj，cmsj，pwlj，pwrj

%es

イベントジョブおよびカスタムイベントジョブの打ち切り状態

kl：強制終了

nr：正常終了

wr：警告検出終了

an：異常検出終了

evwj，flwj，lfwj，mlwj，mqwj，mswj，ntwj，tmwj，cewj

%Ee

実行前のイベント検索

JP1イベント受信監視ジョブが実行された時刻から指定された時間分だけさかのぼった時刻以降のJP1イベントを検索する。1〜720（単位：分）の値。

no：過去のJP1イベント検索をしない

evwj

%eK

イベントの到達確認

y：到達確認を行う

n：到達確認を行わない

evsj

%eP

イベントの到達確認を行う間隔

3〜600（単位：秒）の値。到達確認を行わない場合，-。

evsj

%eR

イベントの到達確認を行う回数

0〜999（単位：回）の値。到達確認を行わない場合，-。

evsj

%fd

終了遅延監視するジョブネットまたはリモートジョブネットの実行所要時間。1〜2,879（単位：分）の値。

または，ジョブの実行所要時間。1〜1,440（単位：分）の値。

指定がない場合，何も出力されない。

n，rm，j，pj，qj，cj，cpj，cmsj，evsj，evwj，flwj，lfwj，mlsj，mlwj，mqsj，mqwj，mssj，mswj，ntwj，pwlj，pwrj，tmwj，htpj，cewj

%AB

起動条件付きジョブネット異常終了後の動作

exec：ジョブネットの実行を開始する

hold：ジョブネットの実行開始を保留する

stop：起動条件の監視を停止する

rc

%mS

監視世代の多重起動

multi：監視を開始する

wait：監視の終了を待つ

skip：監視を開始しない

rc

%gs

起動条件が成立した実行世代の滞留

yes：繰り越さないで滞留させる

no：繰り越して滞留させない

rc

%Nl

ルートジョブネットの実行順序制御

y：ルートジョブネットの実行順序を制御する

n：ルートジョブネットの実行順序を制御しない

g，n

%Nn

ジョブネットコネクタ名

930（単位：バイト）以内の文字列。

指定がない場合，何も出力されない。

g，n

%Nm

ルートジョブネットの実行順序制御方式

y：ジョブネットコネクタと同期して実行する

n：ジョブネットコネクタと非同期に実行する

ルートジョブネットの実行順序を制御しない場合，-。

g，n

%Nr

接続先のルートジョブネット名

930（単位：バイト）以内の文字列。

指定がない場合，何も出力されない。

nc

%Ud

配下ユニットを含めた最終更新日時

注意事項

フォーマット指示子%Udを指定してajsprintコマンドを実行した場合，出力対象のユニット配下すべてのユニットの情報を参照するため，処理に時間が掛かります。処理時間は，出力対象のユニット配下の総ユニット数に依存します。

出力対象がリリース登録したルートジョブネット（リリース先ジョブネット）の場合，リリース登録したジョブネット定義のうち，最新の定義の最終更新日付が出力されます。

mg，g，mn，rc，n，rm，j，pj，qj，jdj，cj，cpj，orj，cmsj，evsj，evwj，flwj，lfwj，mlsj，mlwj，mqsj，mqwj，mssj，mswj，ntwj，pwlj，pwrj，tmwj，hln，nc，fxj，htpj，cewj

%mm

待ち合わせ方法

and：すべての待ち合わせ対象ユニットが終了したら実行を開始する。

or：待ち合わせ対象ユニットが一つでも終了したら実行を開始する。

待ち合わせ条件に待ち合わせ対象ユニットが一つも定義されていない場合，何も出力されない。

n，j，pj，qj，cmsj，evsj，evwj，flwj，lfwj，mlsj，mlwj，mqsj，mqwj，mssj，mswj，ntwj，pwlj，pwrj，tmwj，nc，cj，cpj，fxj，htpj，cewj

%NM

待ち合わせ対象ユニットに待ち合わせる世代がない場合の動作

y：実行を開始する。

n：実行を開始しない。

待ち合わせ条件に待ち合わせ対象ユニットが一つも定義されていない場合，何も出力されない。

n，j，pj，qj，cmsj，evsj，evwj，flwj，lfwj，mlsj，mlwj，mqsj，mqwj，mssj，mswj，ntwj，pwlj，pwrj，tmwj，nc，cj，cpj，fxj，htpj，cewj

%EN

待ち合わせ対象ユニット名

930バイト以内の文字列。

待ち合わせ条件に待ち合わせ対象ユニットが一つも定義されていない場合，何も出力されない。

待ち合わせ条件に待ち合わせ対象ユニットが複数定義されている場合，1ユニットごとに改行されて出力される。

n，j，pj，qj，cmsj，evsj，evwj，flwj，lfwj，mlsj，mlwj，mqsj，mqwj，mssj，mswj，ntwj，pwlj，pwrj，tmwj，nc，cj，cpj，fxj，htpj，cewj

%an

待ち合わせ対象ユニットとの順序関係

待ち合わせ対象ユニット名および自ユニット名が次の形式で出力される。

待ち合わせ対象ユニット名,自ユニット名

各ユニットは930バイト以内の完全名で出力される。

待ち合わせ条件に待ち合わせ対象ユニットが一つも定義されていない場合，何も出力されない。

待ち合わせ条件に待ち合わせ対象ユニットが複数定義されている場合，1ユニットごとに改行されて出力される。

n，j，pj，qj，cmsj，evsj，evwj，flwj，lfwj，mlsj，mlwj，mqsj，mqwj，mssj，mswj，ntwj，pwlj，pwrj，tmwj，nc，cj，cpj，fxj，htpj，cewj

%ga

実行世代に異常終了がある場合の動作

待ち合わせ対象ユニットが存在しない場合，何も出力されない。

exec：実行を開始する。

execdeffer：実行を開始しない。ただし，実行世代が「繰り越し未実行」状態の場合は，実行を開始する。

none：実行を開始しない。

n，j，pj，qj，cmsj，evsj，evwj，flwj，lfwj，mlsj，mlwj，mqsj，mqwj，mssj，mswj，ntwj，pwlj，pwrj，tmwj，nc，cj，cpj，fxj，htpj，cewj

%um

監視世代が監視未起動終了の場合の動作

待ち合わせ対象ユニットが存在しない場合，何も出力されない。

y：実行を開始する。

n：実行を開始しない。

n，j，pj，qj，cmsj，evsj，evwj，flwj，lfwj，mlsj，mlwj，mqsj，mqwj，mssj，mswj，ntwj，pwlj，pwrj，tmwj，nc，cj，cpj，fxj，htpj，cewj

%da

宛先または一斉配信エージェント

128バイト以内の文字列。

指定がない場合，何も出力されない。

fxj

%fg

一斉実行方式

none：一斉実行をしない。

sync：同期モードで実行する。

async：非同期モードで実行する。

fxj

%HC

接続設定ファイル名

511バイト以内の文字列。

指定がない場合，何も出力されない。

htpj

%HK

リクエスト種別

GET（取得）

POST（追加）

PUT（更新）

DELETE（削除）

htpj

%HS

送信情報ファイル名

511バイト以内の文字列。

指定がない場合，何も出力されない。

htpj

%HT

ステータス格納ファイル名

511バイト以内の文字列。

指定がない場合，何も出力されない。

htpj

%HD

受信データ格納方式

diff：APIから取得した受信データのヘッダーとボディを別のファイルに出力する。

same：APIから取得した受信データのヘッダーとボディを同じファイルに出力する。

htpj

%HH

受信ヘッダー格納ファイル名

511バイト以内の文字列。

指定がない場合，何も出力されない。

htpj

%HB

受信ボディ格納ファイル名

511バイト以内の文字列。

指定がない場合，何も出力されない。

htpj

%HE

拡張モード

y：拡張モードを使用する。

n：拡張モードを使用しない。

htpj

%HU

送信情報ファイル名（URLパラメーター）

511バイト以内の文字列。

指定がない場合，何も出力されない。

htpj

%HM

送信情報ファイル名（メッセージボディ）

511バイト以内の文字列。

指定がない場合，何も出力されない。

htpj

%HR

終了コード指定

511バイト以内の文字列。

指定がない場合，何も出力されない。

htpj

%CN

カスタムイベントジョブ名

16バイト以内の文字列。

指定がない場合，何も出力されない。

cewj

%cp

定義パラメーター

20,479バイト以内の文字列。

指定がない場合，何も出力されない。

cewj

注※1

-tオプションに指定できるフォーマット指示子です。

注※2

出力形式については，表3-17を参照してください。

注※3

ユニット種別の略号については，「5.2.1 属性定義情報の記述方法」のパラメーター「ty=」の説明を参照してください。

表3‒16　その他のフォーマット指示子

フォーマット指示子

出力情報

%%

%

%n

改行文字

%t

タブ文字

%x

現在の日※

%X

現在の時刻※

注※

ajsprintコマンドの実行開始日時です。なお，出力形式については，次の表を参照してください。

表3‒17　フォーマット指示子の出力形式

フォーマット指示子

出力形式

%ud

%Ed

%Ud

YYYY/MM/DD hh:mm:ss

（例）

2009/12/30 12:30:30

%cl

%op

%ed

%x

YYYY/MM/DD

（例）

2009/12/30

指定がない場合，****/**/**

%X

hh:mm:ss

（例）

12:30:30

%Sd

[N,]{[[yyyy/]mm/]{[+|*|@]dd|[+|*|@]b[-DD]|[+]{su|mo|tu|we|th|fr|sa}[:{n|b}]}|en|ud}

Nは複数定義の場合のルール番号で，1〜144の値

yyyyは，西暦年の4けた

mmは，月

+は，相対日

*は，運用日

@は，休業日

ddは，1か月の日付

bは，最終日

-DDは最終日からの日数で，1〜35の値

su，mo，tu，we，th，fr，saは日曜日からの曜日（日曜〜土曜）

nは，第n週のnで，1〜5の値

省略した場合，実行登録操作をした日，およびajsscheduleコマンドの実行操作をした日から次の曜日を開始日として扱います。なお，開始年月の［年］または［月］のどちらかを指定している場合に，この指定を省略すると，実行登録操作時，およびajsscheduleコマンド実行時に第1週が仮定されます。

bは，その月の最終日

enは，実行開始日が実行登録日であるということ

udは，未定義であるということ

%St

[N,][+]hh:mm

Nは複数定義の場合のルール番号で，1〜144の値

+は，相対時刻

hhは時で，0〜47の値

mmは分で，0〜59の値

指定がない場合，**:**

%sy

%ey

[N,]{hh:mm|Pmmmm}

Nは複数定義の場合のルール番号で，1〜144の値

hhは時で，0〜47の値

mmは分で，0〜59の値

Pは，M（ルートジョブネットから），U（上位ジョブネットから），またはC（自ジョブネットから）

mmmmは分で，0〜2,879の値

指定がない場合，**:**

表3‒18　許可モードの表示内容

けた

意味

値

1

ジョブに対して，セットユーザーIDビット，セットグループIDビットを設定している

セットユーザーIDビットあり：

4，または5

セットグループIDビットあり：

2，または3

両方あり：

6，または7

両方なし：

0，または1

2〜4

所有者（2けた目），グループ（3けた目），その他（4けた目）の更新，操作，参照，不可の権限を表す8進数の値

更新：7

操作：5

参照：4，または6

不可：0，1，2，または3

使用例1

ジョブグループ（group1）のカレンダー情報を標準出力ファイルに出力します。

基準日は21日とします。

(1) 1日分（2009年10月30日分）を出力する場合

ajsprint -c 2009/10/30 /group1

出力例

o(運用日)またはx(休業日)
o

(2) 1か月分（2009年10月分）を出力する場合

ajsprint -c 2009/10 /group1

出力例

表示開始月  基準日      曜日  o(運用日)またはx(休業日)...
2009/10    2009/10/21  Wed   o o o o x x o o o o o x x .........

(3) 12か月分（2009年分）を出力する場合

ajsprint -c 2009 /group1

出力例

表示開始月  基準日      曜日  o(運用日)またはx(休業日)...
2009/01    2009/01/21  Wed   o o o o x x o o o o o x x ...
2009/02    2009/02/21  Sat   o x x o o o o o x x o o o ...
（中略）
2009/12    2009/12/21  Mon   x o x o o o x x x x x x x ...

使用例2

ルートジョブグループ「/」下のすべてのユニット定義情報・カレンダー情報を退避・回復します。

Windows版JP1/AJS3を使って退避・回復する場合

退避手順とコマンドの指定例を次に示します。

すべてのユニットの，ユニット定義情報を退避する。

ajsprint -a /* > c:¥temp¥winbackup.txt

ルートジョブグループ「/」（つまりルートジョブグループ「AJSROOT」）の運用日・休業日のカレンダー情報を退避する。

ajsprint -d / > c:¥temp¥rootcal.txt

「AJSROOT」の基準時刻，基準日，および月区分を退避する。

ajsprint -f"-lt %st -ld %sd -md %md" / > c:¥temp¥calopt.txt

「AJSROOT」のコメント，所有者，およびグループを退避する。

ajsprint -f"-C %cm -o %ow -g %gr" / > c:¥temp¥chgopt.txt

回復時に指定するコマンドの指定例を次に示します。

ajsdefine c:¥temp¥winbackup.txt

ajscalendar -df c:¥temp¥rootcal.txt /

for /F "tokens=*" %i in (c:¥temp¥calopt.txt) do ajscalendar %i /

for /F "tokens=*" %i in (c:¥temp¥chgopt.txt) do ajschange %i /

UNIX版JP1/AJS3を使って退避・回復する場合

退避手順とコマンドの指定例を次に示します。

すべてのユニットの，ユニット定義情報を退避する。

ajsprint -a "/*" > /tmp/unitbackup.txt

ルートジョブグループ「/」（つまりルートジョブグループ「AJSROOT」）の運用日・休業日のカレンダー情報を退避する。

ajsprint -d / > /tmp/rootcal.txt

「AJSROOT」の基準時刻，基準日，および月区分を退避する。

ajsprint -f"-lt %st -ld %sd -md %md" / > /tmp/calopt.txt

「AJSROOT」のコメント，所有者，およびグループを退避する。

ajsprint -f"-C %cm -o %ow -g %gr" / > /tmp/chgopt.txt

回復時に指定するコマンドの指定例を次に示します。

ajsdefine /tmp/unitbackup.txt

ajscalendar -df /tmp/rootcal.txt /

ajscalendar `cat /tmp/calopt.txt` /

ajschange `cat /tmp/chgopt.txt` /

上記手順でユニット定義情報・カレンダー情報を退避・回復する場合は，回復先のユニットに含まれるジョブネットが一つも実行していない状態で実施してください。jajs_spmd_stopコマンドを使って，スケジューラーサービスを停止してから実施することを推奨します。

上記の退避手順2，3および4は，カレンダー情報，基準時刻，基準日，月区分，コメント，所有者，およびグループのすべてが設定されている場合のコマンド指定例です。これらの項目が設定されていない場合，上記手順のコマンド指定例の内容をそのまま指定して退避・回復すると，回復時に不適切な情報が設定されたり，エラーになったりすることがあります。ユニットに指定している内容を確認し，回復時に指定するオプションを必要に応じて変更してください。ユニットに設定している内容を確認する方法と，回復時に指定するオプションを次に示します。

退避時に手順2で指定したファイルを確認し，ファイルにカレンダー情報が出力されていない場合，回復時の手順2は不要です。

退避時に手順3および4で指定したファイルを確認し，ファイルに出力されるajscalendarまたはajschangeコマンドのオプションに値が設定されていない場合，または初期値（「-（ハイフン）」など）が出力されている場合，そのオプションを削除してから回復してください。

退避時に作成したファイルをほかのホストにコピーし，そのホスト上でコピーしたファイルを回復すると，ルートジョブグループ「/」下のすべての階層をコピーできます。

使用例3

ジョブネット（/net1）配下のユニットで定義されているマクロ変数を探索し，一覧で出力します。このジョブネット配下には三つのジョブ（job1，job2，job3）があり，job1のパラメーター（prm）に?AJS2PARAM?，job3の環境変数（env）定義に?AJS2ENV1?および?AJS2ENV2?が定義されているものとします。

ajsprint -F AJSROOT1 -v /net1

出力例

/net1/job1 prm ?AJS2PARAM?
/net1/job3 env ?AJS2ENV1?
/net1/job3 env ?AJS2ENV2?

使用例4

定義済みのジョブネット1（/net1）と，ジョブネット1をコピーして作成したジョブネット2（/net2）のユニット定義情報ファイルを採取します。この二つのユニット定義情報ファイルを比較した場合，差分が発生しないことを期待するため，ジョブネット1とジョブネット2に対して-s yesオプションを指定して実行します。

定義済みのジョブネット1を次に示します。

ajsprint -F AJSROOT1 -s yes /net1 > C:¥temp¥net1.txt

-s yesオプションを指定した場合のジョブネット1の関連線情報の出力例

：
ar=(f=JobA,t=JobB,seq);
ar=(f=JobC,t=JobB,seq);
ar=(f=JobD,t=JobA,seq);
ar=(f=JobD,t=JobC,seq);
：

ジョブネット1をコピーして作成したジョブネット2を次に示します。

ajsprint -F AJSROOT1 -s yes /net2 > C:¥temp¥net2.txt

-s yesオプションを指定した場合のジョブネット2の関連線情報の出力例

：
ar=(f=JobA,t=JobB,seq);
ar=(f=JobC,t=JobB,seq);
ar=(f=JobD,t=JobA,seq);
ar=(f=JobD,t=JobC,seq);
：

-s yesオプションを指定したため，関連線情報がユニット名の昇順に出力され，ジョブネット1とジョブネット2で差分は発生しません。

注意事項

二つのユニットのユニット定義情報ファイルを採取して比較する場合，スケジューラーサービスの文字コード（環境設定パラメーターAJSCHARCODE）は同一にしてください。スケジューラーサービスの文字コードが変わると，ユニット定義情報の出力順に影響が出るおそれがあります。

ajsprofalter

形式

ajsprofalter
     [-F サービス名]
     -t {agent|unit}
     -m {set|unset}

機能

運用プロファイルの有効／無効を変更したり，適用する運用プロファイルの設定を変更したりする場合に指定します。

運用プロファイルの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　21.1 運用プロファイルを使用した機能の設定」を参照してください。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-F サービス名

処理対象とするスケジューラーサービスのサービス名を指定します。指定できる文字数は，1〜30（単位：バイト）です。

省略した場合，デフォルトスケジューラーサービス名が仮定されます。

-t {agent|unit}

設定を変更する運用プロファイルの種類を指定します。

agent

実行エージェントプロファイルの設定を変更します。

unit

ユニット属性プロファイルの設定を変更します。

-m {set|unset}

運用プロファイルの有効／無効を変更したり，設定を変更したりします。

set

環境設定ファイル格納フォルダ※に格納されている運用プロファイルを適用します。適用する運用プロファイルの種類は-tオプションで，処理対象とするスケジューラーサービスは-Fオプションで指定します。

無効になっている運用プロファイルを適用すると，運用プロファイルが有効になります。すでに有効である運用プロファイルを適用すると，適用中の運用プロファイルの設定内容が破棄され，適用時点での運用プロファイルの設定内容に変更されます。

unset

環境設定ファイル格納フォルダ※に格納されている運用プロファイルを無効にします。無効にする運用プロファイルの種類は-tオプションで，処理対象とするスケジューラーサービスは-Fオプションで指定します。

指定した運用プロファイルがすでに無効である場合，コマンドはエラーメッセージを出力し，異常終了します。

注※

環境設定ファイル格納フォルダとは，次のフォルダのことです。

物理ホストの場合

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

UNIX：/etc/opt/jp1ajs2/conf

論理ホストの場合

Windows：共有フォルダ名¥jp1ajs2¥conf

UNIX：共有ディレクトリ名/jp1ajs2/conf

注意事項

運用プロファイルの有効／無効や，設定の変更が反映されるタイミングについての詳細は，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　7.10 運用プロファイルの設定を変更する」を参照してください。

-mオプションで運用プロファイルの有効／無効を変更したり，設定内容を変更したりした際に，コマンドが異常終了した場合は，コマンド実行前の運用プロファイルの設定が継続されます。

-m unsetオプションで運用プロファイルを無効にしても，JP1/AJS3サービスを起動すると，運用プロファイルが有効になります。そのため，次回JP1/AJS3サービス起動時にも運用プロファイルを無効にしたい場合は，運用プロファイルを削除，または別の場所に移動しておく必要があります。

このコマンドは，スケジューラーサービスの起動状態に関係なく実行できるため，実行ログはスケジューラーログに出力されません。

同一論理ホスト上では，次のコマンドと同時に実行できません。

ajsprofalterコマンド

ajsembdbstartコマンド

ajsembdbstopコマンド

ajsstartコマンド

ajsstopコマンド

jajs_hstdコマンド

jajs_hstd_stopコマンド

jajs_spmdコマンド

jajs_spmd_statusコマンド

jajs_spmd_stopコマンド

jajs_startコマンド（UNIX限定）

jajs_start.clusterコマンド（UNIX限定）

jajs_stopコマンド（UNIX限定）

jajs_stop.clusterコマンド（UNIX限定）

戻り値

0

正常終了。

上記以外の値

異常終了。

使用例1

スケジューラーサービス「AJSROOT2」のユニット属性プロファイルを有効にします。

ajsprofalter -F AJSROOT2 -t unit -m set

使用例2

スケジューラーサービス「AJSROOT1」の実行エージェントプロファイルを無効にします。

ajsprofalter -F AJSROOT1 -t agent -m unset

ajsprofstatus

形式

ajsprofstatus
     [-F サービス名]
     -t {agent|unit}
     [-s|-p]

機能

運用プロファイルの有効／無効の状態，または適用中の運用プロファイルの定義内容を，標準出力ファイルに出力します。

実行権限

なし

引数

-F サービス名

処理対象とするスケジューラーサービスのサービス名を指定します。指定できる文字数は，1〜30（単位：バイト）です。

省略した場合，デフォルトスケジューラーサービス名が仮定されます。

-t {agent|unit}

出力対象の運用プロファイルの種類を指定します。

agent

実行エージェントプロファイルを出力対象にします。

unit

ユニット属性プロファイルを出力対象にします。

[-s|-p]

標準出力ファイルへの出力形式を指定します。

出力する運用プロファイルは，環境設定ファイル格納フォルダ※に格納されています。出力する運用プロファイルの種類は-tオプションで，処理対象とするスケジューラーサービスは-Fオプションで指定します。

注※

環境設定ファイル格納フォルダとは，次のフォルダのことです。

物理ホストの場合

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

UNIX：/etc/opt/jp1ajs2/conf

論理ホストの場合

Windows：共有フォルダ名¥jp1ajs2¥conf

UNIX：共有ディレクトリ名/jp1ajs2/conf

省略した場合は，-sが仮定されます。

-s

運用プロファイルの種類，有効／無効の状態，適用日時，および運用プロファイルの完全名を出力します。ただし，運用プロファイルが無効となっている場合は，適用日時および運用プロファイルの完全名は出力されません

-p

有効になっている運用プロファイルの定義内容を出力します。

運用プロファイルが無効になっている場合，エラーメッセージが出力され，コマンドは異常終了します。

戻り値

0

正常終了。

上記以外の値

異常終了。

使用例1

AJSROOT1のユニット属性プロファイルの有効／無効の状態を，標準出力ファイルに出力します。

ajsprofstatus -F AJSROOT1 -t unit

使用例2

AJSROOT2に適用されている実行エージェントプロファイルの定義内容を，標準出力ファイルに出力します。

ajsprofstatus -F AJSROOT2 -t agent -p

出力例1

AJSROOT1に適用されているユニット属性プロファイルが有効な場合に，-sオプションを指定してこのコマンドを実行した場合の出力例を次に示します。

(1) ユニット属性プロファイル
(2) 状態　　　　　　　　有効
(3) 適用日時　　　　　　2010/10/21 20:15
(4) 運用プロファイル名　/etc/opt/jp1ajs2/conf/ajsprof_AJSROOT1_unit.conf

出力項目の説明

(1) 運用プロファイルの種類

-tオプションで指定した，出力対象の運用プロファイルの種類を出力します。

(2) 有効／無効の状態

運用プロファイルの有効／無効の状態を出力します。

(3) 適用日時

運用プロファイルが有効な場合は，運用プロファイルを適用した日時を出力します。

運用プロファイルが無効な場合は，見出しも含めて出力しません。

(4) 運用プロファイルの完全名

運用プロファイルが有効な場合は，運用プロファイルの完全名を出力します。

運用プロファイルが無効な場合は，見出しも含めて出力しません。

出力例2

AJSROOT2に適用されている実行エージェントプロファイルが有効な場合に，-pオプションを指定してこのコマンドを実行した場合の出力例を次に示します。

(1) @SYS_RESTRICT_START
(2) unit_path=/Group1/Work
(3) View=on
(4) ViewCheckLevel=error
(5) JobExec=on
(6) @SYS_AGENTLIST_START
(7) AGT1
(8) @SYS_AGENTLIST_END
(9) @SYS_RESTRICT_END
(10) KAVS8007-I 運用プロファイル情報の出力が終了しました

出力項目の説明

(1)〜(9) 運用プロファイルの定義内容

運用プロファイルの定義内容を出力します。

運用プロファイルに複数のユニットの設定が記載されている場合は，(1)〜(9)を繰り返して出力します。

(10) 出力完了メッセージ

運用プロファイルの定義内容の出力が完了したことを示すメッセージを出力します。

ajsrelease

形式

ajsrelease
     [-F サービス名]
     {-a リリース先ルートジョブネット名
        -rid リリースID [-rcm リリースコメント]
        -rdy リリース日付 [-rti リリース時刻]
        -ru リリース元ルートジョブネット名 |
      -c リリース先ルートジョブネット名 |
      -i リリース先ルートジョブネット名...}

形式1（リリース登録）

ajsrelease
     [-F サービス名]
     -a リリース先ルートジョブネット名
     -rid リリースID
     [-rcm リリースコメント]
     -rdy リリース日付
     [-rti リリース時刻]
     -ru リリース元ルートジョブネット名

形式2（リリース中止）

ajsrelease
     [-F サービス名]
     -c リリース先ルートジョブネット名

形式3（リリース情報の出力）

ajsrelease
     [-F サービス名]
     -i リリース先ルートジョブネット名...

機能

ルートジョブネットに対して，次の操作をします。

リリース登録

ジョブネットの定義を切り替える日時と，切り替える定義内容を登録します。

リリース中止

リリース登録したジョブネットの定義内容の切り替えを中止します。

リリース情報の出力

リリース情報を出力します。

上位ユニット属性継承機能を設定したジョブネットをリリース先としてリリース登録した場合，リリース登録したジョブネット定義の所有者やJP1資源グループは，上位ユニット属性継承機能によって設定されます。上位ユニット属性継承機能の詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　6.4.1(4)(a) 上位ユニット属性継承機能の概要」を参照してください。

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

リリース登録およびリリース中止の場合

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Editor権限およびJP1_AJS_Operator権限

リリース情報の出力の場合

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Editor権限

JP1_AJS_Operator権限

JP1_AJS_Guest権限

引数

-F サービス名

操作の対象となるルートジョブネット（リリース先ルートジョブネット）が定義されているスケジューラーサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

-a リリース先ルートジョブネット名

リリース登録する場合に指定します。

定義の切り替え先となるルートジョブネットを，リリース先ルートジョブネットとして完全名で指定します。

指定できる文字数は，1〜930（単位：バイト）です。

リリース先のルートジョブネットに「リリース待ち」状態，「削除待ち」状態，または「リリース登録待ち」状態のジョブネット定義がない場合に指定できます。

指定したルートジョブネットがない場合には，エラーになります。また，次に示すルートジョブネットは指定できません。

プランニンググループ配下のルートジョブネット

リモートジョブネット

リカバリージョブネット

マネージャージョブネット

-c リリース先ルートジョブネット名

リリース登録したジョブネット定義への切り替えを中止する場合に指定します。

中止の対象となるルートジョブネットを完全名で指定します。

指定できる文字数は，1〜930（単位：バイト）です。

このオプションを指定すると，「リリース待ち」状態，「削除待ち」状態，および「リリース登録待ち」状態のジョブネット定義が削除されます。

-i

ルートジョブネットのリリース情報を出力します。

リリース情報として出力されるのは，「適用中」状態，「リリース待ち」状態，「削除待ち」状態，および「リリース登録待ち」状態のジョブネット定義の情報です。それ以外の状態のリリース情報は出力されません。

-rid リリースID

操作の対象となるルートジョブネット（リリース先ルートジョブネット）定義のリリースIDを指定します。指定できる文字数は，1〜30（単位：バイト）です。

このオプションは，-aオプションと同時に指定します。

-aオプションを指定した場合は，必ず指定してください。

なお，次のリリースIDは指定できません。

操作の対象となるリリース先ジョブネットに存在するリリースID

先頭が半角英字の「AJS」（大文字）で始まるリリースID

次の文字を含むリリースID

「(」「)」「,」「/」「:」「;」「=」「"」「&」「'」「*」「<」「>」「?」「[」「¥」「]」「^」「`」「{」「|」「}」「~」「‘」，半角スペース，タブ文字，改行文字

-cおよび-iオプションとは同時に指定できません。

-rcm リリースコメント

リリース登録する際のコメントを指定します。

指定できる文字数は，1〜80（単位：バイト）です。

このオプションは，-aオプションと同時に指定します。

-cおよび-iオプションと同時には指定できません。

省略した場合，リリースコメントは登録されません。

-rdy リリース日付

ジョブネット定義を切り替える（リリースする）日付を「YYYY/MM/DD」の形式で指定します。

指定できる値は，1994/01/01〜環境設定パラメーターSCHEDULELIMITに設定した西暦年/12/31です。環境設定パラメーターSCHEDULELIMITの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2(123) SCHEDULELIMIT」を参照してください。

このオプションは，-aオプションを指定した場合は，必ず指定してください。

-cおよび-iオプションとは同時に指定できません。

過去の日時を指定するとエラーになります。また，すでにリリース登録されたジョブネット定義のリリース日時と同じ日時を指定した場合は，エラーになります。

-rti リリース時刻

ジョブネット定義を切り替える（リリースする）時刻を「HH:MM」の形式で指定します。

指定できる値は，00:00〜23:59です。省略した場合は，00:00が仮定されます。

このオプションは，-aオプションと同時に指定します。

-cおよび-iオプションと同時には指定できません。

過去の日時を指定するとエラーになります。

-ru リリース元ルートジョブネット名

定義の切り替え元のルートジョブネットを，リリース元ルートジョブネットとして完全名で指定します。

指定できる文字数は，1〜930（単位：バイト）です。

次に示すルートジョブネットは指定できません。

リリース登録されたルートジョブネット

プランニンググループ配下のルートジョブネット

リモートジョブネット

リカバリージョブネット

マネージャージョブネット

-aオプションを指定した場合は，必ず指定してください。

-cおよび-iオプションとは同時に指定できません。

リリース先ルートジョブネット名...

操作の対象となるルートジョブネットを指定します。

複数ユニットの指定および総称指定ができます。

論理ホスト名やサービス名，実行IDを含んだ指定はできません。

指定できる文字数は，1〜930（単位：バイト）です。

-iオプションを指定した場合に指定します。

-aおよび-cオプションとは同時に指定できません。

注意事項

リリース登録およびリリース中止できるのは，次のどちらかのユーザーです。

リリース対象のユニットに対して，操作権限および更新権限を与えられたユーザー。

Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザー。

ただし，環境設定パラメーターADMACLIMITをデフォルトから変更して「yes」を設定している場合は，Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザーであっても，操作権限および更新権限が必要です。

リリース情報を出力できるのは，次のどちらかのユーザーです。

出力対象のユニットに対して，参照権限を与えられたユーザー。

Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザー。

ただし，環境設定パラメーターADMACLIMITをデフォルトから変更して「yes」を設定している場合は，Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザーであっても，参照権限が必要です。

リリース登録する場合の注意事項

リリース日時以降にスケジュールがあるジョブネットのうち，期間指定や日付指定で確定実行登録をしているジョブネットは，リリース先に指定できません。この場合，リリース日時以降のスケジュールを登録解除するか，または実行中止してからリリース登録してください。ただし，未来世代数指定の確定実行登録と併用している場合は，リリース日時以降にスケジュールがあってもリリース登録できます。

スケジューラーサービスが異なるジョブネット間では，ジョブネットリリース機能を使用できません。

次のジョブネットはリリース元に指定できません。

すでにリリース先に指定されているジョブネット

サスペンドされているジョブネット

編集中のジョブネット

ほかのユーザーが操作しているジョブネット

ジョブネットコネクタ，接続先のジョブネット，および起動条件（.CONDITION）のうちのどれか二つ以上が定義されているジョブネット

次のジョブネットはリリース先に指定できません。

サスペンドされているジョブネット

「閉塞」状態のジョブネット

編集中のジョブネット

ほかのユーザーが操作しているジョブネット

ただし，ほかのユーザーの操作が，「適用中」状態のジョブネット配下のユニットを対象にした保留属性の設定または解除の場合は，リリース先に指定できます。

ジョブネットコネクタ，接続先のジョブネット，および起動条件（.CONDITION）のうちのどれか二つ以上が定義されているジョブネット

「リリース待ち」状態，「削除待ち」状態，または「リリース登録待ち」状態のジョブネット定義を持つジョブネットは，リリース先ジョブネットとして指定できません。「リリース待ち」状態のジョブネット定義がある場合，新しいリリース登録は，ジョブネットが「適用中」状態になってから実施してください。「削除待ち」状態または「リリース登録待ち」状態のジョブネット定義がある場合は，「削除待ち」状態または「リリース登録待ち」状態のジョブネット定義をリリース中止したあとでリリース登録してください。

リリース登録する場合には，スケジューラーサービスが起動されている必要があります。

リリース登録によって掛かるシステムへの負荷は，リリース元ジョブネットを定義する場合と同等か，それ以上です。リリース登録は，ジョブ実行のピーク時を避けて実行してください。

リリース登録すると，リリース登録したジョブネットの定義を基にリリース日時以降の世代が生成し直されます。そのため，リリース登録する前に計画一時変更の操作をしても，リリース日時以降の世代には引き継がれません。ただし，実行登録時に指定したマクロ変数やJP1ユーザーなどの情報は引き継がれます。

リリース登録する前の計画一時変更の操作を，リリース日時以降の世代に反映させたい場合は，一時変更の再操作機能を使って，リリース登録前に実行した操作を再反映してください。一時変更の再操作機能については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　4.5.16 ジョブネットやジョブの一時変更の操作情報を確認・再操作する」を参照してください。

スケジュール定義上，次回の実行予定世代が作成されないジョブネットの定義をリリース登録しても，その定義から実行予定世代は作成されません。そのため，リリース登録したジョブネットの定義から正しく実行予定世代が作成されているかどうか，JP1/AJS3 - Viewまたはajsshowコマンドで確認してください。実行予定世代が作成されていない場合は，リリース中止したあとでリリース元ジョブネットの定義内容を見直し，再度リリース登録してください。

確定実行登録をしていて，指定するリリース日時以降にだけ世代がある場合，スケジュール定義上，次回の実行予定世代が作成されないジョブネットの定義をリリース登録すると，未登録状態に戻ります。この場合，リリース中止してリリース元ジョブネットの定義内容を見直したあとで，再度リリース登録および実行登録してください。

「リリース待ち」状態のジョブネット定義を変更したい場合は，一度リリース中止して定義を変更してから，再度リリース登録してください。「適用中」状態のジョブネット定義を変更したい場合は，ジョブネットをサスペンドして定義を変更してください。

リリース登録に失敗すると，ジョブネット定義が「リリース登録待ち」状態のままになり，リリース登録されません。そのため，リリース登録したときは，リリースしたジョブネット定義のリリース状態が「リリース登録待ち」状態から「適用中」状態または「リリース待ち」状態に遷移することを確認してください。リリース登録に失敗して残った「リリース登録待ち」状態の定義は，リリース中止することで削除できます。

リリース登録によって，リリース先のユニットのJP1資源グループを変更することは推奨しません。リリース登録によってJP1資源グループを変更した場合，リリース後でも，リリース前のユニットにアクセスできるJP1ユーザーでコマンドおよびJP1/AJS3 - Viewを操作する必要があります。

リリース中止する場合の注意事項

リリース中止するルートジョブネットが，ほかのユーザーによって操作されている場合はリリース中止できません。

リリース中止するルートジョブネットがサスペンドされた状態の場合は，リリース中止できません。サスペンドを解除してからリリース中止してください。

リリース中止するルートジョブネットが閉塞状態の場合は，リリース中止できません。ルートジョブネットを登録解除してからリリース中止してください。

リリース中止するには，スケジューラーサービスが起動されている必要があります。

リリース中止によって掛かるシステムへの負荷は，リリース情報のジョブネットの定義内容を削除する場合と同等か，それ以上です。リリース中止は，ジョブ実行のピーク時を避けて実行してください。

リリース中止すると，リリース中止後に「適用中」状態になるジョブネットの定義を基に世代が生成し直されます。そのため，リリース中止する前に計画一時変更の操作をしても，リリース中止後のジョブネットには引き継がれません。ただし，実行登録時に指定したマクロ変数やJP1ユーザーなどの情報は引き継がれます。

リリース中止したあと「適用中」状態になるジョブネットの定義上，次回の実行予定世代が作成されない場合，その定義から実行予定世代は作成されません。そのため，リリース中止したあとで，正しく実行予定世代が作成されているかどうか，JP1/AJS3 - Viewまたはajsshowコマンドで確認してください。実行予定世代が作成されていない場合は，「適用中」状態のジョブネットの定義内容を見直してください。

確定実行登録をしていて，リリース中止するジョブネットの定義にだけ世代がある場合で，リリース中止したあとに「適用中」状態になるジョブネットの定義上，次回の実行予定世代が作成されないときは，未登録状態に戻ります。リリース中止したあとで「適用中」状態になるジョブネットの定義内容を見直したあと，再度実行登録してください。

次のジョブネットはリリース中止できません。

サスペンドされているジョブネット

「閉塞」状態のジョブネット

編集中のジョブネット

ほかのユーザーが操作しているジョブネット

ただし，ほかのユーザーの操作が，「適用中」状態のジョブネット配下のユニットを対象にした保留属性の設定または解除の場合は，リリース中止できます。

リリース情報を出力する場合の注意事項

出力情報から情報を切り出す場合，固定バイトでの切り出しではなく，スペースを区切り文字として情報の切り出しをしてください。

戻り値

0

正常終了。

4〜124で4の倍数値

異常終了。

使用例1

2009年8月10日20時からジョブネット「テスト環境/Rel001」の定義が，「/本番環境/unit001/」の内容に切り替わるようにリリースIDを「001」としてリリース登録します。

ajsrelease -F AJSROOT1 -a /本番環境/unit001 -rid 001 -rcm 2009/08/10 リリース定義 -rdy 2009/08/10 -rti 20:00 -ru /テスト環境/Rel001

使用例2

リリース登録されたルートジョブネットの定義内容「/本番環境/unit001」のリリースを中止します。

ajsrelease -F AJSROOT1 -c /本番環境/unit001

使用例3

ルートジョブネット「/本番環境/unit001」のリリース情報を表示します。

ajsrelease -F AJSROOT1 -i /本番環境/unit001

出力例

-iオプションを指定した場合の出力例と出力内容の意味を次に示します。

出力内容の意味を次に示します。

上位ジョブグループ名

上位ジョブグループ名を示します。

ユニット名

ユニット名を示します。

リリースID

リリースIDを示します。

リリース日時

リリース日時を「YYYY/MM/DD HH:MM」の形式で示します。

リリース状態

次のリリース状態を示します。

リリース待ち：

リリース日時を待っている状態を示します。

適用中：

リリース登録したジョブネット定義が適用されている状態を示します。

削除待ち：

リリース中止に失敗した定義がある状態を示します。

リリース登録待ち：

リリース登録に失敗した定義がある状態を示します。または，リリース登録してから「リリース待ち」状態になるまでの一時的な状態を示します。

リリースコメント

リリース登録時のコメントを示します。

リリース元ユニット名

リリース元ユニット名を示します。

ajsrerun

形式

ajsrerun
     [-F サービス名]
     [-B 実行登録番号]
     [{-t|-s|-n|-a|-w|-f|-p|-e}]
     [-h]
     [-c]
     [-rr [-rn リトライ回数] [-ri リトライ間隔]]
     [-R]
     [-E]
     [-T]
     [-N|-J]
     [-X {yes|no|auto}]
     ジョブ名，ジョブネット名，またはジョブグループ名...

機能

ジョブネットを再実行します（再実行を指示すると，ジョブネットはすぐに実行されます）。なお，ジョブネットやジョブを保留状態にしたあと，再実行することもできます。

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Operator権限

引数

-F サービス名

処理対象とする，スケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

-B 実行登録番号

再実行するジョブネットの実行登録番号を「YYYYMMDDNNN」の形式で指定します。「YYYYMMDDNNN」の内容を次に示します。

YYYY：実行年

MM：実行月

DD：実行日

NNN：実行年月日の実行登録順序番号

実行登録番号の詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　4.5.13 コマンド実行時の世代の指定方法」を参照してください。

-t

ジョブネットを先頭から再実行します。

正常終了したジョブネットや，警告終了したジョブネットも再実行できます。

このオプションはルートジョブネットだけに指定できます。

-s

異常終了したジョブを直下に含むジョブネットから再実行します。

このオプションはルートジョブネットだけに指定できます。

-n

異常終了したジョブの次のジョブから再実行します。

ただし，関連線で接続されているユニットの中で，最初に異常終了したユニットが，「未実行終了」状態や「繰り越し未実行」状態の場合は，それらのユニットも再実行します。

このオプションはルートジョブネットだけに指定できます。

-a

異常終了したジョブから再実行します。

このオプションはルートジョブネットだけに指定できます。

-w

警告検出終了しているジョブを再実行します。

以前に警告検出終了したジョブを再実行した際にそのジョブが異常終了した場合でも，警告検出終了ジョブだけを再実行できます（例えば，ジョブAが警告終了したため，ジョブAを再実行（1度目）したとします。1度目の再実行でジョブAが異常終了した場合でも，-wオプションを指定すれば，ジョブAを再実行（2度目）できます）。

このオプションはルートジョブネットだけに指定できます。

-f

指定したジョブネット，またはジョブから再実行します。

-p

指定したジョブネット，またはジョブを再実行します。

-e

指定したジョブネット，またはジョブの次から再実行します。

このオプションはルートジョブネットには指定できません。-hオプションと同時には指定できません。

-h

再実行するジョブ，またはジョブネットを一時的に保留状態にしたあと，再実行します。

このオプションはジョブネットコネクタには指定できません。-eオプションと同時には指定できません。

-c

異常状態の先行ジョブや先行ジョブネットを警告検出終了にしたあと，再実行します。

-rr

対象ユニットが終了状態でない場合で，再実行をリトライするときに指定します。このオプションは，ユニットが異常終了した場合に，異常終了したユニットの後続ユニットに対してajsrerunコマンドをすぐに実行するときに使用します。

ユニットを複数指定した場合，一つずつリトライし，リトライが終わってから，次のユニットを処理します。

ルートジョブネットを指定した場合，このコマンドは異常終了します。

また，対象ユニットのルートジョブネットがサスペンド中など，ユニットの状態以外の要因で再実行できない場合は，リトライしません。

再実行の詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　4.5.11 実行が終了したジョブネットやジョブを再実行する」を参照してください。また，-rrオプションの使用例については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　2.4.6 ジョブが異常終了したときに特定の処理を実行する（リカバリーユニットを使ったジョブネットの定義例）」を参照してください。

-rn リトライ回数

リトライ回数を指定します。指定できる値は，1〜10（単位：回）です。

このオプションは，-rrオプションと同時に指定します。省略した場合は6が仮定されます。

-ri リトライ間隔

リトライ間隔を指定します。指定できる値は，2〜60（単位：秒）です。

このオプションは，-rrオプションと同時に指定します。省略した場合は10が仮定されます。

-R

指定したユニットに含まれるすべてのジョブネットおよびジョブを再実行します。

このオプションを，-E，-Tオプションと同時に指定した場合，各オプションの指定内容に従って，ジョブネットおよびジョブを再実行します。

-E

実行登録済みのジョブネットを再実行します。

-T

ルートジョブネットを再実行します。

-N

ジョブネットから再実行します。

-J

ジョブから再実行します。

-X {yes|no|auto}

プランニンググループの下にあるユニットの中から，現在運用中のユニットを自動的に選択して操作するかどうかを指定します。ただし，ジョブグループの下にあるユニットに対しては，どの値を指定しても自動的に選択しません。また，ルートジョブネット名も省略できません。

yes

自動的に選択して操作する場合に指定します。

コマンドに指定するユニット名は，プランニンググループの下のルートジョブネット名を省略して指定します。

no

自動的に選択して操作しない場合に指定します。

指定したユニットに対して操作します。プランニンググループの下のルートジョブネット名を省略して指定することはできません。

auto

ユニット名の指定方法に従って，自動的に選択して操作するかしないかを決定する場合に指定します。

自動的に選択して操作する場合

プランニンググループの下のルートジョブネット名を省略してユニット名を指定します。

自動的に選択して操作しない場合

プランニンググループの下のルートジョブネット名を省略しないでユニット名を指定します。この場合，指定したユニットが操作対象になります。ただし，プランニンググループの下のルートジョブネット名を省略して指定したパス名と同じ名称のユニットがある場合，省略したものとして扱われ，操作対象のユニットが自動選択されます。

ジョブ名，ジョブネット名，またはジョブグループ名

再実行するジョブ名，ジョブネット名，または-R，-E，-Tオプションと同時にジョブ名，ジョブネット名，またはジョブグループ名を指定します。

指定できる文字数は，1〜930（単位：バイト）です。

ジョブ名，ジョブネット名，またはジョブグループ名は複数指定できます。なお，マネージャージョブグループ名とマネージャージョブネット名は指定できません。

ジョブ名，ジョブネット名，またはジョブグループ名に，論理ホスト名および実行IDを指定できます。ただし，実行IDを指定した場合，-Bオプションは無効になります。実行IDの指定方法については，「1.1 コマンドの記述形式」を参照してください。

注意事項

ジョブネットを再実行できるのは，次のどちらかのユーザーです。

再実行するジョブネットに含まれるすべてのユニットを定義したときに，または属性を変更したときに，操作権限を与えられたユーザー

Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザー

ただし，環境設定パラメーターADMACLIMITをデフォルトから変更して「yes」を設定している場合は，Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザーであっても，操作権限が必要です。

スケジューラーサービスが起動していない場合，このコマンドは異常終了します。

次の場合，-f，-p，または-eオプションを指定して再実行しようとすると，このコマンドは異常終了します。

ルートジョブネットが保留中，開始時刻待ちの場合

ネストジョブネットやジョブが実行中，異常検出実行中，警告検出実行中，保留中，開始時刻待ち，先行終了待ち，未計画，キューイング，実行待ちの場合

ネストジョブネットやジョブの上位ジョブネットにスケジュールがない場合

ジョブネットの実行中に，-fまたは-eオプションを指定してジョブネットやジョブを再実行する場合，再実行開始点が実行中のジョブより前にあるとき，実行中のジョブは2回実行されます。

再実行しようとしたジョブが判定ジョブの場合，このコマンドは異常終了します。

再実行しようとしたジョブが従属ジョブの場合，環境設定パラメーターRERUNSUBORDINATEに「no」が設定されていると，このコマンドは異常終了します。環境設定パラメーターRERUNSUBORDINATEの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2(106) RERUNSUBORDINATE」を参照してください。

リモートジョブネット下のユニットに対しては，操作できません。

再実行しようとしたジョブネット，ジョブがサスペンド状態の場合，このコマンドは異常終了します。

プランニンググループの下にあるユニットの中から操作するユニットを自動的に選択する指定をした場合に，自動的に選択されたユニットに操作権限がないと，エラーになります。

-Xオプションが省略された場合，環境変数AJSAUTOJUDGEの指定値に従って，プランニンググループの下にあるユニットの操作対象が決定されます。

プランニンググループの下にあるユニット名の指定方法については，「3. 通常の運用で使用するコマンド　ajsplan」の「補足事項」を参照してください。

-t，-s，-n，-w，-f，-p，-eオプションを指定しなかった場合，-aオプションが指定されたものとして処理されます。

-s，-n，-aオプションを指定した場合，次の状態を異常終了として扱います。

異常検出終了

未実行終了

中断

強制終了

順序不正

起動失敗

終了状態不明

繰り越し未実行

起動条件の監視が終了して監視中が次の状態になるとき，ルートジョブネット配下のユニットの状態は，「未実行終了」となります。

監視未起動終了

監視打ち切り終了

監視正常終了

「未実行終了」は異常終了として扱われるため，上記の状態の世代に対して再実行する場合は注意してください。

判定ジョブの結果で，ルートジョブネットや先行ユニットを再実行する場合は，注意が必要です。詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　2.4.3 先行ジョブの結果でそのあとの処理を動的に変える（判定ジョブを使ったジョブネットの定義例）」を参照してください。

戻り値

0

正常終了。

4〜124で4の倍数値

異常終了。

補足事項

前日以前に実行が終了しているジョブネットを再実行すると，前回の実行日時点でのスケジュール情報で再実行されます。例を挙げて説明します。

（例）

毎日実行するジョブネット「A」と，金曜日だけに実行するジョブネット「B」を，一つのジョブネット「X」として運用している。

木曜日にジョブネット「A」が異常終了したため，金曜日にジョブネット「A」を再実行することにした。

この例の場合，金曜日に実行されるのはジョブネット「A」だけです。再実行する日は金曜日ですが，前回の実行日時点での定義情報（つまり，木曜日の定義情報）で再実行されるため，金曜日だけに実行するようにスケジュールされているジョブネット「B」は実行されません。

使用例

ajsintrptコマンドなどで実行を中断したジョブネット（net1）を，先頭から再実行します。

ajsrerun -t net1

ajsreport

形式

ajsreport
     [-F スケジューラーサービス名]|[-d 稼働状況ログファイル格納ディレクトリ]
     [-n [-r 分]|
         [-b 年/月/日] [-s 時:分]
         [-e 年/月/日] [-f 時:分]]
     [-i 集計間隔]
     [-H]

機能

JP1/AJS3の稼働状況レポートを出力します。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-F スケジューラーサービス名

処理対象とする，スケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

省略した場合，デフォルトスケジューラーサービス名が仮定されます。

このオプションは，-dオプションと同時には指定できません。

-d 稼働状況ログファイル格納ディレクトリ

稼働状況ログファイルの格納ディレクトリ名を指定します。

省略した場合，環境設定パラメーターAJSREPORTDIRの設定値を格納ディレクトリとします。

ディレクトリ名は絶対パスで指定してください。指定するディレクトリに空白文字を含む場合は，パスを「""」で囲んでください。

このオプションは，-Fオプションと同時には指定できません。

-n

コマンドを実行した日時の直近の稼働状況を出力します。

-rを指定した場合，コマンド実行した日時分の0秒を基準として-rで指定した値（分）さかのぼった時間からコマンド実行時間の0秒になる直前までの稼働状況を出力します。

-iを指定した場合，-rで指定した時間範囲内での収集間隔を指定できます。

このオプションは，-b，-s，-e，-fオプションと同時には指定できません。

-r 分

コマンドを実行した日時からさかのぼる時間を指定します。

省略した場合，1（分）を仮定します。

このオプションは，-b，-s，-e，-fオプションと同時には指定できません。

分

指定できる値は，1〜1,440（単位：分）です。

-b 年/月/日

稼働状況を出力する期間の開始日を指定します。

省略した場合，コマンドを実行した日を開始日とします。

このオプションは，-n，-rオプションと同時には指定できません。

年

指定できる値は，1994〜2099（単位：西暦年）です。

月

指定できる値は，1（または01）〜12（単位：月）です。

日

指定できる値は，1（または01）〜31（単位：日）です。

-s 時:分

稼働状況を出力する期間の開始時間を指定します。

省略した場合，00:00を開始時間とします。

このオプションは，-n，-rオプションと同時には指定できません。

時

指定できる値は，0（または00）〜23（単位：時間）です。

分

指定できる値は，0（または00）〜59（単位：分）です。

-e 年/月/日

稼働状況を出力する期間の終了日を指定します。

省略した場合，-bオプションと同じ日を終了日とします。

このオプションは，-n，-rオプションと同時には指定できません。

-bオプションで指定した開始日，または省略して設定される開始日より過去の日付は指定できません。

年

指定できる値は，1994〜2099（単位：西暦年）です。

月

指定できる値は，1（または01）〜12（単位：月）です。

日

指定できる値は，1（または01）〜31（単位：日）です。

-f 時:分

稼働状況を出力する期間の終了時間を指定します。

省略した場合，開始時間の24時間後を終了時間とします。

-eオプションおよび-fオプションをどちらも省略した場合は，開始日時に24時間を加算した時刻を終了日時とします。

このオプションは，-n，-rオプションと同時には指定できません。

-bと-sオプションで指定した開始日時と同一日時，または過去の日時を，-eと-fオプションへ指定できません。

時

指定できる値は，0（または00）〜23（単位：時間）です。

分

指定できる値は，0（または00）〜59（単位：分）です。

-b，-s，-eおよび-fオプションの組み合わせによる稼働状況レポートの集計期間の例を次の表に示します。

表3‒19　-b，-s，-eおよび-fオプションの組み合わせによる稼働状況レポートの集計期間の例（コマンド実行日が2018/04/08の場合）

項番

-bオプション

-sオプション

-eオプション

-fオプション

開始日時

終了日時

集計期間

1

省略

省略

省略

省略

2018/04/08 00:00

2018/04/09 00:00

2018/04/08 00:00:00.000から2018/04/08 23:59:59.999までの1日分

2

2018/04/01

省略

省略

省略

2018/04/01 00:00

2018/04/02 00:00

2018/04/01 00:00:00.000から2018/04/01 23:59:59.999までの1日分

3

省略

09:00

省略

省略

2018/04/08 09:00

2018/04/09 09:00

2018/04/08 09:00:00.000から2018/04/09 08:59:59.999までの1日分

4

2018/04/01

11:00

省略

省略

2018/04/01 11:00

2018/04/02 11:00

2018/04/01 11:00:00.000から2018/04/02 10:59:59.999までの1日分

5

省略

省略

2018/04/08

省略

2018/04/08 00:00

2018/04/09 00:00

2018/04/08 00:00:00.000から2018/04/08 23:59:59.999までの1日分

6

省略

省略

省略

20:00

2018/04/08 00:00

2018/04/08 20:00

2018/04/08 00:00:00.000から19:59:59.999までの約1日分

7

省略

省略

2018/04/08

22:30

2018/04/08 00:00

2018/04/08 22:30

2018/04/08 00:00:00.000から22:29:59.999までの約1日分

8

2018/04/01

省略

2018/04/07

省略

2018/04/01 00:00

2018/04/08 00:00

2018/04/01 00:00:00.000から2018/04/07 23:59:59.999までの7日分

9

省略

11:00

省略

22:30

2018/04/08 11:00

2018/04/08 22:30

2018/04/08 11:00:00.000から2018/04/08 22:29:59.999までの約半日分

10

2018/04/01

08:00

2018/04/07

21:30

2018/04/01 08:00

2018/04/07 21:30

2018/04/01 08:00:00.000から2018/04/07 21:29:59.999までの約7日分

-i 集計間隔

稼働状況を集計する間隔を指定します。

省略した場合は1（分）を仮定します。

このオプションと同時に-rオプションが指定されている場合，-rオプションの指定値より大きい値は指定できません。

集計間隔

指定できる値は，1〜1,440（単位：分）です。

-H

稼働状況のヘッダー情報として，コマンド実行日時，コマンド指定内容，および項目名を出力しない場合に指定します。

注意事項

このコマンドは，リモート実行できません。

オプションと値との間は，必ず1バイト以上の空白文字で区切ってください。

スケジューラーサービス名には，正規表現を指定できません。

このコマンドはシステム時刻で集計した結果を出力します。スケジューラーサービスローカル日時の設定は反映されません。

ジョブネットまたはジョブの実行中に，このコマンドを実行した場合，実行中に状態が遷移したジョブネット，ジョブの情報は，集計開始後の情報となるため集計結果に含まれません。

-dオプションに，他ホスト上のディレクトリパスを指定して実行することはできません。また，異なるOS上で記録された稼働状況ログファイルを指定して実行することはできません。

コマンド実行時にKAVS1112-Eのメッセージが出力された場合は，稼働状況ログファイル格納ディレクトリが存在するか確認してください。

ajsreportコマンドは，稼働状況レポートを出力する期間に応じてコマンドの実行時間が長くなり，メモリ使用量も大きくなります。コマンドの実行時間を短くしたい場合やメモリ使用量の増加による影響を小さくしたい場合は，レポートを出力する期間を短く指定して，分割して出力してください。

コマンドを実行すると，ajsreportコマンドのプロセスによってCPU負荷が一時的に高くなります。CPU負荷が低い時間帯に実行することを推奨します。

戻り値

0

正常終了。

4

コマンド実行時の環境変数が不正である。

8

コマンド引数の指定に誤りがある。

12

コマンド処理中にメモリー不足が発生した。

24

コマンド実行権限がない。

32

稼働状況ログファイルに不正なレコードがある。

40

共有メモリーの割り当て，ファイルディスクリプタの割り当て，または排他資源の割り当ての際，システムの限界値を超えた。

120

OSのシステムコールで予期しないエラーを検知した。

124

JP1/AJS3の内部処理で予期しないエラーを検知した。

稼働状況レポートに出力される項目

稼働状況レポートに出力される項目を次に示します。

表3‒20　稼働状況レポートに出力される項目一覧

項番

項目名

説明

集計種別※1

1

RJ_EXEC_START_NUM

ルートジョブネット，ルートリモートジョブネットの実行開始数です。実行中状態になったジョブネット数に応じて加算されます。

件数/時間

2

CONDRJ_MONITOR_START_NUM

起動条件付きジョブネットの監視世代の監視開始数です。監視中状態になった監視世代の数に応じて加算されます。

件数/時間

3

CONDRJ_EV_DETECTED_NUM

起動条件付きジョブネットの起動条件成立数です。起動条件が成立したジョブネット数に応じて加算されます。

件数/時間

4

CONDRJ_EXEC_START_NUM

起動条件付きジョブネットの実行世代の実行開始数です。実行中状態になった実行世代の数に応じて加算されます。

件数/時間

5

NEST_EXEC_START_NUM

ネストジョブネット，ネストリモートジョブネットの実行開始数です。実行中状態になったジョブネット数に応じて加算されます。

件数/時間

6

JOB_EXECWAIT_NUM

ジョブ※2が実行待ち状態に遷移した数です。実行待ち状態になったジョブ数に応じて加算されます。

件数/時間

7

JOB_TRANSITTED_QUEUING_NUM

ジョブ※2がキューイング状態に遷移した数です。キューイング状態になったジョブ数に応じて加算されます。

件数/時間

8

JOB_EXEC_START_NUM

ジョブ※2の実行開始数です。実行中状態になったジョブ数に応じて加算されます。

件数/時間

9

EVJOB_EXEC_START_NUM

イベントジョブおよびカスタムイベントジョブの実行開始数です。実行中状態になったジョブ数に応じて加算されます。

件数/時間

10

QLJOB_EXEC_START_NUM

キューレスジョブの実行開始数です。実行中状態になったジョブ数に応じて加算されます。

件数/時間

11

OTHERJOB_EXEC_START_NUM

ORジョブ，判定ジョブの実行開始数です。実行開始すると加算されます。

件数/時間

12

JOBCON_EXEC_START_NUM

ジョブネットコネクタの実行開始数です。実行中状態になったジョブネットコネクタ数に応じて加算されます。

件数/時間

13

RJ_EXEC_END_N_NUM

ルートジョブネット，ルートリモートジョブネットが正常終了した数です。正常終了状態になったジョブネット数に応じて加算されます。起動条件付きジョブネットの監視世代を再実行して正常終了した場合も対象になります。

件数/時間

14

RJ_EXEC_END_W_NUM

ルートジョブネット，ルートリモートジョブネットが警告検出終了した数です。警告検出終了状態になったジョブネット数に応じて加算されます。起動条件付きジョブネットの監視世代を再実行して警告検出終了した場合も対象になります。

件数/時間

15

RJ_EXEC_END_E_NUM

ルートジョブネット，ルートリモートジョブネットが異常終了した数です。次の状態になったジョブネット数に応じて加算されます。

異常検出終了

異常検出終了-WR

順序不正

中断

強制終了

強制終了-WR

件数/時間

16

CONDRJ_MONITOR_END_N_NUM

起動条件付きジョブネットの監視世代が監視正常終了に遷移した数です。監視正常終了状態になったジョブネット数に応じて加算されます。

件数/時間

17

CONDRJ_NOMONITOR_END_NUM

起動条件付きジョブネットの監視世代が監視未起動終了に遷移した数です。監視未起動状態になったジョブネット数に応じて加算されます。

件数/時間

18

CONDRJ_MONITOR_END_E_NUM

起動条件付きジョブネットの監視世代が監視打ち切り終了に遷移した数です。監視打ち切り終了状態になったジョブネット数に応じて加算されます。

件数/時間

19

CONDRJ_MONITOR_STOPPED_END_NUM

起動条件付きジョブネットの監視世代が監視中断に遷移した数です。監視中断状態になったジョブネット数に応じて加算されます。

件数/時間

20

CONDRJ_EXEC_END_N_NUM

起動条件付きジョブネットの実行世代が正常終了に遷移した数です。正常終了になったジョブネット数に応じて加算されます。

件数/時間

21

CONDRJ_EXEC_END_W_NUM

起動条件付きジョブネットの実行世代が警告検出終了に遷移した数です。警告検出終了状態になったジョブネット数に応じて加算されます。

件数/時間

22

CONDRJ_EXEC_END_E_NUM

起動条件付きジョブネットの実行世代が異常終了した数です。次の状態になったジョブネット数に応じて加算されます。

異常検出終了

異常検出終了-WR

順序不正

中断

強制終了

強制終了-WR

件数/時間

23

NEST_EXEC_END_N_NUM

ネストジョブネット，ネストリモートジョブネットが正常終了した数です。正常終了状態になったジョブネット数に応じて加算されます。

件数/時間

24

NEST_EXEC_END_W_NUM

ネストジョブネット，ネストリモートジョブネットが警告検出終了した数です。警告検出終了になったジョブネット数に応じて加算されます。

件数/時間

25

NEST_EXEC_END_E_NUM

ネストジョブネット，ネストリモートジョブネットが異常終了した数です。次の状態になったジョブネット数に応じて加算されます。

異常検出終了

異常検出終了-WR

順序不正

中断

強制終了

強制終了-WR

件数/時間

26

JOB_END_NOTIFICATION_DETECTED_NUM

ジョブ※2の終了を検知した数です。エージェントからジョブの終了通知を受信したときに加算されます。ジョブを強制終了するときや，エラーが発生してジョブを終了するときにも加算されます。なお，次のようにジョブの受け付けが完了する前にエラーが発生したときには加算されません。

存在しない実行エージェントグループまたは実行エージェントを指定したジョブを実行登録する

存在しないキューまたはエージェントを指定したQUEUEジョブを実行登録する

件数/時間

27

JOB_EXEC_END_N_NUM

ジョブ※2が正常終了した数です。正常終了状態になったジョブ数に応じて加算されます。

件数/時間

28

JOB_EXEC_END_W_NUM

ジョブ※2の警告検出終了数です。警告検出終了状態になったジョブ数に応じて加算されます。

件数/時間

29

JOB_EXEC_END_E_NUM

ジョブ※2が異常終了した数です。次の状態になったジョブ数に応じて加算されます。

異常検出終了

異常検出終了-WR

強制終了

強制終了-WR

起動失敗

起動失敗-WR

終了状態不明

終了状態不明-WR

件数/時間

30

EVJOB_DETECTED_EV_NUM

エージェントから受信したイベントジョブおよびカスタムイベントジョブの通知数です。

起動条件付きジョブネットの起動条件成立数は，有効範囲の設定に依存するため，イベントの検知数とは一致しません。起動条件成立数はCONDRJ_EV_DETECTED_NUMを確認してください。

件数/時間

31

EVJOB_EXEC_END_N_NUM

イベントジョブおよびカスタムイベントジョブが正常終了した数です。正常終了状態になったジョブ数に応じて加算されます。

件数/時間

32

EVJOB_EXEC_END_W_NUM

イベントジョブおよびカスタムイベントジョブが警告検出終了した数です。警告検出終了状態になったジョブ数に応じて加算されます。

件数/時間

33

EVJOB_EXEC_END_E_NUM

イベントジョブおよびカスタムイベントジョブが異常終了した数です。次の状態になったジョブ数に応じて加算されます。

異常検出終了

異常検出終了-WR

強制終了

強制終了-WR

起動失敗

起動失敗-WR

終了状態不明

終了状態不明-WR

件数/時間

34

QLJOB_EXEC_END_N_NUM

キューレスジョブが正常終了した数です。正常終了状態になったジョブ数に応じて加算されます。

件数/時間

35

QLJOB_EXEC_END_W_NUM

キューレスジョブが警告検出終了した数です。警告検出終了状態になったジョブ数に応じて加算されます。

件数/時間

36

QLJOB_EXEC_END_E_NUM

キューレスジョブが異常終了した数です。次の状態になったジョブ数に応じて加算されます。

異常検出終了

異常検出終了-WR

強制終了

強制終了-WR

起動失敗

起動失敗-WR

終了状態不明

終了状態不明-WR

件数/時間

37

OTHERJOB_EXEC_END_N_NUM

ORジョブ，判定ジョブが正常終了，正常終了-偽に遷移した数です。正常終了，正常終了-偽状態になったジョブ数に応じて加算されます。

件数/時間

38

OTHERJOB_EXEC_END_E_NUM

判定ジョブが異常検出終了した数です。異常検出終了状態になったジョブ数に応じて加算されます。

件数/時間

39

JOBCON_EXEC_END_N_NUM

ジョブネットコネクタが正常終了した数です。正常終了状態になったジョブネットコネクタ数に応じて加算されます。

件数/時間

40

JOBCON_EXEC_END_W_NUM

ジョブネットコネクタが警告検出終了した数です。警告検出終了状態になったジョブネットコネクタ数に応じて加算されます。

件数/時間

41

JOBCON_EXEC_END_E_NUM

ジョブネットコネクタが異常終了した数です。次の状態になったジョブネットコネクタ数に応じて加算されます。

異常検出終了

強制終了

終了状態不明

件数/時間

42

CONDRJ_EXEC_START_BACKLOG_NUM

起動条件付きジョブネットの中で，起動条件が成立しているが実行が開始されていない起動条件待ち，または，保留中状態の実行世代の合計数です。起動条件が成立しているが実行が開始されていない要因については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　3.4.6 起動条件付きジョブネットの実行世代の滞留」またはマニュアル「JP1/Automatic Job Management System 3 導入ガイド　3.4.7 起動条件付きジョブネットの実行世代が異常終了したときの実行抑止」を参照してください。

合計数

43

JOB_SUBMIT_RETRY_BACKLOG_NUM

サブミット可能になったジョブ※2の中で，ジョブ実行情報通信バッファーのあふれによりサブミットできていないジョブの合計数です。ジョブ実行情報通信バッファーのあふれは，同時に多量のジョブがサブミットされた場合に起こります。

合計数

44

JOB_QUEUING_BACKLOG_NUM

次の状態のジョブ※2の合計数です。

実行待ち

キューイング

合計数

45

EVJOB_QUEUING_BACKLOG_NUM

キューイング状態のイベントジョブおよびカスタムイベントジョブの合計数です。

合計数

46

EVJOB_START_BACKLOG_NUM

エージェント上でイベント監視を開始したイベントジョブおよびカスタムイベントジョブの中で，スケジューラーサービスが開始の通知を受信していない未処理の合計数です。

合計数

47

CONDRJ_EXEC_END_BACKLOG_NUM

起動条件が成立した起動条件付きジョブネットの中で，スケジューラーサービスが成立の通知を受信していない未処理の合計数です。

合計数

48

JOB_EXEC_END_BACKLOG_NUM

ジョブ※2の終了を検知したあと，終了状態に遷移していないジョブの合計数です。

ジョブの終了を検知したときに加算し，ジョブを終了状態に遷移させるときに減算します。

合計数

49

EVJOB_DETECTED_NOTIFICATION_WITHOUT_EV_END_BACKLOG_NUM

エージェントから受信した，イベントジョブおよびカスタムイベントジョブのイベント成立以外の通知の中で，スケジューラーサービスに通知できていない未処理の合計数です。

合計数

50

EVJOB_DETECTED_EV_END_BACKLOG_NUM

エージェントから受信した，イベントジョブおよびカスタムイベントジョブのイベント成立通知の中で，スケジューラーサービスに通知できていない未処理の合計数です。

合計数

51

JOB_EXCEEDED_MAX_CON-EXE

ジョブ※2（例外としてQUEUEジョブを除く）の実行多重度に達したかどうかを示します。

「0」のときは，ジョブ実行多重度に達していません。

「1」のときは，ジョブ実行多重度に達しています。

次の条件に該当する場合，ジョブ実行多重度に達していないと見なします。

ジョブ実行多重度を「0」にした実行エージェントにジョブを実行したとき

実行エージェントグループにリンクされている実行エージェントに，実行多重度に達している実行エージェントが存在しても，ほかの実行エージェントでジョブを配信できるとき

有無/時間

52

JOB_MAXIMUM_TRANSFER_FILE_SIZE

集計間隔内で最も大きかったジョブ※2（QUEUEジョブを除く）の転送ファイルのサイズをバイト単位で表示します。

一つのジョブで複数の転送ファイルが指定されている場合，それらのファイルデータの合計サイズが表示されます。なお，実際のファイルサイズよりも数百バイト程度大きな値が表示されます。

環境設定パラメーターReceiveFileSizeStatusの値を1，2，3のどれかで指定しているときに，受信サイズの上限値に達した場合，転送ファイルは受信しません。このとき，転送ファイルの最大サイズは0になります。

最大数/時間

53

JOB_ERROR_AGENT_DETECTED

ジョブ※2（例外としてQUEUEジョブを除く）実行時の障害エージェントの存在有無を表示します。

「0」のときは，障害エージェントは存在しません。

「1」のときは，障害エージェントが存在します。

実行エージェントへのジョブの配信が失敗したときに1を表示します。

なお，障害エージェントへのジョブの配信を試みず，ほかの正常稼働している実行エージェントにジョブを配信したときは，0を表示します。

（例）実行エージェントグループAGTGRに実行エージェントAGT1とAGT2がリンクされている場合

障害エージェントが存在するものと見なすケース

AGT1へのジョブの配信に失敗したあと，AGT2へのジョブの配信が成功したとき

障害エージェントが存在しないものと見なすケース

AGT1へのジョブの配信をせずに，AGT2へのジョブの配信が成功したとき

有無/時間

54

EVJOB_ERROR_AGENT_DETECTED

イベントジョブおよびカスタムイベントジョブ実行時の障害エージェントの存在有無を示します。

「0」のときは，障害エージェントは存在しません。

「1」のときは，障害エージェントが存在します。

有無/時間

55

JOB_MAXIMUM_RESULT_FILE_SIZE

集計間隔内で最も大きかったジョブ※2（QUEUEジョブを除く）の結果ファイルサイズをバイト単位で表示します。環境設定パラメーターReceiveFileSizeStatusの値を1，2，3のどれかで指定しているとき，ファイル受信サイズの上限値を超えたデータは破棄されます。ただし，この項目では，破棄したデータサイズを含めて表示します。

なお，実際のファイルサイズよりも数百バイト程度大きな値が表示されます。

最大数/時間

56

RUNNING_AND_SCHEDULED_NEXT_GENERATIONS_NUM

実行中および次回の実行予定の世代の合計数です。終了した結果世代や次々回以降の実行予定の世代は含みません。実行中および次回の実行予定の世代とは，次の状態の世代です。

実行中

警告検出実行中

異常検出実行中

監視中

保留中

起動条件待ち

開始時刻待ち

合計数

57

ALL_NOEXEC_END_UNITS_NUM

実行開始せずに終了したユニットの数です。次のどれかの状態に遷移したときに加算されます。スケジューラーサービスが起動したときの状態遷移は含みません。

監視未起動終了※3

繰り越し未実行

計画未実行

未実行終了

未実行終了-W

件数/時間

58

DELAY_NET_START_NUM

ジョブネットの開始遅延数です。ジョブネットの遅延監視機能で，開始遅延を検知したときに加算されます。

件数/時間

59

DELAY_NET_END_NUM

ジョブネットの終了遅延数です。ジョブネットの遅延監視機能で，終了遅延を検知したときに加算されます。

件数/時間

60

DELAY_ALLJOB_END_NUM

ジョブ※2，イベントジョブおよびカスタムイベントジョブの終了遅延数です。ジョブ，イベントジョブおよびカスタムイベントジョブの実行所要時間による終了遅延監視機能で，終了遅延を検知したときに加算されます。

件数/時間

61

CONTENTJOB_NUM

集計間隔内で最も大きかった同時ジョブ※2実行数（キューイングおよび実行中状態のジョブ※2の合計数）です。

最大数/時間

62

EVJOB_UNREPORTED_EVENT_NUM

スケジューラーサービスに通知できていない次の通知の合計数が，集計間隔内で最も大きい値を示します。

イベントジョブの開始通知

カスタムイベントジョブの開始通知

起動条件の成立通知

イベント成立通知

イベント成立以外（強制終了など）の通知

最大数/時間

注※1

稼働状況レポートの集計種別を，次に示します。

集計種別

説明

件数/時間

集計期間内に0から加算した結果の件数を表します。

最大数/時間

集計期間内で対象の項目が記録した最大値を表します。

有無/時間

集計期間内で対象の項目の事象が発生しているかどうかを表します。

合計数

集計期間を経過した時点での対象の項目の合計数を表します。

注※2

ジョブとは，PCジョブ／UNIXジョブ（キューレスジョブを除く），QUEUEジョブ，フレキシブルジョブ，HTTP接続ジョブ，カスタムジョブ，アクションジョブ（キューレスジョブを除く），および引き継ぎ情報設定ジョブのことを指します。

注※3

監視世代が監視中になったあとで監視未起動終了に遷移した場合は含みません。実行世代が開始せずに監視未起動終了になった場合は含みます。

使用例1

当日（2018/01/01）の稼働状況を出力します。

ajsreport

出力例

#exectime: 2018/01/01 19:00:13
#command: ajsreport
#DATE,RJ_EXEC_START_NUM,CONDRJ_MONITOR_START_NUM,CONDRJ_EV_DETECTED_NUM,...
2018/01/01 00:00,0,0,0,...
2018/01/01 00:01,0,0,0,...
        :       ,:,:,:,...
2018/01/01 23:59,0,0,0,...

使用例2

当日（2018/01/01）の稼働状況を，ヘッダ情報なしで出力します。

ajsreport -H

出力例

2018/01/01 00:00,0,0,0,...
2018/01/01 00:01,0,0,0,...
        :       ,:,:,:,...
2018/01/01 23:59,0,0,0,...

使用例3

当日（2018/01/01）のコマンド実行日時（15:10）の稼働状況を出力します。

ajsreport -n

出力例

#exectime: 2018/01/01 15:10:34
#command: ajsreport -n
#DATE,RJ_EXEC_START_NUM,CONDRJ_MONITOR_START_NUM,CONDRJ_EV_DETECTED_NUM,...
2018/01/01 15:09,0,0,0,...

使用例4

当日（2018/01/01）のコマンド実行日時（15:10）の10分前からの稼働状況を出力します。

ajsreport -n -r 10

出力例

#exectime: 2018/01/01 15:10:34
#command: ajsreport -n -r 10
#DATE,RJ_EXEC_START_NUM,CONDRJ_MONITOR_START_NUM,CONDRJ_EV_DETECTED_NUM,...
2018/01/01 15:00,0,0,0,...
2018/01/01 15:01,0,0,0,...
        :       ,:,:,:,...
2018/01/01 15:09,0,0,0,...

使用例5

当日（2018/01/01）の9:00から21:30までの稼働状況を出力します。

ajsreport -s 9:00 -f 21:30

出力例

#exectime: 2018/01/01 22:02:51
#command: ajsreport -s 9:00 -f 21:30
#DATE,RJ_EXEC_START_NUM,CONDRJ_MONITOR_START_NUM,CONDRJ_EV_DETECTED_NUM,...
2018/01/01 09:00,0,0,0,...
2018/01/01 09:01,0,0,0,...
        :       ,:,:,:,...
2018/01/01 21:29,0,0,0,...

使用例6

スケジューラーサービス「AJSROOT2」の，2018/01/02 9:00から2018/01/03 09:00までの稼働状況を7分間隔で出力します。

最後の行は，集計間隔の7分に満たないため，集計範囲の終了時刻までの時間（この場合，2018/1/3 08:55から5分）を集計して出力します。

ajsreport -F AJSROOT2 -b 2018/01/02 -s 9:00 -i 7

出力例

#exectime: 2018/01/03 12:17:26
#command: ajsreport -F AJSROOT2 -b 2018/01/02 -s 9:00 -i 7
#DATE,RJ_EXEC_START_NUM,CONDRJ_MONITOR_START_NUM,CONDRJ_EV_DETECTED_NUM,...
2018/01/02 09:00,0,0,0,...
2018/01/02 09:07,0,0,0,...
        :       ,:,:,:,...
2018/01/03 08:55,0,0,0,...

使用例7

2018/7/1から1週間分（2018/7/1〜2018/7/7）の稼働状況を5時間（300分）間隔で出力します。

最後の行は，集計間隔の5時間（300分）に満たないため，集計範囲の終了時刻までの時間（この場合，2018/7/7 21:00から180分）を集計して出力します。

ajsreport -b 2018/07/01 -e 2018/07/07 -i 300

出力例

#exectime: 2018/07/10 18:31:57
#command: ajsreport -b 2018/07/01 -e 2018/07/07 -i 300
#DATE,RJ_EXEC_START_NUM,CONDRJ_MONITOR_START_NUM,CONDRJ_EV_DETECTED_NUM,...
2018/07/01 00:00,0,0,0,...
2018/07/01 05:00,0,0,0,...
        :       ,:,:,:,...
2018/07/07 21:00,0,0,0,...

使用例8

2018/9/1 8:00から2018/9/15 17:30までの稼働状況を2時間（120分）間隔で出力します。

最後の行は，集計間隔の2時間（120分）に満たないため，集計範囲の終了時刻までの時間（この場合，2018/9/15 16:00から90分）を集計して出力します。

ajsreport -b 2018/09/01 -s 8:00 -e 2018/09/15 -f 17:30 -i 120

出力例

#exectime: 2018/12/04 08:43:35
#command: ajsreport -b 2018/09/01 -s 8:00 -e 2018/09/15 -f 17:30 -i 120
#DATE,RJ_EXEC_START_NUM,CONDRJ_MONITOR_START_NUM,CONDRJ_EV_DETECTED_NUM,...
2018/09/01 08:00,0,0,0,...
2018/09/01 10:00,0,0,0,...
        :       ,:,:,:,...
2018/09/15 16:00,0,0,0,...

ajsrestore

形式

ajsrestore
     [-F サービス名]
     [-b 退避情報ディレクトリ名]
     [-d 回復先ユニット名]
     [{-i|-e|-f}]
     [-t]
     [-S]
     -n 退避ボックス名
     [退避ファイル名...]

機能

退避ボックスに退避したユニットを回復します。

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Editor権限

このコマンドは，Administrators権限（Windowsの場合），またはスーパーユーザー権限（UNIXの場合）を持つユーザーが使用することを推奨します。

引数

-F サービス名

処理対象とする，スケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

-b 退避情報ディレクトリ名

環境設定時に指定した退避情報ディレクトリ※と異なるディレクトリを使用する場合に，ディレクトリ名をフルパスで指定します。

指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，環境設定時に指定した退避情報ディレクトリ名※が仮定されます。

注※

環境設定パラメーターAJSBKUROOTに指定したディレクトリ名。

-d 回復先ユニット名

退避したユニットを回復する際に，回復先で使用するジョブグループ名，またはジョブネット名を指定します。

指定できる文字数は，1〜899（単位：バイト）です。

-i

回復先に，これから回復するユニットと同一名称のユニットがある場合に，メッセージおよび了解を求めるプロンプトを表示します。

-e

回復先に，これから回復するユニットと同一名称のユニットがある場合に，エラーとします。情報は更新されません。

-f

回復先に，これから回復するユニットと同一名称のユニットがある場合でも，強制的に更新します。

-t

退避ボックスに退避したユニット名の一覧を標準出力ファイルに出力します。

出力形式は，環境変数AJSDISPSUBUNITTYPEの設定によって切り替えができます。

ジョブグループ種別を出力する場合

環境変数AJSDISPSUBUNITTYPEにYESを指定します。

注

ジョブグループ種別が表示されるのは，退避ユニット種別がジョブグループの場合だけです。

ジョブグループ種別を出力しない場合

次のどちらかを選択します。

環境変数AJSDISPSUBUNITTYPEにNOを指定する。

環境変数AJSDISPSUBUNITTYPEに値を設定しない。

なお，環境変数AJSDISPSUBUNITTYPEの詳細については，「1.4.1 JP1/AJS3のコマンド実行時に使用される環境変数」の表1-5を参照してください。

-S

ジョブネットがサスペンド状態の場合，実行登録済みのジョブネットであっても，そのジョブネットにユニットを更新できるようにします。ただし，ジョブネットがサスペンド状態でも，次の場合は定義の更新は行えません。

ルートジョブネットの定義を更新する場合

ルートジョブネットの定義を含むジョブグループの定義を更新する場合

実行中のジョブネットの場合

-n 退避ボックス名

退避ボックス名を指定します。

指定できる文字数は，1〜50（単位：バイト）です。

退避ボックスの名称は，OSのファイルシステムに依存します。OSがUNIXの場合，退避ボックス名の大文字・小文字は区別されます。OSがWindowsの場合，退避ボックス名の大文字・小文字は区別されません。

退避ファイル名

退避ボックスの中にある，回復したいファイル名を指定します。

指定できる値は，0001〜1024です。

退避ファイル名は複数指定できます。

省略すると，退避ボックスの中のすべての退避ファイルが回復されます。

注意事項

ユニットを回復できるのは，次のどちらかのユーザーです。

回復先のユニットに対して更新権限を与えられたユーザー。

Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザー。

ただし，環境設定パラメーターADMACLIMITをデフォルトから変更して「yes」を設定している場合は，Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザーであっても，更新権限が必要です。

次の場合はユニットを回復できません。

退避ボックス，および退避ファイルの両方に参照権限がない場合。

回復先にユニットがない場合。

ジョブネットの中にジョブグループを回復するなど，ありえない階層構造になる場合。

そのネスト数が許容最大数（デフォルトは30，環境設定パラメーターDEFLENTYPEに「sjis」が設定されている場合は10）を超えるジョブグループや，ジョブネットの場合。

回復先に，これから回復するユニットと同一名称のユニットがある場合，そのユニットをあらかじめ削除したあと，回復することを推奨します。

実行登録済みのルートジョブネットや，そのルートジョブネットを含むジョブグループおよびプランニンググループを回復する場合は，回復する前に，ajsleaveコマンドで実行登録を解除しておいてください（実行登録された状態では，回復できません）。ただし，ルートジョブネット，そのルートジョブネットを含むジョブグループ，およびリモートジョブネット以外のユニットの場合，操作対象のジョブネットをサスペンド状態にしておき，このコマンドに-Sオプションを指定すれば，ジョブネットの実行登録を解除しなくても，回復できます（操作対象のユニットが実行中の場合，-Sオプションを指定しても回復できません）。

回復先ユニットに指定したジョブネットがサスペンド状態変更処理中の場合，このコマンドは異常終了します。

ジョブネットの中にプランニンググループを回復できません。

プランニンググループの中にはジョブネット，リモートジョブネット以外のユニットを回復できません。

戻り値

0

正常終了。

4〜124で4の倍数値

異常終了。

補足事項

退避ファイル名を省略した場合，退避ファイルを作成した順で回復されます。

回復したユニットの，JP1/AJS3 - Viewの［ジョブネットエディタ］ウィンドウでの表示位置は自動的に決まります。ただし，同一名称のユニットは，回復前と同じ位置になります。

使用例1

退避ボックス（BOX1）に退避したすべての退避ファイルをジョブグループ（/資材部/出庫管理）に回復します。回復先に，これから回復するユニットと同一名称のユニットがありますが，強制的に回復します。

ajsrestore -f -d /資材部/出庫管理 -n BOX1

使用例2

退避ボックス（BOX1）に退避したユニット一覧を出力します（ジョブネットの場合）。

ajsrestore -t -n BOX1

出力例

0001:/資材部:テンプレート:g
0002:/資材部/出庫管理:出庫伝票作成:n

使用例3

退避ボックス（BOX1）に退避したユニット一覧を出力します（ジョブネットコネクタの場合）。

ajsrestore -t -n BOX1

出力例

0001:/資材部:テンプレート:g
0002:/資材部/出庫管理/出庫伝票作成:ジョブネット実行待ち:nc

ajsrgexport

形式

ajsrgexport
     [-F サービス名]
     [-R]
     [-e {s|f}]
     [-o 登録予定情報ファイル名]
     [-m]
     ユニット名...

機能

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

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Editor権限

JP1_AJS_Operator権限

JP1_AJS_Guest権限

引数

-F サービス名

処理対象とする，スケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。省略した場合は，デフォルトスケジューラーサービス名が仮定されます。

-R

指定したユニット，およびその配下に含まれるすべてのルートジョブネットをエクスポート対象ユニットとします。

-e {s|f}

どの登録方法で登録されているジョブネットの登録予定情報をエクスポートするかを指定します。

s

計画実行で登録されているルートジョブネットの登録予定情報をエクスポートします。

f

確定実行で登録されているルートジョブネットの登録予定情報をエクスポートします。

計画実行と確定実行の両方を指定する場合は，「-e sf」と指定します。

省略した場合は，計画実行および確定実行で登録されたルートジョブネット両方の登録予定情報がエクスポートされます。

指定したルートジョブネットの登録方法に該当しない場合，および指定したルートジョブネットに未来予定がない場合は，確認のメッセージが出力されます。

-mオプションを指定した場合，メッセージは出力されません。

-m

指定したルートジョブネットに対し，該当しない登録方法を選択している場合でもメッセージを出力しないようにします。

-o 登録予定情報ファイル名

登録予定情報が出力されるファイル名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。256バイト以上の文字数で登録ファイル名を指定した場合は，エラーメッセージが出力されます。省略した場合，登録予定情報は標準出力ファイルに出力します。すでにあるファイル名を指定した場合は，ファイルが上書きされます。

このファイルは修正しないでください。修正したファイルをインポートした場合，正常に動作しないおそれがあります。

ユニット名

エクスポート対象のルートジョブネット名またはジョブグループ名を930バイト以内で指定します。

なお，ユニット名にスケジューラーサービス名を指定できますが，ホスト名および実行IDは指定できません。

戻り値

0

正常終了。

4〜124の整数

異常終了。

注意事項

このコマンドを実行できるのは，次のどちらかのユーザーです。

エクスポートするユニットに対して参照権限のあるユーザー。

Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザー。

ただし，環境設定パラメーターADMACLIMITをデフォルトから変更して「yes」を設定している場合は，Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザーであっても，参照権限が必要です。

登録予定情報として出力されるのは，計画実行または確定実行で登録されているルートジョブネットだけです。ただし，サスペンド状態のルートジョブネットは出力されません。

このコマンドは，リモート実行できません。

コマンドを実行した結果，出力する情報が何もなかった場合はメッセージ「KAVS4837-I エクスポートする情報はありません」が出力されます。

タイムゾーンが異なるシステム間で登録予定情報を退避・回復する場合は，ajsrgexportコマンド実行時のタイムゾーンとajsrgimportコマンド実行時のタイムゾーンを合わせてください。

操作対象がリリース登録したルートジョブネット（リリース先ジョブネット）の場合，または操作対象にリリース登録したルートジョブネットが含まれる場合で，かつ確定実行登録されているときは，リリース日時を境に切り替え予定のジョブネット定義（リリース元ジョブネット）内容が出力されます。

実行登録状態のバックアップおよびリカバリーの詳細については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　3.4 ajsrgexport，ajsrgimportコマンドによるジョブネットの実行登録状態のバックアップ・リカバリー」を参照してください。

使用例1

ジョブグループ（/GROUPA）直下のルートジョブネットの登録予定情報を取得する。

ajsrgexport -F AJSROOT1 -o /tmp/unitreg.txt /GROUPA/*

使用例2

ルートジョブネット（/GROUPA/JOBNETA）単独の登録予定情報を取得する。

ajsrgexport -F AJSROOT1 -o /tmp/unitreg_net.txt /GROUPA/JOBNETA

使用例3

ジョブグループ（/GROUPA）配下のルートジョブネットの登録予定情報を取得する。

ajsrgexport -F AJSROOT1 -R -o /tmp/unitreg_net.txt /GROUPA

ajsrgimport

形式

ajsrgimport
     [-F サービス名]
     [-f]
     [-h]
     [-c]
     [-u ユニット名]
     [-o ユニット名]
     -i 登録予定情報ファイル名

機能

登録予定情報をインポートし，その内容に従ってルートジョブネットを実行登録します。

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Operator権限

引数

-F サービス名

処理対象とする，スケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。省略した場合は，デフォルトスケジューラーサービス名が仮定されます。

-f

当日に実行予定があっても予定時刻を過ぎている場合は，ジョブネットを実行しません。このオプションは，登録予定情報ファイルに指定されているすべてのジョブネット，およびすべての実行登録方法（計画実行および確定実行）に対して有効です。

-h

インポートによる実行登録時に，ルートジョブネットの実行を保留します。

計画実行登録および確定実行登録されていたジョブネットをインポートする場合は，実行登録時に作成される世代のうち，最初の実行世代だけが保留対象です。保留対象の世代に対しては登録予定情報ファイルでの保留解除の情報よりも，このオプションの指定が優先されます。

保留を設定して計画実行登録されていたジョブネット※を，ajsrgexportコマンドでエクスポートしたあと，ajsrgimportコマンドでインポートする場合，インポートしたあとの最初の実行世代は保留されません。インポートしたあとの最初の実行世代を保留したい場合は，ajsrgimportコマンドで-hオプションを指定してください。

保留を設定して確定実行登録されていたジョブネット※を，ajsrgexportコマンドでエクスポートしたあと，ajsrgimportコマンドでインポートする場合，ajsrgimportコマンドの実行日以降の実行予定をインポートします。そのため，保留を設定された実行予定がインポートされるかどうかは，エクスポートされた実行予定とajsrgimportコマンドの実行日に依存します。エクスポートされた実行予定の保留設定状況に関係なく，登録予定情報をインポートしたあとの最初の実行世代を保留したい場合は，ajsrgimportコマンドで-hオプションを指定してください。

注※

次のどれかの方法で実行登録したジョブネットです。

ajsentryコマンドに-hオプションを指定して実行登録した（JP1/AJS3 - Viewの［一時変更情報の一覧］ダイアログボックスからの再操作も含む）。

ajsrgimportコマンドに-hオプションを指定して登録予定情報をインポートした。

JP1/AJS3 - ViewまたはJP1/AJS3 - Web Consoleの［実行登録］ダイアログボックスで，［保留］の［する］をチェックして実行登録した。

JP1/AJS3 - Viewの［追加］ダイアログボックス（ルートジョブネット用）で，［保留］の［する］をチェックして確定実行スケジュールを追加した。

-c

インポートによる実行登録時に，スケジュールを作成できずにエラーになっても，ほかに実行登録対象のルートジョブネットが存在する場合は，コマンドの実行を続行します。

ただし，-iオプションに指定した登録予定情報ファイルが不正な内容の場合は，コマンドの実行を中断し，処理を終了します。

このオプションを省略した場合は，エラーが発生した時点でコマンドの実行を中断し，処理を終了します。

-u ユニット名

インポート対象のルートジョブネットまたはジョブグループのユニット名を930バイト以内で指定します。ただし，ユニット名に総称名は指定できません。また，ユニット名にスケジューラーサービス名，ホスト名，および実行IDは指定できません。

このオプションは，複数指定できます。複数のユニットを指定する場合は，「-u ユニット名 -u ユニット名」のように指定してください。

指定したユニットと同名のルートジョブネット，または指定したユニットと同名のジョブグループ配下のルートジョブネットが登録予定情報ファイルにある場合は，それらのルートジョブネットを実行登録します。

-oオプションおよびこのオプションを省略した場合，-iオプションで指定した登録予定情報ファイル中のすべてのユニットを実行登録します。

なお，このオプションは-oオプションとは同時に指定できません。

-o ユニット名

インポートの対象外とするルートジョブネットまたはジョブグループのユニット名を930バイト以内で指定します。ただし，ユニット名に総称名は指定できません。また，ユニット名にスケジューラーサービス名，ホスト名，および実行IDは指定できません。

このオプションは，複数指定できます。複数のユニットを指定する場合は，「-o ユニット名 -o ユニット名」のように指定してください。

指定したユニットと同名のルートジョブネット，または指定したユニット名と同名のジョブグループ配下のルートジョブネットが登録予定情報ファイルにある場合は，それらのルートジョブネットを除いたルートジョブネットを実行登録します。指定したユニットが登録予定情報ファイルにない場合，このオプションは無視されます。

-uオプションおよびこのオプションを省略した場合，-iオプションで指定した登録予定情報ファイル中のすべてのユニットを実行登録します。

なお，このオプションは-uオプションとは同時に指定できません。

-i 登録予定情報ファイル名

登録予定情報が保存されたファイル名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。256バイト以上の文字数で登録ファイル名を指定した場合は，メッセージ「KAVS4829-E 指定したファイル名(ファイル名)が長すぎます」を出力します。

戻り値

0

正常終了。

4〜124の整数

異常終了。

注意事項

このコマンドを実行できるのは，次のどちらかのユーザーです。

エクスポートしたJP1ユーザーと同じJP1ユーザーで，かつ登録予定情報ファイルに記述されているインポート対象のルートジョブネットに含まれるすべてのユニットに対して操作権限を持つユーザー

Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザー

ただし，環境設定パラメーターADMACLIMITをデフォルトから変更して「yes」を設定している場合は，Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザーであっても，操作権限が必要です。

複数のユーザーでルートジョブネットを確定実行している場合に，このコマンドを実行できるのは，Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザーだけです。ただし，環境設定パラメーターADMACLIMITをデフォルトから変更して「yes」を設定している場合は，Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザーであっても，操作権限が必要です。

ajsrgimportコマンドを実行できないJP1ユーザーがインポートを実行した場合，メッセージKAVS4824-Eが出力され，登録予定情報をインポートできません。

実行登録できるのは，計画実行または確定実行で登録されていたルートジョブネットだけです。

このコマンドは，リモート実行できません。

タイムゾーンが異なるシステム間で登録予定情報を退避・回復する場合は，ajsrgexportコマンド実行時のタイムゾーンとajsrgimportコマンド実行時のタイムゾーンを合わせてください。

実行登録状態のバックアップおよびリカバリーの詳細については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　3.4 ajsrgexport，ajsrgimportコマンドによるジョブネットの実行登録状態のバックアップ・リカバリー」を参照してください。

使用例1

登録予定情報ファイルの内容をすべてインポートする。

ajsrgimport -F AJSROOT1 -i unitreg.txt

使用例2

登録予定情報ファイル中の特定のユニット（/GROUPA/JOBNETA）をインポートする。

ajsrgimport -F AJSROOT1 -i unitreg.txt -u /GROUPA/JOBNETA

ajsschedule

形式

ajsschedule
     [-F サービス名]
     -b [[年/]月/]日
     -e [[年/]月/]日
     ルートジョブネット名

機能

特定期間について，ジョブネットの実行スケジュールを作成します。作成結果は，予定情報パラメーターの形式に従って標準出力ファイルに出力されます。予定情報パラメーターの詳細については，「5.4 予定情報ファイルの作成」を参照してください。

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Editor権限

JP1_AJS_Operator権限

JP1_AJS_Guest権限

引数

-F サービス名

処理対象とする，スケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

-b [[年/]月/]日

作成するスケジュールの適用期間の開始日を指定します。

なお，開始時刻は基準時刻です。

年

指定できる値は，1994〜2099（単位：西暦年）です。

月

指定できる値は，1（または01）〜12（単位：月）です。

日

指定できる値は，1（または01）〜31（単位：日）です。

このオプションで，年，または年/月の指定を省略した場合，次の値が仮定されます。

年：コマンドを実行した年

年/月：コマンドを実行した年と月

-e [[年/]月/]日

作成するスケジュールの適用期間の終了日を指定します。終了日は開始日と同じ日，または開始日以降の日を指定します。

なお，終了時刻は基準時刻に23時間59分59秒を加えた時刻です。

年

指定できる値は，1994〜2099（単位：西暦年）です。

月

指定できる値は，1（または01）〜12（単位：月）です。

日

指定できる値は，1（または01）〜31（単位：日）です。

このオプションで，年，または年/月の指定を省略した場合，次の値が仮定されます。

年：コマンドを実行した年

年/月：コマンドを実行した年と月

ルートジョブネット名

出力対象のルートジョブネット名を930バイト以内で指定します。

ただし，ルートジョブネット名に総称名は指定できません。総称名を指定して実行した場合は，該当するルートジョブネットが複数あっても出力対象となるルートジョブネットは一つだけです。

また，ルートジョブネット名に論理ホスト名および実行IDは指定できません。

注意事項

実行スケジュールを作成できるのは，次のどちらかのユーザーです。

そのジョブネットを定義したときに，または属性を変更したときに，参照権限を与えられたユーザー。

Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザー。

ただし，環境設定パラメーターADMACLIMITをデフォルトから変更して「yes」を設定している場合は，Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザーであっても，参照権限が必要です。

-b，および-eオプションに指定する日付は実行日が対象になります。実行日については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　3.3.1 ルートジョブネットの時間制とスケジュールルール」を参照してください。

48時間制スケジュールで，かつ基準時刻を0:00以外として運用している場合，日またがりが発生するスケジュールをこのコマンドで出力すると，定義しているスケジュール情報と出力されるスケジュール情報の内容が異なることがあります。出力される実行日については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　3.3.1 ルートジョブネットの時間制とスケジュールルール」を参照してください。また，ネストジョブネットの実行日は，日またがりが発生する場合でも，0:00〜23:59の時間が出力されます。これは，ルートジョブネットが基準時刻を意識して実行されるため，ルートジョブネットが実行状態にならないと実行できないネストジョブネットに関しては，実行する時間は基準時刻を意識しないでそのまま出力されます。

操作対象がリリース登録したルートジョブネット（リリース先ジョブネット）の場合，リリース日時を境に切り替え予定のジョブネット定義（リリース元ジョブネット）内容でスケジュールが作成されます。

戻り値

0

正常終了。

4〜124で4の倍数値

異常終了。

使用例

ジョブネット「net1」の20XX年6月の予定を作成します。

ajsschedule -b 20XX/6/1 -e 20XX/6/30 /net1

出力例

PN=net1:20XX06050000:h::::::;
  {
    PJ=job:y:y:h;
  }
PN=net1:20XX06120000:h::::::;
  {
    PJ=job:y:y:h;
  }
PN=net1:20XX06190000:h::::::;
  {
    PJ=job:y:y:n;
  }
PN=net1:20XX06260000:h::::::;
  {
    PJ=job:y:y:n;
  }

ajsshow

形式

ajsshow
     [-F サービス名]
     [{-s|-p|-l|-xw [-xi {b|c}]|-r|-f "フォーマット指示子"
                  |-i "2バイトフォーマット指示子"}]
     [-t "フォーマット指示子"]
     [-k]
     [-g {世代数|a}
        |-b 年/月[/日] [-e 年/月[/日]]
        |-v 年/月[/日] [-w 年/月[/日]]
        |-B 実行登録番号]
     [-u ユーザー名]
     [-c]
     [-R]
     [-E]
     [-T]
     [-N|-J]
     [-d [[年/]月/]日]
     [-h 時[:分]]
     [-X {yes|no|auto}]
     ジョブ名，ジョブネット名，またはジョブグループ名...

機能

実行登録済みのジョブネットまたはジョブの，前回までの実行結果，現在の状態，および次回の実行予定などの情報を標準出力ファイルに出力します（出力形式については，後述の「補足事項1」を参照してください）。

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Editor権限

JP1_AJS_Operator権限

JP1_AJS_Guest権限

引数

-F サービス名

処理対象とする，スケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

-s

指定したジョブネットの次回実行予定の実行登録情報を出力します。

次回実行予定がない場合，前回の実行結果または実行中のジョブネットの実行登録情報を出力します。

なお，計画実行登録したジョブネットで次回予定がない場合，次回実行予定として未計画の世代を生成するため，次回実行予定がない状態でこのオプションを指定すると，「状態」の欄に「未計画」と出力します。

操作するユニットを自動的に選択する機能を使用する場合，プランニンググループの下にあるルートジョブネットの中で，次回実行予定のジョブネットを選択し，実行登録情報を出力します。次回実行予定がない場合，前回の実行結果または実行中のジョブネットを選択し，実行登録情報を出力します。

このオプションは，ジョブには指定できません。

このオプションは，-p，-l，-xw，-r，-f，-i，-g，-b，-e，-v，-w，-B，-Jオプションと同時には指定できません。

ジョブ名，ジョブネット名，またはジョブグループ名に実行IDを指定する場合，このオプションは指定できません。

-p

指定したジョブネットの，次回の実行予定情報を出力します。

操作するユニットを自動的に選択する機能を使用する場合，プランニンググループの下にあるルートジョブネットの中で次回実行予定のジョブネットの次回予定情報を出力します。

このオプションは，ジョブには指定できません。

このオプションは，-s，-l，-xw，-r，-f，-i，-g，-b，-e，-v，-w，-B，-Jオプションと同時には指定できません。

ジョブ名，ジョブネット名，またはジョブグループ名に実行IDを指定する場合，このオプションは指定できません。

-l

指定したジョブネット，およびそのジョブネット中のジョブネットおよびジョブの実行結果情報を出力します。

操作するユニットを自動的に選択する機能を使用する場合，プランニンググループの下にあるルートジョブネットの中で，世代番号1の世代から-gオプションで指定した世代数分のジョブネットまたはジョブの結果情報を出力します。

このオプションは，-s，-p，-xw，-r，-f，-i，-b，-e，-v，-w，-Bオプションと同時には指定できません。

ジョブ名，ジョブネット名，またはジョブグループ名に実行IDを指定する場合，このオプションは指定できません。

-xw

指定した待ち合わせ条件付きユニットおよび待ち合わせ条件付きユニットに設定されている待ち合わせ対象ユニットの状態を出力します。待ち合わせ対象ユニットの情報は，現在待ち合わせ対象となっている世代の情報を出力します。

待ち合わせ条件を設定した起動条件付きジョブネットを出力対象とする場合，-xiオプションにcを指定します。-xiオプションにcを指定しないで待ち合わせ条件を設定した起動条件付きジョブネットを出力対象とすると，ajsshowコマンドは異常終了します。詳細については，-xiオプションを参照してください。

待ち合わせ対象ユニットの確認方法の詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　2.2.5(8) 待ち合わせ対象ユニットの確認方法」を参照してください。

操作するユニットを自動的に選択する機能を使用する場合，プランニンググループの下にあるルートジョブネットの中で，世代番号1の世代から-gオプションで指定した世代数分のジョブネットまたはジョブの結果情報を出力します。

このオプションは，-l，-s，-p，-r，-f，-i，-b，-e，-v，-wオプションと同時には指定できません。

このオプションは，データベース構成が標準構成のときにだけ使用できます。

-Bオプションまたはユニット名に実行IDを指定した場合，対象となる世代の情報だけを出力します。

-gオプションに1以上の値を指定した場合，世代番号1の世代から-gオプションで指定した世代数分の結果情報を出力します。ただし，世代番号1の世代がない場合，世代番号0の世代の情報を出力します。

-gオプションに0を指定した場合，世代番号0の世代の結果情報を出力します。

-Bオプション，実行ID，および-gオプションのすべてを省略した場合，-gに1が指定されたと仮定します。

-xi {b|c}

待ち合わせ情報の出力形式を指定します。このオプションは，-xwオプションと同時に指定します。省略した場合はbが仮定されます。

待ち合わせ条件を設定した起動条件付きジョブネットを出力対象とする場合，bまたはcの指定によって，出力する世代（監視世代または実行世代）が異なります。

b

待ち合わせ条件付きユニットの情報や，待ち合わせ条件として設定した情報を出力します。ただし，「待ち合わせ対象が起動条件付きジョブネットの場合」の設定情報は，出力しません。

起動条件付きジョブネットを出力対象とする場合，監視世代および実行世代の両方を出力します。ただし，実行世代に待ち合わせ情報はないため，ajsshowコマンドは異常終了します。

c

待ち合わせ条件付きユニットの情報や，待ち合わせ条件として設定した情報を出力します。「待ち合わせ対象が起動条件付きジョブネットの場合」の設定情報も出力します。

起動条件付きジョブネットを出力対象とする場合，監視世代だけを出力し，実行世代は出力しません。-gオプションで実行世代だけを出力対象とした場合，ajsshowコマンドは異常終了します。

-xiオプションの引数による出力対象世代の違いを次の表に示します。

表3‒21　-xiオプションに指定した引数による出力対象世代の違い

項番

-xiオプションの引数

世代の指定方法

起動条件を使用するジョブネットの世代

起動条件を使用しないジョブネットの世代

監視世代

実行世代

1

b

実行IDまたは実行登録番号

○

E

○

2

-gオプション

○

E

○

3

c

実行IDまたは実行登録番号

○

×

○

4

-gオプション

○

×またはE※

○

（凡例）

○：情報の出力対象であり，情報を出力する

×：情報の出力対象でない

E：情報の出力対象だが，ajsshowコマンドは異常終了する

注※

-gオプションですべての世代を対象とした場合，情報の出力対象になりません。-gオプションで実行世代だけを出力対象とした場合，ajsshowコマンドは異常終了します。

-xiオプションの出力例については，「使用例8」を参照してください。

-r

指定したジョブの標準エラー出力ファイル名を出力します。

指定したジョブが標準エラー出力に出力していない場合でも，仮定した標準エラー出力ファイル名を出力します。

外部DBを利用している場合は，環境設定パラメーターSTDFILEOUTDIRに指定されたディレクトリに標準エラー出力ファイルを作成し，ファイル名を標準出力に出力します。

このオプションは，-s，-p，-l，-xw，-f，-i，-T，-Nオプションと同時には指定できません。

-f "フォーマット指示子"

指定したジョブネットまたはジョブについて，フォーマット指示子で指定した情報を出力します。

フォーマット指示子は，%と1バイトの英字で指定します。フォーマット指示子の詳細については，後述の「補足事項1」を参照してください。

「"（ダブルクォーテーションマーク）」で囲んだフォーマット指示子以外の文字は，指定したとおりに出力されます。

-i "2バイトフォーマット指示子"

指定したジョブネットまたはジョブについて，フォーマット指示子で指定した情報を出力します。

フォーマット指示子は，%と2バイトの英字で指定します。フォーマット指示子の詳細については，後述の「補足事項1」を参照してください。

「"（ダブルクォーテーションマーク）」で囲んだフォーマット指示子以外の文字は，指定したとおりに出力されます。

-t "フォーマット指示子"

フォーマット指示子で指定した情報をタイトル行に出力します。

フォーマット指示子は，%と1バイトの英字で指定します。フォーマット指示子の詳細については，後述の「補足事項1」を参照してください。

「"（ダブルクォーテーションマーク）」で囲んだフォーマット指示子以外の文字は，指定したとおりに出力されます。

このオプションは，-f，または-iオプションと同時に指定してください。-s，-p，-l，-xw，-kオプションと同時に指定すると，このオプションは無効になります。

-k

タイトル行を出力しません。

なお，このオプションを-s，-p，-l，-xwオプションと同時に指定した場合，「AJSPATH=」行だけは出力します。

-g {世代数|a}

実行結果情報を，新しい世代から順に指定した世代まで出力します。

省略した場合，世代数として1が仮定されます。また，世代数に1を指定した場合も，世代番号1がないときは，世代数として0が仮定されます。

操作するユニットを自動的に選択する機能を使用する場合，プランニンググループの下にあるルートジョブネットの中で，世代番号0または世代番号1の世代から指定した世代数分のジョブネットまたはジョブの情報を出力します。

このオプションは，-s，-p，-b，-e，-v，-w，-Bオプションと同時には指定できません。

世代数

指定できる値は，0〜99（単位：世代）です。ただし，システム設定オプションを有効にしておくと，最大999（単位：世代）まで拡張できます。

0を指定すると，実行前や保留中のジョブネットの情報を出力します（この場合，-lオプションと同時には指定できません）。

なお，ネストジョブネットの場合，そのジョブネットが実行前や保留中であっても，そのジョブネットのルートジョブネットが実行中のときは，世代数は1になります。

世代数が0でない場合に-lオプションを指定すると，タイトル行に世代番号を出力します。

a

すべての世代の実行結果情報を出力します。

一度も実行されていないユニットに対してコマンドを実行した場合，世代番号0の結果を出力します。すでに実行済みのユニットに対してコマンドを実行した場合，世代番号1以上の結果を出力します。

-b 年/月[/日]

情報を出力する期間の開始日を暦日で指定します。

なお，開始時刻は基準時刻です。

年

指定できる値は，1994〜2099（単位：西暦年）です。

月

指定できる値は，1（または01）〜12（単位：月）です。

日

指定できる値は，1（または01）〜31（単位：日）です。省略した場合，「年」および「月」に指定した年月の基準日が仮定されます。

情報を出力する期間の終了日は-eオプションで指定します。

開始日から終了日の期間内に，指定したユニットの予定，または結果情報がある場合，情報を出力します。

開始日から終了日の期間内に，指定したユニットの予定，または結果情報がない場合，情報は出力しません。

操作するユニットを自動的に選択する機能を使用する場合，プランニンググループの下にあるジョブネットの中で，指定した期間に結果または予定情報があるユニットの情報を出力します。

このオプションは，-fまたは-iオプションと同時に指定してください。-s，-p，-l，-xw，-g，-v，-w，-Bオプションと同時には指定できません。

このオプションの使用方法は，後述の使用例を参照してください。

-e 年/月[/日]

情報を出力する期間の終了日を暦日で指定します。

終了日には開始日と同じ日，または開始日以降の日を指定します。

省略した場合，-bオプションに指定した日が仮定されます。

なお，終了時刻は基準時刻に23時間59分59秒を加えた時刻です。

年

指定できる値は，1994〜2099（単位：西暦年）です。

月

指定できる値は，1（または01）〜12（単位：月）です。

日

指定できる値は，1（または01）〜31（単位：日）です。省略した場合，「年」および「月」に指定した年月の，基準日を基にした最終日が仮定されます（例えば，基準日を20日に設定している場合は，最終日として19日が仮定されます）。

このオプションは，-fまたは-i，および-bオプションと同時に指定してください。-s，-p，-l，-xw，-g，-v，-w，-Bオプションと同時には指定できません。

-v 年/月[/日]

情報を出力する期間の開始日を実行日で指定します。

なお，開始時刻は基準時刻です。

年

指定できる値は，1994〜2099（単位：西暦年）です。

月

指定できる値は，1（または01）〜12（単位：月）です。

日

指定できる値は，1（または01）〜31（単位：日）です。省略した場合，「年」および「月」に指定した年月の基準日が仮定されます。

開始日から終了日の期間内に，指定したユニット上位のルートジョブネットの予定，または結果情報がある場合，指定したユニットの情報を出力します。

開始日から終了日の期間内に，上位のルートジョブネットに予定，または結果情報がある場合，指定したユニットの予定，または結果情報が-v，-wオプションに指定した期間にない場合でも，指定したユニット配下のすべて（未計画のユニットも含む）の情報を出力します。

操作するユニットを自動的に選択する機能を使用する場合，プランニンググループの下にあるジョブネットの中で，指定した期間に結果または予定情報があるユニットの情報を出力します。

このオプションは，-fまたは-iオプションと同時に指定してください。-s，-p，-l，-xw，-g，-b，-e，-Bオプションと同時には指定できません。

このオプションの使用方法は，後述の使用例を参照してください。

-w 年/月[/日]

情報を出力する期間の終了日を実行日で指定します。

終了日には開始日と同じ日，または開始日以降の日を指定します。

省略した場合，-vオプションに指定した日が仮定されます。

なお，終了時刻は基準時刻に23時間59分59秒を加えた時刻です。

年

指定できる値は，1994〜2099（単位：西暦年）です。

月

指定できる値は，1（または01）〜12（単位：月）です。

日

指定できる値は，1（または01）〜31（単位：日）です。省略した場合，「年」および「月」に指定した年月の，基準日を基にした最終日が仮定されます（例えば，基準日を20日に設定している場合は，最終日として19日が仮定されます）。

このオプションは，-fまたは-i，および-vオプションと同時に指定してください。-s，-p，-l，-xw，-g，-b，-e，-Bオプションと同時には指定できません。

-B 実行登録番号

情報を表示するジョブネットの実行登録番号を「YYYYMMDDNNN」の形式で指定します。「YYYYMMDDNNN」の内容を次に示します。

YYYY：実行年

MM：実行月

DD：実行日

NNN：実行年月日の実行登録順序番号

操作するユニットを自動的に選択する機能を使用する場合，プランニンググループの下にあるジョブネットの中で，実行登録番号があるユニットの情報を出力します。

実行登録番号の詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　4.5.13 コマンド実行時の世代の指定方法」を参照してください。

このオプションは，-s，-p，-l，-g，-b，-e，-v，-wオプションと同時には指定できません。このオプションは，-f，-i，-r，または-xwオプションと同時に指定してください。

-u ユーザー名

指定したユーザーが実行登録したジョブネットの情報を出力する場合に，ユーザー名を指定します。

指定できる文字数は，1〜31（単位：バイト）です。

-c

指定したジョブネットまたはジョブだけの情報を取得し，高速で出力します。

サスペンド中に追加したジョブネットまたはジョブの情報は取得できません。

フォーマット指示子，%B，%b，%O，%oの情報は「****/**/** **:**:**」または「****/**/** **:**」で表示されます。

フォーマット指示子，%aの情報は「00:00:00」で表示されます。

このオプションは，-f，-i，または-rと同時に指定してください。

このオプションは，-s，-p，-l，-xw，-b，-e，-v，-w，-Rオプションと同時には指定できません。ただし，-Rは-Tと同時に指定した場合だけ指定できます。

-R

指定したユニットに含まれるすべてのジョブネットの情報またはジョブの情報を出力します。

このオプションを，-E，-T，-N，-Jオプションと同時に指定した場合，各オプションの指定内容に従って，ジョブネットおよびジョブの情報を出力します。

-E

実行登録済みのジョブネットの情報を出力します。

-T

ルートジョブネットの情報を出力します。

このオプションは，-r，-Jオプションと同時には指定できません。

-N

ジョブネットの情報を出力します。

このオプションは，-r，-Jオプションと同時には指定できません。

-J

ジョブの情報を出力します。

このオプションは，-s，-p，-T，-Nオプションと同時には指定できません。

-d [[年/]月/]日

ルートジョブネットの再実行開始日を指定します。-iオプションに2バイトフォーマット指示子の%abまたは%anを指定して推定所要時間を求めるときにこのオプションを指定します。

年

指定できる値は，1994〜2099（単位：西暦年）です。

月

指定できる値は，1（または01）〜12（単位：月）です。

日

指定できる値は，1（または01）〜31（単位：日）です。

このオプションで年，または年/月の指定を省略した場合，次の値が仮定されます。

年：コマンドを実行した年

年/月：コマンドを実行した年と月

省略した場合，コマンドを実行した年月日が仮定されます。

-iオプションに2バイトフォーマット指示子の%abまたは%anが指定されていない場合，このオプションは無効になります。

このオプションは，-s，-p，-l，-xw，-r，-f，-g，-B，-cオプションと同時には指定できません。

-iオプション，および-bオプションまたは-vオプションと同時に指定します。

-h 時[:分]

ルートジョブネットの再実行開始時刻を指定します。-iオプションに2バイトフォーマット指示子の%abまたは%anを指定して推定所要時間を求めるときにこのオプションを指定します。

時

指定できる値は，0（または00）〜24（単位：時）です。

分

指定できる値は，0（または00）〜59（単位：分）です。省略した場合，0が仮定されます。

省略した場合，コマンドを実行した時刻が仮定されます。

-iオプションに2バイトフォーマット識別子の%abまたは%anが指定されていない場合，このオプションは無効になります。

このオプションは，-s，-p，-l，-xw，-r，-f，-g，-B，-cオプションと同時には指定できません。

-iオプション，および-bオプションまたは-vオプションと同時に指定します。

-X {yes|no|auto}

プランニンググループの下にあるユニットの中から，現在運用中のユニットを自動的に選択して操作するかどうかを指定します。ただし，ジョブグループの下にあるユニットに対しては，どの値を指定しても自動的に選択しません。また，ルートジョブネット名称も省略できません。

yes

自動的に選択して操作する場合に指定します。

コマンドに指定するユニット名は，プランニンググループの下のルートジョブネット名を省略して指定します。

no

自動的に選択して操作しない場合に指定します。

指定したユニットに対して操作します。プランニンググループの下のルートジョブネット名を省略して指定することはできません。

auto

ユニット名の指定方法に従って，自動的に選択して操作するかしないかを決定する場合に指定します。

自動的に選択して操作する場合

プランニンググループの下のルートジョブネット名を省略してユニット名を指定します。

自動的に選択して操作しない場合

プランニンググループの下のルートジョブネット名を省略しないでユニット名を指定します。この場合，指定したユニットが操作対象になります。ただし，プランニンググループの下のルートジョブネット名を省略して指定したパス名と同じ名称のユニットがある場合，省略したものとして扱われ，操作対象のユニットが自動選択されます。

ジョブ名，ジョブネット名，またはジョブグループ名

情報を出力するジョブ名，ジョブネット名，または-R，-E，-T，-N，-Jオプションと同時に，ジョブ名，ジョブネット名，またはジョブグループ名を指定します。

指定できる文字数は，1〜930（単位：バイト）です。

ジョブ名，ジョブネット名，またはジョブグループ名は，複数指定できます。ただし，マネージャージョブグループ名とマネージャージョブネット名は指定できません。

なお，ジョブ名，ジョブネット名，またはジョブグループ名に，論理ホスト名および実行IDを指定できます。ただし，実行IDを指定した場合，-g，-b，-e，-v，-w，-Bオプションは無効になります。

ジョブ名，ジョブネット名，またはジョブグループ名に実行IDを指定する場合，-f，-i，-r，または-xwオプションと同時に指定してください。また，-s，-p，または-l（デフォルト）オプションを指定した場合，実行IDは指定できません。実行IDの指定方法については，「1.1 コマンドの記述形式」を参照してください。

注意事項

出力情報から情報を切り出す場合，固定バイトでの切り出しではなく，スペースを区切り文字として情報の切り出しをしてください。

ユニットの情報を出力できるのは，次のどちらかのユーザーです。

情報を出力するユニットを定義したときに，または属性を変更したときに，参照権限を与えられたユーザー

Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザー

ただし，環境設定パラメーターADMACLIMITをデフォルトから変更して「yes」を設定している場合は，Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザーであっても，参照権限が必要です。

情報を出力する期間は，-b，-eオプションの組み合わせ，または-v，-wオプションの組み合わせで指定します。-b，-eオプションを組み合わせて期間を指定した場合の出力内容と，-v，-wオプションを組み合わせて期間を指定した場合の出力内容は異なります。詳細については後述の「使用例5」を参照してください。

-b，-e，-v，-wオプションで情報を出力する期間を指定した場合，情報は古い世代から順に出力されます。

サスペンド中のルートジョブネットに追加したユニットは，ルートジョブネットのサスペンドが解除されるまで出力の対象となりません。サスペンド解除後は，シミュレーションした結果を出力します。そのため，サスペンドの解除前と解除後では出力結果が異なります。

-cオプションと-gで世代数を指定した場合で，複数ユニットを同時に指定したときは，ジョブネットまたはジョブごとに実行結果情報を新しい世代から順に指定した世代まで出力します。

プランニンググループの下にあるユニットの中から操作するユニットを自動的に選択する指定をした場合に，自動的に選択されたユニットに操作権限がないと，エラーになります。

-Xオプションが省略された場合，環境変数AJSAUTOJUDGEの指定値に従って，プランニンググループの下にあるユニットの操作対象が決定されます。

プランニンググループの下にあるユニット名の指定方法については，「3. 通常の運用で使用するコマンド　ajsplan」の「補足事項」を参照してください。

-s，-p，-r，-f，-iオプションを指定しなかった場合，-lが指定されたものとして処理されます。

-l，-r，-f，-iオプションを指定し，-g，-b，-e，-v，-w，-B，実行IDを指定しなかった場合，「-g 1」が指定されたものとして処理されます。

-b，-eまたは-v，-wオプションを指定した場合，スケジュールシミュレーションおよび実行シミュレーションを行います。-g（デフォルト），-Bまたは実行ID指定時はシミュレーションを行いません。シミュレーションについては，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　4.4.2 シミュレーション」を参照してください。

外部DB接続時に-r，-f %r，-i %soオプションを指定した場合に作成する標準出力ファイルおよび標準エラー出力ファイルの更新権限は，コマンドを実行するユーザーに設定されます。ファイルを作成する場合，同名のファイルがすでに存在するときは，そのファイルを削除します。指定したジョブが標準エラー出力を出力していない場合は，ファイルを作成せず，標準出力に標準エラー出力ファイル名を仮定して出力します。次の場合，コマンドは異常終了します。

環境設定パラメーターSTDFILEOUTDIRに指定されたディレクトリに対して，コマンドを実行したユーザーにアクセス権限がない場合

環境設定パラメーターSTDFILEOUTDIRに指定されたディレクトリが存在しない場合

環境設定パラメーターSTDFILEOUTDIRにディレクトリが指定されていない場合

ajsshowコマンドは暦日での日付および時刻を出力します。このため，環境設定パラメーターROOTJOBNETSCHEDULERANGEでルートジョブネットのスケジュールの有効範囲を48時間に設定していても，24:00以降の時刻は翌日として出力されます。

世代が実行開始した直後は，世代の世代番号が変更されていない場合があります。そのため，世代が実行開始した直後は，-gオプションでは意図した世代の情報を出力できない場合がありますので，-gオプションの代わりに，-Bオプションや実行IDを指定することを検討してください。実行開始した世代のジョブからその世代の情報を取得したい場合，環境変数AJSEXECIDで実行IDを指定できます。環境変数AJSEXECIDについては，「1.4.2 JP1/AJS3から実行されるジョブ実行時に設定される環境変数」を参照してください。

JP1/AJS3 - Viewからコマンドを実行する場合に指定できる引数

JP1/AJS3 - Viewからこのコマンドを実行する場合，次に示す引数を指定できます。

項番

引数

必須または任意

1

-F サービス名

○

2

-s

−

3

-p

−

4

-l

−

5

-xw

−

6

-xi {b|c}

−

7

-r

−

8

-f "フォーマット指示子"

−

9

-i "2 バイトフォーマット指示子"

−

10

-t "フォーマット指示子"

−

11

-k

−

12

-g {世代数|a}

−

13

-b 年/月[/日]

−

14

-e 年/月[/日]

−

15

-v 年/月[/日]

−

16

-w 年/月[/日]

−

17

-B 実行登録番号

−

18

-u ユーザー名

−

19

-c

−

20

-R

−

21

-E

−

22

-T

−

23

-N

−

24

-J

−

25

-d [[年/]月/]日

−

26

-h 時[:分]

−

27

-X {yes|no|auto}

−

28

ジョブ名，ジョブネット名，またはジョブグループ名

○

（凡例）

○：必須

−：任意

これ以外のオプションは，JP1/AJS3 - Viewからこのコマンドを実行する場合には指定できません。

JP1/AJS3 - ViewからJP1/AJS3のコマンドを実行する方法については，マニュアル「JP1/Automatic Job Management System 3 操作ガイド　10.4 JP1/AJS3 - ViewからJP1/AJS3のコマンドを実行する」を参照してください。

戻り値

0

正常終了。

4〜124で4の倍数値

異常終了。

補足事項1

ジョブネット，およびジョブの定義内容を出力するフォーマット指示子を表3-22に示します。

ジョブネット，およびジョブの定義内容を出力する2バイトフォーマット指示子を表3-23に示します。

その他のフォーマット指示子を表3-24に示します。

フォーマット指示子の出力形式を表3-25に示します。

表3‒22　ジョブネットとジョブの定義情報を出力するフォーマット指示子

フォーマット指示子

出力情報

-f

-t

%J

ジョブネット完全名，またはジョブ完全名

○

○

%j

ジョブネット名，またはジョブ名

30バイト以内の文字列

○

○

%A

AJSPATH=で表される内容

%Jで表される内容のうち，最右端の「/」より右の部分を除いた内容

○

○

%T

ユニットの種別

mgroup：マネージャージョブグループ

group：ジョブグループ

mnet：マネージャージョブネット

condn：起動条件（.CONDITION）

net：ジョブネット

rnet：リカバリージョブネット

rmnet：リモートジョブネット

rrnet：リカバリーリモートジョブネット

job：UNIXジョブ

rjob：リカバリーUNIXジョブ

pjob：PCジョブ

rpjob：リカバリーPCジョブ

qjob：QUEUEジョブ

rqjob：リカバリーQUEUEジョブ

jdjob：判定ジョブ

rjdjob：リカバリー判定ジョブ

orjob：ORジョブ

rorjob：リカバリーORジョブ

cmsjb：JP1/Cm2状態通知ジョブ

rcmsjb：リカバリーJP1/Cm2状態通知ジョブ

evwjb：JP1イベント受信監視ジョブ

revwjb：リカバリーJP1イベント受信監視ジョブ

flwjb：ファイル監視ジョブ

rflwjb：リカバリーファイル監視ジョブ

mlwjb：メール受信監視ジョブ

rmlwjb：リカバリーメール受信監視ジョブ

mqwjb：メッセージキュー受信監視ジョブ

rmqwjb：リカバリーメッセージキュー受信監視ジョブ

mswjb：MSMQ受信監視ジョブ

rmswjb：リカバリーMSMQ受信監視ジョブ

lfwjb：ログファイル監視ジョブ

rlfwjb：リカバリーログファイル監視ジョブ

ntwjb：Windowsイベントログ監視ジョブ

rntwjb：リカバリーWindowsイベントログ監視ジョブ

tmwjb：実行間隔制御ジョブ

rtmwjb：リカバリー実行間隔制御ジョブ

evsjb：JP1イベント送信ジョブ

revsjb：リカバリーJP1イベント送信ジョブ

mlsjb：メール送信ジョブ

rmlsjb：リカバリーメール送信ジョブ

mqsjb：メッセージキュー送信ジョブ

rmqsjb：リカバリーメッセージキュー送信ジョブ

mssjb：MSMQ送信ジョブ

rmssjb：リカバリーMSMQ送信ジョブ

pwljb：ローカル電源制御ジョブ

rpwljb：リカバリーローカル電源制御ジョブ

pwrjb：リモート電源制御ジョブ

rpwrjb：リカバリーリモート電源制御ジョブ

cuujb：カスタムUNIXジョブ

rcuujb：リカバリーカスタムUNIXジョブ

cupjb：カスタムPCジョブ

rcupjb：リカバリーカスタムPCジョブ

netcn：ジョブネットコネクタ

fxjob：フレキシブルジョブ

rfxjob：リカバリーフレキシブルジョブ

htpjb：HTTP接続ジョブ

rhtpjb：リカバリーHTTP接続ジョブ

cewjb：カスタムイベントジョブ

rcewjb：リカバリーカスタムイベントジョブ

○

○

%C

ジョブネットの状態，またはジョブの状態※30

○

※10

×

%U

ジョブネットの実行登録ユーザー名

31バイト以内の文字列

○

※9

×

%D

ジョブネットの実行登録日時※7

○

※9

×

%L

ルートジョブネットを0とした場合の，ジョブネットのネスト数

○

※9

○

%p※3

次回実行予定の有無（括弧内は言語種別が英語の場合）

あり（exist）

なし（none）

○

※27

×

%P※3

次回実行予定日時※7

○

※1

×

%M※3

次回実行方法（括弧内は言語種別が英語の場合）

スケジュール（schedule）

一時変更（plan）

振り替え（shift）

○

※1

×

%R

戻り値，またはシグナルコード

戻り値，またはシグナルコードがない場合は，***。

○

※2

×

%S

ジョブネットの実行開始日時，またはジョブのサブミット日時※7

○

※12

×

%s

ジョブネットの実行開始日時，またはジョブのサブミット日時※7

○

※12

×

%K

ジョブネットの再実行開始日時※7

○

※1,

※15

×

%k

ジョブネットの再実行開始日時※7

○

※1,

※15

×

%E

ジョブネット，またはジョブの実行終了日時※7

○

×

%e

ジョブネット，またはジョブの実行終了日時※7

○

×

%V

他ホストでの，ジョブの実行開始日時※7，※28

○

※2

×

%Q

他ホストでの，ジョブの実行終了日時※7，※28

○

※2

×

%W

＄LANGの値

○

※9

○

%Z

＄TZの値

○

※9

○

%G

世代番号※8

（予定世代は0以下の値）

（実行中または実行結果世代は1以上の値）

○

※8

○

%N

実行優先順位（括弧内は言語種別が英語の場合）※24

1〜5の値

なし（none）

○

×

%H

エージェントホスト名※31

○

※2

×

%I

ジョブ番号

○

※2,

※17

×

%Y

実行登録後に正常終了したジョブネット，またはジョブの実行回数※13

○

×

%B

処理サイクルの計算から求めた実行開始予定日時※7

○

※4,

※18,

※22

×

%b

処理サイクルの計算から求めた実行開始予定日時※7

○

※4,

※19,

※22

×

%a

予定または実行中世代の場合

実行所要時間の推定値※7

実行結果世代の場合

実際の実行所要時間※7

○

※5,

※16,

※22

×

%O

処理サイクルの計算から求めた実行終了予定日時※7

○

※4,

※14,

※20,

※22

×

%o

処理サイクルの計算から求めた実行終了予定日時※7

○

※4,

※14,

※21,

※22

×

%v

予実績情報の出力対象期間の開始日時※7

○

※6

○

※6

%w

予実績情報の出力対象期間の終了日時※7

○

※6

○

※6

%F

次回実行予定の保留属性（括弧内は言語種別が英語の場合）※26

する（yes）：保留されている

しない（no）：保留されていない

前回異常時だけ保留（Before Abnormal End）：前回異常時だけ保留する

前回異常警告時だけ保留（Before Warning End）：前回異常警告時だけ保留する

○

×

%i

実行登録方法の種別（括弧内は言語種別が英語の場合）

即時登録（immediate）

確定登録（definit）

計画登録（planned）

擬似予定（simulation）

○

※9

×

%l

実行登録番号※7

○

※29

×

%r

標準エラー出力ファイル名

この項目は，ジョブを実行していない，エラーが発生していないなど，標準エラー出力ファイルがない場合でも，仮定された標準エラー出力ファイル名が出力されます。

外部DBを利用している場合は，環境設定パラメーターSTDFILEOUTDIRに指定されたディレクトリに標準エラー出力ファイルを作成し，ファイル名を標準出力に出力します。

（出力例）

/var/opt/jp1ajs2/jobinf/7.14a.0.8.err

○

※8,

※23

×

%d

遅延状態（括弧内は言語種別が英語の場合）

なし（none）

開始遅延（start-delay）

ネスト開始遅延（nest-start-delay）

終了遅延（end-delay）

ネスト終了遅延（nest-end-delay）

○

※25

×

%#

実行ID

○

※8

×

%m

起動条件の有効実行時刻（括弧内は言語種別が英語の場合）

無制限（unlimited）※7

○

※11

×

%q

起動条件の有効実行回数（括弧内は言語種別が英語の場合）

10進数の値

無制限（unlimited）

○

※11

×

（凡例）

○：-f，または-tオプションに指定できるフォーマット指示子。

×：-f，または-tオプション指定できないフォーマット指示子。

注※1

ユニットの種別がnetの場合にだけ有効です。これ以外の場合，「*」と出力されます。

注※2

ユニットの種別がjobの場合にだけ有効です。これ以外の場合，「*」と出力されます。

注※3

世代番号が0のジョブネットの情報です。なお，リリース登録されている場合，出力対象と同じ定義の次回予定（世代番号0の情報）を出力します。このため，出力対象の世代と次回予定の間に定義の切り替わりが発生する場合，次回予定がないものとして出力されます。

注※4

「-g」と同時に指定した場合，「****/**/** **:**」および「****/**/** **:**:**」と出力されます。

注※5

一度も実行していないジョブネットおよびジョブは，1分が仮定されます。

注※6

-b，-e，-v，-wオプションを同時に指定していない場合，「****/**/** **:**:**」と出力されます。

注※7

出力形式については，表3-25を参照してください。

注※8

擬似予定の場合，「***」と出力されます。

注※9

ユニットの種別がnet，hlnetの場合にだけ有効です。これら以外の場合，「***」と出力されます。

注※10

サスペンド中に追加したユニットは，既存の上位ユニットが終了状態の場合，「計画未実行」と出力されます。終了状態以外の場合，「未計画」と出力されます。

注※11

ユニットの種別がnetまたはcondnの場合にだけ有効です。これら以外の場合，「***」と出力されます。

注※12

ジョブの場合，サブミットした時刻が出力されます。キューレスジョブ，イベントジョブおよびカスタムイベントジョブの場合，ジョブ実行要求時刻が出力されます。

注※13

保存世代数や出力する世代にかかわらず，登録後の総計が出力されます。

注※14

「処理サイクルの計算から求めた実行開始予定日時」に「実行所要時間の推定値」を加算した時刻が出力されます。

注※15

ユニットが再実行されたときの開始時刻が表示されます。

再実行開始日時は，ユニットが再実行されたとき，再実行開始点の上位ジョブネットに対して設定されます。ただし，ルートジョブネットが実行中の場合は，ルートジョブネットに再実行開始日時は設定されません。

ルートジョブネットが終了状態の場合は，再実行開始点にルートジョブネットを指定していると，ルートジョブネットにだけ再実行開始日時が設定されます。

注※16

-b，-e，-v，-w，-Bまたは実行ID指定の場合に出力されます。

それ以外の場合は，「00:00:00」と出力されます。

注※17

キューレスジョブの場合は，「***」と出力されます。

注※18

終了状態のジョブネットまたはジョブの場合は，%St「ジョブネットまたはジョブの，実際の実行開始日時」と同じ日時が出力されます。

注※19

終了状態のジョブネットまたはジョブの場合は，%st「ジョブネットまたはジョブの，実際の実行開始日時」と同じ日時が出力されます。

注※20

終了状態のジョブネットまたはジョブの場合は，%E「ジョブネット，またはジョブの実行終了日時」と同じ日時が出力されます。

注※21

終了状態のジョブネットまたはジョブの場合は，%e「ジョブネット，またはジョブの実行終了日時」と同じ日時が出力されます。

注※22

実行シミュレーションした結果が出力されます。実行シミュレーションの詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　4.4.2(2) 実行シミュレーション」を参照ください。

スケジュールを一時変更した場合，変更後の時間で実行シミュレーションを行います。

注※23

ユニットの種別がjob，netcn，または接続先のジョブネットの場合にだけ有効です。

これ以外の場合，「***」と出力されます。

注※24

ユニットの種別がnetの場合にだけ有効です。

これ以外の場合，「なし」（言語種別が英語の場合は「none」）と出力されます。

注※25

ユニットの種別が次に示すものの場合だけ有効です。

net，pjob，job，qjob，evwjb，flwjb，mlwjb，mqwjb，mswjb，lfwjb，ntwjb，tmwjb，evsjb，mlsjb，mqsjb，mssjb，cmsjb，pwljb，pwrjb，cupjb，cuujb，cewj

これ以外の場合，「***」と出力されます。

注※26

ジョブネットまたはジョブの状態が，次に示すものの場合だけ有効です。

「開始時刻待ち」「先行終了待ち」「実行待ち」「保留中」

これ以外の場合，「***」と出力されます。

注※27

ユニットの種別がnetまたはrmnetの場合にだけ有効です。これ以外の場合，「***」と出力されます。

注※28

フレキシブルジョブの場合，次の日時が出力されます。

中継エージェントを使用するとき

中継エージェントの実行開始日時または実行終了日時

中継エージェントを使用しないとき

マネージャーホストの実行開始日時または実行終了日時

注※29

擬似予定，または未計画および閉塞の世代の場合，「***」と出力されます。

注※30

ジョブネットの状態およびジョブの状態については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　6.1 ジョブネット・ジョブ・ジョブネットコネクタの状態」を参照してください。

注※31

エージェント停止やジョブ状態変更などで，実行先のホストでジョブ開始前に終了すると，「***」と出力されることがあります。

表3‒23　ジョブネットとジョブの定義情報を出力する2バイトフォーマット指示子

2バイトフォーマット指示子

出力情報

%SP

サスペンド状態の有無（括弧内は言語種別が英語の場合）

あり（exist）

なし（none）

%OP

ジョブネットの実行日※1

%St

ジョブネットまたはジョブの，実際の実行開始日時※1

%st

ジョブネットまたはジョブの，実際の実行開始日時※1

%Pt

ジョブネットの実行開始予定日時※2，※10

%Jm

ジョブネット完全名，またはジョブ完全名（プランニンググループの下にあるユニットの場合，ルートジョブネット名を省略して出力します）

%Am

AJSPATH=で表される内容（プランニンググループの下にあるユニットの場合，ルートジョブネット名を省略して出力します）

%Jmで表される内容のうち，最右端の「/」より右の部分を除いた内容

%Ed

スケジューラーサービスの起動時に予定時刻が超過した場合の実行抑止※3（括弧内は言語種別が英語の場合）

する（yes）：実行抑止する

しない（no）：実行抑止しない

%cm

コメント※4（80バイト以内の文字列）

%ab

異常終了したジョブを開始してから，ルートジョブネットが終了するまでの実行所要時間の推定値※1，※5

%an

異常終了したジョブの次のユニットを開始してから，ルートジョブネットが終了するまでの実行所要時間の推定値※1，※5

%FG

未来世代数※6（1〜99）

%ds

開始遅延の監視日時※1

%de

終了遅延の監視日時※1，※7

%Ft

保留属性（括弧内は言語種別が英語の場合）

保留する（hold）：保留する

保留しない（not-hold）：保留しない

前回異常時だけ保留（abend-hold）：前回異常時だけ保留する

前回異常警告時だけ保留（warning-hold）：前回異常警告時だけ保留する

保留設定（hold-set）：一時的に保留属性が設定されている，または即時実行登録時に保留が設定されている

保留解除（hold-release）：一時的に保留属性が解除されている

%MV

ジョブネット実行登録時に指定したマクロ変数名と引き継ぎ情報，またはジョブ実行時に引き継いだマクロ変数名と引き継ぎ結果情報※1，※4，※8，※9，※21

%CN

接続相手のユニット完全名※11，※14

ジョブネットコネクタを指定した場合，接続先のジョブネットのユニット完全名

接続先のジョブネットを指定した場合，ジョブネットコネクタのユニット完全名

%CI

接続相手の実行ID※11，※12

ジョブネットコネクタを指定した場合，接続先のジョブネットの実行ID

接続先のジョブネットを指定した場合，ジョブネットコネクタの実行ID

%CS

接続先のジョブネットの実行順序制御方式※13

%CH

接続相手のホスト名※11，※15

ジョブネットコネクタに指定した場合，接続先のジョブネットのホスト名

接続先のジョブネットに指定した場合，ジョブネットコネクタのホスト名

%CF

接続相手のスケジューラーサービス名※11，※15

ジョブネットコネクタに指定した場合，接続先のジョブネットのスケジューラーサービス名

接続先のジョブネットに指定した場合，ジョブネットコネクタのスケジューラーサービス名

%RI

リリースID※16

%so

標準出力ファイル名※17，※18

標準出力を出力しないユニット（ORジョブ，判定ジョブ，イベントジョブ，カスタムイベントジョブ，ジョブネットコネクタ，接続先のジョブネット）を指定した場合や，実行していないユニットを指定した場合など，標準出力ファイルがない場合でも，仮定された標準出力ファイル名が出力されます。

外部DBを利用している場合は，環境設定パラメーターSTDFILEOUTDIRに指定されたディレクトリに標準出力ファイルを作成し，標準出力ファイル名を標準出力に出力します。

%PW

待ち合わせ条件の不成立の有無（括弧内は言語種別が英語の場合）

あり（exist）：待ち合わせ条件が成立していない

なし（none）：待ち合わせ条件が成立している

***：待ち合わせ条件が定義されていない

%RY

リトライ実行回数※19

%RC

リトライ状態（括弧内は言語種別が英語の場合）

リトライ待ち（wait）：

ジョブの実行ファイルがエラーになって，リトライ間隔に設定した時間が経過するのを待っている状態

リトライ実行中（exec）：

リトライ実行によって，ジョブが実行中の状態

リトライ終了（end）：

リトライ実行によるジョブの実行が終了した状態

***：

リトライ実行されていない

%RS

リトライ登録日時※1，※20

リトライ実行によるジョブのサブミット日時（年月日時分を出力）

%Rs

リトライ登録日時※1，※20

リトライ実行によるジョブのサブミット日時（年月日時分秒を出力）

%RT

リトライ開始日時※1

リトライ実行による実行開始日時（年月日時分を出力）

%Rt

リトライ開始日時※1

リトライ実行による実行開始日時（年月日時分秒を出力）

注

表3-22に示したフォーマット指示子については，英字を2文字続けると，2バイトフォーマット指示子として指定できます。例えば，「%S」の場合は，「-i %SS」と指定できます（-f，-tオプションには，2バイトフォーマット指示子は指定できません。「-f %JJ」「-t %JJ」「-f %SP」などと指定することはできません）。

注※1

出力形式については，表3-25を参照してください。

注※2

ユニットがジョブネットの場合にだけ有効です。ジョブネット以外の場合，「*」と出力されます。

注※3

ユニットの種別がnet，netcn，rmnet，またはhlnetの場合にだけ有効です。

これら以外の場合，「***」と出力されます。

注※4

文字列の先頭と最後に「"（ダブルクォーテーションマーク）」が出力されます。

出力する値がない場合は「""」だけが出力されます。

注※5

-b，-e，-v，-wオプションを指定した場合にだけ，ルートジョブネットを実行登録してからの実行結果を基に，推定所要時間を算出します。異常終了しているジョブが含まれている世代で，一度も実行していないジョブの推定所要時間は，1分が仮定されます。すでに正常終了しているジョブの，推定所要時間は0秒になります。なお，未実行終了となったユニットの情報は，-b，-eオプションでは出力されません。未実行終了のユニットの情報を出力する場合は-v，-wオプションを使用してください。

推定所要時間については，後述の「補足事項3」を参照してください。

注※6

実行登録時に未来世代数が指定されていなかった場合は「***」と出力されます。世代番号が0のルートジョブネットの情報です。

注※7

実行所要時間による終了遅延監視の監視日時は出力されません。「*」で出力されます。

注※8

ユニットの種別がルートジョブネット（リモートジョブネットを除く）またはジョブの場合にだけ有効です。

これら以外の場合，「***」と出力されます。

注※9

擬似予定の場合，「""」と出力されます。

注※10

スケジュールされている日時を出力します。スケジュールを一時変更した場合，変更後のスケジュールを出力します。

注※11

ユニットの種別がジョブネットコネクタおよびジョブネット（接続先のジョブネット）の場合にだけ有効です。

それ以外の場合，「***」と出力されます。また，ジョブネットコネクタおよび接続先のジョブネットに対して参照権限がない場合も「***」と出力されます。

ジョブネットコネクタおよび接続先のジョブネットの接続相手に不正ユニットが指定されている場合，接続相手の実行ID，ユニット完全名，ホスト名，スケジューラーサービス名は表示されますが，実行時には定義不正のため，異常検出終了になります。

定義不正がないかを確認するには，ajschkdefコマンドにジョブネットコネクタを指定してください。ajschkdefコマンドについては，「3. 通常の運用で使用するコマンド　ajschkdef」およびマニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　8. 定義内容の事前チェック」を参照してください。

注※12

ジョブネットコネクタと接続先のジョブネットが異なるホストまたは異なるスケジューラーサービスに定義されている場合，予定世代については「***」と出力されます。

異なるホストまたは異なるスケジューラーサービスでジョブネットコネクタおよび接続先のジョブネットの実行IDを確認する手順については，後述の「補足事項4」を参照してください。

注※13

接続先のジョブネットの場合にだけ有効です。それ以外の場合，「***」と出力されます。

注※14

［接続範囲］を［別サービス］とした場合，ユニットに定義した内容が出力されます。

注※15

［接続範囲］を［同一サービス］とした場合，「***」と出力されます。

注※16

リリース登録されたルートジョブネット（リリース先ジョブネット）およびその配下のユニットの場合，リリースIDが出力されます。これら以外の場合，「***」と出力されます。

注※17

ユニットの種別が次に示すものの場合だけ有効です。

net，pjob，job，qjob，evwjb，flwjb，mlwjb，mqwjb，mswjb，lfwjb，ntwjb，tmwjb，evsjb，mlsjb，mqsjb，mssjb，cmsjb，pwljb，pwrjb，cupjb，cuujb，orjob，jdjob，netcn，cewj

これ以外の場合，「***」と出力されます。

注※18

擬似予定の場合，「***」と出力されます。

注※19

リトライ実行されていない場合は，「0」と出力されます。自動リトライ対象外のユニットの場合は「***」と出力されます。

注※20

ジョブの場合，サブミットした時刻が出力されます。キューレスジョブの場合，ジョブ実行要求時刻が出力されます。

注※21

マクロ変数で引き継いだ結果の詳細についてはマニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　2.2.6(2)(b) マクロ変数で引き継いだ結果の確認」を参照してください。

表3‒24　その他のフォーマット指示子

フォーマット指示子

出力情報

%%

％

%n

改行文字

%t

タブ文字

%x

現在の日※

%X

現在の時刻※

注※

ajsshowコマンドの実行開始日時です。なお，出力形式については，次の表を参照してください。

表3‒25　フォーマット指示子の出力形式

フォーマット指示子

出力形式

日本語

英語

%D

%P

%S

%E

%K

%V

%Q

%B

%O

%m

%St

%Pt

%ds

%de

%RS

%RT

YYYY/MM/DD hh:mm

MM，DD，hh，mmの出力けた数が足りない場合は，前にゼロを付けて出力されます。

（例）

2009/07/01 12:30

ただし，ユニットに表示できる情報がない場合，「****/**/** **:**」と出力されます。

MMM DD YYYY hh:mm

DDの出力けた数が足りない場合は，前にスペースが出力されます。

hh，mmの出力けた数が足りない場合は，前にゼロを付けて出力されます。

（例）

Jul 1 2009 12:30

ただし，ユニットに表示できる情報がない場合，「*** ** **** **:**」と出力されます。

%s

%e

%k

%b

%o

%v

%w

%st

%Rs

%Rt

YYYY/MM/DD hh:mm:ss

MM，DD，hh，mmの出力けた数が足りない場合は，前にゼロを付けて出力されます。

（例）

2009/07/01 12:30:00

ただし，ユニットに表示できる情報がない場合，「****/**/** **:**:**」と出力されます。

MMM DD YYYY hh:mm:ss

DDの出力けた数が足りない場合は，前にスペースが出力されます。

hh，mmの出力けた数が足りない場合は，前にゼロを付けて出力されます。

（例）

Jul 1 2009 12:30:00

ただし，ユニットに表示できる情報がない場合，「*** ** **** **:**:**」と出力されます。

%x

%OP

YYYY/MM/DD

MM，DD，hh，mmの出力けた数が足りない場合は，前にゼロを付けて出力されます。

（例）

2009/07/01

ただし，ユニットに表示できる情報がない場合，「****/**/**」と出力されます。

MMM DD YYYY

DDの出力けた数が足りない場合は，前にスペースが出力されます。

（例）

Jul 1 2009

ただし，ユニットに表示できる情報がない場合，「*** ** ****」と出力されます。

%X

%a

%ab

%an

hh:mm:ss

（例）

12:30:30

%l

YYYYMMDDNNN

（例）実行登録番号が20090701001のジョブ

20090701001

%MV

"情報1:情報2"[,"情報1:情報2"[...]]

情報1：マクロ変数名

情報2：引き継ぎ情報，または引き継ぎ結果情報

（例1）ルートジョブネットの場合

"AJS2ENV:/data/job_report","AJS2COM:c:¥temp¥test.exe"

（例2）ジョブの場合

"AJS2ENV:/data/job_report","AJS2COM:c:¥temp¥test.exe"

補足事項2

プランニンググループの下にあるユニットの中から操作するユニットを自動的に選択する場合と選択しない場合とで，出力情報の違いを次の表に示します。

表3‒26　プランニンググループの下にあるユニットの中から操作するユニットを自動的に選択する場合と選択しない場合の出力情報の違い

フォーマット指示子

操作するユニットを自動的に選択する場合

操作するユニットを自動的に選択しない場合

%p

%P

%M

プランニンググループの下にあるユニットの中で，次回の実行予定のユニットの情報

指定したユニットの次回の実行予定

%G

プランニンググループの下にあるルートジョブネットの実行情報を統合した結果から求めた世代番号

指定したユニットだけの世代番号

%l

プランニンググループの下にあるルートジョブネットの実行情報を統合した結果から求めた実行登録番号

指定したユニットだけの実行登録番号

%Y

%a

この情報はユニットごとに持っている情報です。操作する自動的にユニットを選択する機能を指定した場合でも，ユニットごとの情報が出力されます。

%B

%b

%O

%o

処理サイクルの計算から求める情報は，個々のユニットごとに持つ情報を基に計算します。操作するユニットを自動的に選択する機能を指定した場合でも，ユニットごとの情報が出力されます。

次に示すプランニンググループの定義例を使って，-Xオプションの指定の違いによる「%P」「%G」「%l」の出力情報の違いを示します。

プランニンググループ定義例

プランニンググループ（/group1）下に，三つのユニット（/group1/jobnet001，/group1/jobnet002，/group1/jobnet003）があります。

各ユニットの開始予定時刻は次のとおりとします。

/group1/jobnet001の開始予定時刻は08:00（絶対時刻）。

/group1/jobnet002 の開始予定時刻は09:00（絶対時刻）。

/group1/jobnet003 の開始予定時刻は10:00（絶対時刻）。

とします。

（例1）

-Xオプションにyesを指定した場合の「%P」の出力情報

ajsshow -f "次回予定＝%P %C %J" -g  1 -X yes  /group1

出力結果

次回予定＝20XX/08/13 08:00 正常終了 /group1/jobnet003

解説

この場合は，プランニンググループの下にあるルートジョブネットの中で，次回実行予定のユニット（/group1/jobnet001）の次回実行開始時刻が出力されます。

（例2）

-Xオプションにnoを指定した場合「%P」の出力情報

ajsshow -f "次回予定＝%P %C %J" -g  1 -X no  /group1/jobnet003

出力結果

次回予定＝20XX/08/15 10:00 正常終了 /group1/jobnet003

解説

この場合は，指定したユニット（group1/jobnet003）の次回実行開始予定時刻を出力します。

（例3）

-Xオプションにyesを指定した場合の「%G」の出力情報

ajsshow -f "世代＝%G 開始時刻＝%S %C %J" -g  3 -X yes  /group1

出力結果

世代＝1 開始時刻＝20XX/08/12 10:00 正常終了 /group1/jobnet003
世代＝2 開始時刻＝20XX/08/11 09:00 正常終了 /group1/jobnet002
世代＝3 開始時刻＝20XX/08/10 08:00 正常終了 /group1/jobnet001

解説

この場合，プランニンググループの下にあるルートジョブネットの実行情報を統合した結果から求めた世代番号が出力されます。

（例4）

-Xオプションにnoを指定した場合の「%G」の出力情報

ajsshow -f "世代＝%G 開始時刻＝%S %C %J" -g  3 -X  no  /group1/jobnet001

出力結果

世代＝1 開始時刻＝20XX/08/10 08:00 正常終了 /group1/jobnet001
世代＝2 開始時刻＝20XX/08/07 08:00 正常終了 /group1/jobnet001
世代＝3 開始時刻＝20XX/08/04 08:00 正常終了 /group1/jobnet001

解説

この場合は，指定したユニットの実行情報を基にした世代番号が出力されます。

（例5）

-Xオプションにyesを指定した場合の「%l」の出力情報

ajsshow -f "登録番号＝%l 開始時刻＝%S %C %J" -b 20XX/8/3  -X yes  /group1

出力結果

登録番号＝20XX0803001 開始時刻＝20XX/08/03 08:00 正常終了 /group1/jobnet001
登録番号＝20XX0803002 開始時刻＝20XX/08/03 09:00 正常終了 /group1/jobnet002
登録番号＝20XX0803003 開始時刻＝20XX/08/03 10:00 正常終了 /group1/jobnet003

解説

この場合は，プランニンググループの下にあるルートジョブネットの実行情報を統合した結果から求めた実行登録番号が出力されます。

（例6）

-Xオプションにnoを指定した場合の「%l」の出力情報

ajsshow -f "登録番号＝%l 開始時刻＝%S %C %J" -b 20XX/8/3  -X no  /group1/jobnet003

出力結果

登録番号＝20XX0803001 開始時刻＝20XX/08/03 10:00 正常終了 /group1/jobnet003

解説

この場合は，指定したジョブネットの実行情報を基にした実行登録番号が出力されます。

補足事項3

異常終了したジョブの推定所要時間を算出する例を次に示します。

（例1）

異常終了したジョブをすぐに再実行するかどうかを判断するときの推定所要時間の算出方法を，次のジョブネット構成例を使って示します。

ジョブ（/jobnet1/nestjobnet001/job3）とジョブ（/jobnet1/nestjobnet002/job2）が異常検出終了しています。

-v，-wオプションを指定した場合の「%ab」の出力情報および出力結果を次に示します。

出力情報

ajsshow -i "推定所要時間＝%ab UnitName=%JJ" -v 20XX/2/12 -w 20XX/8/12 -RN /jobnet1

出力結果

推定所要時間＝07:00:00 UnitName＝/jobnet1
推定所要時間＝07:00:00 UnitName＝/jobnet1/nestjobnet001
推定所要時間＝03:00:00 UnitName＝/jobnet1/nestjobnet002

解説

出力結果から，jobnet001は7時間掛かるためこのユニット（jobnet1/nestjobnet001）だけを夜間に再実行する，またはnestjobnet002は3時間で終わるためこのユニット（jobnet1/nestjobnet002）だけを今すぐに再実行する，などの判断ができます。

（例2）

異常終了したジョブの後続のジョブネットに，実行開始予定時刻が指定されているとします。このとき，再実行開始によってジョブが終了した時刻が，後続ジョブネットの実行開始予定時刻より前の場合とあとの場合とで，推定所要時間の計算値が変わることがあります。

再実行開始によるジョブの終了時刻が後続ジョブネットの実行開始予定時刻より前の場合

ジョブ（/jobnet1/nestjobnet001/job2）が異常検出終了しています。後続ジョブネット（/jobnet1/nestjobnet002）の開始予定時刻は05:00です。

03:00から再実行を開始するとした場合，ジョブ（/jobnet1/nestjobnet001/job2）が03:00〜04:00に実行され，nestjobnet001は04:00に終了します。その後，nestjobnet002は開始予定時刻の05:00になるまで待ち，05:00に実行されて07:00に終了します。出力情報および出力結果を次に示します。

出力情報

ajsshow -i "推定所要時間＝%ab UnitName＝%JJ" -v 20XX/8/21 -w 20XX/8/21 -d 20XX/8/21 -h 3:00 -RN /jobnet1

出力結果

推定所要時間＝04:00:00 UnitName＝/jobnet1
推定所要時間＝01:00:00 UnitName＝/jobnet1/nestjobnet001
推定所要時間＝02:00:00 UnitName＝/jobnet1/nestjobnet002

解説

出力結果から，jobnet1の推定所要時間は3:00〜7:00ということで，4時間と算出されます。

再実行開始によるジョブの終了時刻が後続ジョブネットの実行開始予定時刻よりあとの場合

ジョブ（/jobnet1/nestjobnet001/job2）が異常検出終了しています。後続ジョブネット（/jobnet1/nestjobnet002）の開始予定時刻は05:00です。

05:00から再実行を開始するとした場合，ジョブ（/jobnet1/nestjobnet001/job2）が05:00〜06:00に実行され，nestjobnet001は06:00に終了します。このとき，開始予定時刻の05:00を過ぎているnestjobnet002が直ちに実行されて08:00に終了します。出力情報および出力結果を次に示します。

出力情報

ajsshow -i "推定所要時間＝%ab UnitName＝%JJ" -v 20XX/8/21 -w 20XX/8/21 -d 20XX/8/21 -h 5:00 -RN /jobnet1

出力結果

推定所要時間＝03:00:00 UnitName＝/jobnet1
推定所要時間＝01:00:00 UnitName＝/jobnet1/nestjobnet001
推定所要時間＝02:00:00 UnitName＝/jobnet1/nestjobnet002

解説

出力結果から，jobnet1の推定所要時間は5:00〜8:00ということで，3時間と算出されます。

このように，推定所要時間を算出する際に-d，-hオプションを指定することで，何時から再実行を開始したら所要時間がどれだけ掛かるのかを算出できます。

補足事項4

ジョブネットコネクタと接続先のジョブネットコネクタが異なるホストまたは異なるスケジューラーサービスに定義されている場合，-iオプションで「%CI」を指定しても「***」と出力されます。

異なるホストまたは異なるスケジューラーサービスで，ジョブネットコネクタおよび接続先のジョブネットの実行IDを確認したい場合は，次の手順でajsshowコマンドをリモート実行してください。

ajsshowコマンドをリモート実行し，接続相手のホスト名，スケジューラーサービス名，およびユニット完全名を求める。

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

ajsshow -v 20XX/07/01 -i "%CH %CF %CN" ユニット名

手順1で出力された情報を基に，接続相手の実行IDを求める。

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

手順1で出力されたホスト名:手順1で出力されたスケジューラーサービス名:ajsshow -v 20XX/07/01 -i "%CI" ユニット名

補足事項5

-gオプションにaを指定した場合，起動条件を設定したジョブネットの実行結果情報は，開始予定日時の遅い世代から順に出力されます。

起動条件が設定されているジョブネットを実行登録した場合，開始時刻に到達すると，起動条件を監視する世代が作成されます。これと同時に起動条件待ち状態の世代が作成され，起動条件が成立するとこの世代が実行されます。

起動条件待ちの世代も起動条件成立によって実行した世代も，監視中の世代と同じ開始予定日時が仮定されます。起動条件を使用する運用と，起動条件を使用しない運用を併用している場合は，実行結果情報の出力順に注意してください。

保存世代数が「10」の場合で，ジョブネット（net）を起動条件を設定して実行登録後，起動条件を設定しないで実行登録したときの例を次に示します。

この例では，ジョブネット（net）を3/1に起動条件を設定して実行登録し，起動条件を監視する世代が作成されています（図中の1-0）。同時に起動条件待ち状態の世代が作成され，それぞれ3/2，3/4，3/5に起動条件が成立して実行されています（図中の1-1，1-2，1-3）。

また，3/3にジョブネット（net）の起動条件を設定しないで実行登録しています（図中の2）。

出力情報

ajsshow -f "世代=%G %J %# %C" -g a -T /net

出力結果

世代=1 /net @A103 正常終了
世代=2 /net @A105 起動条件待ち※
世代=3 /net @A104 正常終了※
世代=4 /net @A102 正常終了※
世代=5 /net @A101 正常終了※
世代=6 /net @A100 監視中※

注※　起動条件を設定した世代の実行結果情報です。

解説

ajsshowコマンドで実行結果情報を出力した場合，ジョブネット（net）の最新の実行結果として世代1には3/3に実行登録したジョブネットの実行結果が出力されます。また，世代2から世代6には3/1に起動条件を設定して実行登録したジョブネットの実行結果が，最後に起動条件成立した世代から順番に出力されます。

使用例1

ジョブネット（net1），およびそのジョブネット中のジョブネットやジョブの実行結果を標準出力ファイルに出力します。

ajsshow -l net1

使用例2

ジョブグループ（group1）に含まれるジョブネットの実行結果を2世代分出力します。表示する情報は，ジョブネット完全名，実行開始日時，および実行終了日時です。

ajsshow -t"世代: %G" -g2 -f"%J %S %E" -RE /group1

出力例

世代: 1
/group1/net1 20XX/06/08  10:00 20XX/06/08  12:00
世代: 2
/group1/net1 20XX/06/01  10:00 20XX/06/01  11:30
世代: 1
/group1/net2 20XX/06/08  11:00 20XX/06/08  11:30
世代: 2
/group1/net2 20XX/06/01  11:00 20XX/06/01  12:00

使用例3

ジョブネット（net）の2009年7月分（2009/7/1〜2009/7/31）の実行予定情報（ジョブネット名，世代番号，実行開始日時の予定）を出力します。同時に，タイトル行に出力対象の期間も表示します。

ajsshow -t"◆◆期間◆◆%v〜%w" -f" %j %G %B" -b 2009/7/1 -e 2009/7/31 /net

出力例

◆◆期間◆◆2009/7/1  00:00:00〜2009/7/31 23:59:59
 net -5  2009/7/7   10:00
◆◆期間◆◆2009/7/1  00:00:00〜2009/7/31 23:59:59
 net -6  2009/7/14  10:00
◆◆期間◆◆2009/7/1  00:00:00〜2009/7/31 23:59:59
 net -7  2009/7/21  10:00
◆◆期間◆◆2009/7/1  00:00:00〜2009/7/31 23:59:59
 net -8  2009/7/31  10:00

使用例4

実行登録番号が20090701001であるジョブネット（net）中のジョブ（job1）の，標準エラー出力ファイル名を出力します。環境設定パラメーターJOBINFDIRには，ジョブエラー情報ディレクトリ（/var/opt/jp1ajs2/jobinf）が定義されています。

ajsshow -B 20090701001 -r /net/job1

出力例

/var/opt/jp1ajs2/jobinf/e/67/0.e.err

使用例5

次に示すジョブネット（net）およびジョブネット下のジョブ（job1，job2，job3）について，-b，-e，-v，-wオプションで期間を指定し，実行開始日時および実行終了日時を出力します。

-b，-eオプションに2009/7/21を指定した場合

ajsshow -b 2009/07/21 -e 2009/07/21  -f "%S %E %J"  -R /net

出力例

2009/07/21 10:00 2009/07/22 06:00 /net
2009/07/21 16:00 2009/07/21 21:00 /net/job1
2009/07/21 21:00 2009/07/22 02:00 /net/job2

解説

暦日が出力対象になります。

2009/07/21に実行が開始するnet，およびnet下のjob1，job2の情報が出力されます。

-v，-wオプションに2009/07/21を指定した場合

ajsshow -v 2009/07/21 -w 2009/07/21  -f "%S %E %J"  -R /net

出力例

2009/07/21 10:00 2009/07/22 06:00 /net
2009/07/21 16:00 2009/07/21 21:00 /net/job1
2009/07/21 21:00 2009/07/22 02:00 /net/job2
2009/07/22 02:00 2009/07/22 06:00 /net/job3

解説

ジョブネットの実行日が出力対象になります。

netの実行日が2009/07/21なので，netおよびnet下の三つのジョブの情報が出力されます。

-b，-eオプションに2009/07/22を指定した場合

ajsshow -b 2009/07/22 -e 2009/07/22  -f "%S %E %J"  -R /net

出力例

2009/07/21 10:00 2009/07/22 06:00 /net
2009/07/21 21:00 2009/07/22 02:00 /net/job2
2009/07/22 02:00 2009/07/22 06:00 /net/job3

解説

暦日が出力対象になります。

2009/07/22に実行が終了するjob2，および実行が開始するjob3の情報が出力されます。

-v，-wオプションに2009/07/22を指定した場合

ajsshow -v 2009/07/22 -w 2009/07/22  -f "%S %E %J"  -R -/net

解説

ジョブネットの実行日が出力対象になります。

netの実行日は2009/07/21であるため，-v，-wオプションに2009/07/22を指定しても，情報は何も出力されません。

使用例6

-iオプションで，ジョブネットコネクタおよび接続先のジョブネットの情報を出力します。

ジョブネットコネクタ

ホスト名：HOSTA

スケジューラーサービス名：AJSROOT1

ユニット名：/JC/ジョブネットコネクタ

実行ID：@A544

接続先のジョブネット

ホスト名：HOSTB

スケジューラーサービス名：AJSROOT2

ユニット名：/JC-NET

実行ID：@A546

-iオプションでジョブネットコネクタを指定した場合

ajsshow -i "%JJ %TT %CH %CF %CN %CI %CS" /JC/ジョブネットコネクタ

出力例

/JC/ジョブネットコネクタ netcn HOSTB AJSROOT2 /JC-NET @A546 ***

-iオプションで接続先のジョブネットを指定した場合

ajsshow -i "%JJ %TT %CH %CF %CN %CI %CS" /JC-NET

出力例

/JC-NET net HOSTA AJSROOT1 /JC/ジョブネットコネクタ @A544 非同期

使用例7

2009/08/06〜2009/08/07に実行する，ジョブネット（net）中のジョブ（job1）の標準出力ファイル名を出力します。環境設定パラメーターJOBINFDIRには，ジョブ情報格納ディレクトリ（C:¥Program Files¥HITACHI¥JP1AJS2¥jobinf）が定義されています。

ajsshow -b 2009/08/06 -e 2009/08/07 -i "%so" /net/job1

出力例

C:¥Program Files¥HITACHI¥JP1AJS2¥jobinf¥d¥6e¥0.e.std

使用例8

次の図のジョブネットを，7/1は起動条件を使用するように，7/2は起動条件を使用しないように実行登録した場合の，-xiオプションの使用例について説明します。

図中のジョブネット（netB）の情報を出力します。

（例1）-xi bオプションを指定して，すべての世代を出力する場合

ajsshow -xw -xi b -g a /netB

出力例

解説

監視世代，実行世代，および起動条件を使用しない世代の情報を出力します。出力対象は図中の世代番号1〜4です。ただし，世代番号2および3は実行世代であり，待ち合わせ情報がないため，ajsshowコマンドは異常終了します。

（例2）-xi cオプションを指定して，すべての世代を出力する場合

ajsshow -xw -xi c -g a /netB

出力例

解説

監視世代，および起動条件を使用しない世代の情報を出力するため，出力対象は図中の世代番号1および4です。世代番号2および3は，実行世代なので，出力対象になりません。

出力例1

-sオプションを指定した場合

-pオプションを指定した場合

-lオプションを指定した場合

出力項目の説明（括弧内は言語種別が英語の場合）

AJSPATH=

ジョブネット完全名，またはジョブ完全名の内容から，「名称」で表示するジョブネット名，またはジョブ名を除いた内容を示します。

名称（Name）

ジョブネット名，またはジョブ名を示します。

種別（Type）

ユニットの種別を示します。

mgroup：マネージャージョブグループ

group：ジョブグループ

mnet：マネージャージョブネット

condn：起動条件（.CONDITION）

net：ジョブネット

rnet：リカバリージョブネット

rmnet：リモートジョブネット

rrnet：リカバリーリモートジョブネット

job：UNIXジョブ

rjob：リカバリーUNIXジョブ

pjob：PCジョブ

rpjob：リカバリーPCジョブ

qjob：QUEUEジョブ

rqjob：リカバリーQUEUEジョブ

jdjob：判定ジョブ

rjdjob：リカバリー判定ジョブ

orjob：ORジョブ

rorjob：リカバリーORジョブ

cmsjb：JP1/Cm2状態通知ジョブ

rcmsjb：リカバリーJP1/Cm2状態通知ジョブ

evwjb：JP1イベント受信監視ジョブ

revwjb：リカバリーJP1イベント受信監視ジョブ

flwjb：ファイル監視ジョブ

rflwjb：リカバリーファイル監視ジョブ

mlwjb：メール受信監視ジョブ

rmlwjb：リカバリーメール受信監視ジョブ

mqwjb：メッセージキュー受信監視ジョブ

rmqwjb：リカバリーメッセージキュー受信監視ジョブ

mswjb：MSMQ受信監視ジョブ

rmswjb：リカバリーMSMQ受信監視ジョブ

lfwjb：ログファイル監視ジョブ

rlfwjb：リカバリーログファイル監視ジョブ

ntwjb：Windowsイベントログ監視ジョブ

rntwjb：リカバリーWindowsイベントログ監視ジョブ

tmwjb：実行間隔制御ジョブ

rtmwjb：リカバリー実行間隔制御ジョブ

evsjb：JP1イベント送信ジョブ

revsjb：リカバリーJP1イベント送信ジョブ

mlsjb：メール送信ジョブ

rmlsjb：リカバリーメール送信ジョブ

mqsjb：メッセージキュー送信ジョブ

rmqsjb：リカバリーメッセージキュー送信ジョブ

mssjb：MSMQ送信ジョブ

rmssjb：リカバリーMSMQ送信ジョブ

pwljb：ローカル電源制御ジョブ

rpwljb：リカバリーローカル電源制御ジョブ

pwrjb：リモート電源制御ジョブ

rpwrjb：リカバリーリモート電源制御ジョブ

cuujb：カスタムUNIXジョブ

rcuujb：リカバリーカスタムUNIXジョブ

cupjb：カスタムPCジョブ

rcupjb：リカバリーカスタムPCジョブ

netcn：ジョブネットコネクタ

n：ジョブグループ

p：プランニンググループ

fxj：フレキシブルジョブ

rfxj：リカバリーフレキシブルジョブ

htpjb：HTTP接続ジョブ

rhtpjb：リカバリーHTTP接続ジョブ

cewjb：カスタムイベントジョブ

rcewjb：リカバリーカスタムイベントジョブ

状態（Status）

ジョブネットの状態，またはジョブの状態を示します。

次回実行予定（Plan）

表示したジョブネット，またはジョブの次回実行予定の有無を示します。

括弧内は言語種別が英語の場合の表示です。

あり（exist）：次回実行予定あり

なし（none）：次回実行予定なし

登録者（Registrant）

ジョブネットを実行登録したユーザー名を示します。

登録日時（Registered time）

ジョブネットを実行登録した日時を示します。

次回実行予定日時（Next execution time）

次回実行予定日時を示します。

次回実行予定がない場合は，****/**/** **:**と示します。

実行方法（Method）

次回実行方法を示します。

括弧内は言語種別が英語の場合の表示です。

スケジュール（schedule）：計画実行スケジュールに従って実行する

一時変更（plan）：計画を一時変更して実行する

振り替え（shift）：振り替えて実行する

コード（Code）

戻り値，またはシグナルで打ち切られた場合はそのシグナルコードを示します。

戻り値，またはシグナルコードがない場合は，***と示します。

実行開始日時（Start time）

実行開始日時を示します。

実行が開始していない場合は，****/**/** **:**と示します。

実行終了日時（End time）

実行終了日時を示します。

実行が終了していない場合は，****/**/** **:**と示します。

出力例2

-xwオプションと-xi bオプションを指定した場合

-xwオプションと-xi cオプションを指定した場合

出力項目の説明（括弧内は言語種別が英語の場合）

AJSPATH=

ジョブネット完全名，またはジョブ完全名の内容から，待ち合わせ条件付きユニットの「名称」で表示するジョブネット名，またはジョブ名を除いた内容を示します。

待ち合わせ条件付きユニット（An unit with wait condition）

待ち合わせ条件付きユニットの情報を示します。

名称（Name）

待ち合わせ条件付きユニットのジョブネット名，またはジョブ名を示します。

世代（Generation）

待ち合わせ条件付きユニットの世代番号を示します。なお，未来世代を指定した場合は，マイナスの値で出力されます。

実行ID（Execution ID）

待ち合わせ条件付きユニットの実行IDを示します。

状態（Status）

待ち合わせ条件付きユニットの状態を示します。

待ち合わせ条件付きユニットが起動条件付きジョブネットの場合，監視世代の状態を示します。

待ち合わせ方法（Wait method）

待ち合わせ方法を示します。

AND：すべての待ち合わせが完了したら，待ち合わせ条件が成立します。

OR：一つでも待ち合わせが完了したら，待ち合わせ条件が成立します。

待ち合わせる世代がない場合（No generations to wait for）

待ち合わせ対象ユニットに待ち合わせる世代がない場合の，待ち合わせ条件付きユニットの動作を示します。

実行を開始する（Execute）：待ち合わせ対象ユニットに待ち合わせる世代がない場合，待ち合わせ条件付きユニットは実行を開始します。

実行を開始しない（Do not execute）：待ち合わせ対象ユニットに待ち合わせる世代がない場合，待ち合わせ条件付きユニットは実行を開始しないで待ち続けます。

監視未起動終了の場合（When Unmonitored + Ended）

待ち合わせ条件付きユニットが起動条件付きジョブネットで，監視世代が「監視未起動終了」状態の場合の，待ち合わせ条件付きユニットの動作を示します。

実行を開始する（Execute）：監視世代が「監視未起動終了」状態の場合，待ち合わせ条件付きユニットは実行を開始します。

実行を開始しない（Do not execute）：監視世代が「監視未起動終了」状態の場合，待ち合わせ条件付きユニットは実行を開始しません。

実行世代に異常終了がある場合（Abnormal end for an execution generation）

待ち合わせ条件付きユニットが起動条件付きジョブネットで，実行世代に異常終了がある場合の待ち合わせ条件付きユニットの動作を示します。

実行を開始する（Execute）：実行世代に異常終了がある場合，待ち合わせ条件付きユニットは実行を開始します。

実行を開始しない（Do not execute）：実行世代に異常終了がある場合，待ち合わせ条件付きユニットは実行を開始しません。

待ち合わせ状態（Wait status）

待ち合わせ対象ユニットとの待ち合わせ状態を示します。

未完了（Incomplete）：待ち合わせは完了していません。

完了（Complete）：待ち合わせは完了しました。

未完了（手動）（Incomplete_manually）：待ち合わせ有効化操作によって，待ち合わせは未完了と見なされます。

完了（手動）（Complete_manually）：待ち合わせ無効化操作によって，待ち合わせは完了したものと見なされます。

未完了（再実行）（Incomplete_rerun）：待ち合わせ対象ユニットは終了状態ですが，後続ユニットの再実行時に異常終了から変更された状態のため，待ち合わせは未完了と見なされます。

待ち合わせ対象ユニット（Unit whose end is being waited for）

待ち合わせ対象ユニットの情報を示します。

状態（Status）

待ち合わせ対象ユニットの状態を示します。待ち合わせ対象にプランニンググループを設定していた場合，実際に待ち合わせるプランニンググループ配下のユニットの状態を示します。

次の場合，「***」を出力します。

待ち合わせ対象ユニットの定義不正

待ち合わせ対象ユニットに待ち合わせる世代がない

待ち合わせ対象ユニットが未登録

実行ID（Execution ID）

待ち合わせ対象ユニットの実行IDを示します。待ち合わせ対象にプランニンググループを設定していた場合，実際に待ち合わせるプランニンググループ配下のユニットの実行IDを示します。

次の場合，「***」を出力します。

待ち合わせ対象ユニットの定義不正

待ち合わせ対象ユニットに待ち合わせる世代がない

待ち合わせ対象ユニットが未登録

コメント（Comment）

待ち合わせ対象ユニットのコメントを示します。待ち合わせ対象にプランニンググループを設定していた場合，実際に待ち合わせるプランニンググループ配下のユニットのコメントを示します。

次の場合，「***」を出力します。

待ち合わせ対象ユニットの定義不正

待ち合わせ対象ユニットに待ち合わせる世代がない

待ち合わせ対象ユニットが未登録

待ち合わせ対象ユニットに対して参照権限がない

名称（Name）

待ち合わせ対象ユニットの完全名を示します。

ajsstart

形式

ajsstart
     [-c|-o|-t]
     [-F サービス名]
     [-s {none|EXEC}]
     [-w]
     [-R]
     [-D]

機能

JP1/AJS3のスケジューラーサービスを起動します。その後，実行登録済みのジョブネットを実行します。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-c

すべてのジョブネットの実行登録を強制的に解除して，スケジューラーサービスを起動します（コールドスタートします）。

コールドスタートが必要な場合を次に示します。

JP1/AJS3のスケジューラーの，データベースのテーブル構造が変更された場合。

スケジューラーサービスが起動できない場合。

スケジューラーサービスをコールドスタートした場合，スケジューラーサービスの起動後に，ジョブネットを再実行登録してください。

なお，スケジューラーサービスをコールドスタートすると，すべてのジョブネットの前世代までの実行結果がすべて削除されます。コールドスタートする前に，必要な履歴情報を保存しておくことを推奨します。

このオプションは-Rおよび-Dオプションと同時には指定できません。

-c，-R，および-Dオプションのどれも指定しなかった場合は，スケジューラーサービスをウォームスタートします。

-o

その日に実行予定があるジョブネットの場合で，実行開始予定時間がスケジューラーサービスの起動時間より前のジョブネットは，スケジューラーサービス起動時に実行しません。

このオプションを省略した場合，実行開始予定時間がスケジューラーサービスの起動時間より前のジョブネットを，スケジューラーサービス起動時に自動的に実行します。

-Rオプションと同時に指定した場合，このオプションは無効です。

-t

その日に計画実行するように予定されているジョブネット，またはその日に確定実行するように予定されているジョブネットを実行しません。

-Rオプションと同時に指定した場合，このオプションは無効です。

-F サービス名

処理対象とする，スケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

省略した場合，デフォルトスケジューラーサービス名が仮定されます。

-s {none|EXEC}

ジョブネットおよびジョブの実行を抑止するか，または抑止を解除するかを指定します。

none

ジョブネットとジョブの実行抑止を解除します。

EXEC

ジョブネットとジョブの実行を抑止します。現在実行中のジョブネットおよびジョブの実行が終了したあとは，新たにジョブネットおよびジョブは起動されません。

-w

スケジューラーサービスが起動したあと，コマンドを終了します。

-R

スケジューラーサービスの前回の停止時に実行中状態であったジョブネットおよびジョブの実行を継続します（ホットスタートします）。

ジョブネットの場合

スケジューラーサービス停止時の状態から継続実行します。

また，開始予定時刻を超過しているジョブネットを，スケジューラーサービス起動直後に実行します。

ジョブの場合

スケジューラーサービス停止時のジョブ状態を求め，その状態から継続実行します。

このオプションは-cおよび-Dオプションと同時には指定できません。

-c，-R，および-Dオプションのどれも指定しなかった場合は，スケジューラーサービスをウォームスタートします。

-D

スケジューラーサービスをディザスターリカバリースタートします。ディザスターリカバリースタートの詳細については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　6.2.1 JP1/AJS3起動時の動作を一時的に変更する」を参照してください。

このオプションは，-c，-R，および-sオプションと同時には指定できません。

-c，-R，および-Dオプションのどれも指定しなかった場合は，スケジューラーサービスをウォームスタートします。

注意事項

このコマンドを実行する前に，JP1/AJS3を起動しておく必要があります。

Windowsの場合は，［サービス］ダイアログボックスや［サービス］ウィンドウを使って，JP1/AJS3サービスを起動しておいてください。

UNIXの場合は，jajs_spmdコマンドを使って，JP1/AJS3のプロセスを起動しておいてください。

システムの日付や時刻を前に戻した場合は，JP1/AJS3全体をコールドスタートしてください。

ajslocaldateコマンドでスケジューラーサービスのローカル日時を変更した場合は，変更したスケジューラーサービスをコールドスタートしてください。

スケジューラーサービスがすでに起動している場合，このコマンドは異常終了します。

-c，-R，および-Dオプションのどれも指定しなかった場合は，スケジューラーサービスをウォームスタートします。

トラブルが発生した場合にスケジューラーサービスをコールドスタートするときは，必要な履歴情報を採取したあとに実施することを推奨します。ログ情報の採取方法については，マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング　1.3 トラブル発生時に採取が必要な資料」，およびマニュアル「JP1/Automatic Job Management System 3 トラブルシューティング　1.4 資料の採取方法」を参照してください。

環境設定※が不適切であった場合，スケジューラーサービスは起動されません。

注※

スケジューラーサービスの環境設定内容を指しています。

データベースの種類にISAMを設定しているスケジューラーサービスをコールドスタートする場合，データベースには何もアクセスしてない状態（JP1/AJS3 - ViewからログオフしてJP1/AJS3のコマンドを使用していない状態）でコールドスタートしてください。データベースへのアクセスが残っていると，登録済みの情報の消去処理に失敗してサービスが起動できません（イベントログ（Windowsの場合）またはsyslog（UNIXの場合）にエラーメッセージ「KAVS0218-E データベースへのアクセスが残っているためスケジューラーサービス(スケジューラーサービス名)をコールドスタートできませんでした」が出力されて異常終了します）。

-Rオプションを指定してスケジューラーサービスをホットスタートした際またはウォームスタートした際に，ジョブの状態を取得できなかった場合は，ジョブの状態を「終了状態不明」に遷移させ，ジョブの実行を終了することがあります。ジョブの状態を取得できない条件の詳細については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　6.2.1(3) 起動モード別のジョブネットおよびジョブの状態」の「表6-3 ホットスタート（-hot）した場合のジョブネットおよびジョブの状態」または「表6-4 ウォームスタート（-warm）した場合のジョブネットおよびジョブの状態」の「ジョブ（UNIXジョブ，PCジョブ，フレキシブルジョブ，HTTP接続ジョブ，アクションジョブ，カスタムジョブ）」の欄を参照してください。

このコマンドでスケジューラーサービスを起動した場合，環境設定パラメーターOVERSCHEDULEの値は有効になりません。このコマンドの動作に従って実行されます。環境設定パラメーターOVERSCHEDULEとこのコマンドのオプションとの対応を次の表に示します。

表3‒27　環境設定パラメーターとajsstartコマンドのオプションとの対応表

パラメーターの設定

ajsstartコマンドのオプション

OVERSCHEDULEに「exec」を設定する。

-tおよび-oを指定しない。

OVERSCHEDULEに「skip」を設定する。

-oオプションを指定する。

OVERSCHEDULEに「plan」を設定する。

-tオプションを指定する。

同一論理ホスト上では，次のコマンドと同時に実行できません。

ajsprofalterコマンド

ajsembdbstartコマンド

ajsembdbstopコマンド

jajs_hstdコマンド

jajs_hstd_stopコマンド

jajs_spmdコマンド（-nオプションにjajs_schdを指定しない場合）

jajs_spmd_statusコマンド

jajs_spmd_stopコマンド（-nオプションにjajs_schdを指定しない場合）

jajs_startコマンド（UNIX限定）

jajs_start.clusterコマンド（UNIX限定）

jajs_stopコマンド（UNIX限定）

jajs_stop.clusterコマンド（UNIX限定）

同一スケジューラーサービスを指定する場合，次のコマンドと同時に実行できません。

ajsstartコマンド

ajsstopコマンド

jajs_spmdコマンド（-nオプションにjajs_schdを指定する場合）

jajs_spmd_stopコマンド（-nオプションにjajs_schdを指定する場合）

戻り値

0

正常終了。

4〜124で4の倍数値

異常終了。

使用例1

スケジューラーサービスAJSROOT1をコールドスタートします。

ajsstart -F AJSROOT1 -c

使用例2

スケジューラーサービスAJSROOT1をウォームスタートします。

ajsstart -F AJSROOT1

使用例3

スケジューラーサービスAJSROOT1をホットスタートします。

ajsstart -F AJSROOT1 -R

使用例4

スケジューラーサービスAJSROOT1をディザスターリカバリースタートします。

ajsstart -F AJSROOT1 -D

ajsstatus

形式

ajsstatus
     [-F サービス名]
     [-h ホスト名]
     [-v | -c]

機能

スケジューラーサービスの現在の運用環境，JP1/AJS3 - Managerに接続しているJP1/AJS3 - View，JP1/AJS3 - Web Console，または外部DBの接続情報を標準出力ファイルに出力します。出力形式については，後述の「出力例1」，「出力例2」，「出力例3」，および「出力例4」を参照してください。

実行権限

なし

ただし，-hオプションで他ホストに対してajsstatusコマンドを実行する場合，次に示すどちらかの設定が必要です。

コマンドを実行するOSユーザー名が，実行先ホストのJP1ユーザーにマッピングされているOSユーザー名である

環境変数JP1_USERNAMEに実行先ホストのJP1ユーザーを指定している

引数

-F サービス名

処理対象とする，スケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

省略した場合，デフォルトスケジューラーサービス名が仮定されます。

-h ホスト名

他ホストのスケジューラーサービスの現在の運用環境を出力したい場合に，操作対象のスケジューラーサービスがあるホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，カレントホスト名（使用しているJP1/AJS3 - Managerホスト名）が仮定されます。

-v

JP1/AJS3 - Managerに接続しているJP1/AJS3 - Viewの接続情報を出力します。

出力される情報は，物理ホストおよび論理ホストに接続しているJP1/AJS3 - Viewの接続情報です。

このオプションを指定した場合，スケジューラーサービスの運用環境は出力されません。また，このオプションと同時に-Fオプションを指定した場合，-Fオプションは意味を持ちません。また，ajsinetd（ネットワーク制御プロセス）が起動されていない場合，接続情報は出力されません。

-c

JP1/AJS3 - Managerに接続しているJP1/AJS3 - Web Consoleの接続情報を出力します。

出力される情報は，物理ホストおよび論理ホストに接続しているJP1/AJS3 - Web Consoleの接続情報です。

このオプションを指定した場合，スケジューラーサービスの運用環境は出力されません。また，このオプションと同時に-Fオプションを指定した場合，-Fオプションは意味を持ちません。また，ajscdinetd（JP1/AJS3 - Web Console制御プロセス）が起動されていない場合，接続情報は出力されません。

JP1/AJS3 - Viewからコマンドを実行する場合に指定できる引数

JP1/AJS3 - Viewからこのコマンドを実行する場合，次に示す引数を指定できます。

項番

引数

必須または任意

1

-F サービス名

○

（凡例）

○：必須

これ以外のオプションは，JP1/AJS3 - Viewからこのコマンドを実行する場合には指定できません。

JP1/AJS3 - ViewからJP1/AJS3のコマンドを実行する方法については，マニュアル「JP1/Automatic Job Management System 3 操作ガイド　10.4 JP1/AJS3 - ViewからJP1/AJS3のコマンドを実行する」を参照してください。

戻り値

0

正常終了。

4〜124で4の倍数値

異常終了。

使用例1

スケジューラーサービスの現在の運用環境を，標準出力ファイルに出力します。

ajsstatus

使用例2

JP1/AJS3 - Managerに接続しているJP1/AJS3 - Viewの接続情報を，標準出力ファイルに出力します。

ajsstatus -v

使用例3

JP1/AJS3 - Managerに接続しているJP1/AJS3 - Web Consoleの接続情報を，標準出力ファイルに出力します。

ajsstatus -c

出力例1

スケジューラーサービスの現在の運用環境の出力例，出力項目の制限，および出力項目の説明を次に示します。

出力例

出力項目の制限

スケジューラーサービスが終了している場合，(4)，(5)，(16)，(17)は表示されません。

次の場合，(16)，(17)は表示されません。

(15)のスケジューラーログファイルのサイズが0の場合。

環境設定時に，すべての履歴情報を出力しないように定義した場合（具体的には，環境設定パラメーターLOGSIZEに0を指定した場合）。

出力項目の説明

(1) サービス名

スケジューラーサービスのサービス名を示します。

(2) AJS状態

JP1/AJS3による運用が開始しているか（スケジューラーサービスが起動しているか）を示します。

運用中：JP1/AJS3による運用が開始している

停止：JP1/AJS3による運用が停止している

メンテナンス中：JP1/AJS3による運用が停止している

(3) 抑止機能

JP1/AJS3の機能のうち，抑止状態を示します。

ジョブ実行：ジョブの実行を抑止する

なし：ジョブの実行を抑止しない

(4) AJS開始日時

JP1/AJS3の運用が開始された日時（スケジューラーサービスが起動した日時）を示します。

(5) 終了制限

ajsstopコマンドを使ってJP1/AJS3による運用を終了したことを示します。

スケジュール：スケジュール制限による終了監視中である

ジョブネット：ジョブネット制限による終了監視中である

ジョブ：ジョブ制限による終了監視中である

なし：ajsstopコマンドが実行されていない

強制停止：強制停止中である

停止：停止中である

制限解除：終了制限が解除された状態である

(6) データベースの種類

データベースの種類を示します。

ISAM：ISAMファイルに情報を格納する

EmbedDB：組み込みDBに情報を格納する

SQLSVR：外部DB（Microsoft SQL Server）に情報を格納する

(7) データベースファイル格納ディレクトリ

ISAMファイルおよびユニットロックファイルを格納するディレクトリ名を示します。

(8) テーブル・ファイル名称

ISAMの場合，各情報を格納するファイル名（ファイルのベース名）を示します。

組み込みDBの場合，各情報を格納するテーブル名を示します。

(9) マネージャ文字コード種別

データベースに情報を格納する際に使用する文字コード種別を示します。

SJIS：シフトJIS文字コードを使用する

EUC：日本語EUC文字コードを使用する

UTF-8：UTF-8文字コードを使用する

C：7ビットASCII文字コードを使用する

注意事項

中国語を使用している場合は，「C」が表示されます。

(10) ジョブエラー情報ディレクトリ

ジョブエラー情報ディレクトリ名を示します。

(11) 退避情報ディレクトリ

退避情報ディレクトリ名を示します。

(12) AJS開始・終了メッセージの出力

JP1/AJS3の運用開始・終了メッセージを，Windowsイベントログまたはsyslogに出力するかを示します。

出力しない：メッセージを出力しない

すべて出力する：すべてのメッセージを出力する

(13) ジョブネット開始・終了メッセージの出力

ジョブネットの開始・終了メッセージを，Windowsイベントログまたはsyslogに出力するかを示します。

出力しない：メッセージを出力しない

異常終了時出力する：ジョブネット異常終了メッセージだけを出力する

警告終了時出力する：ジョブネット警告終了メッセージだけを出力する

保留時出力する：ジョブネット保留通知メッセージだけを出力する

開始遅延時出力する：ジョブネット開始遅延通知メッセージだけを出力する

終了遅延時出力する：ジョブネット終了遅延通知メッセージだけを出力する

起動条件監視開始・終了時出力する：ジョブネット起動条件監視開始・終了通知メッセージだけを出力する

繰り越し未実行時出力する：ジョブネット繰り越し未実行通知メッセージだけを出力する

ジョブネットコネクタ接続エラー時出力する：ジョブネットコネクタと接続先のジョブネットとの接続に関するエラーメッセージだけを出力する

待ち合わせ時出力する：ジョブネットの待ち合わせ条件による待ち合わせ，および待ち合わせの滞留メッセージを出力する

すべて出力する：すべてのメッセージ（ジョブネット開始，正常終了，異常終了，警告終了，保留通知，開始遅延通知，終了遅延通知，起動条件監視開始・終了通知，繰り越し未実行通知，全登録解除，ジョブネットコネクタ接続エラー，および待ち合わせの滞留通知）を出力する

(14) ジョブ開始・終了メッセージの出力

ジョブの開始・終了メッセージを，Windowsイベントログまたはsyslogに出力するかを示します。

出力しない：メッセージを出力しない

異常終了時出力する：ジョブ異常終了メッセージだけを出力する

警告終了時出力する：ジョブ警告終了メッセージだけを出力する

保留時出力する：ジョブ保留通知メッセージだけを出力する

終了遅延時出力する：ジョブ終了遅延通知メッセージだけを出力する

待ち合わせ時出力する：ジョブネットの待ち合わせ条件による待ち合わせ，および待ち合わせの滞留メッセージを出力する

自動リトライ時出力する：ジョブ異常終了時の自動リトライ通知メッセージだけを出力する

すべて出力する：すべてのメッセージ（ジョブ開始，正常終了，異常終了，警告終了，終了遅延，待ち合わせの滞留通知，およびジョブ異常終了時の自動リトライ）を出力する

(15) スケジューラーログファイルのサイズ

スケジューラーログファイルのサイズ（単位：キロバイト）を示します。

(16) 使用中のスケジューラーログファイル名

スケジューラーサービスが使用しているスケジューラーログファイル名を示します。

(17) 交代用のスケジューラーログファイル名

履歴情報を指定したサイズまでファイルに出力した場合に，次に使用するスケジューラーログファイル名を示します。

(18) AJS開始・終了履歴の出力

JP1/AJS3の運用を開始したとき，および終了したときに履歴情報を出力するかを示します。

出力しない：履歴を出力しない

すべて出力する：すべての履歴を出力する

(19) ジョブネット開始・終了履歴の出力

ジョブネットの実行を開始したとき，および終了したときに履歴情報を出力するかを示します。

出力しない：履歴を出力しない

異常終了時出力する：ジョブネットの異常終了履歴を出力する

警告終了時出力する：ジョブネットの警告終了履歴を出力する

保留時出力する：ジョブネットの保留通知履歴を出力する

開始遅延時出力する：ジョブネット開始遅延通知履歴だけを出力する

終了遅延時出力する：ジョブネット終了遅延通知履歴だけを出力する

起動条件監視開始・終了時出力する：ジョブネット起動条件監視開始・終了通知履歴だけを出力する

繰り越し未実行時出力する：ジョブネット繰り越し未実行通知履歴だけを出力する

待ち合わせ時出力する：ジョブネットの待ち合わせ条件による待ち合わせ，および待ち合わせの滞留履歴を出力する

すべて出力する：すべての履歴（ジョブネット起動，異常終了，警告終了，保留通知，開始遅延通知，終了遅延通知，起動条件監視開始・終了通知，繰り越し未実行通知，全登録解除，および待ち合わせの滞留通知）を出力する

(20) ジョブ開始・終了履歴の出力

ジョブの実行を開始したとき，および終了したときに履歴情報を出力するかを示します。

出力しない：履歴を出力しない

異常終了時出力する：ジョブの異常終了履歴を出力する

警告終了時出力する：ジョブの警告終了履歴を出力する

保留時出力する：ジョブの保留通知履歴を出力する

終了遅延時出力する：ジョブの終了遅延通知履歴だけを出力する

待ち合わせ時出力する：ジョブネットの待ち合わせ条件による待ち合わせ，および待ち合わせの滞留履歴を出力する

自動リトライ時出力する：ジョブ異常終了時の自動リトライ通知履歴だけを出力する

すべて出力する：すべての履歴（ジョブ起動，異常終了，警告終了，終了遅延，待ち合わせの滞留通知，およびジョブ異常終了時の自動リトライ）を出力する

(21) 操作履歴の出力

操作履歴情報を出力するかを示します。

出力しない：履歴を出力しない

ALTER：ajsalterコマンドでの操作履歴を出力する

STOP：ajsstopコマンドでの操作履歴を出力する

ENTRY：ジョブネットの実行登録の操作履歴を出力する

LEAVE：ジョブネットの実行登録解除の操作履歴を出力する

PLAN：ジョブネットのスケジュール一時変更の操作履歴を出力する

INTRPT：ジョブネットの実行中断の操作履歴を出力する

RERUN：ジョブネットの再実行の操作履歴を出力する

KILL：ジョブの強制終了の操作履歴を出力する

CHANGE：ユニットの定義内容変更の操作履歴を出力する

CALENDAR：カレンダー情報の変更の操作履歴を出力する

DELETE：ユニットの削除の操作履歴を出力する

RESTORE：ユニットの回復の操作履歴を出力する

DEFINE：ユニットの定義の操作履歴を出力する

COPY：ユニットのコピー，および移動の操作履歴を出力する

CHGST：ジョブの状態変更の操作履歴を出力する

SUSPEND：ジョブネットのサスペンド・サスペンド解除の操作履歴を出力する

IMPORT：ユニットのインポートの操作履歴を出力する

START：ajsstartコマンドでの操作履歴を出力する

RGIMPORT：登録情報インポートの操作履歴を出力する

RELEASE：ルートジョブネットのリリース情報の操作履歴を出力する

すべて出力する：すべての履歴を出力する

(22) ルートジョブネットのスケジュール

ルートジョブネットのスケジュール定義時に使用している時間制を示します。

24時間：スケジュールを24時間制で定義している

48時間：スケジュールを48時間制で定義している

(23) サスペンド機能

サスペンド機能の有効・無効を示します。

有効：サスペンド機能が有効である

無効：サスペンド機能が無効である

(24) 参照履歴の出力

参照履歴情報を出力するかを示します。

出力しない：すべての参照履歴を出力しない

BACKUP：ユニットの退避の参照履歴を出力する

EXPORT：ユニットのエクスポートの参照履歴を出力する

NAME：ユニットの名称出力の参照履歴を出力する

PRINT：ユニットの定義内容出力の参照履歴を出力する

SCHEDULE：ジョブネットの予定情報出力の参照履歴を出力する

SHOW：ユニットの状態出力の参照履歴を出力する

RGEXPORT：登録情報エクスポートの参照履歴を出力する

RELEASE：ルートジョブネットのリリース情報の参照履歴を出力する

CALUTIL：カレンダーの計算の参照履歴を出力する

すべて出力する：すべての履歴を出力する

(25) 一時変更の操作管理機能

一時変更の操作管理機能の有効・無効を示します。

有効：一時変更の操作管理機能が有効である

無効：一時変更の操作管理機能が無効である

出力例2

JP1/AJS3 - Managerに接続しているJP1/AJS3 - Viewの接続情報の出力例，出力項目の制限，および出力項目の説明を次に示します。

出力例

出力項目の制限

JP1/AJS3 - View接続情報がない場合，またはajsinetdプロセスが起動されていない場合，(1)〜(6)の見出し行と(7)のメッセージだけ出力されます。

出力項目の説明

(1) 接続先スケジューラーサービス

接続しているスケジューラーサービス名を出力します。接続処理中のためスケジューラーサービス名が取得できない場合，サービス名に「***」が出力されます。

(2) JP1ユーザー

JP1/AJS3 - ViewにログインしているJP1ユーザー名が出力されます。

(3) プロセスID

JP1/AJS3 - Viewの接続を管理している，ajsmonsvrのプロセスIDが出力されます。同一行の出力項目は，このプロセスに対する情報となります。出力情報がある範囲は，JP1/AJS3 - Viewのログイン完了時から，ログオフまでの間です。

(4) 接続開始日時

JP1/AJS3 - Viewの接続を開始した日時が次に示す形式で出力されます。

YYYY/MM/DD hh:mm:ss

出力フォーマットは，日本語環境と英語環境で共通です。各項目の出力けた数が足りない場合は，前にゼロを付けて出力されます。

（例）2009年7月1日 10時2分5秒の場合

　　2009/07/01 10:02:05

(5) 接続元IPアドレス

JP1/AJS3 - Managerに接続しているJP1/AJS3 - ViewホストのIPアドレスが，次に示す形式で出力されます。

xxx.xxx.xxx.xxx

各項目の出力けた数が足りない場合は，詰めて出力されます。

（例）133.108.132.1の場合

　　133.108.132.1

(6) 接続元ホスト

IPアドレスをホスト名称に変換して出力されます。IPアドレスからホスト名に変換できない場合，IPアドレスがそのまま出力されます。JP1/AJS3 - Viewの接続元のIPアドレスからホスト名を逆引きしてホスト名が出力されます。

JP1/AJS3 - Viewホスト自体のホスト名とは異なる場合があります。DNS環境の場合，ドメイン名が付加されFQDN形式で表示します。IPアドレスにエイリアスホスト名があり複数のホスト名が設定されている場合は，正ホスト名が表示されます。

(7) メッセージ

ajsinetdプロセスが起動されていない場合，メッセージ「KAVS0831-I JP1/AJSサービスが起動されていないため，View接続情報を取得できません」が出力されます。

その他の場合は，情報がすべて出力されたあと，メッセージ「KAVS0832-I View接続情報の出力が終了しました」が出力されます。

ajsinetdプロセスを個別に起動・停止する方法については，「3. 通常の運用で使用するコマンド　jajs_hstd」および「3. 通常の運用で使用するコマンド　jajs_hstd_stop」を参照してください。

出力例3

JP1/AJS3 - Managerに接続しているJP1/AJS3 - Web Consoleの接続情報の出力例，出力項目の制限，および出力項目の説明を次に示します。

出力例

出力項目の制限

JP1/AJS3 - Web Console接続情報がない場合，またはajscdinetdプロセスが起動されていない場合，(1)〜(6)の見出し行と(7)のメッセージだけが出力されます。

出力項目の説明

(1) 接続先スケジューラーサービス

接続しているスケジューラーサービス名を出力します。接続処理中のためスケジューラーサービス名が取得できない場合，サービス名に「***」が出力されます。

(2) JP1ユーザー

ログインしているJP1ユーザー名が出力されます。

(3) プロセスID

接続を管理しているajsmonsvrのプロセスIDが出力されます。同一行の出力項目は，このプロセスに対する情報となります。出力情報がある範囲は，ログイン完了時から，ログオフまでの間です。

(4) 接続開始日時

接続を開始した日時が次に示す形式で出力されます。

YYYY/MM/DD hh:mm:ss

出力フォーマットは，日本語環境と英語環境で共通です。各項目の出力けた数が足りない場合は，前にゼロを付けて出力されます。

（例）20XX年7月1日 10時2分5秒の場合

　　20XX/07/01 10:02:05

(5) 接続元IPアドレス

JP1/AJS3 - Managerに接続しているホストのIPアドレスが，次に示す形式で出力されます。

xxx.xxx.xxx.xxx

各項目の出力けた数が足りない場合は，詰めて出力されます。

（例）133.108.132.1の場合

　　133.108.132.1

(6) 接続元ホスト

JP1/AJS3 - Managerに接続しているホストのIPアドレスからホスト名が逆引きされて出力されます。IPアドレスからホスト名に変換できない場合，IPアドレスがそのまま出力されます。

出力されるホスト名が，接続元ホストのホスト名とは異なる場合があります。DNS環境の場合，ドメイン名が付加されてFQDN形式で出力されます。IPアドレスにエイリアスホスト名があり複数のホスト名が設定されている場合は，正ホスト名が出力されます。

(7) メッセージ

ajscdinetdプロセスが起動されていない場合，メッセージKAVS4982-Iが出力されます。

その他の場合は，情報がすべて出力されたあと，メッセージKAVS4981-Iが出力されます。

ajscdinetdプロセスを個別に起動・停止する方法については，「3. 通常の運用で使用するコマンド　jajs_hstd」および「3. 通常の運用で使用するコマンド　jajs_hstd_stop」を参照してください。

出力例4

JP1/AJS3 - Managerに接続している外部DBの接続情報の出力例，出力項目の制限，および出力項目の説明を次に示します。

出力例

出力項目の制限

スケジューラーサービスが終了している場合，(4)，(5)，(17)，(18)は表示されません。

次の場合，(17)，(18)は表示されません。

(16)のスケジューラーログファイルのサイズが0の場合。

環境設定時に，すべての履歴情報を出力しないように定義した場合（具体的には，環境設定パラメーターLOGSIZEに0を指定した場合）。

出力項目の説明

(1) サービス名

スケジューラーサービスのサービス名を示します。

(2) AJS状態

JP1/AJS3による運用が開始しているか（スケジューラーサービスが起動しているか）を示します。

運用中：JP1/AJS3による運用が開始している

停止：JP1/AJS3による運用が停止している

メンテナンス中：JP1/AJS3による運用が停止している

(3) 抑止機能

JP1/AJS3の機能のうち，抑止状態を示します。

ジョブ実行：ジョブの実行を抑止する

なし：ジョブの実行を抑止しない

(4) AJS開始日時

JP1/AJS3の運用が開始された日時（スケジューラーサービスが起動した日時）を示します。

(5) 終了制限

ajsstopコマンドを使ってJP1/AJS3による運用を終了したことを示します。

スケジュール：スケジュール制限による終了監視中である

ジョブネット：ジョブネット制限による終了監視中である

ジョブ：ジョブ制限による終了監視中である

なし：ajsstopコマンドが実行されていない

強制停止：強制停止中である

停止：停止中である

制限解除：終了制限が解除された状態である

(6) データベースの種類

データベースの種類を示します。

ISAM：ISAMファイルに情報を格納する

EmbedDB：組み込みDBに情報を格納する

SQLSVR：外部DB（Microsoft SQL Server）に情報を格納する

(7) ODBCファイルデータソース名

外部DBと接続するためのODBCファイルデータソース名を出力します。データベースの種類が「SQLSVR」の場合だけ出力します。

(8) データベース名

スケジューラーサービス情報が格納されている外部DB上のデータベース名を出力します。データベースの種類が「SQLSVR」の場合だけ出力します。

(9) データベースファイル格納ディレクトリ

ISAMファイルおよびユニットロックファイルを格納するディレクトリ名を示します。

(10) マネージャ文字コード種別

データベースに情報を格納する際に使用する文字コード種別を示します。

SJIS：シフトJIS文字コードを使用する

EUC：日本語EUC文字コードを使用する

UTF-8：UTF-8文字コードを使用する

C：7ビットASCII文字コードを使用する

注意事項

中国語を使用している場合は，「C」が表示されます。

(11) ジョブエラー情報ディレクトリ

ジョブエラー情報ディレクトリ名を示します。

(12) 退避情報ディレクトリ

退避情報ディレクトリ名を示します。

(13) AJS開始・終了メッセージの出力

JP1/AJS3の運用開始・終了メッセージを，Windowsイベントログまたはsyslogに出力するかを示します。

出力しない：メッセージを出力しない

すべて出力する：すべてのメッセージを出力する

(14) ジョブネット開始・終了メッセージの出力

ジョブネットの開始・終了メッセージを，Windowsイベントログまたはsyslogに出力するかを示します。

出力しない：メッセージを出力しない

異常終了時出力する：ジョブネット異常終了メッセージだけを出力する

警告終了時出力する：ジョブネット警告終了メッセージだけを出力する

保留時出力する：ジョブネット保留通知メッセージだけを出力する

開始遅延時出力する：ジョブネット開始遅延通知メッセージだけを出力する

終了遅延時出力する：ジョブネット終了遅延通知メッセージだけを出力する

起動条件監視開始・終了時出力する：ジョブネット起動条件監視開始・終了通知メッセージだけを出力する

繰り越し未実行時出力する：ジョブネット繰り越し未実行通知メッセージだけを出力する

ジョブネットコネクタ接続エラー時出力する：ジョブネットコネクタと接続先のジョブネットとの接続に関するエラーメッセージだけを出力する

待ち合わせ時出力する：ジョブネットの待ち合わせ条件による待ち合わせ，および待ち合わせの滞留メッセージを出力する

すべて出力する：すべてのメッセージ（ジョブネット開始，正常終了，異常終了，警告終了，保留通知，開始遅延通知，終了遅延通知，起動条件監視開始・終了通知，繰り越し未実行通知，全登録解除，ジョブネットコネクタ接続エラー，および待ち合わせの滞留通知）を出力する

(15) ジョブ開始・終了メッセージの出力

ジョブの開始・終了メッセージを，Windowsイベントログまたはsyslogに出力するかを示します。

出力しない：メッセージを出力しない

異常終了時出力する：ジョブ異常終了メッセージだけを出力する

警告終了時出力する：ジョブ警告終了メッセージだけを出力する

保留時出力する：ジョブ保留通知メッセージだけを出力する

終了遅延時出力する：ジョブ終了遅延通知メッセージだけを出力する

待ち合わせ時出力する：ジョブネットの待ち合わせ条件による待ち合わせ，および待ち合わせの滞留メッセージを出力する

自動リトライ時出力する：ジョブ異常終了時の自動リトライ通知メッセージだけを出力する

すべて出力する：すべてのメッセージ（ジョブ開始，正常終了，異常終了，警告終了，終了遅延，待ち合わせの滞留通知，およびジョブ異常終了時の自動リトライ）を出力する

(16) スケジューラーログファイルのサイズ

スケジューラーログファイルのサイズ（単位：キロバイト）を示します。

(17) 使用中のスケジューラーログファイル名

スケジューラーサービスが使用しているスケジューラーログファイル名を示します。

(18) 交代用のスケジューラーログファイル名

履歴情報を指定したサイズまでファイルに出力した場合に，次に使用するスケジューラーログファイル名を示します。

(19) AJS開始・終了履歴の出力

JP1/AJS3の運用を開始したとき，および終了したときに履歴情報を出力するかを示します。

出力しない：履歴を出力しない

すべて出力する：すべての履歴を出力する

(20) ジョブネット開始・終了履歴の出力

ジョブネットの実行を開始したとき，および終了したときに履歴情報を出力するかを示します。

出力しない：履歴を出力しない

異常終了時出力する：ジョブネットの異常終了履歴を出力する

警告終了時出力する：ジョブネットの警告終了履歴を出力する

保留時出力する：ジョブネットの保留通知履歴を出力する

開始遅延時出力する：ジョブネット開始遅延通知履歴だけを出力する

終了遅延時出力する：ジョブネット終了遅延通知履歴だけを出力する

起動条件監視開始・終了時出力する：ジョブネット起動条件監視開始・終了通知履歴だけを出力する

繰り越し未実行時出力する：ジョブネット繰り越し未実行通知履歴だけを出力する

待ち合わせ時出力する：ジョブネットの待ち合わせ条件による待ち合わせ，および待ち合わせの滞留履歴を出力する

すべて出力する：すべての履歴（ジョブネット起動，異常終了，警告終了，保留通知，開始遅延通知，終了遅延通知，起動条件監視開始・終了通知，繰り越し未実行通知，全登録解除，および待ち合わせの滞留通知）を出力する

(21) ジョブ開始・終了履歴の出力

ジョブの実行を開始したとき，および終了したときに履歴情報を出力するかを示します。

出力しない：履歴を出力しない

異常終了時出力する：ジョブの異常終了履歴を出力する

警告終了時出力する：ジョブの警告終了履歴を出力する

保留時出力する：ジョブの保留通知履歴を出力する

終了遅延時出力する：ジョブの終了遅延通知履歴だけを出力する

待ち合わせ時出力する：ジョブネットの待ち合わせ条件による待ち合わせ，および待ち合わせの滞留履歴を出力する

自動リトライ時出力する：ジョブ異常終了時の自動リトライ通知履歴だけを出力する

すべて出力する：すべての履歴（ジョブ起動，異常終了，警告終了，終了遅延，待ち合わせの滞留通知，およびジョブ異常終了時の自動リトライ）を出力する

(22) 操作履歴の出力

操作履歴情報を出力するかを示します。

出力しない：履歴を出力しない

ALTER：ajsalterコマンドでの操作履歴を出力する

STOP：ajsstopコマンドでの操作履歴を出力する

ENTRY：ジョブネットの実行登録の操作履歴を出力する

LEAVE：ジョブネットの実行登録解除の操作履歴を出力する

PLAN：ジョブネットのスケジュール一時変更の操作履歴を出力する

INTRPT：ジョブネットの実行中断の操作履歴を出力する

RERUN：ジョブネットの再実行の操作履歴を出力する

KILL：ジョブの強制終了の操作履歴を出力する

CHANGE：ユニットの定義内容変更の操作履歴を出力する

CALENDAR：カレンダー情報の変更の操作履歴を出力する

DELETE：ユニットの削除の操作履歴を出力する

RESTORE：ユニットの回復の操作履歴を出力する

DEFINE：ユニットの定義の操作履歴を出力する

COPY：ユニットのコピー，および移動の操作履歴を出力する

CHGST：ジョブの状態変更の操作履歴を出力する

SUSPEND：ジョブネットのサスペンド・サスペンド解除の操作履歴を出力する

IMPORT：ユニットのインポートの操作履歴を出力する

START：ajsstartコマンドでの操作履歴を出力する

RGIMPORT：登録情報インポートの操作履歴を出力する

RELEASE：ルートジョブネットのリリース情報の操作履歴を出力する

すべて出力する：すべての履歴を出力する

(23) ルートジョブネットのスケジュール

ルートジョブネットのスケジュール定義時に使用している時間制を示します。

24時間：スケジュールを24時間制で定義している

48時間：スケジュールを48時間制で定義している

(24) サスペンド機能

サスペンド機能の有効・無効を示します。

有効：サスペンド機能が有効である

無効：サスペンド機能が無効である

(25) 参照履歴の出力

参照履歴情報を出力するかを示します。

出力しない：すべての参照履歴を出力しない

BACKUP：ユニットの退避の参照履歴を出力する

EXPORT：ユニットのエクスポートの参照履歴を出力する

NAME：ユニットの名称出力の参照履歴を出力する

PRINT：ユニットの定義内容出力の参照履歴を出力する

SCHEDULE：ジョブネットの予定情報出力の参照履歴を出力する

SHOW：ユニットの状態出力の参照履歴を出力する

RGEXPORT：登録情報エクスポートの参照履歴を出力する

RELEASE：ルートジョブネットのリリース情報の参照履歴を出力する

CALUTIL：カレンダーの計算の参照履歴を出力する

すべて出力する：すべての履歴を出力する

(26) 一時変更の操作管理機能

一時変更の操作管理機能の有効・無効を示します。

有効：一時変更の操作管理機能が有効である

無効：一時変更の操作管理機能が無効である

ajsstop

形式

ajsstop
     [-F サービス名]
     [-s|-n|-j|-k|-c|-r]
     [-f]
     [-w]

機能

JP1/AJS3のスケジューラーサービスを終了します。

スケジューラーサービスを終了する必要がある場合を次に示します。

スケジューラーサービスの運用を計画的に終了する場合

データベースを回復する場合

環境設定パラメーターを変更する場合

また，このコマンドで要求したスケジュール制限，ジョブネット制限を解除して，元の運用に戻します。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-F サービス名

処理対象とする，スケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

このオプションを省略した場合，デフォルトスケジューラーサービス名が仮定されます。

-s

このコマンドを投入した日に実行が予定されているジョブネットがすべて終了したあと，スケジューラーサービスを終了します（これを「スケジュール制限」と呼びます）。

実行登録されているジョブネットが，基準時刻を設定したジョブグループに属している場合の，スケジューラーサービスを終了する例を次に示します。なお，例中の○印は実行されるジョブネット，×印は実行されないジョブネットを示します。

（例1）

ジョブグループA：

基準時刻　9:00

スケジューラーサービス開始時刻　9:00

ジョブネット実行予定時刻　12:00，7:00

コマンド投入時刻　10:00

（例2）

ジョブグループA：

基準時刻　10:00

スケジューラーサービス開始時刻　10:00

ジョブネット実行予定時刻　12:00，7:00

コマンド投入時刻　9:00

（例3）

ジョブグループA：

基準時刻　9:00

スケジューラーサービス開始時刻　9:00

ジョブネット実行予定時刻　12:00，7:00

ジョブグループB：

基準時刻　11:00

スケジューラーサービス開始時刻　11:00

ジョブネット実行予定時刻　13:00，9:00

コマンド投入時刻　10:00

（例4）

ジョブグループA：

基準時刻　9:00

スケジューラーサービス開始時刻　9:00

ジョブネット実行予定時刻　12:00，7:00

ジョブグループB：

基準時刻　10:00

スケジューラーサービス開始時刻　10:00

ジョブネット実行予定時刻　13:00，8:00

コマンド投入時刻　11:00

実行日の振り替えによって，ジョブネットの実行日がコマンドを投入した日に振り替えられた場合，ジョブネットは，コマンド投入日に実行されるジョブネットとして処理されます。

起動条件付きジョブネットの場合，「監視中」状態の監視世代は，コマンドを投入した日に実行予定があるジョブネットがすべて終了したあと，「監視中断」状態になります。スケジュール制限停止中であっても，監視世代が「監視中」状態の間は，起動条件が成立し，ジョブネットが実行されます。

-n

コマンドを投入したときに実行中のジョブネットがすべて終了したあと，スケジューラーサービスを終了します（これを「ジョブネット制限」と呼びます）。

ジョブネット制限停止中は，次の状態になってもジョブネットは開始されません。

開始時刻に到達する

前回世代の終了を待っている状態で，前回世代が終了する

起動条件付きジョブネットで起動条件が成立する※

注※

ジョブネット制限停止中に起動条件の成立によって新たに生成された実行世代は，このコマンドに-rオプションを指定してジョブネット制限停止を解除したあと，またはスケジューラーサービスを再起動したあとに実行されます。

起動条件付きジョブネットの「監視中」状態の監視世代は，コマンド投入時に実行中のジョブネットがすべて終了したあと「監視中断」状態になります。

-j

コマンドを投入したときに実行中のジョブおよび実行中状態※のジョブネットコネクタがすべて終了したあと，スケジューラーサービスを終了します（これを「ジョブ制限」と呼びます）。実行中のルートジョブネットは，ルートジョブネットに対して中断操作を行った場合と同様の状態になります。

注※

実行中状態とは，次の状態のどれかを指します。

実行中

警告検出実行中

異常検出実行中

ジョブ制限停止中は，次の状態になってもジョブネットは開始されません。

開始時刻に到達する

前回世代の終了を待っている状態で，前回世代が終了する

起動条件付きジョブネットの起動条件が成立する※

注※

ジョブ制限停止中に起動条件の成立によって新たに生成された実行世代は，スケジューラーサービスを再起動したあとに実行されます。

起動条件付きジョブネットの「監視中」状態の監視世代は，コマンドが投入された時点で「監視中断」状態になります。

-k

コマンドを投入した時点で，スケジューラーサービスを終了します。なお，スケジューラーサービス終了時に実行中のジョブはすべて強制終了します（これを「ジョブ強制終了」と呼びます）。実行中のルートジョブネットは，ルートジョブネットに対して強制終了操作を行った場合と同様の状態になります。

ジョブ強制終了停止中は，次の状態になってもジョブネットを開始しません。

開始時刻に到達する

前回世代の終了を待っている状態で，前回世代が終了する

起動条件付きジョブネットの起動条件が成立する※

注※

ジョブ強制終了停止中に起動条件の成立によって新たに生成された実行世代は，スケジューラーサービスを再起動したあとに実行されます。

起動条件付きジョブネットの「監視中」状態の監視世代は，コマンドが投入された時点で「監視中断」状態になります。

-c

コマンドを投入した時点で，スケジューラーサービスを終了します。ただし，停止時に実行中のジョブは実行を継続します（これを「スケジューラーサービス強制終了」と呼びます）。

このオプションは，システムを緊急停止させたい場合に，短時間のうちにすべてのプロセスを強制終了させて，スケジューラーサービスプロセスの強制終了を回避するときに指定します。

-r

スケジュール制限（-sオプション），またはジョブネット制限（-nオプション）を解除して，元の運用に戻します。

-f

このオプションを指定した場合，通常の停止要求が受け付けられない次の状態でも，スケジューラーサービスの停止要求を受け付けます。

スケジューラーサービスが開始要求されてから起動中になるまでの起動処理中

このオプションは，-s，-n，-j，-rオプションと同時には指定できません。

このオプションは，-c，または-kオプションを同時に指定する必要があります。

スケジューラーサービスが開始要求されてから起動中になるまでの起動処理中に，このオプションを指定しないで実行した場合，エラーとなります。

-w

スケジューラーサービスが完全に停止するのを待って，コマンドを終了します。また，-rオプションと同時に指定した場合は，スケジュール制限またはジョブネット制限を完全に解除するのを待って，コマンドを終了します。

注意事項

スケジューラーサービスが起動していない場合，このコマンドは異常終了します。

ジョブ制限は解除できません（スケジュール制限，およびジョブネット制限は，それぞれ-rオプションで解除できます）。

制限処理が終了したあと，スケジューラーサービスの終了処理が開始します。終了処理開始後は，制限解除できません。現在の状態は，ajsstatusコマンドで確認できます。

スケジューラーサービスを確実に停止させたい場合は，-wオプションを必ず指定してください（-wオプションを省略した場合，ajsstopコマンドはスケジューラーサービスに停止要求を出したあと，すぐに終了します。そのため，スケジューラーサービスの停止処理が完了する前に，次のコマンドの実行が開始してしまう場合があります）。

ジョブネットコネクタを使ってルートジョブネットの実行順序を制御している場合，接続先のジョブネットの状態によってはジョブネットコネクタが実行中状態※になるため，ジョブネットコネクタを含むルートジョブネットが実行中状態のままとなって，スケジューラーサービスを制限停止できません。この場合は，-kオプションまたは-cオプションで停止するか，または実行中状態のジョブネットコネクタを状態変更して終了させてください。

注※　実行中状態とは，次の状態のどれかを指します。

実行中

警告検出実行中

異常検出実行中

ジョブネットコネクタを使ってルートジョブネットの実行順序を制御している場合，-jオプションを指定したときに接続先のジョブネット配下に先行終了待ちのユニットがあるとジョブネットコネクタを含むルートジョブネットが実行中のままとなって，スケジューラーサービスを停止できません。この場合は，-kオプションまたは-cオプションで停止してください。

ジョブ制限停止中およびジョブ強制終了停止中に，ジョブおよびジョブネットを再実行することはできません。

ジョブ制限停止中およびジョブ強制終了停止中は，ジョブ異常終了時の自動リトライは実行されません。ジョブは終了コードやリトライ実行回数に関係なく，リトライ実行しないで終了状態になります。

大量のリモートジョブネットが実行中のときにジョブ強制終了停止を行うと，デスクトップヒープ不足が発生してリモートジョブネットの終了に失敗し，スケジューラーサービスが停止しないおそれがあります。大量のリモートジョブネットが実行中のときにジョブ強制終了停止を行う場合は，リモートジョブネットを終了させてからジョブ強制終了停止を行ってください。

実行中のルートジョブネットがサスペンドされていると，ルートジョブネットを終了させることができないため，スケジューラーサービスを停止できません。この場合は，該当のルートジョブネットに対して，サスペンド解除を行ってください。

同一論理ホスト上では，次のコマンドと同時に実行できません。

ajsprofalterコマンド

ajsembdbstartコマンド

ajsembdbstopコマンド

jajs_hstdコマンド

jajs_hstd_stopコマンド

jajs_spmdコマンド（-nオプションにjajs_schdを指定しない場合）

jajs_spmd_statusコマンド

jajs_spmd_stopコマンド（-nオプションにjajs_schdを指定しない場合）

jajs_startコマンド（UNIX限定）

jajs_start.clusterコマンド（UNIX限定）

jajs_stopコマンド（UNIX限定）

jajs_stop.clusterコマンド（UNIX限定）

同一スケジューラーサービスを指定する場合，次のコマンドと同時に実行できません。

ajsstartコマンド

ajsstopコマンド

jajs_spmdコマンド（-nオプションにjajs_schdを指定する場合）

jajs_spmd_stopコマンド（-nオプションにjajs_schdを指定する場合）

戻り値

0

正常終了。

4〜124で4の倍数値

異常終了。

使用例

現在実行中のジョブネットが終了してから，スケジューラーサービスを終了します。

ajsstop -n

ajssuspend

形式

ajssuspend
     [-F サービス名]
     {-S [-n]|-C [-r|-h|-p]|-U}
     [-R]
     [-E]
     [-T]
     ルートジョブネット名，またはジョブグループ名...

機能

ルートジョブネットをサスペンドします。また，ルートジョブネットのサスペンド状態を解除します。

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Operator権限

引数

-F サービス名

対応するスケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

-S

ルートジョブネットをサスペンドします。

ただし，操作対象のルートジョブネットが実行中の場合は，サスペンドしません。実行中のルートジョブネットをサスペンドしたい場合は，-nオプションと同時に指定してください。

-n

実行中のルートジョブネットをサスペンドします。

省略した場合，実行中のルートジョブネットはサスペンドしません。

-C

ルートジョブネットのサスペンド状態を解除します。

実行中のルートジョブネットをサスペンドし，そのルートジョブネット下にユニットを追加した場合に，サスペンド解除後に追加したユニットをどのように扱うかについては，-r，-h，または-pオプションで指定してください。-r，-h，または-pオプションを指定しなかった場合，サスペンド解除後は，サスペンド前に実行中であったルートジョブネット，およびそのルートジョブネット下に追加したユニットはすべて実行されます。

-r

サスペンド中に追加したユニットを，サスペンド解除後に実行します。

-h

サスペンド中に追加したユニットを，サスペンド解除後に保留します。

-p

サスペンド中に追加したユニットを，サスペンド解除後に実行しません。

-U

データベース上に残っている無効なユニットレコードを削除します。

-R

指定したルートジョブネット，またはジョブグループに含まれるすべてのジョブネットをサスペンド，またはサスペンド解除します。

このオプションを，-E，-Tオプションと同時に指定した場合，各オプションの指定内容に従って，サスペンド，またはサスペンド解除します。

-E

実行登録されているルートジョブネットをサスペンド，またはサスペンド解除します。

-T

ルートジョブネットをサスペンド，またはサスペンド解除します。

ルートジョブネット名，またはジョブグループ名

サスペンドするルートジョブネット名，または-R，-E，-Tオプションと同時にジョブネット名，またはジョブグループ名を指定します。

指定できる文字数は，1〜930（単位：バイト）です。

ルートジョブネット名，またはジョブグループ名は，複数指定できます。なお，マネージャージョブネット名およびマネージャージョブグループ名は指定できません。

ルートジョブネット名，またはジョブグループ名に，論理ホスト名を指定できます。実行IDは指定できません。

注意事項

ルートジョブネットをサスペンドしたり，サスペンド状態を解除したりできるのは，次のどちらかのユーザーです。

そのルートジョブネットに含まれるすべてのジョブとジョブネットを定義したときに，またはそれらの属性を変更したときに，操作権限を与えられたユーザー。

Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザー。

ただし，環境設定パラメーターADMACLIMITをデフォルトから変更して「yes」を設定している場合は，Administrators権限またはスーパーユーザー権限を持つOSユーザーにマッピングしたJP1ユーザーであっても，操作権限が必要です。

スケジューラーサービスが起動していない場合，このコマンドは異常終了します。

サスペンドしたり，サスペンド状態を解除したりできるのは，ルートジョブネットだけです。

サスペンドしようとしたジョブネットが起動条件監視中の場合，このコマンドは異常終了します。

サスペンドしようとしたルートジョブネットがすでにサスペンド状態の場合，このコマンドは異常終了します。

サスペンドしようとしたルートジョブネットがすでにサスペンド処理中の場合，このコマンドは異常終了します。

サスペンド状態を解除しようとしたルートジョブネットがすでにサスペンド状態を解除されている場合，このコマンドは異常終了します。

サスペンド状態を解除しようとしたルートジョブネットがすでにサスペンド解除処理中の場合，このコマンドは異常終了します。

戻り値

0

正常終了。

4〜124で4の倍数値

異常終了。

補足事項

このコマンドはルートジョブネットがサスペンド状態になるのを待って終了します。また，サスペンド状態が解除されるのを待って終了します。

使用例1

ジョブネット（net1）をサスペンドします。

ajssuspend -S net1

使用例2

ルートジョブネット（net1）のサスペンド状態を解除します。ルートジョブネット（net1）はサスペンド前に実行中だったので，サスペンド解除後には実行を継続します。ただし，サスペンド中に追加したユニットは保留します。

ajssuspend -C -h net1

ajssysctlstart（UNIX限定）

形式

JP1/AJS3 - Managerの場合

ajssysctlstart
     [-m]
     [-a]

JP1/AJS3 - Agentの場合

ajssysctlstart
     [-a]

機能

JP1/AJS3 System Control ManagerサービスまたはJP1/AJS3 System Control Agentサービスを起動します。

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1ajs2/bin/

引数

-m

JP1/AJS3 System Control Managerサービスを起動します。

このオプションは，JP1/AJS3 - Managerの場合だけ指定できます。JP1/AJS3 - Agentでは指定できません。

-a

JP1/AJS3 System Control Agentサービスを起動します。

注意事項

オプションをすべて省略した場合，次のオプションが仮定されます。

JP1/AJS3 - Managerの場合：-mオプションおよび-aオプション

JP1/AJS3 - Agentの場合：-aオプション

このコマンドを実行する前に，マネジメントポータルの実行環境をセットアップしておく必要があります。マネジメントポータルの実行環境をセットアップしていない場合は，ajssysctlsetupコマンドを実行してマネジメントポータルの実行環境をセットアップしてください。

このコマンドはUNIXだけで実行できます。Windowsでは実行できません。

このコマンドは，サービスの起動完了を待たないで終了します。サービスが起動したかどうかは，ajssysctlstatusコマンドで確認してください。

戻り値

0

正常終了。

0以外の値

異常終了。

ajssysctlstatus

形式

JP1/AJS3 - Managerの場合

ajssysctlstatus
     [-m]
     [-a]
     [-e]

JP1/AJS3 - Agentの場合

ajssysctlstatus
     [-a]
     [-e]

機能

JP1/AJS3 System Control ManagerサービスまたはJP1/AJS3 System Control Agentサービスの詳細情報を出力します。

実行権限

なし

格納先ディレクトリ

Windowsの場合

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

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

UNIXの場合

/opt/jp1ajs2/bin/

引数

-m

JP1/AJS3 System Control Managerサービスの情報を表示します。

このオプションは，JP1/AJS3 - Managerの場合だけ指定できます。JP1/AJS3 - Agentでは指定できません。

-a

JP1/AJS3 System Control Agentサービスの情報を表示します。

-e

-mオプションまたは-aオプションで指定されたサービスの動作環境の情報（稼働中に有効になる環境設定パラメーター情報）を表示します。このオプションを省略した場合は情報を表示しません。

環境設定パラメーターの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.15 マネジメントポータル実行環境設定」を参照してください。

注意事項

オプションをすべて省略した場合，次のオプションが仮定されます。

JP1/AJS3 - Managerの場合：-mオプションおよび-aオプション

JP1/AJS3 - Agentの場合：-aオプション

このコマンドでJP1/AJS3 System Control ManagerサービスまたはJP1/AJS3 System Control Agentサービスの情報を取得する場合，JP1/Baseの物理ホストの通信設定に従って自ホストに対してTCP/IP通信接続を行い，サービスの情報を取得します。そのため，自ホスト名（hostnameコマンドの結果）に対応するIPアドレスで通信できるホストが別ホストとなる環境では，別ホストのサービスの情報を取得するおそれがあります。

自ホスト名（hostnameコマンドの結果）に対応するIPアドレスで通信できるホストが別ホストとなる環境では，自ホスト名から自ホストのIPアドレスが解決できるようにhostsファイル，DNSファイル，jp1hostsファイル，またはjp1hosts2ファイルを設定してから，コマンドを実行してください。

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

戻り値

0

正常終了。

0以外の値

異常終了。

出力例

Windowsの場合

UNIXの場合

表示項目の説明

表示項目を次に説明します。各表示項目の括弧は，UNIXでコマンド実行OSユーザーの環境変数LANGの値が「C」の場合の出力形式を示します。

次の（1）〜（14）の順番で表示します。

（1）〜（7）：

JP1/AJS3 System Control Managerサービスの情報を表示します。

-mオプションを指定している場合，または-mオプションが仮定される場合に表示します。

（1）<JP1/AJS3 System Control Managerサービス>（<JP1/AJS3 System Control Manager Service>）

JP1/AJS3 System Control Managerサービスの情報を出力する場合のタイトル文字列を表示します。

（2） サービス状態（Service status）

JP1/AJS3 System Control Managerサービスの起動状態を表示します。

運用中（active）：JP1/AJS3 System Control Managerサービスの運用を開始しています。

停止（inactive）：JP1/AJS3 System Control Managerサービスの運用を停止しています。

停止処理中（stop processing...）：JP1/AJS3 System Control Managerサービスが停止処理中のため，要求を受け付けられない状態です。

（3） サービス開始時刻（Service start time）

「運用中」状態の場合は，JP1/AJS3 System Control Managerサービスの開始時刻を「yyyy/mm/dd hh:mm:ss」の形式で表示します。

「停止」状態の場合は，「****/**/** **:**:**」を表示します。

（4） 最大同時操作実行数（Maximum number of concurrent operations）

JP1/AJS3 System Control Managerサービスについて，クライアントからの操作要求の最大同時実行数を示します。

「停止」状態の場合は「-（半角ハイフン）」を表示します。

（5） 現在の操作実行数（Number of operations currently running）

JP1/AJS3 System Control Managerサービスについて，クライアントからの操作要求の現在の実行数を表示します。

「停止」状態の場合は「-（半角ハイフン）」を表示します。

（6） 集計処理の最大同時実行数（Maximum number of concurrent aggregation processes）

JP1/AJS3 System Control Managerサービスについて，クライアントから要求される集計処理の最大同時実行数を表示します。

「停止」状態の場合は，「-（半角ハイフン）」を表示します。

（7） 現在の集計処理の同時実行数（Current number of concurrent aggregation processes）

JP1/AJS3 System Control Managerサービスについて，クライアントから要求される集計処理の現在の同時実行数を表示します。

「停止」状態の場合は，「-（半角ハイフン）」を表示します。

（8）〜（12）：

JP1/AJS3 System Control Agentサービスの情報を表示します。

-aオプションを指定している場合，または-aオプションが仮定される場合に表示します。

（8）<JP1/AJS3 System Control Agentサービス>（<JP1/AJS3 System Control Agent Service>）

JP1/AJS3 System Control Agentサービスの情報を出力する場合のタイトル文字列を表示します。

（9）サービス状態（Service status）

JP1/AJS3 System Control Agentサービスの起動状態を表示します。

運用中（active）：JP1/AJS3 System Control Agentサービスの運用を開始しています。

停止（inactive）：JP1/AJS3 System Control Agentサービスの運用を停止しています。

停止処理中（stop processing...）：JP1/AJS3 System Control Agentサービスが停止処理中のため，要求を受け付けられない状態です。

（10） サービス開始時刻（Service start time）

「運用中」状態の場合は，JP1/AJS3 System Control Agentサービスの開始時刻を「yyyy/mm/dd hh:mm:ss」の形式で表示します。

「停止」状態の場合は，「****/**/** **:**:**」を表示します。

（11） 最大同時操作実行数（Maximum number of concurrent operations）

JP1/AJS3 System Control Agentサービスについて，クライアントからの操作要求の最大同時実行数を示します。

「停止」状態の場合は「-（半角ハイフン）」を表示します。

（12） 現在の操作実行数（Number of operations currently running）

JP1/AJS3 System Control Agentサービスについて，クライアントからの操作要求の現在の実行数を表示します。

「停止」状態の場合は「-（半角ハイフン）」を表示します。

（13）〜（14）：

各サービスの環境設定パラメーターの情報を表示します。

-eオプションを指定している場合に，次のオプションとの組み合わせで表示します。

（13）：JP1/AJS3 System Control Managerサービスの環境設定パラメーター情報

-mオプションを指定している場合，または-mオプションが仮定される場合に表示します。

（14）：JP1/AJS3 System Control Agentサービスの環境設定パラメーター情報

-aオプションを指定している場合，または-aオプションが仮定される場合に表示します。

（13）<JP1/AJS3 System Control Managerサービス環境情報>（<JP1/AJS3 Sysrem Control Manager Service environment information>）

JP1/AJS3 System Control Managerサービスが使用する，次の定義キーの環境設定パラメーター情報を表示します。

[JP1_DEFAULT¥JP1AJS2¥CONTROL]

[JP1_DEFAULT¥JP1AJS2¥CONTROL¥MANAGER]

環境設定パラメーターの指定がない場合は，デフォルト値を表示します。

-eオプションを指定していない場合は，この情報を表示しません。

（14）<JP1/AJS3 System Control Agentサービス環境情報>（<JP1/AJS3 Sysrem Control Agent Service environment information>）

JP1/AJS3 System Control Agentサービスが使用する，次の定義キーの環境設定パラメーター情報を表示します。

[JP1_DEFAULT¥JP1AJS2¥CONTROL]

[JP1_DEFAULT¥JP1AJS2¥CONTROL¥AGENT]

環境設定パラメーターの指定がない場合は，デフォルト値を表示します。

-eオプションを指定していない場合は，この情報を表示しません。

ajssysctlstop（UNIX限定）

形式

JP1/AJS3 - Managerの場合

ajssysctlstop
     [-m]
     [-a]

JP1/AJS3 - Agentの場合

ajssysctlstop
     [-a]

機能

JP1/AJS3 System Control ManagerサービスまたはJP1/AJS3 System Control Agentサービスを停止します。

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1ajs2/bin/

引数

-m

JP1/AJS3 System Control Manager サービスを停止します。

このオプションは，JP1/AJS3 - Managerの場合だけ指定できます。JP1/AJS3 - Agentでは指定できません。

-a

JP1/AJS3 System Control Agent サービスを停止します。

注意事項

オプションをすべて省略した場合，次のオプションが仮定されます。

JP1/AJS3 - Managerの場合：-mオプションおよび-aオプション

JP1/AJS3 - Agentの場合：-aオプション

このコマンドを実行する前に，マネジメントポータルの実行環境をセットアップ，およびJP1/AJS3 System Control ManagerサービスまたはJP1/AJS3 System Control Agentサービスを起動しておく必要があります。マネジメントポータルの実行環境をセットアップしていない場合は，ajssysctlsetupコマンドを実行してマネジメントポータルの実行環境をセットアップしてください。

クライアントからの操作要求を実行中の場合，要求処理の終了を待たないで終了します。

このコマンドは，JP1/AJS3 System Control ManagerサービスまたはJP1/AJS3 System Control Agentサービスへの停止要求を送信した時点で終了します。このため，このコマンドからでは各サービスが停止したかどうかを確認できません。各サービスの停止を確認したい場合は，ajssysctlstatusコマンドを実行して確認してください。

このコマンドでJP1/AJS3 System Control ManagerサービスまたはJP1/AJS3 System Control Agentサービスを停止する場合，JP1/Baseの物理ホストの通信設定に従って自ホストに対してTCP/IP通信接続を行い，サービスを停止します。そのため，自ホスト名（hostnameコマンドの結果）に対応するIPアドレスで通信できるホストが別ホストとなる環境では，別ホストのサービスを停止するおそれがあります。

自ホスト名（hostnameコマンドの結果）に対応するIPアドレスで通信できるホストが別ホストとなる環境では，自ホスト名から自ホストのIPアドレスが解決できるようにhostsファイル，DNSファイル，jp1hostsファイル，またはjp1hosts2ファイルを設定してから，コマンドを実行してください。

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

戻り値

0

正常終了。

0以外の値

異常終了。

ajstrsetsz

形式

ajstrsetsz
     [-F スケジューラーサービス名]
     [-s サイズ]

機能

トレースログファイルまたはスケジューラーサービス単位のトレースログファイルのサイズを変更・確認します。

引数を指定しないで実行した場合は，現在設定されているトレースログファイルのサイズを標準出力ファイルに出力します。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-F スケジューラーサービス名

処理対象とするスケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

このオプションは，環境設定パラメーターTRACELOGDIVの値が「yes」の場合だけ指定できます。

このオプションを指定した場合は，指定したスケジューラーサービスのトレースログファイルが処理対象となります。スケジューラーサービス単位のトレースログファイルは，環境設定パラメーターTRACELOGDIVDIRに指定したフォルダに出力されます。

このオプションを省略した場合は，環境設定パラメーターTRACELOGFILEに指定したパスのトレースログファイルが処理対象となります。

-s サイズ

トレースログファイルのサイズを指定します。

指定できる値は，64〜2,097,151（単位：キロバイト）です。

このオプションを省略した場合は，トレースログファイルまたはスケジューラーサービス単位のトレースログファイルのサイズが標準出力ファイルに出力されます。

注意事項

このコマンドでトレースログファイルのサイズを小さくした場合，サイズ変更前のトレースログファイルの内容は削除されます。

オプションと値との間は，必ず1バイト以上の空白文字で区切ってください。

クラスタ運用の場合，実行系と待機系のそれぞれでこのコマンドを実行して，トレースログファイルのサイズを同じにしてください。

戻り値

0

正常終了。

4〜124で4の倍数値

異常終了。

使用例1

トレースログファイルのサイズを，デフォルトサイズから，3メガバイト（3,072キロバイト）に変更します。

ajstrsetsz -s 3072

使用例2

多重起動しているスケジューラーサービスのうち，AJSROOT2のトレースログファイルのサイズをデフォルトサイズから3メガバイト（3,072キロバイト）に拡張します。

ajstrsetsz -F AJSROOT2 -s 3072

使用例3

現在設定されているトレースログファイルのサイズを，標準出力ファイルに出力します。

ajstrsetsz

出力例

SIZE:64KB

使用例4

多重起動しているスケジューラーサービスのうち，AJSROOT2のトレースログファイルのサイズを標準出力ファイルに出力します。

ajstrsetsz -F AJSROOT2

出力例

SIZE:3072KB

ajswebtz（Linux限定）

形式

ajswebtz

機能

Web Consoleサーバの環境設定ファイルに指定できるタイムゾーンIDを出力します。

出力される情報を次に示します。

タイムゾーンID

UTCに追加されるオフセット時間（夏時間は考慮されません）

タイムゾーンの名称

実行権限

なし

格納先ディレクトリ

/opt/jp1ajs3web/tools/

引数

なし

注意事項

このコマンドはLinuxだけで実行できます。Windowsでは実行できません。

戻り値

0

正常終了。

0以外

異常終了。

出力例

出力例を次に示します。

タイムゾーンID                  GMTオフセット 名前
Etc/GMT+12                          -12:00    GMT-12:00
Etc/GMT+11                          -11:00    GMT-11:00
MIT                                 -11:00    西サモア時間
Pacific/Apia                        -11:00    西サモア時間
Pacific/Midway                      -11:00    サモア標準時
Pacific/Niue                        -11:00    ニウエ島時間
Pacific/Pago_Pago                   -11:00    サモア標準時
Pacific/Samoa                       -11:00    サモア標準時
US/Samoa                            -11:00    サモア標準時
America/Adak                        -10:00    ハワイ - アリューシャン標準時
America/Atka                        -10:00    ハワイ - アリューシャン標準時
...
GMT                                  00:00    グリニッジ標準時
...
Pacific/Kiritimati                  +14:00    ライン諸島時間

ajswebtz.bat（Windows限定）

形式

ajswebtz.bat

機能

Web Consoleサーバの環境設定ファイルに指定できるタイムゾーンIDを出力します。

出力される情報を次に示します。

タイムゾーンID

UTCに追加されるオフセット時間（夏時間は考慮されません）

タイムゾーンの名称

実行権限

なし

格納先ディレクトリ

JP1/AJS3 - Web Consoleのインストール先フォルダ¥tools¥

引数

なし

注意事項

このコマンドはWindowsだけで実行できます。Linuxでは実行できません。

戻り値

0

正常終了。

0以外

異常終了。

出力例

出力例を次に示します。

タイムゾーンID                  GMTオフセット 名前
Etc/GMT+12                          -12:00    GMT-12:00
Etc/GMT+11                          -11:00    GMT-11:00
MIT                                 -11:00    西サモア時間
Pacific/Apia                        -11:00    西サモア時間
Pacific/Midway                      -11:00    サモア標準時
Pacific/Niue                        -11:00    ニウエ島時間
Pacific/Pago_Pago                   -11:00    サモア標準時
Pacific/Samoa                       -11:00    サモア標準時
US/Samoa                            -11:00    サモア標準時
America/Adak                        -10:00    ハワイ - アリューシャン標準時
America/Atka                        -10:00    ハワイ - アリューシャン標準時
...
GMT                                  00:00    グリニッジ標準時
...
Pacific/Kiritimati                  +14:00    ライン諸島時間

jajs_dbbackup

形式

jajs_dbbackup
     [-id 組み込みDBセットアップ識別子]
     -o バックアップデータ格納ディレクトリ
     [-t タイムアウト時間]

機能

JP1/AJS3の運用中に，組み込みDBのデータのバックアップを取得します。-oオプションに指定したバックアップデータ格納ディレクトリ配下に，バックアップデータを格納します。

このコマンドは，バックアップ強化機能を有効にしている場合だけ実行できます。

組み込みDBが起動状態のときに使用できます。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-id 組み込みDBセットアップ識別子

バックアップする組み込みDBのセットアップ識別子を「_JFn」（nは0〜9またはA〜Z）の4文字で指定します。ajsembdbbuildコマンドの-idオプションで指定した値を指定してください。

このオプションを省略した場合は，_JF0が仮定されます。

-o バックアップデータ格納ディレクトリ

バックアップデータを格納するディレクトリを指定します。ディレクトリは絶対パスで指定してください。Windows版の場合，指定する絶対パスに空白文字を含む場合はパスを「"（ダブルクォーテーションマーク）」で囲んでください。

指定できる文字数は，1〜200（単位：バイト）です。UNIXの場合，ルートディレクトリは指定できません。

バックアップデータは，このオプションで指定したディレクトリ配下に，次のディレクトリ名で出力されます。なお，ディレクトリ名に含まれる「YYYYMMDD_hhmmss」は「西暦年 月 日_時 分 秒」のことです。

Windowsの場合

バックアップデータ格納ディレクトリ¥BK組み込みDBセットアップ識別子_YYYYMMDD_hhmmss

UNIXの場合

バックアップデータ格納ディレクトリ/BK組み込みDBセットアップ識別子_YYYYMMDD_hhmmss

-t タイムアウト時間

バックアップ処理のタイムアウト時間を指定します。バックアップ処理のタイムアウト時間であり，コマンド全体のタイムアウト時間ではありません。

指定できる値は，1〜1440（単位：分）です。

省略した場合，10分が仮定されます。

指定した時間内にバックアップ処理が終了しない場合，jajs_dbbackupコマンドは異常終了します。

バックアップデータ格納ディレクトリに必要な容量

バックアップデータ格納ディレクトリは，組み込みDBのデータベースモデルによって，次の表に示すとおり必要な空き容量が異なります。

表3‒28　組み込みDBのデータベースモデルと必要な空き容量

データベースモデル

必要な空き容量

大規模

約7,200メガバイト

中規模

約1,900メガバイト

小規模

約700メガバイト

ajsembdbaddareaコマンドでデータベース領域を拡張している場合は，拡張した容量を合計した容量が必要になります。また，データベース領域の自動増分機能を有効にしている場合は，自動増分による拡張後の容量が必要になります。

自動増分機能については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　23.2 データベース領域の見積もり」を参照してください。

注意事項

このコマンドを実行している間，ジョブの実行は一時停止します。このため，このコマンドを実行した場合，ジョブネットの開始時刻や終了時刻が遅れることがあります。ジョブ運用への影響を少なくするため，このコマンドはジョブが実行されない時間帯に実行してください。

ジョブの実行中にこのコマンドを実行した場合，jajs_dbbackupコマンドが異常終了するおそれがあります。jajs_dbbackupコマンドが異常終了した場合は，ジョブが実行されていない時間帯に再実行してください。

バックアップ処理が実行中の場合，バックアップ対象の組み込みDBやバックアップ対象の組み込みDB上で動作するスケジューラーサービスについて，次の操作はバックアップ処理が完了するまで一時停止します。

スケジューラーサービスの起動

スケジューラーサービスに定義されているユニットを操作するコマンドの実行

JP1/AJS3 - Viewからスケジューラーサービスの操作

組み込みDBを操作するコマンドの実行

スケジューラーサービスに定義されているリモートジョブネットの実行（実行元ホスト）

スケジューラーサービスに定義されているリモートジョブネットの実行（実行先ホスト）

JP1/AJS3 - Web Consoleからスケジューラーサービスの操作

実行エージェントまたは実行エージェントグループの追加，変更，削除※

注※　バックアップ対象の組み込みDB上にエージェント管理データベースが格納されている場合

JP1/AJS3 - View，JP1/AJS3 - Web Console，またはほかのコマンドを使用してバックアップ対象の組み込みDBや組み込みDB上で動作するスケジューラーサービスが操作されている場合，jajs_dbbackupコマンドが異常終了するおそれがあります。jajs_dbbackupコマンドが異常終了した場合は，バックアップ対象の組み込みDBや組み込みDB上で動作するスケジューラーサービスに対して操作が行われていないか確認し，jajs_dbbackupコマンドを再実行してください。

実行中のバックアップ処理を中断する場合は，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　2.5.2(4) 実行中の組み込みDBバックアップ処理をキャンセルする」の手順を実施してください。

このコマンドをジョブから実行した場合，次の操作を実行してもバックアップは中断されません。

実行中のジョブやジョブネットの強制終了

実行中のジョブネットの中断

上記操作を実施した場合，タイムアウト時間に従ったバックアップの中断が実行されません。実行中のバックアップをキャンセルする場合は，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　2.5.2(4) 実行中の組み込みDBバックアップ処理をキャンセルする」の手順を実施してください。

JP1/AJS3サービスが正常に起動しない環境でこのコマンドを実行しないでください。JP1/AJS3サービスが正常に起動しない環境で取得したバックアップデータを回復に使用した場合，リカバリー環境で問題が発生するおそれがあります。

同じバックアップデータ格納ディレクトリを指定したバックアップ運用を続けると，バックアップデータ格納ディレクトリを含むディスクの容量が不足する場合があります。ディスク容量の不足が発生しないよう，定期的にバックアップデータ格納ディレクトリ配下の不要なバックアップデータを削除してください。

戻り値

0

正常終了。

0以外の値

異常終了。

バックアップ情報ファイル（backupinfo.txt）

このコマンドを実行してバックアップが正常に終了すると，バックアップデータに，バックアップ情報ファイル（backupinfo.txt）が出力されます。

バックアップ情報ファイル（backupinfo.txt）の出力例を次に示します。

[SETUP-ID]
_JF0

[BACKUP START TIME]
2019/06/25 00:00:00

[BACKUP END TIME]
2019/06/25 00:05:00

[BACKUP RESULT]
SUCCEEDED

出力内容の意味を次に示します。

[SETUP-ID]

バックアップを取得した組み込みDBのセットアップ識別子が出力されます。

[BACKUP START TIME]

バックアップの開始時刻が出力されます。

[BACKUP END TIME]

バックアップの終了時刻が出力されます。

[BACKUP RESULT]

バックアップの終了ステータスが出力されます。

表示される終了ステータスを次に示します。

終了ステータス

説明

SUCCEEDED

正常終了

FAILED

異常終了

jajs_dbrestoreコマンドを使用してリカバリーするとき，この項目が「SUCCEEDED」になっているバックアップデータだけ使用できます。

使用例

組み込みDB（_JF0）のバックアップを取得し，バックアップデータ格納ディレクトリ（/backup）に格納します。

jajs_dbbackup -id _JF0 -o /backup

jajs_dbrestore

形式

jajs_dbrestore
     [-id 組み込みDBセットアップ識別子]
     -i バックアップデータ

機能

jajs_dbbackupコマンドで取得したバックアップデータを使用して，組み込みDBをリストアします。

このコマンドは，バックアップ強化機能を有効にしている場合だけ実行できます。

このコマンドで組み込みDBをリストアしたあと，リストアした組み込みDB上で動作するスケジューラーサービスは，初回起動時だけディザスターリカバリースタートします。ディザスターリカバリースタートでは，ジョブ実行は抑止され，ジョブおよびジョブネットの状態が変更されます。ディザスターリカバリースタートの詳細については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　6.2.1 JP1/AJS3起動時の動作を一時的に変更する」を参照してください。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-id 組み込みDBセットアップ識別子

リストアする組み込みDBのセットアップ識別子を「_JFn」（nは0〜9またはA〜Z）の4文字で指定します。-idオプションは，-iオプションに指定するバックアップデータを取得したとき，jajs_dbbackupコマンドの-idオプションに指定した値を指定してください。jajs_dbbackupコマンドの-idオプションで指定した値は，バックアップデータに含まれるバックアップ情報ファイル（backupinfo.txt）で確認できます。

このオプションを省略した場合は，_JF0が仮定されます。

このオプションに指定した値と，-iオプションに指定するバックアップデータのバックアップ情報ファイルに記載されている組み込みDBセットアップ識別子が一致しない場合，コマンドが異常終了します。

-i バックアップデータ

jajs_dbbackupコマンドで出力したバックアップデータを指定します。バックアップデータは絶対パスで指定してください。Windows版の場合，指定する絶対パスに空白文字を含む場合はパスを「"（ダブルクォーテーションマーク）」で囲んでください。

指定できる文字数は，1〜223（単位：バイト）です。

jajs_dbbackupコマンドが異常終了した場合など，不正に出力されたバックアップデータを指定した場合，コマンドが異常終了します。正常に出力されたバックアップデータかどうかは，バックアップデータに含まれるバックアップ情報ファイル（backupinfo.txt）で確認できます。

注意事項

このコマンドを実行した場合，指定したセットアップ識別子の組み込みDB上で動作するスケジューラーサービスの，ユニットの実行結果詳細と一時変更情報がすべて削除されます。

このコマンドは，組み込みDBが停止している状態で実行してください。

このコマンドは，同一ホスト内で同時に複数実行しないでください。同一ホストで複数実行した場合は，あとから実行したコマンドが異常終了します。

このコマンドの実行中にエラーが発生した場合，データベースをコマンド実行前の状態に戻します。ただし，データベースの回復が不完全であるおそれがあります。エラーが発生した場合は，JP1/AJS3を起動しないで，エラー原因を取り除いて再度リストアを実施してください。

組み込みDBのリストアでエラーが発生した場合，組み込みDBのデータベース領域が閉塞状態になっているおそれがあります。この状態で再度jajs_dbrestoreコマンドを実行するとエラーが発生します。その場合，次の組み込みDBのコマンドを実行して，データベース領域の閉塞状態を解除してください。閉塞解除後，再度jajs_dbrestoreコマンドを実行し，組み込みDBをリストアしてください。

操作対象の組み込みDBの起動状態を確認する。

ajsembdbstatus -s ust -id 組み込みDBセットアップ識別子

操作対象の組み込みDBが起動している場合，組み込みDBの正常停止を行う。

ajsembdbstop -id 組み込みDBセットアップ識別子

操作対象の組み込みDBを起動する。

ajsembdbstart -id 組み込みDBセットアップ識別子

組み込みDBのコマンドを実行するために必要な環境変数を設定する。

設定する環境変数については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　9.2.3(2) スクリプトを使用してデータベースを再編成する」の，設定が必要な環境変数を示した表を参照してください。

データベース領域の閉塞状態を解除する。

pdrels -r ALL -o

操作対象の組み込みDBの正常停止を行う。

ajsembdbstop -id 組み込みDBセットアップ識別子

組み込みDBの環境を削除して，再構築したあとにデータを回復する場合は，ajsembdbsetupコマンドが完了した状態でjajs_dbrestoreコマンドを実行してください。

また，ajsembdbaddareaコマンドで組み込みDBのデータベース領域を拡張していた場合は，このコマンドの実行前に同様の拡張を行っておく必要があります。

拡張手順を次に示します。

Windowsの場合

次のフォルダを退避する。

組み込みDB運用フォルダ※¥CONF¥embrm

ajsembdbunsetコマンドを実行する。

ajsembdbbuildコマンドを実行する。

ajsembdbsetupコマンドを実行する。

手順1で退避したフォルダにあるaddareaファイルをaddarea.batにリネームして実行する。

手順5でリネームしたファイル名をaddareaに戻す。

手順1で退避したフォルダを次のフォルダにリストアする。

組み込みDB運用フォルダ※¥CONF

手順1で退避したフォルダを削除する。

組み込みDBのデータをリカバリーする。

詳細については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　2.5.3(2) 組み込みDBのデータをリカバリーする」を参照してください。

UNIXの場合

次のディレクトリを退避する。

組み込みDB運用ディレクトリ※/conf/embrm

ajsembdbunsetコマンドを実行する。

ajsembdbbuildコマンドを実行する。

ajsembdbsetupコマンドを実行する。

手順1で退避したディレクトリにあるaddareaファイルのパーミッションに実行権限を追加して実行する。

手順1で退避したディレクトリを次のディレクトリにリストアする。

組み込みDB運用ディレクトリ※/conf

手順1で退避したディレクトリを削除する。

組み込みDBのデータをリカバリーする。

詳細については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　2.5.3(2) 組み込みDBのデータをリカバリーする」を参照してください。

注※

組み込みDB運用フォルダおよび組み込みDB運用ディレクトリはajsembdbidlistコマンドで確認できます。ajsembdbidlistコマンドについては，「2. セットアップコマンド　ajsembdbidlist」を参照してください。

このコマンドは，同一の論理ホスト上では，次のコマンドと同時に実行できません。

ajsprofalterコマンド

ajsembdbstartコマンド

ajsembdbstopコマンド

ajsstartコマンド

ajsstopコマンド

jajs_hstdコマンド

jajs_hstd_stopコマンド

jajs_spmdコマンド

jajs_spmd_statusコマンド

jajs_spmd_stopコマンド

jajs_startコマンド（UNIX限定）

jajs_start.clusterコマンド（UNIX限定）

jajs_stopコマンド（UNIX限定）

jajs_stop.clusterコマンド（UNIX限定）

戻り値

0

正常終了。

0以外の値

異常終了。

使用例

バックアップデータ格納ディレクトリ（/backup）配下のバックアップデータ（/BK_JF0_20190101_000000）を使用して，組み込みDB（_JF0）をリストアします。

jajs_dbrestore -id _JF0 -i /backup/BK_JF0_20190101_000000

jajs_extdb

形式

jajs_extdb
     [-v | -p | -r]
     [-F スケジューラーサービス名 | -a]
     [-y]

形式1（外部DBの接続情報の確認）

jajs_extdb
     [-v]

形式2（外部DBとの接続関係を設定）

jajs extdb
     -p
     {-F スケジューラーサービス名 | -a}
     [-y]

形式3（スケジューラーサービスの実行抑止起動状態を解除）

jajs_extdb
     -r
     -F スケジューラーサービス名

機能

外部DBを利用してJP1/AJS3を運用している場合に使用するコマンドです。

指定したオプションに応じて，次の処理が実行されます。

JP1/AJS3 - Managerと接続している外部DBの接続情報を表示します。

JP1/AJS3 - Managerと外部DBのデータベースとの接続関係を設定します。

データベースをシステム障害から復旧したあと，スケジューラーサービスの実行抑止起動状態を解除します。

実行権限

Windowsの場合：Administrators権限

Linuxの場合：スーパーユーザー権限

引数

-v

外部DBの接続情報を表示します。

このオプションは，JP1/AJS3サービスの状態にかかわらず指定できます。

-p，-rオプションと同時に指定した場合，コマンドが異常終了します。

-p

JP1/AJS3 - Managerまたは外部DBをシステム障害から復旧したあと，JP1/AJS3 - Managerと外部DBのデータベースとの接続関係を設定します。

コマンドを実行すると，接続関係を設定するかどうか確認するメッセージが出力されます。設定する場合は「y」または「Y」で，中止する場合はそれ以外の文字（「n」を含む）で応答してください。

-aオプションと同時に指定した場合，JP1/AJS3 - Managerとエージェント管理データベースの接続関係を設定します。

-Fオプションと同時に指定した場合，-Fオプションで指定したスケジューラーサービスと外部DB上のデータベースの接続関係を設定します。また，処理対象としたスケジューラーサービスを実行抑止起動状態に設定します。実行抑止起動状態のJP1/AJS3サービスは，ディザスターリカバリースタートします。ディザスターリカバリースタートの詳細については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　6.2.1 JP1/AJS3起動時の動作を一時的に変更する」を参照してください。

実行抑止起動状態を解除する場合は，-rオプションを指定してコマンドを実行してください。

-v，-rオプションと同時に指定した場合，コマンドが異常終了します。

JP1/AJS3 - Managerが外部DBと接続していない場合（標準構成で組み込みDBを利用している場合），コマンドが異常終了します。

-r

スケジューラーサービスの実行抑止起動状態を解除します。解除対象のスケジューラーサービスは，-Fオプションで指定します。

-v，-pオプションと同時に指定した場合，コマンドが異常終了します。

-F スケジューラーサービス名

処理対象とするスケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

このオプションは，-pまたは-rオプションと同時に指定します。

-v，-aオプションと同時に指定した場合，コマンドが異常終了します。

-a

-pオプションで接続関係を設定する対象に，エージェント管理データベースを指定します。

このオプションは，-pオプションと同時に指定します。

-v，-rおよび-Fオプションと同時に指定した場合，コマンドが異常終了します。

-y

-pオプションで接続関係を設定する場合に，コマンドの実行を確認するメッセージを出力しないときに指定します。

このオプションは，-pオプションと同時に指定します。

-v，-rオプションと同時に指定した場合，コマンドが異常終了します。

注意事項

このコマンドを同時に複数実行しないでください。

このコマンドは，外部DBを利用しているマネージャーホスト，またはスケジューラーサービスに対してだけ実行してください。外部DBを利用していないエージェント管理データベースやスケジューラーデータベースに対してこのコマンドを実行すると，コマンドが異常終了します。

このコマンド実行中に強制終了しないでください。

-pオプションを指定すると，すでに使用しているデータベースであっても，強制的にJP1/AJS3 - Managerまたはスケジューラーサービスとの接続関係を設定します。-pオプションを指定する場合は，接続関係の設定を対象とするデータベースを確認してから実行してください。

-pオプションは，必ずJP1/AJS3サービスを停止した状態で指定してください。

このコマンドは，物理ホストまたは物理ホスト上にセットアップされたスケジューラーサービスに対してだけ実行してください。

戻り値

0

正常終了。

0以外の値

異常終了。

使用例1

物理ホストのホスト情報と，外部でDB上のエージェント管理データベース，およびすべてのスケジューラーデータベースの接続情報を表示します。

jajs_extdb -v

使用例2

JP1/AJS3 - Managerと，スケジューラーサービス（AJSROOT1）のデータベースとの接続関係を設定します。

jajs_extdb -p -F AJSROOT1

使用例3

JP1/AJS3 - Managerと，スケジューラーサービス（AJSROOT2）のデータベースとの接続関係の設定を，コマンドの実行を確認するメッセージを出力せずに設定します。

jajs_extdb -p -F AJSROOT2 -y

使用例4

JP1/AJS3 - Managerと，外部DB上のエージェント管理データベースとの接続関係を設定します。

jajs_extdb -p -a

使用例5

スケジューラーサービス（AJSROOT1）の実行抑止起動状態を解除します。

jajs_extdb -r -F AJSROOT1

出力例1

-vオプションを指定した場合の出力例と出力内容の意味を次に示します。

(1)ホスト                          JP1_DEFAULT
(2)データベースの種類              SQLSVR

(3)エージェント管理
(4)  状態                          有効
(5)  ODBCファイルデータソース名    /odbc/ajsdatasource.dsn
(6)  データベース名                AJSROOT1DB

(7)スケジューラーサービス          AJSROOT1
(8)  状態                          有効
(5)  ODBCファイルデータソース名    /odbc/ajsdatasource.dsn
(6)  データベース名                AJSROOT1DB

(7)スケジューラーサービス          AJSROOT2
(8)  状態                          有効
(5)  ODBCファイルデータソース名    /odbc/ajsdatasource2.dsn
(6)  データベース名                AJSROOT2DB

出力内容の意味を次に示します。

(1) ホスト

物理ホスト名（JP1_DEFAULT）を出力します。

(2) データベースの種類

外部DBで使用しているデータベースの種類を出力します。

Microsoft SQL Serverを使用している場合：SQLSVR

(3) エージェント管理

項目名を出力します。

(4) 状態

外部DB上のエージェント管理用データベースの状態を表示します。

表示される状態を次に示します。

項番

状態

説明

1

有効

エージェント管理用データベースとして使用できる状態です。

2

無効

エージェント管理用データベースとして使用できない状態です。JP1/AJS3 - Managerとエージェント管理データベースの接続関係の設定が必要です。

3

接続不可

対象のデータベースに接続できない状態です。

(5) ODBCファイルデータソース名

利用するODBCファイルデータソース名を出力します。

(6) データベース名

利用するデータベース名を出力します。

(7) スケジューラーサービス

スケジューラーサービス名を出力します。

(8) 状態

外部DB上のスケジューラーデータベースの状態を表示します。

表示される状態を次に示します。

項番

状態

説明

1

有効

スケジューラーデータベースとして使用できる状態です。

2

無効

スケジューラーデータベースとして使用できない状態です。JP1/AJS3 - Managerとスケジューラーデータベースの接続関係の設定が必要です。

3

抑止状態

-pオプションでJP1/AJS3 - Managerとの接続関係を設定したことで，JP1/AJS3サービスが実行抑止起動状態で起動する状態です。

ジョブ運用を開始する場合，以下が必要です。

jajs_extdb -rによる実行抑止起動状態の解除

ajsalter -s noneによるジョブ実行抑止の解除

4

接続不可

対象のデータベースに接続できない状態です。

jajs_hstd

形式

jajs_hstd
     [-h 論理ホスト名]
      -n 詳細プロセス名

機能

ホストサービス管理機能（jajs_hstd）の詳細プロセスを個別に起動します。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-h 論理ホスト名

クラスタで運用している場合に，ホストサービスを起動する論理ホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名（hostnameコマンドで求められるホスト名）が仮定されます。

-n 詳細プロセス名

起動する詳細プロセス名を指定します。指定できるプロセス名を次の表に示します。

起動する詳細プロセス

-nオプションに指定する詳細プロセス名

Windows

UNIX

ajshlogd

hlogd

ajshlogd

ajsinetd

ajsinetd

ajsinetd

ajsnetwd

network

ajsnetwd

ajsagtmd

agentm

ajsagtmd

ajsovstatd

ajsovstatd

ajsovstatd

ajsgwmasterd

gatewayd

ajsgwmasterd

jpqman※

submitqueue

jpqman_hst

jpomanager

hostevam

jpomanager_hst

ajscdinetd

ajscdinetd

ajscdinetd

ajsagtmond

agentmon

ajsagtmond

注※

HP-UX，AIX，およびLinuxの場合，詳細プロセス名は「jpqman32」です。

注意事項

このコマンドはJP1/AJS3が起動している状態で実行してください。

Windowsでajsrcmdsvr.exeが実行されているときにjajs_hstd_stopコマンドでajsinetdを個別に停止したあと，このコマンドでajsinetdを個別に起動すると，ajsinetdプロセスが統合トレースログにメッセージKAVS0903-EまたはKAVS0904-Eを出力して，起動に失敗する場合があります。この場合は，次のように対処してください。

物理ホストの場合

タスクマネージャーでJP1/AJS3のコマンドプロセスが残っていないか確認してください。コマンドプロセスが残っている場合はコマンドの終了を待つか，タスクマネージャーで強制終了したあと，ajsinetdを個別起動してください。コマンドプロセスが残っていない場合は，出力されたメッセージの対処に従ってください。

論理ホストの場合

タスクマネージャーでJP1/AJS3のコマンドプロセスが残っていないか確認してください。コマンドプロセスが残っている場合はコマンドの終了を待つか，タスクマネージャーで強制終了したあと，JP1/AJS3サービスを再起動してください。コマンドプロセスが残っていない場合は，出力されたメッセージの対処に従ってください。

同一論理ホスト上では，次のコマンドと同時に実行できません。

jajs_hstdコマンド

jajs_hstd_stopコマンド

jajs_spmdコマンド

jajs_spmd_statusコマンド

jajs_spmd_stopコマンド

jajs_startコマンド（UNIX限定）

jajs_start.clusterコマンド（UNIX限定）

jajs_stopコマンド（UNIX限定）

jajs_stop.clusterコマンド（UNIX限定）

Windowsの場合，ショートファイル名では実行できません。

戻り値

0

正常終了。

0以外の値

異常終了。

使用例

論理ホスト（lhost1）のネットワーク制御プロセス（ajsinetd）を起動します。

jajs_hstd -h lhost1 -n ajsinetd

jajs_hstd_stop

形式

jajs_hstd_stop
     [-h 論理ホスト名]
      -n 詳細プロセス名

機能

ホストサービス管理機能（jajs_hstd）の詳細プロセスを個別に終了します。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-h 論理ホスト名

クラスタで運用している場合に，ホストサービスを終了する論理ホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名（hostnameコマンドで求められるホスト名）が仮定されます。

-n 詳細プロセス名

終了する詳細プロセス名を指定します。指定できるプロセス名を次の表に示します。

終了する詳細プロセス

-nオプションに指定する詳細プロセス名

Windows

UNIX

ajshlogd

hlogd

ajshlogd

ajsinetd

ajsinetd

ajsinetd

ajsnetwd

network

ajsnetwd

ajsagtmd

agentm

ajsagtmd

ajsovstatd

ajsovstatd

ajsovstatd

ajsgwmasterd

gatewayd

ajsgwmasterd

jpqman※

submitqueue

jpqman_hst

jpomanager

hostevam

jpomanager_hst

ajscdinetd

ajscdinetd

ajscdinetd

ajsagtmond

agentmon

ajsagtmond

注※

HP-UX，AIX，およびLinuxの場合，詳細プロセス名は「jpqman32」です。

注意事項

このコマンドはJP1/AJS3が起動している状態で実行してください。

ajsinetdを個別に終了することで，指定した論理ホスト上のスケジューラーサービスに接続しているJP1/AJS3 - Viewのアクセスを強制的に切断できます。

Windowsでajsinetdを個別に終了させる場合は，タスクマネージャーでajsrcmdsvr.exeが実行していないことを確認してから終了させてください。ajsrcmdsvr.exeが実行している場合，ajsinetdの終了が遅延したり，ajsinetdの再起動に失敗したりする場合があります。

ajscdinetdを個別に終了することで，指定した論理ホスト上のスケジューラーサービスに接続しているJP1/AJS3 - Web Consoleのアクセスを強制的に切断できます。

ajsinetdおよびajscdinetd以外の詳細プロセスを個別に終了させるのは，障害に対応する場合だけにしてください。通常，運用中にホストサービス管理機能（jajs_hstd）の詳細プロセスを終了すると，ジョブ実行ができなくなるなどの影響があります。

同一論理ホスト上では，次のコマンドと同時に実行できません。

jajs_hstdコマンド

jajs_hstd_stopコマンド

jajs_spmdコマンド

jajs_spmd_statusコマンド

jajs_spmd_stopコマンド

jajs_startコマンド（UNIX限定）

jajs_start.clusterコマンド（UNIX限定）

jajs_stopコマンド（UNIX限定）

jajs_stop.clusterコマンド（UNIX限定）

Windowsの場合，ショートファイル名では実行できません。

戻り値

0

正常終了。

0以外の値

異常終了。

使用例

論理ホスト（lhost1）のネットワーク制御プロセス（ajsinetd）を終了します。

jajs_hstd_stop -h lhost1 -n ajsinetd

jajs_killall.cluster（UNIX限定）

形式

jajs_killall.cluster
     [論理ホスト名]

機能

クラスタを運用している場合に，起動中のJP1/AJS3プロセスを強制終了します。

フェールオーバー時にjajs_stop.clusterコマンドを実行してもプロセスを停止できないで，フェールオーバーに失敗することがあります。停止しないプロセスを強制停止させる場合にだけ，このコマンドを実行してください。

実行権限

スーパーユーザー権限

格納先ディレクトリ

/etc/opt/jp1ajs2/

引数

論理ホスト名

JP1/Baseで設定した論理ホスト名を指定します。

指定できる文字数は，1〜32（単位：バイト）です。

省略した場合，環境変数JP1_HOSTNAMEに指定しているホスト名が仮定されます（論理ホスト名は，先頭から32バイトまでが有効になります）。このオプションを省略し，環境変数JP1_HOSTNAMEに何も指定していない場合，このコマンドは異常終了します。

注意事項

このコマンドは，UNIXだけで実行できます。Windowsでは実行できません。

このコマンドは，jajs_stop.clusterコマンドを実行してもプロセスを停止できない場合にだけ，実行してください。

JP1/AJS3への強制終了要求と同時に共有ディスクが切り離されて，共有ディスクにアクセスできない状態になることがあります。この場合，JP1/AJS3強制停止シェルスクリプト（jajs_killall.cluster）のログの出力先を，物理ホストのログファイル格納ディレクトリに変更して実行してください。次に示す個所を変更してください。

変更前

  LOGDIR=`jbsgetcnf -h "$JP1_HOSTNAME" | grep '^"JP1AJS2_LOGDIR"=' | ¥
          sed -e 's/^[^=]*=//' -e 's/^"//' -e 's/"$//'`
  COMNAME=`basename "$0"`

変更後

  LOGDIR="/var/opt/jp1ajs2/log"　　# 物理ホストのログファイル格納ディスクに変更する
  COMNAME=`basename "$0"`

戻り値

0

正常終了。

0以外の値

異常終了。

補足事項

このコマンドは，/etc/opt/jp1ajs2/下に格納されています。

このコマンドでは，論理ホスト対応のプロセスを強制終了させます。ただし，JP1/AJS3のプロセスのうち，次の表に示すプロセスは強制終了の対象外です。

プロセス名

内容

jpocwtmqmaii

MQSeries連携時のMQ監視プロセス

表中のプロセスは，フェールオーバー時に，JP1/AJS3のサービスとともにフェールオーバーする必要はありません。必要に応じて終了させてください。

ログをファイルに出力します。ログファイルは5世代分保存されます。

デフォルトのログファイル格納ディレクトリとログファイル名は次のとおりです。

ログファイル格納ディレクトリ

共有ディレクトリ/jp1ajs2/log

（ログファイルの出力先を物理ホストのログファイル格納ディレクトリに変更している場合は「/var/opt/jp1ajs2/log」）

ログファイル名

jajs_killall.cluster_論理ホスト名.{1|2|3|4|5}.log

jajs_logまたは_04（UNIX限定）

形式

jajs_log | _04
     [-h 論理ホスト名]
     [-f 格納ディレクトリ]
     [-s]
     [-t]
     [-u]
     [-e]
     [-b]
     [追加ファイル]

機能

JP1/AJS3の各種定義情報，動作情報，OS情報などの保守情報を採取します。

jajs_logと_04は，基本的な機能は同じです。この二つは，用途やカスタマイズの要否によって使い分けます。

jajs_logと_04の用途とカスタマイズ可否を次に示します。

表3‒29　資料採取ツールの用途とカスタマイズ可否

資料採取ツール

用途

カスタマイズ

jajs_log

ログの出力先を変更していない場合やその他の情報を採取する必要がない場合に使用します。

×

_04

ログの出力先を変更している場合やその他の情報を採取する場合に，ツールをカスタマイズして使用します。※

○

（凡例）

○：カスタマイズできる。

×：カスタマイズできない。

注※

ツールのカスタマイズ方法については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　16.1.1 資料採取ツールの設定手順」を参照してください。

資料採取ツールの実行結果は，デフォルトでは「/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

その他の資料が出力されます。

資料採取ツールで取得される情報の見積もり

資料採取ツールを，すべての情報を出力するオプションを指定して実行した場合に採取される情報の容量は，次に示す方法で各ディレクトリおよびファイルのサイズを合算して見積もってください。

物理ホストの資料を採取する場合

物理ホスト環境のデータサイズ※1 ＊ 3

論理ホストの資料を採取する場合

(物理ホスト環境のデータサイズ※1 ＋ 論理ホスト環境のデータサイズ※2) ＊ 3

注※1

次に示すディレクトリおよびファイルのサイズの総和です。複数の対象製品が同一環境にインストールされている場合，インストールされているすべての製品について，ディレクトリおよびファイルのサイズを合算してください。

統合トレースログ情報

/var/opt/hitachi/HNTRLib2/spool

ログファイル情報

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

/var/opt/jp1ajs2/log

JP1/AJS3 - Web consoleの場合

/var/opt/jp1ajs3web/log

システムファイル情報

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

/var/opt/jp1ajs2/sys

JP1/AJS3 - Web consoleの場合

/opt/jp1ajs3web/sys

/var/opt/jp1ajs3web/sys

ジョブ情報

JP1/AJS3 - Managerの場合

/var/opt/jp1ajs2/jobinf

環境設定ファイル情報

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

/etc/opt/jp1ajs2/conf

JP1/AJS3 - Web consoleの場合

/etc/opt/jp1ajs3web/conf

JP1/Base情報

/var/opt/jp1base/log

/var/opt/jp1base/sys

/etc/opt/jp1base/conf

syslogおよびsyslog格納ディレクトリ

HP-UXの場合

/var/adm/syslog/syslog.log

Solarisの場合

/var/adm/messages

AIXの場合

/var/adm/syslog

Linuxの場合

/var/adm/messages*

/var/opt/jp1ajs2/database※3

組み込みDB運用ディレクトリ/conf※3

組み込みDB運用ディレクトリ/spool※3

組み込みDB運用ディレクトリ/etc※3

JP1/Base詳細情報（JP1/Baseの資料採取ツールで採取する資料）

JP1/Baseマニュアルで，JP1/Base資料採取ツールの見積もり式を参照してください。

注※2

次に示すディレクトリおよびファイルのサイズの総和です。

JP1/AJS3 - Manager，JP1/AJS3 - Agentの共有ディレクトリ情報

共有ディレクトリ/jp1ajs2

JP1/Baseの共有ディレクトリ情報

共有ディレクトリ/jp1base/log

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

論理ホストの組み込みDB運用ディレクトリ/conf※3

論理ホストの組み込みDB運用ディレクトリ/spool※3

論理ホストの組み込みDB運用ディレクトリ/etc※3

注※3

JP1/AJS3 - Managerだけで取得される情報です。そのほかの製品では不要です。

組み込みDB運用ディレクトリは，次のコマンドajsembdbidlistを実行することで確認できます。

/opt/jp1ajs2/tools/ajsembdbidlist

実際の資料採取では，見積もりで算出した値に加えて，数ギガバイト程度の余裕のある空き容量を確保して，資料採取ツールを実行してください。空き容量は，資料採取ツールの作業領域として使用されます。

なお，見積もりで値を算出し，ディスクに十分な空き容量があることを確認したら，資料を試験的に採取して実際のファイルの合計容量を確認してください。ディスクに空き容量がない場合は，資料採取ツールのコマンドラインに-fオプションを指定して，十分な空き容量があるディスクを指定してください。次回の採取からは，試験的に採取したファイルの合計容量を目安にして必要な空き容量を見積もってください。

注意事項

_04は，JP1/AJS3 10-10以前の資料採取ツールです。JP1/AJS3 10-50以降の場合，jajs_logと_04の両方が利用できます。

JP1/AJS3 - Web Consoleでは，jajs_logだけが利用できます。_04は利用できないため，資料採取ツールはカスタマイズできません。

実行権限

スーパーユーザー権限

格納先ディレクトリ

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

/opt/jp1ajs2/tools

JP1/AJS3 - Web Consoleのjajs_logの場合

/opt/jp1ajs3web/tools

_04の場合

/opt/jp1ajs2/lib/sample_script

引数

-h 論理ホスト名

処理対象とする，論理ホスト名を指定します。

指定した論理ホストのほかに物理ホストの資料も採取します。

省略した場合，物理ホストのログを採取します。

-f 格納ディレクトリ

採取した情報の格納ディレクトリを，空白文字を含まない絶対パスで指定します。指定したディレクトリに空白文字が含まれる場合，空白文字直前までの文字列が格納ディレクトリ名とされ，空白文字以降の文字列は別の引数と見なされます。

格納ディレクトリを相対パスで指定した場合，ルートディレクトリ配下に指定したパスが作成され，資料が採取されます。

存在しないディレクトリを指定した場合は，その名称でディレクトリが新規作成されます。指定した格納ディレクトリの配下に，すでに採取した資料がある場合，ファイルの上書きを確認するメッセージが表示されます。

省略した場合，「/tmp/jp1ajs2/trouble/」下に出力されます。

-s

JP1/AJS3で使用しているデータベースの情報を採取しないときに指定します。

省略した場合，データベースの情報を採取します。

-t

hosts，services，passwordファイルを採取しないときに指定します。

-u

コアを取得しないときに指定します。

このオプションを指定しても，バックトレース情報は採取します。

-e

組み込みDBの詳細情報を採取しないときに指定します。

組み込みDBの詳細情報とは，第二報用資料のembdbinfoディレクトリに出力される資料のことです。

省略した場合は，組み込みDBの詳細情報を採取します。

指定がなければ採取の要否は自動で判断されるため，組み込みDB詳細情報の採取の要否がわからない場合は指定を省略してください。

組み込みDBの詳細情報の採取を抑止したい場合だけ指定してください。

-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オプションを指定してもコアファイルを採取します。

追加ファイルにはディレクトリ名を指定することもできます。ディレクトリを指定した場合は，指定したディレクトリ配下のすべての資料を採取します。

注意事項

クラスタ構成の論理ホストの資料を採取する場合，論理ホストの共有ディスクを必ずマウントしてください。

採取した資料は，資料採取ツールで圧縮します。OSごとの圧縮方法を次に示します。

Linuxの場合

gzipコマンドを使用して圧縮します。資料採取ツールを実行する環境にgzipコマンドがインストールされていなかった場合，tarコマンドで資料をまとめ出力します。compressコマンドは使用しません。tarコマンドがインストールされていない場合，資料採取ツールは異常終了し，処理を終了します。

Linux以外のUNIXの場合

compressコマンドを使用して圧縮します。資料採取ツールを実行する環境にcompressコマンドがインストールされていなかった場合，gzipコマンドを使用して採取した資料を圧縮します。compressコマンドおよびgzipコマンドがない場合，tarコマンドで採取した資料をまとめて出力します。tarコマンドがインストールされていない場合，資料採取ツールは異常終了し，処理を終了します。

スクリプトを実行するユーザーが参照権限を持たないファイルが含まれている場合を考慮し，スーパーユーザーでスクリプトを実行してください。

スクリプトの実行結果を出力したファイルが作成済みの場合，情報の上書きを確認するメッセージが出力されるので，上書きする場合は「y」で，中止する場合は「n」で応答してください。

コアダンプファイルの出力がない場合は，メッセージ（「tar: core? の状態がわかりません。ダンプされません。」）が出力されますが，問題はありません。

対象製品がインストールされていない場合や，他プロセスで使用中またはファイル属性によってアクセスできないファイルを検出した場合は，資料採取中にディレクトリやファイルがない，またはファイルにアクセスできない旨のメッセージが出力されることがありますが，問題はありません。

資料採取ツールの実行中，ajs2collectcoreコマンドを内部的に実行するため，使用しているOSによって採取できる資料に制限があります。詳細については，「3. 通常の運用で使用するコマンド　ajs2collectcore（UNIX限定）」を参照してください。

採取する資料がない場合，資料採取ツールの実行結果を出力したファイルは作成されません。

資料採取ツールは多重実行しないでください。jajs_logと_04の同時実行もしないでください。

AJS管理者で資料採取ツールを実行する場合，スーパーユーザー権限が必要な一部の情報を採取できません。資料採取ツールは，スーパーユーザー権限で実行することを推奨します。

AJS管理者が資料採取ツールを実行する場合，次の操作が必要です。

資料採取ツールを実行する前に，出力先のファイルを削除する。

出力先ディレクトリにJP1管理者グループの書き込み権限を与える。

ルートディレクトリにJP1管理者グループのアクセス権限を与える。

追加採取資料を指定する場合，JP1管理者グループでのアクセス権限を与える。

オプションに，スクリプトが特殊な解釈をする文字や記号を指定すると，予期しないエラーが発生することがあるので指定しないでください。

組み込みDBのサービスが停止中の場合，-sオプションを省略して実行しても，組み込みDBに格納したデータベースの情報は採取しません。

組み込みDBに障害が発生している場合，組み込みDBに格納したデータベースの情報が採取できないことがあります。

外部DBを利用する運用で接続先のデータベースが停止中の場合，-sオプションを省略して実行しても，接続先のデータベースの情報は採取しません。

外部DBを利用する運用で接続先のデータベースに障害が発生している場合，接続先のデータベースの情報が採取できないことがあります。

戻り値

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 EmbedDB _JF*※ begins.

組み込みDBの詳細情報の採取を開始します。

処理を継続します。

The collection of detailed information on EmbedDB_JF*※ ended.

組み込みDBの詳細情報の採取を終了します。

処理を継続します。

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 the database information on SQLSVR begins.

外部DBを利用する場合に接続先のデータベースの情報の採取を開始します。

処理を継続します。

The collection of the database information on SQLSVR ends.

外部DBを利用する場合に接続先のデータベースの情報の採取を終了します。

処理を継続します。

注※

「_JF*」は組み込みDBの識別子（_JF0, _JF1, _JF2, ・・・）です。識別子ごとに詳細情報を採取します。

使用例1

物理ホストの資料を採取します。

jajs_logの場合

jajs_log

_04をカスタマイズし，trouble.shとして使用している場合

trouble.sh

使用例2

論理ホスト（cluster）の資料を採取します。

jajs_logの場合

jajs_log -h cluster

_04をカスタマイズし，trouble.shとして使用している場合

trouble.sh -h cluster

使用例3

コアファイル（/tmp/core）を含めた情報を，ファイル（/tmp/trouble）に出力します。

jajs_logの場合

jajs_log -f /tmp/trouble /tmp/core

_04をカスタマイズし，trouble.shとして使用している場合

trouble.sh -f /tmp/trouble /tmp/core

採取される資料

物理ホストの場合

第一報用資料（/tmp/jp1ajs2/trouble/JP1_DEFAULT_1st.tar.Z※1）

採取された資料のディレクトリ名・ファイル名

内容

/etc/hosts

hostsファイル

/etc/passwd

passwdファイル

/etc/services

servicesファイル

/etc/.hitachi

インストール済みの日立製品情報

/etc/opt/jp1ajs2/conf

/etc/opt/jp1base/conf

/tmp/jp1ajs2/trouble※1/JP1AJS3WEB_INFO/etc/opt/jp1ajs3web/conf

環境設定ファイル格納ディレクトリ

/etc/opt/.hlic/

ライセンス登録情報

/opt/jp1/hcclibcnf/regdir

共通定義情報

/opt/jp1ajs2/PatchHistory

/opt/jp1ajs2/PatchLog

/opt/jp1ajs2v/PatchHistory

/opt/jp1ajs2v/PatchLog

/tmp/jp1ajs2/trouble※1/JP1AJS3WEB_INFO/PatchLog

パッチ情報

/var/adm/syslog/syslog.log（HP-UXの場合）

/var/adm/messages（Solarisの場合）

/var/adm/syslog（AIXの場合）

/var/adm/messages*（Linuxの場合）

syslogおよびsyslog格納ディレクトリ

/opt/hitachi/HNTRLib/spool

/var/opt/hitachi/HNTRLib2/spool

統合トレースログ

/var/opt/hitachi/jp1common

HLICLIBログ

/var/opt/jp1ajs2/log

/tmp/jp1ajs2/trouble※1/JP1AJS3WEB_INFO/var/opt/jp1ajs3web/log

ログファイル格納ディレクトリ

/var/opt/jp1ajs2/log/_04.filelist

/tmp/jp1ajs2/trouble※1/JP1AJS3WEB_INFO/_webras.filelist

ファイルリスト

/var/opt/jp1ajs2/log/_04.osinfo

OS関連情報

/var/opt/jp1ajs2/log/_04.processlist

プロセスリスト

/var/opt/jp1ajs2/log/_04.backtrace

バックトレース情報

/var/opt/jp1ajs2/log/ajsagtshow.txt

ajsagtshowコマンドの実行結果

/var/opt/jp1ajs2/log/ajsagtshow_e.txt

ajsagtshowコマンドの実行結果（-eオプション）

/var/opt/jp1ajs2/log/ajsagtprint.txt

ajsagtprintコマンドの実行結果

/var/opt/jp1ajs2/log/jajs_status.txt

jajs_statusコマンドの実行結果

/var/opt/jp1ajs2/log/jajsadminusr_{1|2}.log

AJS管理者の設定および参照ログ

/var/opt/jp1ajs2/log/ajsprof_スケジューラーサービス名_agent_stat.txt※2

ajsprofstatusコマンドの実行結果（-t agent -sオプション）

/var/opt/jp1ajs2/log/ajsprof_スケジューラーサービス名_agent_def.txt※2

ajsprofstatusコマンドの実行結果（-t agent -pオプション）

/var/opt/jp1ajs2/log/ajsprof_スケジューラーサービス名_unit_stat.txt※2

ajsprofstatusコマンドの実行結果（-t unit -sオプション）

/var/opt/jp1ajs2/log/ajsprof_スケジューラーサービス名_unit_def.txt※2

ajsprofstatusコマンドの実行結果（-t unit -pオプション）

/var/opt/jp1ajs2/log/jajs_pmtcon_m.txt

jajs_pmtconコマンドの実行結果（-m -vオプション）

/var/opt/jp1ajs2/log/jajs_pmtcon_a.txt

jajs_pmtconコマンドの実行結果（-a -vオプション）

/var/opt/jp1ajs2/sys

/tmp/jp1ajs2/trouble※1/JP1AJS3WEB_INFO/var/opt/jp1ajs3web/sys

/tmp/jp1ajs2/trouble※1/JP1AJS3WEB_INFO/opt/jp1ajs3web/sys

システムファイル格納ディレクトリ

/tmp/jp1ajs2/trouble※1/JP1AJS3WEB_INFO/var/opt/jp1ajs3web/tmp

作業ファイル格納ディレクトリ

/var/opt/jp1ajs2/tmp/schedule/pd*.trc

組み込みDBトレース情報

/var/opt/jp1ajs2v/log

/var/opt/jp1base/log

ログファイル格納ディレクトリ

/tmp/jp1ajs2/trouble※1/EMBDB/_JF*※3/conf

組み込みDB定義ファイル

/tmp/jp1ajs2/trouble※1/EMBDB/_JF*※3/spool

組み込みDB障害調査ファイル

/tmp/jp1ajs2/trouble※1/EMBDB/_JF*※3/etc

その他，調査に必要な組み込みDB情報

/var/opt/jp1ajs2/embsch

/opt/jp1ajs2/embsch/ga.ini

/opt/jp1ajs2/embsch/Readme.txt

フレキシブルジョブで使用するディレクトリおよびファイル

/tmp/jp1ajs2/trouble※1/JP1AJS3WEB_INFO/snapshotlog.txt

/tmp/jp1ajs2/trouble※1/JP1AJS3WEB_INFO/srvdata/snapshot.zip

Webサーバの情報

/tmp/jp1ajs2/trouble※1/JP1AJS3WEB_INFO/SHARED

Webサーバの共有ディレクトリ

注※1

-fオプションを省略した場合の出力先です。

注※2

対象ホストにあるすべてのスケジューラーサービスの情報を取得します。

注※3

「_JF*」は組み込みDBの識別子（_JF0, _JF1, _JF2 ・・・）です。識別子ごとのディレクトリが作成されます。

第二報用資料（/tmp/jp1ajs2/trouble/JP1_DEFAULT_2nd.tar.Z※1）

採取された資料のディレクトリ名・ファイル名

内容

/tmp/jp1ajs2/trouble※1/CARDIR/coreinfo-ISAM.shmdump.tar.Z※2

/tmp/jp1ajs2/trouble※1/CARDIR/coreinfo-Scheduler.shmdump.tar.Z※2

/tmp/jp1ajs2/trouble※1/CARDIR/../../core.Z※2

/tmp/jp1ajs2/trouble※1/CARDIR/../../coreinfo-analyze.tar.Z※2

/tmp/jp1ajs2/trouble※1/CARDIR/ProgMon.shmdump

/tmp/jp1ajs2/trouble※1/CARDIR/coreinfo-host.shmdump

/tmp/jp1ajs2/trouble※1/CARDIR/coreinfo-hostprof.shmdump

/tmp/jp1ajs2/trouble※1/CARDIR/coreinfo-pmtcon_m.shmdump

/tmp/jp1ajs2/trouble※1/CARDIR/coreinfo-pmtcon_a.shmdump

ISAMおよびスケジューラーが使用する共有メモリー情報，コアダンプファイル，共有ライブラリー情報，運用プロファイル情報，接続元制限機能の共有メモリー情報

/var/opt/jp1ajs2/database

/tmp/jp1ajs2/trouble※1/embdatabase/_JF*※3

/tmp/jp1ajs2/trouble※1/extdb/SQLSVR/スケジューラーサービス名※6

データベース格納ディレクトリ

/tmp/jp1ajs2/trouble※1/embdbinfo/_JF*※3

組み込みDB詳細情報

/tmp/jp1ajs2/trouble※1/JP1BASE_INFO※5

JP1/Base詳細情報

/追加採取資料※4

追加採取資料

注※1

-fオプションを省略した場合の出力先です。

注※2

採取されたコアダンプファイルがあるディレクトリと同じパスに出力されます。

注※3

「_JF*」は組み込みDBの識別子（_JF0, _JF1, _JF2 ・・・）です。識別子ごとのディレクトリが作成されます。

注※4

追加採取する資料を引数で指定した場合に採取します。

注※5

JP1/Baseの詳細情報については，物理ホスト，論理ホストの資料に関係なく，物理ホストの第二報用資料として作成されます。

注※6

外部DBを利用する場合にスケジューラーサービスごとのディレクトリが作成されます。

第三報用資料（/tmp/jp1ajs2/trouble/JP1_DEFAULT_3rd.tar.Z※）

採取された資料のディレクトリ名・ファイル名

内容

/var/opt/jp1ajs2/jobinf

ジョブ情報格納ディレクトリ

注※

-fオプションを省略した場合の出力先です。

論理ホストの場合

第一報用資料（/tmp/jp1ajs2/trouble/論理ホスト名_1st.tar.Z※1）

採取された資料のディレクトリ名・ファイル名

内容

/共有ディレクトリ名/jp1ajs2/backup

バックアップファイル格納ディレクトリ

/共有ディレクトリ名/jp1ajs2/conf

環境設定ファイル格納ディレクトリ

/共有ディレクトリ名/jp1ajs2/log

ログファイル格納ディレクトリ

/共有ディレクトリ名/jp1ajs2/sys

システムファイル格納ディレクトリ

/共有ディレクトリ名/jp1ajs2/tmp

作業ファイル格納ディレクトリ

/共有ディレクトリ名/jp1base/conf

環境設定ファイル格納ディレクトリ

/共有ディレクトリ名/jp1base/log

ログファイル格納ディレクトリ

/共有ディレクトリ名/jp1ajs2/log/ajsagtshow.txt

ajsagtshowコマンドの実行結果

/共有ディレクトリ名/jp1ajs2/log/ajsagtshow_e.txt

ajsagtshowコマンドの実行結果（-eオプション）

/共有ディレクトリ名/jp1ajs2/log/ajsagtprint.txt

ajsagtprintコマンドの実行結果

/共有ディレクトリ名/jp1ajs2/log/jajs_status.txt

jajs_statusコマンドの実行結果

/共有ディレクトリ名/jp1ajs2/log/ajsprof_スケジューラーサービス名_agent_stat.txt※2

ajsprofstatusコマンドの実行結果（-t agent -sオプション）

/共有ディレクトリ名/jp1ajs2/log/ajsprof_スケジューラーサービス名_agent_def.txt※2

ajsprofstatusコマンドの実行結果（-t agent -pオプション）

/共有ディレクトリ名/jp1ajs2/log/ajsprof_スケジューラーサービス名_unit_stat.txt※2

ajsprofstatusコマンドの実行結果（-t unit -sオプション）

/共有ディレクトリ名/jp1ajs2/log/ajsprof_スケジューラーサービス名_unit_def.txt※2

ajsprofstatusコマンドの実行結果（-t unit -pオプション）

/共有ディレクトリ名/jp1ajs2/log/jajs_pmtcon_m.txt

jajs_pmtconコマンドの実行結果（-m -vオプション）

/共有ディレクトリ名/jp1ajs2/log/jajs_pmtcon_a.txt

jajs_pmtconコマンドの実行結果（-a -vオプション）

/tmp/jp1ajs2/trouble※1/EMBDB_論理ホスト名/_JF*※3/conf

組み込みDB定義ファイル

/tmp/jp1ajs2/trouble※1/EMBDB_論理ホスト名/_JF*※3/spool

組み込みDB障害調査ファイル

/tmp/jp1ajs2/trouble※1/EMBDB_論理ホスト名/_JF*※3/etc

その他，調査に必要な組み込みDB情報

注※1

-fオプションを省略した場合の出力先です。

注※2

対象ホストにあるすべてのスケジューラーサービスの情報を取得します。

注※3

「_JF*」は組み込みDBの識別子（_JF0, _JF1, _JF2 ・・・）です。識別子ごとのディレクトリが作成されます。

第二報用資料（/tmp/jp1ajs2/trouble/論理ホスト名_2nd.tar.Z※1）

採取された資料のディレクトリ名・ファイル名

内容

/tmp/jp1ajs2/trouble※1/CARDIR_論理ホスト名/ProgMon.shmdump

/tmp/jp1ajs2/trouble※1/CARDIR_論理ホスト名/coreinfo-host.shmdump

共有メモリーダンプ

/共有ディレクトリ名/jp1ajs2/database

/tmp/jp1ajs2/trouble※1/embdatabase_論理ホスト名/_JF*※2

データベース格納ディレクトリ

/tmp/jp1ajs2/trouble※1/embdbinfo_論理ホスト名/_JF*※2

組み込みDB詳細情報

注※1

-fオプションを省略した場合の出力先です。

注※2

「_JF*」は組み込みDBの識別子（_JF0, _JF1, _JF2 ・・・）です。識別子ごとのディレクトリが作成されます。

第三報用資料（/tmp/jp1ajs2/trouble/論理ホスト名_3rd.tar.Z※）

採取された資料のディレクトリ名・ファイル名

内容

/共有ディレクトリ名/jp1ajs2/jobinf

ジョブ情報格納ディレクトリ

注※

-fオプションを省略した場合の出力先です。

jajs_log.batまたは_04.bat（Windows限定）

形式

jajs_log.bat | _04.bat
     [-h 論理ホスト名]
     [-f 格納フォルダ]
     [-s]
     [-t]
     [-u]
     [-e]
     [-b]

機能

JP1/AJS3の各種ログ，OS情報などの保守情報を取得します。

どちらの資料採取ツールも，基本的な機能は同じです。この二つは，用途やカスタマイズの要否によって使い分けます。

jajs_log.batと_04.batの用途とカスタマイズ可否を次に示します。

表3‒30　資料採取ツールの用途とカスタマイズ可否

資料採取ツール

用途

カスタマイズ

jajs_log.bat

ログの出力先を変更していない場合やその他の情報を採取する必要がない場合に使用します。

×

_04.bat

ログの出力先を変更している場合やその他の情報を採取する場合に，ツールをカスタマイズして使用します。※1，※2

○

（凡例）

○：カスタマイズできる。

×：カスタマイズできない。

注※1

ツールのカスタマイズ方法については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　7.1.1 資料採取ツールの設定手順」を参照してください。

注※2

インストール先フォルダをデフォルトから変更している場合でも，インストール後にログなどの出力先を変更していなければ，jajs_log.batを使用してください。

資料採取ツールの実行結果は，デフォルトでは「%TEMP%¥jp1ajs2¥backlog」下の次のフォルダに出力されます。

物理ホストの場合

JP1_DEFAULT¥JP1_DEFAULT_1st

第一報用資料が出力されます。

JP1_DEFAULT¥JP1_DEFAULT_2nd

第二報用資料が出力されます。

JP1_DEFAULT¥JP1_DEFAULT_3rd

その他の資料が出力されます。

論理ホストの場合

論理ホスト名¥論理ホスト名_1st

第一報用資料が出力されます。

論理ホスト名¥論理ホスト名_2nd

第二報用資料が出力されます。

論理ホスト名¥論理ホスト名_3rd

その他の資料が出力されます。

資料採取ツールで取得される情報の見積もり

資料採取ツールを，すべての情報を出力するオプションを指定して実行した場合に採取される情報の容量は，次に示す方法で各フォルダおよびファイルのサイズを合算して見積もってください。

物理ホストの資料を採取する場合

物理ホスト環境のデータサイズ※1 ＊ 3

論理ホストの資料を採取する場合

(物理ホスト環境のデータサイズ※1 ＋ 論理ホスト環境のデータサイズ※2) ＊ 3

注※1

次に示すフォルダおよびファイルのサイズの総和です。複数の対象製品が同一環境にインストールされている場合，インストールされているすべての製品について，フォルダおよびファイルのサイズを合算してください。

統合トレースログ情報

%SystemDrive%¥Program Files¥Hitachi¥HNTRLib2¥spool

%SystemDrive%¥Program Files (x86)¥Hitachi¥HNTRLib2¥spool

ログファイル情報

JP1/AJS3 - ManagerまたはJP1/AJS3 - Agentの場合

JP1/AJS3 - ManagerまたはJP1/AJS3 - Agentのインストール先フォルダ¥log

%ALLUSERSPROFILE%¥HITACHI¥JP1¥JP1_DEFAULT¥JP1AJS2¥log

JP1/AJS3 - Viewの場合

%ALLUSERSPROFILE%¥HITACHI¥JP1¥JP1_DEFAULT¥JP1AJS2V¥log

JP1/AJS3 - Definition Assistantの場合

%ALLUSERSPROFILE%¥HITACHI¥JP1¥JP1_DEFAULT¥JP1AJS2DA¥log

JP1/AJS3 - Web consoleの場合

%ALLUSERSPROFILE%¥HITACHI¥JP1¥JP1_DEFAULT¥JP1AJS3WEB¥log

システムファイル情報

JP1/AJS3 - ManagerまたはJP1/AJS3 - Agentの場合

%ALLUSERSPROFILE%¥HITACHI¥JP1¥JP1_DEFAULT¥JP1AJS2¥sys

JP1/AJS3 - Viewの場合

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

JP1/AJS3 - Web consoleの場合

JP1/AJS3 - Web consoleのインストール先フォルダ¥sys

%ALLUSERSPROFILE%¥HITACHI¥JP1¥JP1_DEFAULT¥JP1AJS3WEB¥sys

ジョブ情報

JP1/AJS3 - Managerの場合

%ALLUSERSPROFILE%¥HITACHI¥JP1¥JP1_DEFAULT¥JP1AJS2¥jobinf

環境設定ファイル情報

JP1/AJS3 - ManagerまたはJP1/AJS3 - Agentの場合

JP1/AJS3 - ManagerまたはJP1/AJS3 - Agentのインストール先フォルダ¥conf

%ALLUSERSPROFILE%¥HITACHI¥JP1¥JP1_DEFAULT¥JP1AJS2¥conf

JP1/AJS3 - Viewの場合

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

%ALLUSERSPROFILE%¥HITACHI¥JP1¥JP1_DEFAULT¥JP1AJS2V¥conf

JP1/AJS3 - Definition Assistantの場合

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

JP1/AJS3 - Web consoleの場合

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

JP1/Base情報

JP1/Baseのインストール先フォルダ¥log

JP1/Baseのインストール先フォルダ¥sys

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

%ALLUSERSPROFILE%¥HITACHI¥JP1¥JP1_DEFAULT¥JP1Base¥log

イベントログ（アプリケーションログとシステムログ）

「イベントファイル」形式と「テキスト」形式の２種類の形式で保存された，各イベントログのファイルサイズを合算してください。

%ALLUSERSPROFILE%¥HITACHI¥JP1¥JP1_DEFAULT¥JP1AJS2¥database※3

組み込みDB運用ディレクトリ¥conf※3

組み込みDB運用ディレクトリ¥spool※3

組み込みDB運用ディレクトリ¥UXPLDIR※3

JP1/Base詳細情報（JP1/Baseの資料採取ツールで採取する資料）

JP1/Baseマニュアルで，JP1/Base資料採取ツールの見積もり式を参照してください。

注※2

次に示すフォルダおよびファイルのサイズの総和です。

JP1/AJS3 - Manager，JP1/AJS3 - Agentの共有フォルダ情報

共有フォルダ¥jp1ajs2

JP1/Baseの共有フォルダ情報

共有フォルダ¥jp1base¥log

共有フォルダ¥jp1base¥conf

論理ホストの組み込みDB運用ディレクトリ¥conf※3

論理ホストの組み込みDB運用ディレクトリ¥spool※3

論理ホストの組み込みDB運用ディレクトリ¥UXPLDIR※3

注※3

JP1/AJS3 - Managerだけで取得される情報です。そのほかの製品では不要です。

組み込みDB運用ディレクトリは，次のコマンドajsembdbidlistを実行することで確認できます。

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

実際の資料採取では，見積もりで算出した値に加えて，数ギガバイト程度の余裕のある空き容量を確保して，資料採取ツールを実行してください。空き容量は，資料採取ツールの作業領域として使用されます。

なお，見積もりで値を算出し，ディスクに十分な空き容量があることを確認したら，資料を試験的に採取して実際のファイルの合計容量を確認してください。ディスクに空き容量がない場合は，資料採取ツールのコマンドラインに-fオプションを指定して，十分な空き容量があるディスクを指定してください。次回の採取からは，試験的に採取したファイルの合計容量を目安にして必要な空き容量を見積もってください。

注意事項

_04.batは，JP1/AJS3 10-10以前の資料採取ツールです。JP1/AJS3 10-50以降の場合，jajs_log.batと_04.batの両方が利用できます。

JP1/AJS3 - Web Consoleでは，jajs_log.batだけが利用できます。_04.batは利用できないため，資料採取ツールはカスタマイズできません。

実行権限

Administrators権限

格納先ディレクトリ

jajs_log.batの場合

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

_04.batの場合

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

引数

-h 論理ホスト名

処理対象とする，論理ホスト名を指定します。

指定した論理ホストのほかに物理ホストの資料も採取します。

省略した場合，物理ホストのログを採取します。

-f 格納フォルダ

採取した資料を出力するフォルダ名を，絶対パスまたはコマンドを実行した場所からの相対パスで指定します。ただし，ドライブ直下は指定できません。

パスに空白を含む場合は，「""」で囲んで指定します。

存在しないフォルダを指定した場合は，その名称でフォルダが新規作成されます。

指定した格納フォルダの配下に，すでに採取した資料がある場合，ファイルの上書きを確認するメッセージが表示されます。

格納フォルダに長いパスを指定した場合，資料採取に失敗することがあります。資料採取に失敗した場合は，格納フォルダのパスが短くなるように指定し直して，再度実行してください。

省略した場合，「%TEMP%¥jp1ajs2¥backlog」下に出力されます。このオプションを指定すると，カスタマイズによって格納フォルダを変更した場合よりこのオプションの値が優先されます。

-s

JP1/AJS3で使用しているデータベースの情報を採取しないときに指定します。

省略した場合，データベースの情報を採取します。

-t

hosts，servicesファイルを取得しないときに指定します。

-u

ダンプファイルを取得しないときに指定します。

-e

組み込みDBの詳細情報を採取しないときに指定します。

組み込みDBの詳細情報とは，第二報用資料のembdbinfoフォルダに出力される資料のことです。

省略した場合は，組み込みDBの詳細情報を採取します。

指定がなければ採取の要否は自動で判断されるため，組み込みDB詳細情報の採取の要否がわからない場合は指定を省略してください。

組み込みDBの詳細情報の採取を抑止したい場合だけ指定してください。

-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のサービスの起動中に，-sオプションを省略して実行した場合，ジョブが異常終了するおそれがあるため，ISAMデータベースの情報は採取しません。

クラスタ構成の論理ホストの資料を採取する場合，論理ホストが動作しているホスト上で実行してください。

採取した資料はこのツールでは圧縮しません。別途圧縮ツールなどで圧縮してください。

バッチファイルの実行結果を出力したファイルが作成済みの場合，情報の上書きを確認するメッセージが出力されるので，上書きする場合は「y」を，中止する場合は「n」を応答してください。

バッチファイル実行時に，「JP1/AJS3 - ManagerまたはJP1/AJS3 - Agentのインストール先フォルダ¥sys」フォルダ中のファイルに対して「共有違反です」というエラーメッセージが表示されることがありますが，問題はありません。

資料採取ツールの実行が終了した直後に，採取した資料を移動，削除などの操作を行うと「プロセスはファイルにアクセスできません。別のプロセスが使用中です。」のメッセージが出力される場合があります。これは，資料採取ツールの実行が終了しても，内部的にOSの情報を採取するためのプロセスが実行中のために出力されます。このメッセージが出力された場合は，しばらく待ってから採取した資料を操作してください。

Outlookを使用している場合，資料採取ツールを実行すると，次に示すメッセージボックスが表示される場合があります。

プログラムが，Outlook内に保存されている電子メールアドレスにアクセスしようとしています。よろしいですか？

これは，資料採取ツール内で実行するマシン構成情報採取プログラム（msinfo32）の動作によるものです。資料採取ツールおよびOutlookの動作には問題ありません。

資料採取ツールでは，電子メールアドレスは採取されません。メッセージボックスの［いいえ］ボタンをクリックしてください。

資料採取ツールを実行する場合，コマンドプロンプトを管理者として起動する必要があります。コマンドプロンプトを管理者として起動しないと，資料採取ツール実行中にUAC機能による確認ダイアログボックスが何度も表示されます。ただし，UAC機能が無効の場合は，コマンドプロンプトを管理者として起動する必要はありません。

資料採取ツールは多重実行しないでください。jajs_log.batと_04.batの同時実行もしないでください。

オプションに，バッチファイルが特殊な解釈をする文字や記号を指定すると，予期しないエラーが発生することがあるので指定しないでください。

組み込みDBのサービスが停止中の場合，-sオプションを省略して実行しても，組み込みDBに格納したデータベースの情報は採取しません。

組み込みDBに障害が発生している場合，組み込みDBに格納したデータベースの情報が採取できないことがあります。

外部DBを利用する運用で接続先のデータベースが停止中の場合，-sオプションを省略して実行しても，接続先のデータベースの情報は採取しません。

外部DBを利用する運用で接続先のデータベースに障害が発生している場合，接続先のデータベースの情報が採取できないことがあります。

戻り値

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 EmbedDB _JF*※ begins.

組み込みDBの詳細情報の採取を開始します。

処理を継続します。

The collection of detailed information on EmbedDB_JF*※ ended.

組み込みDBの詳細情報の採取を終了します。

処理を継続します。

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.

テキスト形式でイベントログの採取を終了します。

処理を継続します。

The collection of the database information on SQLSVR begins.

外部DBを利用する場合に接続先のデータベースの情報の採取を開始します。

処理を継続します。

The collection of the database information on SQLSVR ends.

外部DBを利用する場合に接続先のデータベースの情報の採取を終了します。

処理を継続します。

注※

「_JF*」は組み込みDBの識別子（_JF0, _JF1, _JF2, ・・・）です。識別子ごとに詳細情報を採取します。

使用例1

物理ホストの資料を採取します。

jajs_logの場合

jajs_log.bat

_04をカスタマイズし，trouble.batとして使用している場合

trouble.bat

使用例2

JP1/AJS3のサービスを起動したまま，物理ホストの資料を採取します。

jajs_logの場合

jajs_log.bat -s

_04をカスタマイズし，trouble.batとして使用している場合

trouble.bat -s

使用例3

論理ホスト（cluster）の資料を採取します。

jajs_logの場合

jajs_log.bat -h cluster

_04をカスタマイズし，trouble.batとして使用している場合

trouble.bat -h cluster

採取される資料

物理ホストの場合

第一報用資料（%TEMP%¥jp1ajs2¥backlog¥JP1_DEFAULT¥JP1_DEFAULT_1st）

採取された資料のフォルダ名・ファイル名

内容

¥FILELIST.txt

¥JP1AJS3WEB_INFO¥FILELIST.txt

JP1/AJS3のインストール先フォルダ以下のファイルリスト

¥GETERROR.log

¥JP1AJS3WEB_INFO¥GETERROR.log

資料採取ツール（_04.bat）が出力するログ

¥HOSTS

hostsファイル

¥services

servicesファイル

¥JP1AJS2.DAT

¥JP1AJS2C.DAT

¥JP1AJS2DA.DAT

¥JP1AJS2SE.DAT

¥JP1AJS2V.DAT

¥JP1AJS2WOA.DAT

¥JP1AJS3WEB_INFO¥JP1AJS3WEB.DAT

¥JP1BASE.DAT

各製品のレジストリー情報

¥REGDATA.DAT

JP1レジストリー情報

¥WIN.DAT

Windowsレジストリー情報

¥ajsqlstatus.txt

ajsqlstatus.exeの実行結果

¥ajsagtshow.txt

ajsagtshow.exeの実行結果

¥ajsagtshow_e.txt

ajsagtshow.exeの実行結果（-eオプション）

¥ajsagtprint.txt

ajsagtprint.exeの実行結果

¥jajs_status.txt

jajs_status.exeの実行結果

¥ajsprof_スケジューラーサービス名_agent_stat.txt※1

ajsprofstatus.exeの実行結果（-t agent -sオプション）

¥ajsprof_スケジューラーサービス名_agent_def.txt※1

ajsprofstatus.exeの実行結果（-t agent -pオプション）

¥ajsprof_スケジューラーサービス名_unit_stat.txt※1

ajsprofstatus.exeの実行結果（-t unit -sオプション）

¥ajsprof_スケジューラーサービス名_unit_def.txt※1

ajsprofstatus.exeの実行結果（-t unit -pオプション）

¥jajs_pmtcon_m.txt

jajs_pmtcon.exeの実行結果（-m -vオプション）

¥jajs_pmtcon_a.txt

jajs_pmtcon.exeの実行結果（-a -vオプション）

¥OSINFO.txt

OSバージョン，Windowsの環境変数情報，IPコンフィギュレーション情報，Network構成情報，統計情報

¥PERMISSIONINFO.TXT

¥JP1AJS3WEB_INFO¥PERMISSIONINFO.TXT

JP1/AJS3のフォルダのアクセス権限情報

¥WINMSD.TXT

msinfo32コマンドで採取するすべてのシステム情報

¥ALLUSERSPROFILE¥conf¥JP1AJS2

¥conf¥JP1AJS2DA

¥ALLUSERSPROFILE¥conf¥JP1AJS2V

¥conf¥JP1AJS2WOA

¥JP1AJS3WEB_INFO¥ALLUSERSPROFILE¥conf

環境設定ファイル格納フォルダ

¥EMBDB¥_JF*※2¥conf

組み込みDB定義ファイル

¥EMBDB¥_JF*※2¥spool

組み込みDB障害調査ファイル

¥EMBDB¥_JF*※2¥etc

その他調査に必要な組み込みDB情報

¥HNTRLib2¥spool

¥JP1AJS3WEB_INFO¥HNTRLib2

統合トレースログ

¥ALLUSERSPROFILE¥JP1AJS2

¥JP1AJS2C

¥ALLUSERSPROFILE¥JP1AJS2DA

¥JP1AJS2HC

¥ALLUSERSPROFILE¥JP1AJS2V

¥JP1BASE

¥JP1AJS3WEB_INFO¥ALLUSERSPROFILE¥log

¥JP1AJS3WEB_INFO¥jp1common_ajs3web

ログファイル格納フォルダ

¥PATCHLOG¥JP1JAJS2¥PATCHLOG.txt

¥PATCHLOG¥JP1JAJS2C¥PATCHLOG.txt

¥PATCHLOG¥JP1JAJS2DA¥PATCHLOG.txt

¥PATCHLOG¥JP1JAJS2V¥PATCHLOG.txt

¥PATCHLOG¥JP1JAJS2WOA¥PATCHLOG.txt

¥JP1AJS3WEB_INFO¥PATCHLOG.txt

パッチログファイル

¥resource¥JP1AJS2V

リソースファイル格納フォルダ

¥ALLUSERSPROFILE¥sys¥JP1AJS2

¥sys¥JP1AJS2WOA

¥ALLUSERSPROFILE¥sys¥JP1AJS2V

¥JP1AJS3WEB_INFO¥sys

システムファイル格納フォルダ

¥ALLUSERSPROFILE¥tmp¥JP1AJS2DA

実行用一時ファイル格納フォルダ

¥JP1AJS3WEB_INFO¥ALLUSERSPROFILE¥tmp

作業ファイル格納フォルダ

¥ALLUSERSPROFILE¥tmp¥schedule¥pd*.trc

組み込みDBトレースログ

¥user_acl

ユーザーマッピング・認証設定ファイル格納フォルダ

¥jp1common_ajs2

¥jp1common_ajs2da

¥JP1AJS3WEB_INFO¥jp1common_ajs2

製品情報ファイル格納フォルダ

¥HCDINST

日立統合インストールログ

¥jp1common

JP1/Baseのインストールログ

¥Version¥JP1AJS2

¥Version¥JP1AJS2V

¥Version¥JP1AJS2DA

¥JP1AJS3WEB_INFO¥Version

バージョン情報ファイル格納フォルダ

¥embsch_data

¥embsch_inst¥ga.ini

¥embsch_inst¥Readme.txt

フレキシブルジョブで使用するファイル格納フォルダおよびファイル

¥JP1AJS3WEB_INFO¥snapshotlog.txt

¥JP1AJS3WEB_INFO¥srvdata¥snapshot.zip

Webサーバの情報

¥JP1AJS3WEB_INFO¥SHARED

Webサーバの共有フォルダ

注※1

対象ホストにあるすべてのスケジューラーサービスの情報を取得します。

注※2

「_JF*」は組み込みDBの識別子（_JF0, _JF1, _JF2, ・・・）です。識別子ごとのフォルダが作成されます。

第二報用資料（%TEMP%¥jp1ajs2¥backlog¥JP1_DEFAULT¥JP1_DEFAULT_2nd）

採取された資料のフォルダ名・ファイル名

内容

¥ADD

追加取得フォルダ

¥cmdatabase

¥database

¥embdatabase¥_JF*※1

¥extdb¥SQLSVR¥スケジューラーサービス名※3

データベース格納フォルダ

¥eventlog¥AppEvent(Backup).evt

¥eventlog¥AppEvent(Backup).txt

アプリケーションイベントログ

¥eventlog¥SysEvent(Backup).evt

¥eventlog¥SysEvent(Backup).txt

システムイベントログ

¥SHMDUMP¥coreinfo-ISAM.shmdump

¥SHMDUMP¥coreinfo-Scheduler.shmdump

¥SHMDUMP¥ProgMon.shmdump

¥SHMDUMP¥coreinfo-host.shmdump

¥SHMDUMP¥coreinfo-hostprof.shmdump

¥SHMDUMP¥coreinfo-pmtcon_m.shmdump

¥SHMDUMP¥coreinfo-pmtcon_a.shmdump

共有メモリー情報

¥USERDUMP¥*.dmp

ダンプファイル

¥embdbinfo¥_JF*※1

組み込みDB詳細情報

¥JP1BASE_INFO※2

JP1/Base詳細情報

注※1

「_JF*」は組み込みDBの識別子（_JF0, _JF1, _JF2, ・・・）です。識別子ごとのフォルダが作成されます。

注※2

JP1/Baseの詳細情報については，物理ホスト，論理ホストの資料に関係なく，物理ホストの第二報用資料として作成されます。

注※3

外部DBを利用する場合にスケジューラーサービスごとのフォルダが作成されます。

第三報用資料（%TEMP%¥jp1ajs2¥backlog¥JP1_DEFAULT¥JP1_DEFAULT_3rd）

採取された資料のフォルダ名・ファイル名

内容

¥ALLUSERSPROFILE¥jobinf

ジョブ情報格納フォルダ

論理ホストの場合

第一報用資料（%TEMP%¥jp1ajs2¥backlog¥論理ホスト名¥論理ホスト名_1st）

採取された資料のフォルダ名・ファイル名

内容

¥jpomanevshow.txt

jpomanevshow.exeの実行結果

¥ajsqlstatus.txt

ajsqlstatus.exeの実行結果

¥ajsagtshow.txt

ajsagtshow.exeの実行結果

¥ajsagtshow_e.txt

ajsagtshow.exeの実行結果（-eオプション）

¥jajs_status.txt

jajs_status.exeの実行結果

¥ajsprof_スケジューラーサービス名_agent_stat.txt※1

ajsprofstatus.exeの実行結果（-t agent -sオプション）

¥ajsprof_スケジューラーサービス名_agent_def.txt※1

ajsprofstatus.exeの実行結果（-t agent -pオプション）

¥ajsprof_スケジューラーサービス名_unit_stat.txt※1

ajsprofstatus.exeの実行結果（-t unit -sオプション）

¥ajsprof_スケジューラーサービス名_unit_def.txt※1

ajsprofstatus.exeの実行結果（-t unit -pオプション）

¥jajs_pmtcon_m.txt

jajs_pmtcon.exeの実行結果（-m -vオプション）

¥jajs_pmtcon_a.txt

jajs_pmtcon.exeの実行結果（-a -vオプション）

¥JP1AJS2_LOGICAL

ログファイル格納フォルダ

¥JP1BASE

JP1/Baseのログファイル格納フォルダ

¥EMBDB¥_JF*※2¥conf

組み込みDB定義ファイル

¥EMBDB¥_JF*※2¥spool

組み込みDB障害調査ファイル

¥EMBDB¥_JF*※2¥etc

その他調査に必要な組み込みDB情報

¥sys¥JP1AJS2

システムフォルダ

¥tmp¥schedule¥pd*.trc

組み込みDBトレースログ

¥user_acl

ユーザーマッピング・認証設定ファイル格納フォルダ

注※1

対象ホストにあるすべてのスケジューラーサービスの情報を取得します。

注※2

「_JF*」は組み込みDBの識別子（_JF0, _JF1, _JF2, ・・・）です。識別子ごとのフォルダが作成されます。

第二報用資料（%TEMP%¥jp1ajs2¥backlog¥論理ホスト名¥論理ホスト名_2nd）

採取された資料のフォルダ名・ファイル名

内容

¥cmdatabase

¥database

¥embdatabase¥_JF*※

データベース格納フォルダ

¥SHMDUMP¥ProgMon.shmdump

処理状態監視の共有メモリー情報

¥SHMDUMP¥coreinfo-host.shmdump

システム管理機能の共有メモリー情報

¥SHMDUMP¥coreinfo-hostprof.shmdump_論理ホスト名

運用プロファイルの共有メモリー情報

¥SHMDUMP¥coreinfo-pmtcon_m.shmdump

¥SHMDUMP¥coreinfo-pmtcon_a.shmdump

接続元制限機能の共有メモリー情報

¥embdbinfo¥_JF*※

組み込みDB詳細情報

注※

「_JF*」は組み込みDBの識別子（_JF0, _JF1, _JF2, ・・・）です。識別子ごとのフォルダが作成されます。

第三報用資料（%TEMP%¥jp1ajs2¥backlog¥論理ホスト名¥論理ホスト名_3rd）

採取された資料のフォルダ名・ファイル名

内容

¥jobinf

ジョブ情報格納フォルダ

jajs_pmtcon

形式

JP1/AJS3 - Managerの場合

jajs_pmtcon
     [-h 論理ホスト名]
     {-a|-m}
     [-v|-u]

JP1/AJS3 - Agentの場合

jajs_pmtcon
     [-h 論理ホスト名]
     -a
     [-v|-u]

機能

指定したオプションに応じて，次の操作を行います。

接続許可設定ファイルの内容の有効化

現在有効な接続許可ホストの一覧の出力

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-h 論理ホスト名

処理対象の論理ホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホストが仮定されます。

自ホスト名を指定した場合は，論理ホスト名に存在していれば論理ホストとして動作し，論理ホスト名に存在していなければ物理ホストが指定されたとして動作します。

-hオプションに「JP1_DEFAULT」を指定した場合，メッセージKAVS0103-Eが出力されて，コマンドが異常終了します。環境変数JP1_HOSTNAMEに「JP1_DEFAULT」を指定した場合，メッセージKAVS0187-Eが出力されて，コマンドが異常終了します。

-a

エージェント用接続元制限機能を処理対象にします。

-mオプションと同時に指定した場合，メッセージKAVS0116-Eが出力されて，コマンドが異常終了します。

-m

マネージャー用接続元制限機能を処理対象にします。

-aオプションと同時に指定した場合，メッセージKAVS0116-Eが出力されて，コマンドが異常終了します。

このオプションは，JP1/AJS3 - Managerの場合だけ指定できます。JP1/AJS3 - Agentで指定した場合，メッセージKAVS0100-Eが出力されて，コマンドが異常終了します。

-v

接続元制限機能の状態，適用日時，および現在有効な接続許可ホストのIPアドレスの一覧を出力します。接続元制限機能が無効となっている場合は，適用日時および現在有効な接続許可ホストのIPアドレスの一覧は出力されません。

-uオプションと同時に指定した場合，メッセージKAVS0116-Eが出力されて，コマンドが異常終了します。

このオプションの出力例については，「出力例」を参照してください。

-u

接続許可設定ファイルの内容を有効にします。

接続許可設定ファイルの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　21.2.2 接続許可設定ファイルの設定方法」を参照してください。

-vオプションと同時に指定した場合，メッセージKAVS0116-Eが出力されて，コマンドが異常終了します。

戻り値

0

正常終了。

0以外の値

異常終了。

使用例

エージェント用接続許可設定ファイルの内容を有効にする場合

jajs_pmtcon -a -u

エージェントの接続許可ホストの一覧を出力する場合

jajs_pmtcon -a -v

出力例

エージェントの接続許可ホストの一覧を出力する場合の出力例を次に示します。

注意事項

エージェント用接続許可設定ファイルからマネージャーホストのIPアドレスを削除する場合，そのマネージャーホストから実行要求されたジョブが一つもないことを確認した上で，コマンドを実行してください。ジョブの実行中に，エージェント用接続許可設定ファイルからマネージャーホストのIPアドレスを削除した場合，JP1/AJS内の通信が拒否されるため，実行中のジョブの強制終了ができなくなります。誤ってマネージャーホストのIPアドレスを削除した場合，実行中のジョブの強制終了が必要なときは，エージェント用接続許可設定ファイルにマネージャーホストのIPアドレスを追加してから行ってください。

このコマンドを同時に複数実行しないでください。同時に複数実行すると，接続許可設定ファイルの内容を正しく反映できないことがあります。

接続元制限機能で使用する共有メモリーが不当に削除されると，このコマンドは次のようになり正しく動作しません。

-vオプションを指定して実行すると，実際の状態が「制限する」だとしても，コマンドの出力結果は「制限しない」になる。

-uオプションを指定して実行すると，メッセージKAVS8034-Eが出力されて，コマンドが異常終了する。

コマンドを正しく動作させるためには，JP1/AJS3サービスとJP1/AJS3 Queueless Agentサービスを両方とも停止してから再起動してください。

jajsshowadminusr（UNIX限定）

形式

jajsshowadminusr

機能

設定されているAJS管理者の情報を出力します。

実行権限

スーパーユーザー権限

引数

なし

注意事項

引数を指定した場合は，エラーメッセージが出力されて，コマンドは異常終了します。

出力される情報は，JP1/AJS3をインストールした時点の情報です。そのため，JP1/AJS3をインストールしたあとにOSの機能やJP1/Baseの機能でユーザーやグループの情報を変更した場合は，正しい情報が出力されません。

戻り値

0

正常終了。

0以外の値

異常終了。

jajs_spmd

形式

JP1/AJS3 - Managerの場合

jajs_spmd
     [-h 論理ホスト名]
     [-n jajs_agtd |
      -n jajs_schd [-F スケジューラーサービス名]|
      -n jajs_dbmd [-id 組み込みDBセットアップ識別子]]
     [-hot|-warm|-cold[-q {clear|noclear}]|-disaster]
     [-HA]

JP1/AJS3 - Agentの場合

jajs_spmd
     [-h 論理ホスト名]
     [-cold]
     [-HA]

機能

Windowsの場合

JP1/AJS3の各機能に対応するプロセスを起動します。

UNIXの場合

JP1/AJS3サービスの起動またはJP1/AJS3の各機能に対応するプロセスを起動します。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

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

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

UNIXの場合

/opt/jp1ajs2/bin/

引数

-h 論理ホスト名

クラスタで運用している場合に，プロセスまたはサービスを起動する論理ホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名（hostnameコマンドで求められるホスト名）が仮定されます。

-n プロセス名

起動するプロセス名を指定します。指定できるプロセス名を次に示します。

JP1/AJS3 - Managerの場合

jajs_schd（スケジューラーサービス管理）

jajs_agtd（エージェントサービス管理）

jajs_dbmd（DB管理）

スケジューラーサービスを起動する場合は，jajs_schdを指定して-Fオプションにスケジューラーサービス名を指定します。また，論理ホストのスケジューラーサービスを起動する場合は，-hオプションと-Fオプションを同時に指定します。

組み込みDBを起動する場合は，jajs_dbmdを指定して-idオプションに組み込みDBセットアップ識別子を指定します。論理ホストの組み込みDBを起動する場合は，-hオプションと-idオプションを同時に指定します。

-F スケジューラーサービス名

起動するスケジューラーサービス名を指定します。-nオプションにjajs_schdを指定した場合にだけ指定できます。

高度なオプションを指定してスケジューラーサービスを起動する場合は，ajsstartコマンドを使用してください。ajsstartコマンドの詳細については，「3. 通常の運用で使用するコマンド　ajsstart」を参照してください。

省略した場合，デフォルトスケジューラーサービスを仮定します。

-id 組み込みDBセットアップ識別子

組み込みDBを識別するセットアップ識別子を「_JFn」（nは0〜9またはA〜Z）の4文字で指定します。ajsembdbbuildコマンドの-idオプションで指定した値を指定してください。

jajs_setupコマンド，jajs_setup_clusterコマンド，およびjajs_migrateコマンドで作成された組み込みDBに対して操作する場合，ajsembdbidlistコマンドで操作対象となる組み込みDBのセットアップ識別子を確認してください。ajsembdbidlistコマンドの詳細については，「2. セットアップコマンド　ajsembdbidlist」を参照してください。

高度なオプションを指定して組み込みDBを起動する場合は，ajsembdbstartコマンドを使用してください。ajsembdbstartコマンドの詳細については，「3. 通常の運用で使用するコマンド　ajsembdbstart」を参照してください。

このオプションを省略した場合は，_JF0が仮定されます。

-hot|-warm|-cold

JP1/AJS3プロセスまたはサービスの起動モードを指定します。起動モード別のジョブネットおよびジョブの状態については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　6.2.1 JP1/AJS3起動時の動作を一時的に変更する」の起動モード別のジョブネットおよびジョブの状態の説明を参照してください。

JP1/AJS3 - Managerを使用している場合でこのオプションを省略したとき，環境設定パラメーターSTARTMODEの値が仮定されます。

-hot

JP1/AJS3をホットスタートします（前回プロセスまたはサービス終了時の状態を保持したまま，プロセスまたはサービスが起動します）。-nオプションにjajs_agtdまたはjajs_dbmdを指定している場合は，このオプションは指定できません。

-warm

JP1/AJS3をウォームスタートします（前回プロセスまたはサービス終了時の状態を保持したまま，プロセスまたはサービスが起動します。ただし，プロセスまたはサービス終了時に実行中だったジョブネットは終了状態になり，プロセスまたはサービスを起動した日の予定に従って実行されます）。-nオプションにjajs_agtdまたはjajs_dbmdを指定している場合は，このオプションは指定できません。

-cold

JP1/AJS3をコールドスタートします（前回プロセス終了時の状態を解除して，プロセスまたはサービスが起動します）。-nオプションにjajs_dbmdを指定している場合は，このオプションは指定できません。

-q {clear|noclear}

コールドスタート時にジョブ実行環境データベースのジョブ情報を初期化するかどうかを選択します。

-coldオプションとだけ同時に指定できます。

省略した場合，環境設定パラメーターColdStartModeの値が仮定されます。省略した場合，かつ環境設定パラメーターColdStartModeの値がデフォルト状態の場合は，ジョブ実行環境データベースのジョブ情報は初期化されます。

clear

コールドスタート時にジョブ実行環境データベースのジョブ情報を初期化します。ただし，自動起動しない設定のスケジューラーサービスがある場合は初期化しません。

noclear

コールドスタート時にジョブ実行環境データベースのジョブ情報を初期化しません。

-disaster

JP1/AJS3をディザスター・リカバリー運用している場合に使用するオプションです。

メインサイトからリモートサイト，またはリモートサイトからメインサイトに運用拠点を切り替える場合，このオプションを指定してディザスターリカバリースタートします。

ディザスターリカバリースタートは，安全確認のためにジョブやジョブネットの実行が抑止された状態でJP1/AJS3 - Managerを起動します。

-HA

JP1/AJS3のプロセスまたはサービスで異常が発生した場合，縮退運転ではなく，JP1/AJS3サービスのすべてのプロセスまたはサービスを終了します。

JP1/AJS3の一部のプロセスまたはサービスが異常時に，クラスタのフェールオーバーを行う場合などに指定してください。

なお，論理ホストでこのオプションを使用した場合は，拡張起動プロセス定義ファイルに設定した再起動可否オプションの指定に関係なく，再起動されません。クラスタ運用で再起動する場合は，クラスタソフトの制御で再起動するようにしてください。

注意事項

-nオプションはJP1/AJS3が停止している場合は使用できません。JP1/AJS3が起動していて，個別に操作する場合にだけ指定できます。

-nオプションと-HAオプションを同時に指定した場合，-nオプションに指定した子プロセスだけに-HAオプションが有効になります。

このコマンドを，jajs_start，またはjajs_start.clusterコマンドと同時に実行しないでください。JP1/AJS3が正しく起動しないおそれがあります。

このコマンドは，プロセスまたはサービスの起動完了を待たないで終了します。JP1/AJS3のプロセスまたはサービスが起動したかどうかは，jajs_spmd_statusコマンドで確認してください。

JP1/AJS3 - Managerのエージェントサービス管理機能およびJP1/AJS3 - Agentは，-HAオプションの指定の有無に関係なく，プロセスまたはサービスで異常が発生した場合，縮退運転ではなくエージェントサービス管理機能のすべてのプロセスまたはJP1/AJS3サービスを終了します。

Windowsを使用している場合のJP1/AJS3サービスの起動は，Windowsの［コントロールパネル］の［管理ツール］で［サービス］を選択し，表示される［サービス］ダイアログボックスからサービスを起動してください。これは，UNIXでオプションを指定しないでこのコマンドを実行した場合と同等の動作になります（論理ホストの場合は，-hおよび-HAオプションが有効になります）。

JP1/Power Monitorとの連携運用中で，かつJP1/Power Monitorからシステム終了処理を実行している間は，このコマンドを実行しないでください。

同一論理ホスト上では，次のコマンドと同時に実行できません。

ajsprofalterコマンド

ajsembdbstartコマンド

ajsembdbstopコマンド

jajs_hstdコマンド

jajs_hstd_stopコマンド

jajs_spmdコマンド（-nオプションにjajs_schdを指定しない場合）

jajs_spmd_statusコマンド

jajs_spmd_stopコマンド（-nオプションにjajs_schdを指定しない場合）

jajs_startコマンド（UNIX限定）

jajs_start.clusterコマンド（UNIX限定）

jajs_stopコマンド（UNIX限定）

jajs_stop.clusterコマンド（UNIX限定）

同一スケジューラーサービスを指定する場合，次のコマンドと同時に実行できません。

ajsstartコマンド

ajsstopコマンド

jajs_spmdコマンド（-nオプションにjajs_schdを指定する場合）

jajs_spmd_stopコマンド（-nオプションにjajs_schdを指定する場合）

UNIXの場合，このコマンドをリモートシェルコマンドで実行するときは，標準入力，標準出力，および標準エラー出力を切断（標準入力，標準出力，および標準エラー出力に/dev/nullを割り当てる）しておいてください。切断しないでコマンドを実行した場合，JP1/AJS3のプロセスまたはサービスの起動が完了しても，リモートシェルコマンドが終了しないおそれがあります。

UNIXの場合，このコマンドを実行してJP1/AJS3サービスを起動したときは，コマンドを実行したときのカレントディレクトリを削除しないでください。JP1/AJS3サービスを起動したカレントディレクトリを削除する場合は，あらかじめJP1/AJS3サービスを終了させてください。

Windowsの場合，ショートファイル名では実行できません。

ディザスター・リカバリー運用をしている場合，このコマンドを実行する前に，jajs_rpsiteコマンドに-vオプションまたは-Vオプションを指定して実行し，ディザスター・リカバリー運用が正しくセットアップされているか確認してください。

戻り値

0

正常終了。

0以外の値

異常終了。

使用例1

JP1/AJS3をコールドスタートします。

jajs_spmd -cold

使用例2

JP1/AJS3のスケジューラーサービス（AJSROOT1）が異常終了したため，問題を解決したあとにそのスケジューラーサービスだけを起動します。

jajs_spmd -n jajs_schd -F AJSROOT1

jajs_spmd_status

形式

JP1/AJS3 - Managerの場合

jajs_spmd_status
     [-h 論理ホスト名]
     [-s|-a]
     [-t 時間]

JP1/AJS3 - Agentの場合

jajs_spmd_status
     [-h 論理ホスト名]
     [-t 時間]

機能

jajs_spmdに対し，jajs_spmdの子プロセスまたはサービスの状態を確認します。

jajs_spmdの子プロセスまたはサービスについては，マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング　付録B プロセス一覧」を参照してください。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

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

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

UNIXの場合

/opt/jp1ajs2/bin/

引数

-h 論理ホスト名

クラスタで運用している場合に，状態を確認したい論理ホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名（hostnameコマンドで求められるホスト名）が仮定されます。

-s|-a

JP1/AJS3 - Managerの場合に表示する状態を指定します。

-s

各コンポーネントサービスのプロセス状態だけを表示する場合に指定します。

-a

各コンポーネントサービスのプロセス状態および各コンポーネントサービス配下のプロセス状態すべてを表示する場合に指定します。

-t 時間

JP1/AJS3の状態を確認する際のタイムアウト時間を指定します。確認対象プロセスごとのタイムアウト時間であり，コマンド全体のタイムアウト時間ではありません。

指定できる値は，0〜32,767（単位：秒）です。

省略した場合，60秒が仮定されます。また，0を指定した場合も，60秒が指定されたと仮定されます。

なお，指定した時間内にjajs_spmd_statusコマンドによる確認が終了しない場合，jajs_spmd_statusコマンドの実行に失敗したと見なされます。

表示されるプロセス名称と実際のプロセス名との対応

jajs_spmd_statusコマンドで出力されるプロセス名称と，実際のプロセス名との対応について， 次に示します。

実際のプロセス名の詳細については，マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング　付録B プロセス一覧」を参照してください。

表3‒31　JP1/AJS3 - Managerのjajs_spmd_statusコマンドで表示されるプロセス名称と実際のプロセス名との対応(Windowsの場合)

jajs_spmd_statusコマンドで表示されるプロセス名称

実際のプロセス名

jajs_dbmd

jajs_dbmd.exe

ajsdbmgrd※1

ajsdbmgrd.exe

jajs_hstd

jajs_hstd.exe

hlogd

ajshlogd.exe

ajsinetd

ajsinetd.exe

network

ajsnetwd.exe

queue

jpqman.exe

agentm

ajsagtmd.exe

submitqueue

jpqman.exe

hostevam

jpomanager.exe

gatewayd

ajsgwmasterd.exe

ajscdinetd

ajscdinetd.exe

ajsovstatd

ajsovstatd.exe

qlcltd

ajsqlcltd.exe

jajs_agtd

jajs_agtd.exe

queuea

jpqmon.exe

evactiona

jpoagent.exe

jajs_schd

jajs_schd.exe

slogd

ajslogd.exe

queuem

jpqman.exe

evactionm

jpomanager.exe

schedule

ajsmasterd.exe

agentmon

ajsagtmond.exe

表3‒32　JP1/AJS3 - Agentのjajs_spmd_statusコマンドで表示されるプロセス名称と実際のプロセス名との対応(Windowsの場合)

jajs_spmd_statusコマンドで表示されるプロセス名称

実際のプロセス名

qlcltd

ajsqlcltd.exe

queuea

jpqmon.exe

evactiona

jpoagent.exe

表3‒33　JP1/AJS3 - Managerのjajs_spmd_statusコマンドで表示されるプロセス名称と実際のプロセス名との対応(UNIXの場合)

jajs_spmd_statusコマンドで表示されるプロセス名称

実際のプロセス名

jajs_dbmd

jajs_dbmd

ajsdbmgrd※1

ajsdbmgrd

jajs_hstd

jajs_hstd

ajshlogd

ajshlogd

ajsinetd

ajsinetd

ajsnetwd

ajsnetwd

ajsagtmd

ajsagtmd

jpqman_hst

jpqman※2

jpomanager_hst

jpomanager

ajsgwmasterd

ajsgwmasterd

ajscdinetd

ajscdinetd

ajsovstatd

ajsovstatd

jajs_agtd

jajs_agtd

jpqmon

jpqmon

jpoagent

jpoagent

jajs_schd

jajs_schd

ajslogd

ajslogd

jpqman

jpqman

jpomanager

jpomanager

ajsmasterd

ajsmasterd

ajsagtmond

ajsagtmond

表3‒34　JP1/AJS3 - Agentのjajs_spmd_statusコマンドで表示されるプロセス名称と実際のプロセス名との対応(UNIXの場合)

jajs_spmd_statusコマンドで表示されるプロセス名称

実際のプロセス名

jpqmon

jpqmon

jpoagent

jpoagent

注※1

V9からV10以降へバージョンアップインストールした際などに，database（Windowsの場合だけ）およびajsembdbが表示されることがあります。

注※2

HP-UX，AIX，およびLinuxの場合，詳細プロセス名は「jpqman32」です。

注意事項

JP1/Power Monitorとの連携運用中で，かつ，JP1/Power Monitorからシステム終了処理を実行している間は，このコマンドを実行しないでください。

同一論理ホスト上では，次のコマンドと同時に実行できません。

ajsprofalterコマンド

ajsembdbstartコマンド

ajsembdbstopコマンド

ajsstartコマンド

ajsstopコマンド

jajs_hstdコマンド

jajs_hstd_stopコマンド

jajs_spmdコマンド

jajs_spmd_statusコマンド

jajs_spmd_stopコマンド

jajs_startコマンド（UNIX限定）

jajs_start.clusterコマンド（UNIX限定）

jajs_stopコマンド（UNIX限定）

jajs_stop.clusterコマンド（UNIX限定）

Windowsの場合，ショートファイル名では実行できません。

戻り値

0

次のどれか。

すべてのプロセスが起動している

jajs_spmd_stopコマンドの-nオプションやajsstopコマンドなどによって一部のプロセスが停止している

停止処理中（異常終了したプロセスがない）

1

次のどれか。

プロセス管理との通信などでエラーが発生した

クラスタで運用している場合に，共有ディレクトリがマウントされていない

実行する権限がない

4

次のどれか。

一部のプロセスが起動している（異常終了したプロセスがある）

起動処理中

停止処理中（異常終了したプロセスがある）

8

すべてのプロセスが終了している。

12

次のどれか。

jajs_spmd_statusコマンドの処理でエラーが発生し，プロセスの状態を取得できなかった

JP1/AJS3の状態取得の要求がタイムアウトした

jajs_spmd_statusコマンドが状態取得に失敗しています。一時的なエラーのおそれがあるので，次に示す方法で対処してください。

時間を空けてjajs_spmd_statusコマンドを再実行する

jajs_spmd_statusコマンドを複数回実行しても回復しない場合は異常と判断する

使用例

論理ホスト（lhost）のJP1/AJS3の各コンポーネントサービスのプロセス状態および各コンポーネントサービス配下のプロセス状態を確認します。

jajs_spmd_status -h lhost -a

出力例1

JP1/AJS3 - Managerで，-aオプションを指定した場合の出力例を次に示します。

出力例2

JP1/AJS3 - Managerで，-sオプションを指定した場合の出力例を次に示します。

出力例3

JP1/AJS3 - Agentの出力例を次に示します。

出力内容を次に示します。

プロセス名称

プロセス名が出力されます。

プロセスID

プロセスIDが出力されます。

属性

組み込みDBを識別するセットアップ識別子，またはスケジューラーサービス名が出力されます。

jajs_spmd_stop

形式

JP1/AJS3 - Managerの場合

jajs_spmd_stop
     [-h 論理ホスト名]
     [-n jajs_agtd |
      -n jajs_schd [-F スケジューラーサービス名]|
      -n jajs_dbmd [-id 組み込みDBセットアップ識別子]]
     [-job|-kill]

JP1/AJS3 - Agentの場合

jajs_spmd_stop
     [-h 論理ホスト名]
     [-job|-kill]

機能

JP1/AJS3サービスの終了またはJP1/AJS3の各機能に対応するプロセスを終了します。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

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

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

UNIXの場合

/opt/jp1ajs2/bin/

引数

-h 論理ホスト名

クラスタで運用している場合に，プロセスまたはサービスを終了する論理ホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名（hostnameコマンドで求められるホスト名）が仮定されます。

-n プロセス名

終了するプロセス名を指定します。指定できるプロセス名を次に示します。

JP1/AJS3 - Managerの場合

jajs_schd（スケジューラーサービス管理）

jajs_agtd（エージェントサービス管理）

jajs_dbmd（DB管理）

スケジューラーサービスを終了する場合は，jajs_schdを指定して-Fオプションにスケジューラーサービス名を指定します。また，論理ホストのスケジューラーサービスを終了する場合は，-hオプションと-Fオプションを同時に指定します。

組み込みDBを終了する場合は，jajs_dbmdを指定して-idオプションに組み込みDBセットアップ識別子を指定します。論理ホストの組み込みDBを終了する場合は，-hオプションと-idオプションを同時に指定します。

省略した場合，プロセス定義ファイルにある起動中のすべてのプロセスを停止します。

-F スケジューラーサービス名

終了するスケジューラーサービス名を指定します。-nオプションにjajs_schdを指定した場合にだけ指定できます。

高度なオプションを指定してスケジューラーサービスを停止する場合は，ajsstopコマンドを使用してください。ajsstopコマンドの詳細については，「3. 通常の運用で使用するコマンド　ajsstop」を参照してください。

省略した場合，デフォルトスケジューラーサービスを仮定します。

-id 組み込みDBセットアップ識別子

組み込みDBを識別するセットアップ識別子を「_JFn」（nは0〜9またはA〜Z）の4文字で指定します。ajsembdbbuildコマンドの-idオプションで指定した値を指定してください。

jajs_setupコマンド，jajs_setup_clusterコマンド，およびjajs_migrateコマンドで作成された組み込みDBに対して操作する場合，ajsembdbidlistコマンドで操作対象となる組み込みDBのセットアップ識別子を確認してください。ajsembdbidlistコマンドの詳細については，「2. セットアップコマンド　ajsembdbidlist」を参照してください。

高度なオプションを指定して組み込みDBを停止する場合は，ajsembdbstopコマンドを使用してください。ajsembdbstopコマンドの詳細については，「3. 通常の運用で使用するコマンド　ajsembdbstop」を参照してください。

このオプションを省略した場合は，_JF0が仮定されます。

-job|-kill

JP1/AJS3プロセスまたはサービスの終了モードを指定します。

省略した場合，自JP1/AJS3サービスをエージェントとして実行中のジョブ（JP1/AJS3サービス配下のプロセスとして起動しているジョブ）に強制終了を要求し，実行中のジョブやジョブネットの終了を待たずに終了します。

-job

実行中のすべてのジョブが終了したあと，プロセスまたはサービスを終了します。

-kill

自JP1/AJS3サービスをエージェントとして実行中のジョブ（JP1/AJS3サービス配下のプロセスとして起動しているジョブ）に強制終了を要求し，実行中のジョブやジョブネットの終了を待たずに，プロセスまたはサービスを終了します。JP1/AJS3サービス起動中や計画停止などでのサービス停止中でも，割り込んで強制的にプロセスまたはサービスを終了します。JP1/AJS3サービス起動中に-killオプションを指定しないでこのコマンドを実行した場合，エラーになります。

注意事項

このコマンドでは次に示すプロセスまたはサービスを終了できません。

jpomlsrv（Windowsの場合）

このコマンドは，JP1/AJS3のプロセスまたはサービスの終了完了を待たないで終了します。JP1/AJS3のプロセスまたはサービスが終了したかどうかは，jajs_spmd_statusコマンドで確認してください。

JP1/Power Monitorとの連携運用中で，かつ，JP1/Power Monitorからシステム終了処理を実行している間は，このコマンドを実行しないでください。

同一論理ホスト上では，次のコマンドと同時に実行できません。

ajsprofalterコマンド

ajsembdbstartコマンド

ajsembdbstopコマンド

jajs_hstdコマンド

jajs_hstd_stopコマンド

jajs_spmdコマンド（-nオプションにjajs_schdを指定しない場合）

jajs_spmd_statusコマンド

jajs_spmd_stopコマンド（-nオプションにjajs_schdを指定しない場合）

jajs_startコマンド（UNIX限定）

jajs_start.clusterコマンド（UNIX限定）

jajs_stopコマンド（UNIX限定）

jajs_stop.clusterコマンド（UNIX限定）

同一スケジューラーサービスを指定する場合，次のコマンドと同時に実行できません。

ajsstartコマンド

ajsstopコマンド

jajs_spmdコマンド（-nオプションにjajs_schdを指定する場合）

jajs_spmd_stopコマンド（-nオプションにjajs_schdを指定する場合）

イベントジョブ実行継続オプションを使用していると，このコマンドでエージェントホストのJP1/AJS3を終了させても，マネージャーホスト上のイベントジョブおよびカスタムイベントジョブの状態は「実行中」のままとなります。そのため，-jobオプションでジョブの終了を待って停止する運用の場合は，JP1/AJS3を停止できません。イベントジョブ実行継続オプションと-jobオプションを併用する場合は，実行中のイベントジョブおよびカスタムイベントジョブの終了を待つか，イベントジョブおよびカスタムイベントジョブを強制終了する，またはスケジュールなどによってイベントジョブおよびカスタムイベントジョブが終了している状態でコマンドを実行するなど，計画的な運用が必要です。

Windowsの場合，ショートファイル名では実行できません。

戻り値

0

正常終了。

0以外の値

異常終了。

使用例

実行中のすべてのジョブが終了したあと，JP1/AJS3の各サービスを停止します。

jajs_spmd_stop -job

jajs_start（UNIX限定）

形式

jajs_start

機能

物理ホストのJP1/AJS3を起動します。

このコマンドはシステム起動時に実行されます。

このコマンドが行う処理の流れを次に示します。

キューレスエージェントサービスが起動していない場合，キューレスエージェントサービスを起動します。

キューレスファイル転送サービスが起動していない場合，キューレスファイル転送サービスを起動します。

JP1/AJS3を起動します。

JP1/AJS3 Check Managerサービスが起動していない場合，JP1/AJS3 Check Managerサービスを起動します。

JP1/AJS3 Check Agentサービスが起動していない場合，JP1/AJS3 Check Agentサービスを起動します。

JP1/AJS3 Autonomous Agentサービス，およびJP1/AJS3 Autonomous Agent Messengerサービスが起動していない場合，JP1/AJS3 Autonomous Agentサービス，およびJP1/AJS3 Autonomous Agent Messengerサービスを起動します。

jajs_spmd_statusコマンドを実行し，JP1/AJS3が起動するまで最大で60秒間待ちます。

jajs_spmd_statusコマンドを実行し，JP1/AJS3のプロセスの状態を表示します。

JP1/AJS3のインストール直後は，起動処理の定義がコメント化されているため，起動処理は無効になっています。必要に応じて，起動処理が有効になるようにカスタマイズしてください。カスタマイズの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　15.10.1 JP1/AJS3サービスの自動起動および自動終了の設定」を参照してください。

実行権限

スーパーユーザー権限

格納先ディレクトリ

/etc/opt/jp1ajs2/

注意事項

このコマンドはUNIXだけで実行できます。Windowsでは実行できません。

このコマンドを次のコマンドと同時に実行すると，JP1/AJS3が正しく起動しないおそれがあります。

ajsprofalterコマンド

ajsembdbstartコマンド

ajsembdbstopコマンド

ajsstartコマンド

ajsstopコマンド

jajs_hstdコマンド

jajs_hstd_stopコマンド

jajs_spmdコマンド

jajs_spmd_statusコマンド

jajs_spmd_stopコマンド

jajs_startコマンド（UNIX限定）

jajs_stopコマンド（UNIX限定）

環境変数JP1_HOSTNAMEが設定されていない環境でこのコマンドを実行してください。環境変数JP1_HOSTNAMEが設定されている環境でこのコマンドを実行すると，物理ホストではなく環境変数JP1_HOSTNAMEに設定した論理ホストのJP1/AJS3を起動しようとします。物理ホストのJP1/AJS3を起動する場合は，環境変数JP1_HOSTNAMEを削除してください。このコマンドは論理ホストに対応していません。

このコマンドをリモートシェルコマンドで実行する場合は，標準入力，標準出力，および標準エラー出力を切断（標準入力，標準出力，および標準エラー出力に/dev/nullを割り当てる）しておいてください。切断しないでコマンドを実行した場合，JP1/AJS3サービスの起動が完了しても，リモートシェルコマンドが終了しないおそれがあります。

Linuxの場合，標準設定で，コアファイル出力時の最大サイズが「0」となっていることがあります。この場合，コアダンプは出力されません。

しかし，jajs_startコマンドのスクリプトではデフォルトで，JP1/AJS3のプロセス起動時にコアファイル出力時の最大サイズを設定して，コアダンプを出力できるようにしています。

if [ 'uname' = Linux ]; then
  ulimit -c unlimited
fi

この設定は，次のように行の先頭に「#」を付けることで，コメント行に変更できます。

#if [ 'uname' = Linux ]; then
#  ulimit -c unlimited
#fi

コメント行への変更は，次のような場合に実施してください。

コアファイル出力設定が使用中のホストのセキュリティポリシーに反する場合

JP1管理者グループのAJS管理者であるOSユーザーでjajs_startコマンドを実行する場合に，標準設定でコアファイル出力時の最大サイズを変更しているとき

この場合，設定行をコメント行に変更していないと，jajs_startコマンドの実行時に標準エラー出力へエラーメッセージが出力されます。

コメント行に変更すると，jajs_startコマンドによって起動されたJP1/AJS3のプロセス内では，コアファイル出力時の最大サイズは変更されません。ただし，JP1/AJS3のプロセスのセグメンテーション障害やバス障害などのコアダンプの出力契機でコアダンプの出力が不完全になります。そのため，障害の調査ができなくなるおそれがあります。

戻り値

0

正常終了。

0以外の値

異常終了。

jajs_start.cluster（UNIX限定）

形式

jajs_start.cluster
     [論理ホスト名]
     [jajs_spmdコマンドのオプション]

機能

論理ホスト環境で，JP1/AJS3を起動します。

クラスタでJP1/AJS3の起動を制御するコマンドです。このコマンドを，クラスタに登録して使用します。

このコマンドが行う処理の流れを次に示します。

キューレスエージェントサービスが起動していない場合，キューレスエージェントサービスを起動します。

キューレスファイル転送サービスが起動していない場合，キューレスファイル転送サービスを起動します。

キューレスエージェントサービスに論理ホストがアタッチされていない場合，論理ホストをアタッチします。

jajs_spmdコマンドを実行し，JP1/AJS3のプロセスを起動します。

JP1/AJS3 Check Managerサービスが起動していない場合，JP1/AJS3 Check Managerサービスを起動します。

JP1/AJS3 Check Agentサービスが起動していない場合，JP1/AJS3 Check Agentサービスを起動します。

JP1/AJS3 Autonomous Agentサービス，およびJP1/AJS3 Autonomous Agent Messengerサービスが起動していない場合，JP1/AJS3 Autonomous Agentサービス，およびJP1/AJS3 Autonomous Agent Messengerサービスを起動します。

jajs_spmd_statusコマンドを実行し，JP1/AJS3が起動するまで最大で60秒間待ちます。また，JP1/AJS3を起動できない場合，キューレスエージェントサービスの論理ホストをデタッチします。

jajs_spmd_statusコマンドを実行し，JP1/AJS3のプロセスの状態を表示します。

JP1/AJS3のインストール直後は，JP1/AJS3のプロセスだけ起動し，ほかのサービスの起動処理はコメント化されています。必要に応じて，起動処理が有効になるようにカスタマイズしてください，カスタマイズの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　17.2.11 論理ホスト環境のJP1/AJS3の起動および終了を制御する設定」を参照してください。

実行権限

スーパーユーザー権限

格納先ディレクトリ

/etc/opt/jp1ajs2/

引数

論理ホスト名

JP1/AJS3を起動する，論理ホスト環境の論理ホスト名を指定します。

指定できる文字数は，1〜63（単位：バイト）です。

省略した場合，環境変数JP1_HOSTNAMEに指定しているホスト名が仮定されます。このオプションを省略し，環境変数JP1_HOSTNAMEに何も指定していない場合，このコマンドは異常終了します。

jajs_spmdコマンドのオプション

jajs_spmdコマンドのオプションを指定します。ただし，jajs_spmdコマンドの論理ホスト名のオプション（-hオプション）は指定できません。

jajs_spmdコマンドに-HAオプションを設定する場合は，ここに-HAを指定してください。

オプションの詳細については，「3. 通常の運用で使用するコマンド　jajs_spmd」を参照してください。

注意事項

このコマンドはUNIXだけで実行できます。Windowsでは実行できません。

このコマンドにオプションを指定する場合，引数の第一オプションには，必ず論理ホスト名を指定してください。

jajs_spmdコマンドのオプションを指定する場合，論理ホスト名の指定は省略できません。

同一論理ホストに対して，このコマンドを次のコマンドと同時に実行すると，JP1/AJS3が正しく起動しないおそれがあります。

ajsprofalterコマンド

ajsembdbstartコマンド

ajsembdbstopコマンド

ajsstartコマンド

ajsstopコマンド

jajs_hstdコマンド

jajs_hstd_stopコマンド

jajs_spmdコマンド

jajs_spmd_statusコマンド

jajs_spmd_stopコマンド

jajs_start.clusterコマンド（UNIX限定）

jajs_stop.clusterコマンド（UNIX限定）

このコマンドをリモートシェルコマンドで実行する場合は，標準入力，標準出力，および標準エラー出力を切断（標準入力，標準出力，および標準エラー出力に/dev/nullを割り当てる）しておいてください。切断しないでコマンドを実行した場合，JP1/AJS3サービスの起動が完了しても，リモートシェルコマンドが終了しないおそれがあります。

Linuxの場合，標準設定で，コアファイル出力時の最大サイズが「0」となっていることがあります。この場合，コアダンプは出力されません。

しかし，jajs_start.clusterコマンドのスクリプトではデフォルトで，JP1/AJS3のプロセス起動時にコアファイル出力時の最大サイズを設定して，コアダンプを出力できるようにしています。

if [ 'uname' = Linux ]; then
  ulimit -c unlimited
fi

この設定は，次のように行の先頭に「#」を付けることで，コメント行に変更できます。

#if [ 'uname' = Linux ]; then
#  ulimit -c unlimited
#fi

コメント行への変更は，次のような場合に実施してください。

コアファイル出力設定が使用中のホストのセキュリティポリシーに反する場合

JP1管理者グループのAJS管理者であるOSユーザーでjajs_start.clusterコマンドを実行する場合に，標準設定でコアファイル出力時の最大サイズを変更しているとき

この場合，設定行をコメント行に変更していないと，jajs_start.clusterコマンドの実行時に標準エラー出力へエラーメッセージが出力されます。

コメント行に変更すると，jajs_start.clusterコマンドによって起動されたJP1/AJS3のプロセス内では，コアファイル出力時の最大サイズは変更されません。ただし，JP1/AJS3のプロセスのセグメンテーション障害やバス障害などのコアダンプの出力契機でコアダンプの出力が不完全になります。そのため，障害の調査ができなくなるおそれがあります。

戻り値

0

正常終了。

0以外の値

異常終了。

jajs_status

形式

jajs_status
     [-h 論理ホスト名 | -F スケジューラーサービス名 | -v | -c]
     [-s|-e|-a]

形式1（論理ホストの稼働情報の確認）

jajs_status
     -h 論理ホスト名
     [-s|-e|-a]

形式2（スケジューラーサービスの稼働情報の確認）

jajs_status
     -F スケジューラーサービス名
     [-s|-e|-a]

形式3（JP1/AJS3 - Viewの接続情報の確認）

jajs_status
     -v

形式4（JP1/AJS3 - Web Consoleの接続情報の確認）

jajs_status
     -c

機能

JP1/AJS3の稼働情報を確認します。指定したオプションに応じて次の情報を確認できます。

システムの稼働情報

稼働中に有効な環境設定パラメーター情報

実行権限

なし

引数

-h 論理ホスト名

稼働情報を確認する論理ホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名（JP1_DEFAULT）が仮定されます。

-F スケジューラーサービス名

特定のスケジューラーサービスの稼働情報だけを確認する場合に，スケジューラーサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

-v

JP1/AJS3 - Managerに接続しているJP1/AJS3 - Viewの接続情報を確認する場合に指定します。

このオプションは，JP1/AJS3サービスが起動している場合に指定できます。

このオプションは，ほかのオプションと同時には指定できません。

出力される情報は，ajsstatusコマンドで-vオプションを指定した場合と同じ情報です。詳細については，「3. 通常の運用で使用するコマンド　ajsstatus」を参照してください。

-c

JP1/AJS3 - Managerに接続しているJP1/AJS3 - Web Consoleの接続情報を確認する場合に指定します。

このオプションは，JP1/AJS3サービスが起動している場合に指定できます。

このオプションは，ほかのオプションと同時には指定できません。

出力される情報は，ajsstatusコマンドで-cオプションを指定した場合と同じ情報です。詳細については，「3. 通常の運用で使用するコマンド　ajsstatus」を参照してください。

-s

システムの稼働情報を示します。

このオプションは，-hまたは-Fオプションと同時に指定します。-vオプションと同時には指定できません。

-e

稼働中に有効な環境設定パラメーター情報を表示します。

このオプションは，-hまたは-Fオプションと同時に指定します。-vオプションと同時には指定できません。

-a

システムの稼働情報および稼働中に有効な環境設定パラメーター情報を表示します。

このオプションは，-hまたは-Fオプションと同時に指定します。-vオプションと同時には指定できません。

注意事項

-h，-F，および-vオプションのどれも指定しなかった場合，-hオプションが指定されたものとして処理されます。

-s，-e，および-aオプションのどれも指定しなかった場合，-sオプションが指定されたものとして処理されます。

JP1/AJS3サービスが起動していない場合，このコマンドは異常終了します。

戻り値

0

正常終了。

0以外の値

異常終了。

使用例1

論理ホスト（HOST_A）の稼働情報を確認します。

jajs_status -h HOST_A -s

使用例2

スケジューラーサービス（AJSROOT1）の稼働情報と，稼働中に有効な環境設定パラメーター情報を表示します。

jajs_status -F AJSROOT1 -a

出力例1

-hオプションを指定した場合の出力例と出力内容の意味を次に示します。

出力内容を次に示します。

<論理ホスト基本情報>

論理ホスト

論理ホスト名が出力されます。

状態

論理ホストの状態が出力されます。

運用中：

論理ホストのJP1/AJS3が運用中であることを示します。

停止：

論理ホストのJP1/AJS3が停止していることを示します。

開始時刻

「運用中」状態の場合は，論理ホストの開始時刻が「yyyy/mm/dd hh:mm」の形式で出力されます。

「停止」状態の場合は，「****/**/** **:**」が出力されます。

DB構成

「運用中」状態の場合は，DB構成（「標準構成」）が出力されます。

「停止」状態の場合は，「***」が出力されます。

使用中のスケジューラーログファイル名

「運用中」状態の場合は，使用中のスケジューラーログファイル名が出力されます。

「停止」状態の場合は，「***」が出力されます。

交代用のスケジューラーログファイル名

「運用中」状態の場合は，交代用のスケジューラーログファイル名が出力されます。

「停止」状態の場合は，「***」が出力されます。

<論理ホストサービス情報>

サービスごとに次の内容が出力されます。

DBサービス数

DBサービス数が出力されます。

DBサービス

DBサービスのセットアップ識別子が出力されます。

状態

DBサービスの状態が出力されます。

運用中：

DBサービスが運用中であることを示します。

停止：

DBサービスが停止していることを示します。

開始時刻

「運用中」状態の場合は，DBサービスの開始時刻が「yyyy/mm/dd hh:mm」の形式で出力されます。

「停止」状態の場合は，「****/**/** **:**」が出力されます。

再起動回数

「運用中」状態の場合は，DBサービスの再起動回数が出力されます。

「停止」状態の場合は，「***」が出力されます。

ホストサービス

状態

ホストサービスの状態が出力されます。

運用中：

ホストサービスが運用中であることを示します。

停止：

ホストサービスが停止していることを示します。

開始時刻

「運用中」状態の場合は，ホストサービスの開始時刻が「yyyy/mm/dd hh:mm」の形式で出力されます。

「停止」状態の場合は，「****/**/** **:**」が出力されます。

再起動回数

「運用中」状態の場合は，ホストサービスの再起動回数が出力されます。

「停止」状態の場合は，「***」が出力されます。

エージェントサービス

状態

エージェントサービスの状態が出力されます。

運用中：

エージェントサービスが運用中であることを示します。

停止：

エージェントサービスが停止していることを示します。

開始時刻

「運用中」状態の場合は，エージェントサービスの開始時刻が「yyyy/mm/dd hh:mm」の形式で出力されます。

「停止」状態の場合は，「****/**/** **:**」が出力されます。

再起動回数

「運用中」状態の場合は，エージェントサービスの再起動回数が出力されます。

「停止」状態の場合は，「***」が出力されます。

スケジューラーサービス数

スケジューラーサービス数が出力されます。

スケジューラーサービス

スケジューラーサービス名が出力されます。

状態

スケジューラーサービスの状態が出力されます。

運用中：

スケジューラーサービスが運用中であることを示します。

停止：

スケジューラーサービスが停止していることを示します。

開始時刻

「運用中」状態の場合は，スケジューラーサービスの開始時刻が「yyyy/mm/dd hh:mm」の形式で出力されます。

「停止」状態の場合は，「****/**/** **:**」が出力されます。

再起動回数

「運用中」状態の場合は，スケジューラーサービスの再起動回数が出力されます。

「停止」状態の場合は，「***」が出力されます。

組み込みDBセットアップ識別子

組み込みDBセットアップ識別子が出力されます。

<論理ホスト環境情報>

論理ホストの稼働中に有効な，次の定義キーの環境設定パラメーター情報が出力されます。

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥DB]

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HOST]およびその下に存在する定義キー

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

環境設定パラメーターの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20. 環境設定パラメーター」を参照してください。

出力例2

-Fオプションを指定した場合の出力例と出力内容の意味を次に示します。

出力内容を次に示します。

<スケジューラーサービス基本情報>

スケジューラーサービス

スケジューラーサービス名が出力されます。

状態

スケジューラーサービスの状態が出力されます。

運用中：

スケジューラーサービスが運用中であることを示します。

停止：

スケジューラーサービスが停止していることを示します。

開始時刻

「運用中」状態の場合は，スケジューラーサービスの開始時刻が「yyyy/mm/dd hh:mm」の形式で出力されます。

「停止」状態の場合は，「****/**/** **:**」が出力されます。

再起動回数

「運用中」状態の場合は，スケジューラーサービスの再起動回数が出力されます。

「停止」状態の場合は，「***」が出力されます。

組み込みDBセットアップ識別子

組み込みDBセットアップ識別子が出力されます。

使用中のスケジューラーログファイル名

「運用中」状態の場合は，使用中のスケジューラーログファイル名が出力されます。

「停止」状態の場合は，「***」が出力されます。

交代用のスケジューラーログファイル名

「運用中」状態の場合は，交代用のスケジューラーログファイル名が出力されます。

「停止」状態の場合は，「***」が出力されます。

<スケジューラーサービス機能情報>

指定したスケジューラーサービスの次の内容が出力されます。

状態

スケジューラー機能の状態が出力されます。

運用中：

スケジューラー機能が運用中であることを示します。

停止：

スケジューラー機能が停止していることを示します。

開始時刻

「運用中」状態の場合は，スケジューラー機能の開始時刻が「yyyy/mm/dd hh:mm」の形式で出力されます。

「停止」状態の場合は，「****/**/** **:**」が出力されます。

再起動回数

「運用中」状態の場合は，スケジューラー機能の再起動回数が出力されます。

「停止」状態の場合は，「***」が出力されます。

終了制限

「運用中」状態の場合は，終了制限の状態が出力されます。

なし：

ajsstopコマンドが実行されていないことを示します。

スケジュール：

スケジュール制限による終了監視中であることを示します。

ジョブネット：

ジョブネット制限による終了監視中であることを示します。

ジョブ：

ジョブ制限による終了監視中であることを示します。

強制停止：

強制停止中であることを示します。

停止：

停止中であることを示します。

制限解除：

終了制限が解除された状態であることを示します。

「停止」状態の場合は，「***」が出力されます。

<スケジューラーサービス環境情報>

スケジューラーサービスの稼働中に有効な，次の定義キーの環境設定パラメーター情報が出力されます。

[JP1_DEFAULT¥JP1AJSMANAGER]

システムで共通の環境設定パラメーターです。

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

-Fオプションに指定したスケジューラーサービスが存在する論理ホストで共通の環境設定パラメーターです。

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]およびその下に存在する定義キー

-Fオプションに指定したスケジューラーサービスの環境設定パラメーターです。

スケジューラーサービスの環境設定パラメーターの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20. 環境設定パラメーター」を参照してください。

出力例3

データベースが外部DBの場合の出力例と出力内容の意味を次に示します。その他の項目については出力例1および出力例2を参照してください。

出力内容を次に示します。

<論理ホスト基本情報>

DB種別

データベースの種類を示します。DB構成が「標準構成」かつデータベースが外部DBの場合だけ出力します。

外部DB（Microsoft SQL Server）の場合：SQLSVR

<論理ホストサービス情報>

ODBCファイルデータソース名

外部DBと接続するためのODBCファイルデータソース名が出力されます。DB構成が「標準構成」かつDB種別が「SQLSVR」の場合だけ出力します。

データベース名

スケジューラーサービス情報が格納されている外部DB上のデータベース名が出力されます。DB構成が「標準構成」かつDB種別が「SQLSVR」の場合だけ出力されます。

<論理ホストサービス環境情報>

外部DB接続情報に関係する，環境設定パラメーター情報が出力されます。

[{JP1_DEFAULT|論理ホスト名}¥JP1AJS2¥HOST¥AGENTMANAGER]

環境設定パラメーターの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20. 環境設定パラメーター」を参照してください。

<スケジューラーサービス基本情報>

ODBCファイルデータソース名

外部DBと接続するためのODBCファイルデータソース名が出力されます。DB構成が「標準構成」かつDB種別が「SQLSVR」の場合だけ出力します。

データベース名

スケジューラーサービス情報が格納されている外部DB上のデータベース名が出力されます。DB構成が「標準構成」かつDB種別が「SQLSVR」の場合だけ出力されます。

<スケジューラーサービス環境情報>

外部DB接続情報に関係する，環境設定パラメーター情報が出力されます。

[{JP1_DEFAULT|論理ホスト名}¥JP1AJSMANAGER¥スケジューラーサービス名]

スケジューラーサービスの環境設定パラメーターの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20. 環境設定パラメーター」を参照してください。

jajs_stop（UNIX限定）

形式

jajs_stop

機能

物理ホストのJP1/AJS3を停止します。

このコマンドは，システム停止時に実行されます。

このコマンドが行う処理の流れを次に示します。

jajs_spmd_stopコマンドを実行し，JP1/AJS3を停止します。

JP1/AJS3 Autonomous Agentサービス，およびJP1/AJS3 Autonomous Agent Messengerサービスを停止します。

JP1/AJS3 Check ManagerサービスおよびJP1/AJS3 Check Agentサービスを停止します。

psコマンドを実行してjajs_spmdプロセスを監視し，JP1/AJS3が停止するまで待ちます。

キューレスエージェントサービスを停止します。

キューレスファイル転送サービスを停止します。

JP1/AJS3のインストール直後は，停止処理の定義がコメント化されているため，停止処理は無効になっています。必要に応じて，停止処理が有効になるようにカスタマイズしてください。カスタマイズの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　15.10.1 JP1/AJS3サービスの自動起動および自動終了の設定」を参照してください。

実行権限

スーパーユーザー権限

格納先ディレクトリ

/etc/opt/jp1ajs2/

注意事項

このコマンドはUNIXだけで実行できます。Windowsでは実行できません。

このコマンドを次のコマンドと同時に実行すると，JP1/AJS3が正しく停止しないおそれがあります。

ajsprofalterコマンド

ajsembdbstartコマンド

ajsembdbstopコマンド

ajsstartコマンド

ajsstopコマンド

jajs_hstdコマンド

jajs_hstd_stopコマンド

jajs_spmdコマンド

jajs_spmd_statusコマンド

jajs_spmd_stopコマンド

jajs_startコマンド（UNIX限定）

jajs_stopコマンド（UNIX限定）

環境変数JP1_HOSTNAMEが設定されていない環境でこのコマンドを実行してください。環境変数JP1_HOSTNAMEが設定されている環境でこのコマンドを実行すると，物理ホストではなく環境変数JP1_HOSTNAMEに設定した論理ホストのJP1/AJS3を停止しようとします。物理ホストのJP1/AJS3を停止する場合は，環境変数JP1_HOSTNAMEを削除してください。このコマンドは論理ホストに対応していません。

戻り値

0

正常終了。

0以外の値

異常終了。

jajs_stop.cluster（UNIX限定）

形式

jajs_stop.cluster
     [論理ホスト名]
     [jajs_spmd_stopコマンドのオプション]

機能

論理ホスト環境で起動しているJP1/AJS3を停止します。

クラスタからJP1/AJS3の停止を制御するコマンドです。このコマンドを，クラスタに登録して使用します。

このコマンドが行う処理の流れを次に示します。

JP1/AJS3を停止します。

JP1/AJS3 Autonomous Agentサービス，およびJP1/AJS3 Autonomous Agent Messengerサービスを停止します。

JP1/AJS3 Check ManagerサービスおよびJP1/AJS3 Check Agentサービスを停止します。

psコマンドを実行してjajs_spmdプロセスを監視し，JP1/AJS3が停止するまで最大で60秒間待ちます。

キューレスエージェントサービスに論理ホストがアタッチしている場合は，論理ホストをデタッチします。

キューレスエージェントサービスを停止します。

キューレスファイル転送サービスを停止します。

JP1/AJS3のインストール直後は，JP1/AJS3のプロセスだけ停止し，ほかのサービスの停止処理はコメント化されています。必要に応じて，停止処理が有効になるようにカスタマイズしてください，カスタマイズの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　17.2.11 論理ホスト環境のJP1/AJS3の起動および終了を制御する設定」を参照してください。

実行権限

スーパーユーザー権限

格納先ディレクトリ

/etc/opt/jp1ajs2/

引数

論理ホスト名

JP1/AJS3を停止する，論理ホスト環境の論理ホスト名を指定します。

指定できる文字数は，1〜63（単位：バイト）です。

省略した場合，環境変数JP1_HOSTNAMEに指定しているホスト名が仮定されます。このオプションを省略し，環境変数JP1_HOSTNAMEに何も指定していない場合，このコマンドは異常終了します。

jajs_spmd_stopコマンドのオプション

jajs_spmd_stopコマンドのオプションを指定します。ただし，jajs_spmdコマンドの論理ホスト名のオプション（-hオプション）は指定できません。

オプションの詳細については，「3. 通常の運用で使用するコマンド　jajs_spmd_stop」を参照してください。

注意事項

このコマンドはUNIXだけで実行できます。Windowsでは実行できません。

このコマンドにオプションを指定する場合，引数の第一オプションには，必ず論理ホスト名を指定してください。

同一論理ホストに対して，このコマンドを次のコマンドと同時に実行すると，JP1/AJS3が正しく停止しないおそれがあります。

ajsprofalterコマンド

ajsembdbstartコマンド

ajsembdbstopコマンド

ajsstartコマンド

ajsstopコマンド

jajs_hstdコマンド

jajs_hstd_stopコマンド

jajs_spmdコマンド

jajs_spmd_statusコマンド

jajs_spmd_stopコマンド

jajs_start.clusterコマンド（UNIX限定）

jajs_stop.clusterコマンド（UNIX限定）

jajs_spmd_stopコマンドのオプションを指定する場合，論理ホスト名の指定は省略できません。

戻り値

0

正常終了。

0以外の値

異常終了。

jajs_web（Linux限定）

形式

jajs_web
     [-t {http|app}]

機能

JP1/AJS3 HTTP ServerサービスとJP1/AJS3 Web Application Serverサービスを起動します。

実行権限

スーパーユーザー権限

格納先ディレクトリ

/etc/opt/jp1ajs3web/

引数

-t {http|app}

httpを指定すると，JP1/AJS3 HTTP Serverサービスが起動します。

appを指定すると，JP1/AJS3 Web Application Serverサービスが起動します。

このオプションを省略した場合，JP1/AJS3 Web Application Serverサービス，JP1/AJS3 HTTP Serverサービスの順に，両方のサービスが起動します。

注意事項

このコマンドはLinuxだけで実行できます。Windowsでは実行できません。

JP1/AJS3 Web Application Serverサービスの起動に失敗した場合，コマンド内部でJP1/AJS3 Web Application Serverサービスの停止処理が実行され，メッセージKNAK2524-Eと同時にメッセージKNAK2525-Eが出力されることがあります。この場合のメッセージKNAK2525-Eは対処不要です。

オプションを省略してこのコマンドを実行した場合，JP1/AJS3 Web Application Server，JP1/AJS3 HTTP Serverの順に起動処理が実行されます。サービス起動時にJP1/AJS3 HTTP Serverサービスでエラーが発生した場合，JP1/AJS3 Web Application Serverサービスは起動したままになります。エラーが発生したサービスと，各サービスの状態を次の表に示します。

表3‒35　エラーが発生したサービスとサービスの状態

サービスの状態

エラーが発生したサービス

JP1/AJS3 Web Application Server

JP1/AJS3 HTTP Server

JP1/AJS3 Web Application Serverの状態

停止

起動

JP1/AJS3 HTTP Serverの状態

停止

停止

JP1/AJS3 HTTP Serverを二重起動させた場合，メッセージKNAK2524-Eが出力され，コマンドが異常終了します。

JP1/AJS3 HTTP Serverサービスは，デフォルトではnobody/root権限で起動されます。サービスの起動に失敗し，メッセージKNAK2524-Eが出力される場合は，システムにnobodyユーザーが存在するか確認してください。存在しない場合はユーザーを作成するか，次に示す/opt/jp1ajs3web/uCPSB/httpsd/conf/httpsd.confのUserに存在するユーザーを指定してください。

User nobody

Group root

戻り値

0

正常終了。

0以外の値

異常終了。

jajs_web_stop（Linux限定）

形式

jajs_web_stop
     [-t {http|app}]

機能

JP1/AJS3 HTTP ServerサービスとJP1/AJS3 Web Application Serverサービスを停止します。

実行権限

スーパーユーザー権限

格納先ディレクトリ

/etc/opt/jp1ajs3web/

引数

-t {http|app}

httpを指定すると，JP1/AJS3 HTTP Serverサービスが停止します。

appを指定すると，JP1/AJS3 Web Application Serverサービスが停止します。

このオプションを省略した場合，JP1/AJS3 HTTP Serverサービス，JP1/AJS3 Web Application Serverサービスの順に，両方のサービスが停止します。

注意事項

このコマンドはLinuxだけで実行できます。Windowsでは実行できません。

前回，電源を落としたことなどが原因でJP1/AJS3 HTTP Serverサービスが強制終了した場合，再度JP1/AJS3 HTTP Serverサービスを起動する前に，このコマンドでJP1/AJS3 HTTP Serverサービスを停止させると，メッセージKNAK2525-Eが出力され，コマンドが異常終了します。

JP1/AJS3 Web Application Serverサービスの停止で，エラーメッセージや警告メッセージが出力されていないにもかかわらず，コマンドがメッセージKNAK2715-Wを出力して終了する場合があります。この場合，メッセージKNAK2715-Wは対処不要です。これは内部的に一部のプロセスがすでに停止状態であったために発生しているものであり，JP1/AJS3 Web Application Serverサービスの停止処理は正常に完了したことを示しています。

戻り値

0

正常終了。

0以外の値

異常終了。

jp1exec（Windows限定）

形式

jp1exec
     コマンドライン

機能

コマンドラインに指定されたプログラム（コマンド）を実行し，実行したプログラムの終了コードを一時的にファイルに退避します。一時ファイルについては，後述の「補足事項」を参照してください。

このコマンドは，実行ホストでジョブとして実行されるバッチファイル（拡張子がBAT，またはCMDのファイル）内で使用します。通常，ジョブを強制終了した場合，ジョブとして実行されたバッチファイルは強制終了しますが，バッチファイルから実行したプログラムまでは強制終了しません。バッチファイルから実行するプログラムをjp1execコマンドから実行すると，バッチファイルが強制終了された場合，jp1execコマンドから実行されたプログラムも強制終了されます。また，バッチファイルの最後にjp1exitコマンドを記述すると，jp1execコマンドで実行したプログラムの終了コードをそのバッチファイルの終了コードにできます。

実行権限

なし

引数

コマンドライン

実行ホスト上にあるジョブとして実行したいファイル名をフルパスで指定します。実行したいファイル名の引数（パラメーター）も指定できます。指定できるファイル名は，拡張子がEXEのファイルだけです。EXE以外のファイルを指定した場合は，該当するジョブが異常検出終了となるおそれがあります。

指定できる文字数は，1〜259（単位：バイト）です。

第1引数の文字数が最大文字数を超えた場合，およびコマンドラインのトータルの文字数が最大文字数を超えた場合で動作が異なります。

第1引数の文字数が最大文字数を超えた場合

コマンドはエラーとなります。

コマンドラインのトータルの文字数が最大文字数を超えた場合

スペースで区切られた個所で，コマンドラインのトータルの文字数を超えた個所以降を切り捨てて実行します。

（例）

jp1exec C:¥test.exe aaa...a

C:¥test.exe aaa...aが最大文字数を超える場合は，aaa...aを切り捨てて，C:¥test.exeで実行します。

注意事項

このコマンドはWindowsだけで実行できます。UNIXでは実行できません。

このコマンドはJP1/AJS3だけで使用できます。JP1/AJS3からJP1/OJE for VOS3への要求などには使用できません。

フレキシブルジョブは使用できません。

一つのバッチファイル内に複数のjp1execコマンドを記述している場合，最後にjp1execコマンドで実行されたプログラムの終了コードが，そのバッチファイルの終了コードとして一時ファイルに退避されます。

このコマンドに指定できるファイルは，拡張子がEXEのファイルだけです。EXE以外のファイルを指定した場合は，ジョブが異常終了するおそれがあります。バッチファイルから別のバッチファイルを呼び出す場合は，次のように記述してください。

jp1exec CMD.EXE /C ファイル名

ただし，上記のバッチファイルを強制終了（CMD.EXEを強制終了）しても，バッチファイル内で起動されるプログラムは強制終了されません。このバッチファイル内で起動されるプログラムを強制終了したい場合は，jp1execコマンドでプログラムを実行してください。

jp1execコマンドから呼び出すEXEファイルやバッチファイルは，標準出力ファイル，標準エラー出力ファイルに結果をリダイレクトすることはできません。

ジョブとして実行しているバッチファイルの中でさらにバッチファイルを実行し，その中でjp1execコマンドを実行している場合は，ジョブとして実行しているバッチファイルを強制終了することで，そのバッチファイル内のjp1execコマンドで実行しているプロセスを強制終了できます。

jp1exitコマンドを記述しないと，jp1execコマンドの終了コードがバッチファイルの終了コードとなります。jp1execコマンドの終了コードは，jp1execコマンドから実行されたプログラムの終了コードではなく，jp1execコマンドの終了コードです。jp1execコマンドから実行されたプログラムの終了コードはjp1exitコマンドで取得できます。jp1exitコマンドの詳細については，「3. 通常の運用で使用するコマンド　jp1exit（Windows限定）」を参照してください。

バッチファイルの中でTMP，TEMP，JP1から始まる環境変数，およびAJSから始まる環境変数を変更しないでください。

jp1execコマンドに指定するファイルのパス名に空白が含まれるときは，パス名を「"（ダブルクォーテーションマーク）」および「¥"」で囲んでください。囲まない場合，コマンドが異常終了するおそれがあります。

実行ファイル名が「C:¥Program Files¥test.exe」の場合の例を次に示します。

  jp1exec "¥"C:¥Program Files¥test.exe¥""

このコマンドを実行する場合は，次のフォルダにジョブを実行するOSユーザーの書き込み権限および読み取り権限を設定してください。

JP1/AJS3のインストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下のとき

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥log¥jpqagent

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥log¥jpqclient

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

JP1/AJS3のインストール先フォルダが上記以外のとき

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

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

クラスタ運用のとき

共有フォルダ¥jp1ajs2¥log¥jpqagent

共有フォルダ¥jp1ajs2¥log¥jpqclient

補足事項

jp1execコマンドを使用する場合は，jp1exitコマンドを必ず記述してください。jp1exitコマンドを記述しなかった場合，ジョブ実行終了後，ジョブ実行ホスト上にファイル名がAJSJP1EXECで始まるファイルが残ります。このファイルは不要のため，削除してください。

このファイルは，次の順序で各環境変数の最初に設定されているパス内に作成されます。どの環境変数にもパスが設定されていない場合は，Windowsのインストール先フォルダに作成されます。

JP1/AJS3サービスを起動したユーザー※の環境変数tmp

システム環境変数tmp

JP1/AJS3サービスを起動したユーザー※の環境変数temp

システム環境変数temp

これらのパスに対しては，ジョブ実行OSユーザーがアクセスできるよう，書き込み権限および読み取り権限を設定してください。

注※

キューレスジョブの場合，キューレスエージェントサービスの起動ユーザーになります。

jp1exit（Windows限定）

形式

jp1exit
     [-ec 異常終了コード]

機能

jp1execコマンドで退避したプログラム（コマンド）の終了コードを，jp1exitコマンドの終了コードとして返却します。

実行権限

なし

引数

-ec 異常終了コード

jp1exitコマンドの内部でエラーが発生した場合の終了コードを指定します。

指定できる値は，0〜9,999です。

省略した場合，エラー発生時のjp1exitコマンドの終了コードとして172が設定されます。

指定した値に誤りがあった場合，jp1exitコマンドの終了コードとして172が設定されます。エラーの詳細は標準エラー出力に出力されます。

注意事項

このコマンドはWindowsだけで実行できます。UNIXでは実行できません。

このコマンドはJP1/AJS3だけで使用できます。JP1/AJS3からJP1/OJE for VOS3への要求などには使用できません。

フレキシブルジョブは使用できません。

jp1execコマンドの終了コードは，jp1execコマンドから実行されたプログラムの終了コードではなく，jp1execコマンドの終了コードです。

jp1execコマンドの終了コードを判定する必要がある場合は，jp1exitコマンドを実行する前に%ERRORLEVEL%などによるエラー判定を行ってください。

jp1execコマンドから実行されたプログラムの終了コードは，jp1exitコマンドを実行した場合にだけ取得できます。

jp1execコマンドから実行されたプログラムの終了コードを判定して後続処理を分岐させるためには，jp1execコマンドとjp1exitコマンドが対になるように記述してください（後述の「使用例」を参照してください）。jp1execコマンドのあとでjp1exitコマンドを実行していない，またはjp1execコマンドを実行しないでjp1exitコマンドを連続して実行した場合は，jp1exitコマンドがエラーとなり，終了コードは保証されません。

jp1execコマンドから実行されたプログラムの終了コードをバッチファイルの終了コードにしたい場合は，必ずバッチファイルの処理の最後にjp1exitコマンドを実行してください。jp1exitコマンドの実行以降に何らかの処理（別のコマンドなど）が実行されると，バッチファイルの終了コードが置き換わってしまうおそれがあります。

引数に存在しないファイル名を指定してjp1execコマンドを実行する場合，jp1execコマンドは標準エラー出力へエラーの詳細を出力して終了します。このとき，jp1exitコマンドの終了コードは0になります。

このコマンドを実行する場合は，次のフォルダにジョブを実行するOSユーザーの書き込み権限および読み取り権限を設定してください。

JP1/AJS3のインストール先フォルダがデフォルトまたはシステムで保護されたフォルダ配下のとき

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥log¥jpqagent

%ALLUSERSPROFILE%¥Hitachi¥JP1¥JP1_DEFAULT¥JP1AJS2¥log¥jpqclient

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

JP1/AJS3のインストール先フォルダが上記以外のとき

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

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

クラスタ運用のとき

共有フォルダ¥jp1ajs2¥log¥jpqagent

共有フォルダ¥jp1ajs2¥log¥jpqclient

使用例

実行したプログラムの終了コードを判定し，後続処理を分岐させる処理を次に示します。

jp1exec  UAP1.exe
jp1exit
if %ERRORLEVEL% =0  GOTO :next1

エラー処理
GOTO :end

:next1
jp1exec UAP2.exe
jp1exit
if %ERRORLEVEL% =0  GOTO :next2

エラー処理
GOTO :end

:next2
jp1exec UAP3.exe
jp1exit
if %ERRORLEVEL% =0  GOTO :next3

エラー処理
GOTO :end

解説

最後に記述されたjp1exitコマンドまで実行された場合は，対となるjp1execコマンドで実行されたプログラムの終了コードがバッチファイルの終了コードになります。

途中でエラーが発生し，「:end」に分岐してきた場合は，「エラー処理」以降で最後に実行されたプログラムの終了コードがバッチファイルの終了コードになります。

jpoagoec

形式

jpoagoec
     {-a マネージャーホスト名|-d マネージャーホスト名
          |-r|-p}
     [-h ホスト名]

機能

イベントジョブおよびカスタムイベントジョブを使用している場合に，マネージャーホスト名の変更に伴って，イベント・アクションエージェントプロセスが記憶する要求元マネージャーホスト名を変更します。

イベントジョブおよびカスタムイベントジョブの運用に際しては，エージェントはイベントジョブおよびカスタムイベントジョブの要求元マネージャーホスト名を記憶しておき，エージェントとマネージャー間で通信してイベントジョブおよびカスタムイベントジョブの整合を図っています。そのため，マネージャーホスト名が変更されると，コマンドを実行したエージェントホストまたはマネージャーホストのJP1/AJS3が記憶している，JP1/AJS3イベント受信監視の要求元マネージャーホスト名も変更する必要があります（jpoagoecコマンドを使って現在記憶しているマネージャーホスト名を表示して確認し，不要なホスト名を削除し，必要なホスト名を追加する必要があります）。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-a マネージャーホスト名

追加するマネージャーホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

-d マネージャーホスト名

削除するマネージャーホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

-r

すべてのマネージャーホスト名を削除します。

-p

記憶されているマネージャーホスト名の一覧を，標準出力ファイルに出力します。

-h ホスト名

保守（マネージャーホスト名を追加・削除・表示）するJP1/AJS3 - Managerの論理ホスト名，またはJP1/AJS3 - Agentの論理ホスト名を指定します。

指定できる文字数は，1〜196（単位：バイト）です。

省略した場合，物理ホストに対する操作と仮定されます。

注意事項

このコマンドは必ずJP1/AJS3を停止してから実行してください。

このコマンドは，エージェントホストで実行中のイベントジョブおよびカスタムイベントジョブをすべて終了してから実行してください。エージェントホストで実行中のイベントジョブおよびカスタムイベントジョブの有無を確認するには，ajsshowコマンドを使用してください。ajsshowコマンドの詳細については，「3. 通常の運用で使用するコマンド　ajsshow」を参照してください。

このコマンドには，-a，-d，-r，-pのどれかのオプションを必ず指定してください。

戻り値

0

正常終了。

0以外の値

異常終了。

使用例

マネージャーホスト名を「ManagerHostB」から「ManagerHostC」に変更する例を示します。変更作業の流れは次のとおりです。

マネージャーホスト名を確認する。

現在，イベント・アクションエージェント機能が記憶しているマネージャーホスト名を確認します。

実行するコマンド

jpoagoec -p

表示例

ManagerHostA

ManagerHostB

マネージャーホスト名を削除する。

変更前のマネージャーホスト名を削除します。

実行するコマンド

jpoagoec -d ManagerHostB

変更後のマネージャーホスト名を追加する。

実行するコマンド

jpoagoec -a ManagerHostC

マネージャーホスト名が追加されたことを確認する。

実行するコマンド

jpoagoec -p

表示例

ManagerHostA

ManagerHostC

エージェントホストをコールドスタートする。

Windowsの場合

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

表示される［サービス］ウィンドウで，起動させたいJP1/AJS3のサービス名を選択したあと，［操作］−［プロパティ］を実行する。

表示される［サービス名のプロパティ］ダイアログボックスの［全般］タブで，［開始パラメータ］にスタートモードとして「-cold」を指定する。

その後，［開始］をクリックする。

UNIXの場合

「jajs_spmd -cold」コマンドを実行する。

jpoagtjobshow

形式

jpoagtjobshow
     [-h ホスト名]
     [-m マネージャーホスト名...|-all]

機能

現在，エージェントで実行中のイベントジョブおよびカスタムイベントジョブの一覧を標準出力ファイルに出力します。

このコマンドはエージェント実行ホストで実行します。エージェントが保持している情報だけを表示するため，ジョブ実行要求元マネージャーの状況にかかわらず実行できます。エージェントとジョブ実行要求元マネージャーのバージョンが一致しない場合でも，一覧は表示されます。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-h ホスト名

ジョブ情報を表示したいエージェントの自ホスト名，または論理ホスト名を指定します。指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，自ホスト名が仮定されます。

コマンドを実行するホスト上に，指定したエージェントホスト名が定義されていない場合，このコマンドはエラーになります。

-m マネージャーホスト名...|-all

-hオプションで指定したエージェントにジョブの実行要求を出しているマネージャーのうち，ジョブ情報を表示したいマネージャーホスト名を指定します。このとき，DNS運用をしていない場合は，hostnameコマンドで出力される名前を指定し，DNS運用をしている場合はFQDN形式で指定します。

指定できる文字数は，1〜255（単位：バイト）です。

マネージャーホスト名は複数指定できます。複数指定する場合は，マネージャーホスト名間を1バイト以上の空白文字で区切ってください。

すべてのマネージャーホストを対象にしたい場合は「-all」を指定してください。

省略した場合，エージェントホスト名と同じ名称を持つマネージャーホスト名が仮定されます。自マネージャーがない場合，項目名だけが表示されます。

指定したマネージャーホストにジョブ情報がない場合，コマンドはエラーになりません。また，指定したマネージャーホストにマネージャーホスト名が定義されていない場合も，コマンドはエラーになりません。

注意事項

JP1/AJS3が起動していない場合にこのコマンドを実行すると，エラーになります。

JP1/AJS3が完全に起動していない状態でこのコマンドを実行すると，エラーになる場合があります。しばらくしてから再実行してください。

オプションと値との間は，必ず1バイト以上の空白文字で区切ってください。

オプションで値を指定する引数は，オプションの次に指定したものが値と見なされます（例：「-h -m」と指定した場合，-mがホスト名と見なされます）。

このコマンドは，複数を同時に実行できません。一つ目のコマンドの実行が終了してから，二つ目のコマンドを実行してください。

コマンド実行中にJP1/AJS3サービスを停止すると，コマンドから応答がなくなるおそれがあります。コマンドからの応答がなくなった場合は，コマンドを手動でキャンセルしてください。

戻り値

0

正常終了。

0以外の値

異常終了。

補足事項

ジョブ情報はマネージャー単位に出力されます。マネージャーの順番は，エージェントがマネージャーからジョブ実行要求を受けた順です。例えば，エージェントAが，三つのマネージャー（ManagerA，ManagerB，ManagerC）から，ManagerA，ManagerB，ManagerCの順でジョブ実行要求を受けた場合，ジョブ情報は，ManagerA，ManagerB，ManagerCの順で出力されます。

出力例

ファイル出力例と出力内容の意味を次に示します。

出力内容の意味を次に示します。

COMMAND START TIME

コマンドの実行開始日時を「YYYY/MM/DD HH:MM:SS」の形式で示します。

AGENT

エージェントホスト名（自ホスト名，または論理ホスト名）を示します。

MANAGER

ジョブ実行要求元マネージャーホスト名を示します。

Execution ID

実行IDを示します。

Unit ID

ユニットIDを示します。

Scheduler service name

スケジューラーサービス名を示します。

Kind

ジョブの種類を示します。

このコマンドでは，通常のジョブとリカバリージョブの区別はしていません。したがって，通常のジョブもリカバリージョブも，通常のジョブとして出力されます。

evwjb：

JP1イベント受信監視ジョブ，またはリカバリーJP1イベント受信監視ジョブ

flwjb：

ファイル監視ジョブ，またはリカバリーファイル監視ジョブ

mlwjb：

メール受信監視ジョブ，またはリカバリーメール受信監視ジョブ

mqwjb：

メッセージキュー受信監視ジョブ，またはリカバリーメッセージキュー受信監視ジョブ

mswjb：

MSMQ受信監視ジョブ，またはリカバリーMSMQ受信監視ジョブ

lfwjb：

ログファイル監視ジョブ，またはリカバリーログファイル監視ジョブ

ntwjb：

Windowsイベントログ監視ジョブ，またはリカバリーWindowsイベントログ監視ジョブ

tmwjb：

実行間隔制御ジョブ，またはリカバリー実行間隔制御ジョブ

cewjb：

カスタムイベントジョブ，またはリカバリーカスタムイベントジョブ

Status

ジョブの状態を示します。

ready：

監視中である（エージェントからの要求が，各監視プロセスに通知されている）。

not ready：

監視中ではない。

Request time

エージェントがマネージャーからジョブ実行要求を受けた時間を示します。

Watch kind

監視種別を示します。

E：

登録によって監視を開始したイベント（イベントアイコン）

O：

登録によって監視を開始したイベント（起動条件イベント）

A：

JP1/AJS3の再起動などによって監視が再開されたイベント（イベントアイコン）

H：

JP1/AJS3の再起動などによって監視が再開されたイベント（起動条件イベント）

COMMAND END TIME

コマンドの実行終了日時を「YYYY/MM/DD HH:MM:SS」の形式で示します。

なお，「YYYY/MM/DD HH:MM:SS」は「西暦年/月/日 時:分:秒」のことです。

jpomailprof（Windows限定）

形式

jpomailprof
     {-add|-alt|-show|-del}
     [-e|-k|-v]
     [-h 論理ホスト名]
     [-n プロファイル名]
     [-m 送信元メールアドレス]
     [-x 返信先メールアドレス]
     [-s SMTPサーバ名]
     [-p SMTPサーバの通信ポート]
     [-i 認証用のアカウント名]
     [-j 認証用パスワード]
     [-r POP3サーバ名]
     [-t POP3サーバの通信ポート]
     [-f|-q]
     [-o バインドするIPアドレス]

形式1（認証が必要ないメールアカウントのプロファイル作成）

jpomailprof
     -add
     [-e]
     [-h 論理ホスト名]
     -n プロファイル名
     -m 送信元メールアドレス
     [-x 返信先メールアドレス]
     -s SMTPサーバ名
     [-p SMTPサーバの通信ポート]
     [-o バインドするIPアドレス]

形式2（POP before SMTP認証を使用するメールアカウントのプロファイルの作成）

jpomailprof
     -add
     -k
     [-h 論理ホスト名]
     -n プロファイル名
     -m 送信元メールアドレス
     [-x 返信先メールアドレス]
     -s SMTPサーバ名
     [-p SMTPサーバの通信ポート]
     -i 認証用のアカウント名
     -j 認証用パスワード
     -r POP3サーバ名
     [-t POP3サーバの通信ポート]
     [-o バインドするIPアドレス]

形式3（SMTP-AUTH認証を使用するメールアカウントのプロファイルの作成）

jpomailprof
     -add
     -v
     [-h 論理ホスト名]
     -n プロファイル名
     -m 送信元メールアドレス
     [-x 返信先メールアドレス]
     -s SMTPサーバ名
     [-p SMTPサーバの通信ポート]
     -i 認証用のアカウント名
     -j 認証用パスワード
     [-f|-q]
     [-o バインドするIPアドレス]

形式4（プロファイルの内容変更）

jpomailprof
     -alt
     [-e|-k|-v]
     [-h 論理ホスト名]
     -n プロファイル名
     [-m 送信元メールアドレス]
     [-x 返信先メールアドレス]
     [-s SMTPサーバ名]
     [-p SMTPサーバの通信ポート]
     [-i 認証用のアカウント名]
     [-j 認証用パスワード]
     [-r POP3サーバ名]
     [-t POP3サーバの通信ポート]
     [-f|-q]
     [-o バインドするIPアドレス]

形式5（登録されているプロファイルの一覧表示）

jpomailprof
     -show
     [-h 論理ホスト名]

形式6（指定したプロファイルの表示）

jpomailprof
     -show
     [-h 論理ホスト名]
     -n プロファイル名

形式7（指定したプロファイルの削除）

jpomailprof
     -del
     [-h 論理ホスト名]
     -n プロファイル

機能

Outlookを使用しないでメールを送信する場合に必要なプロファイルを作成，変更，参照，および削除できます。

実行権限

Administrators権限

引数

-add

プロファイルを作成する場合に指定します。

プロファイルは16個まで作成できます。

このオプションを指定した場合，-n，-m，および-sオプションは省略できません。

-alt

プロファイルの内容を変更する場合に指定します。内容を変更するプロファイルの名称を-nオプションで指定して，ほかのオプションで変更する情報を指定します。

指定したオプションに対してだけ，変更を行います。

認証方式を指定するオプション（-e，-k，または-vオプション）を指定した場合，同時にほかのオプションも指定します。同時に指定するオプションの組み合わせについては，[-e|-k|-v]オプションの説明を参照してください。

このオプションを指定した場合，-nオプションは省略できません。

-show

プロファイルを表示する場合に指定します。

-nオプションで指定したプロファイルが表示されます。-nオプションを省略した場合，登録されているすべてのプロファイル名が一覧で表示されます。

-del

プロファイルを削除する場合に指定します。削除するプロファイルの名称を-nオプションで指定します。

このオプションを指定した場合，-nオプションは省略できません。

[-e|-k|-v]

メール送信時に実施する認証方式を指定します。

オプション

認証方式

一緒に指定が必要なオプション

説明

-i

-j

-r

-t

{-f|-q}

-e

なし

×

×

×

×

×

認証処理を使用しません。

-k

POP before SMTP

○

○

○

△

×

POP before SMTP認証を使用します。

-v

SMTP-AUTH

○

○

×

×

△

SMTP-AUTH認証を使用します。

（凡例）

○：必ず指定してください。

△：任意で指定できます。省略した場合は次の値が仮定されます。

　　・-t：110

　　・{-f|-q}：-f

×：指定しないでください。指定するとエラーになります。

-addオプションを指定してこのオプションを省略した場合，-eが仮定されます。

このオプションは，-addまたは-altオプションを指定した場合にだけ指定できます。

-h 論理ホスト名

自ホストの論理ホスト名を指定します。このオプションに指定したホストに対して，プロファイルを作成，変更，参照，または削除します。

指定できる文字数は，1〜255（単位：バイト）です。

物理ホストに対してこのコマンドを実行する場合は，このオプションおよび環境変数JP1_HOSTNAMEを指定しないでください。

省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合は，物理ホスト名が仮定されます。

-n プロファイル名

作成，変更，参照，または削除するプロファイル名を指定します。

指定できる文字数は，1〜64（単位：バイト）です。日本語も指定できます。

アルファベットを指定する場合，大文字・小文字は区別されません。

プロファイル名にスペースを含む場合は，プロファイル名を「"（ダブルクォーテーションマーク）」で囲んでください。囲まない場合，コマンドが異常終了します。

また，次のプロファイル名は指定できません。

半角スペース記号から始まる

「.（ピリオド）」一文字

次の文字を含む

「¥」「/」「:」「*」「?」「"」「<」「>」「|」

次のどれか

CON，PRN，AUX，CLOCK$，NUL，COM0，COM1，COM2，COM3，COM4，COM5，COM6，COM7，COM8，COM9，LPT0，LPT1，LPT2，LPT3，LPT4，LPT5，LPT6，LPT7，LPT8，LPT9

物理ホストの場合，JP1/AJS3のインストール場所によっては，プロファイル名に指定できる値が64バイト以下になることがあります。

このオプションは，-add，-alt，-delオプションを指定した場合は，必ず指定してください。

-m 送信元メールアドレス

送信元メールアドレスを指定します。

次の文字を指定できます。

半角英数字，スペース，「!」，「#」，「$」，「%」，「&」，「'」，「*」，「+」，「-」，「/」，「=」，「?」，「^」，「_」，「`」，「{」，「|」，「}」，「~」，「.」，「(」，「)」，「<」，「>」，「[」，「]」，「:」，「;」，「@」，「,」

メールアドレスに指定できる文字数は，1〜255（単位：バイト）です。

指定されたメールアドレスが有効かどうかはチェックしません。

このオプションは，-addオプションを指定した場合は，必ず指定してください。

-x 返信先メールアドレス

メールの返信先を送信元と異なるメールアドレスにしたい場合に指定します。

次の文字を指定できます。

半角英数字，スペース，「!」，「#」，「$」，「%」，「&」，「'」，「*」，「+」，「-」，「/」，「=」，「?」，「^」，「_」，「`」，「{」，「|」，「}」，「~」，「.」，「(」，「)」，「<」，「>」，「[」，「]」，「:」，「;」，「@」，「,」

メールアドレスに指定できる文字数は，1〜255（単位：バイト）です。

指定されたメールアドレスが有効かどうかはチェックしません。

-addオプションを指定してこのオプションを省略した場合，-mオプションで指定した送信元メールアドレスが仮定されます。

-s SMTPサーバ名

メールを送信するSMTPサーバ名を指定します。次の文字を指定できます。

半角英数字，「.」，「-」，「_」，「:」

指定できる文字数は，1〜255（単位：バイト）です。SMTPサーバ名は複数指定できません。

このオプションは，-addオプションを指定した場合は，必ず指定してください。

-p SMTPサーバのポート番号

SMTPサーバの通信ポートのポート番号を指定します。

指定できるポート番号は1〜65535です。

-addオプションを指定してこのオプションを省略した場合，TCPの25番を使用します。

-i 認証用アカウント

POP before SMTP認証またはSMTP-AUTH認証の認証用アカウント名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

このオプションは，-kまたは-vオプションを指定した場合は，必ず指定してください。

-j 認証用パスワード

POP before SMTP認証またはSMTP-AUTH認証の認証用アカウントのパスワードを指定します。

このオプションで指定したパスワードは，スクランブルが掛けられた状態でプロファイルに格納されます。

指定できる文字数は，1〜127（単位：バイト）です。

このオプションは，-kまたは-vオプションを指定した場合は，必ず指定してください。

-r POP3 サーバ名

POP before SMTP認証に使用するPOP3サーバ名を指定します。

次の文字を指定できます。

半角英数字，「.」，「-」，「_」，「:」

指定できる文字数は，1〜255（単位：バイト）です。

POP3サーバ名は複数指定できません。

このオプションは，-kオプションを指定している場合にだけ指定できます。

-t POP3サーバのポート番号

POP before SMTP認証に使用するPOP3サーバの通信ポートのポート番号を指定します。

指定できるポート番号は1〜65535です。

このオプションは，-kオプションを指定した場合にだけ指定できます。

-kオプションを指定してこのオプションを省略した場合，TCPの110番を使用します。

[-f|-q]

SMTP-AUTH認証の認証方式を指定します。

オプション

認証方式

説明

-f

LOGIN

SMTP-AUTH LOGIN認証を使用します。

-q

PLAIN

SMTP-AUTH PLAIN認証を使用します。

なお，SMTP-AUTH CRAM-MD5認証，およびSMTP-AUTH DIGEST-MD5認証は使用できません。

このオプションは，-vオプションを指定した場合にだけ指定できます。

-vオプションを指定してこのオプションを省略した場合，-fが仮定されます。

-o バインドするIPアドレス

通信するときに，送信元となるIPアドレスを指定します。

「0」を指定した場合，または-addオプションを指定してこのオプションを省略した場合，ANYバインド方式になります。

IPv4またはIPv6の，どちらのIPアドレス形式でも指定できます。SMTPサーバ名およびPOP3サーバ名の名前解決結果と同じIPアドレス形式を指定してください。なお，SMTPサーバ名とPOP3サーバ名の名前解決結果が，異なるIPアドレス形式にならないようにしてください。

注意事項

プロファイルは次のフォルダに格納されます。コマンドを実行するためには，Administrators権限でこのフォルダを読み書き，および削除できる必要があります。

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

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

このコマンドを複数同時に実行した場合，先に実行したコマンドが終了するのを待ってから，あとで実行したコマンドが動作します。ただし，コマンドの処理に時間が掛かる場合はエラーになり，メッセージKAVT3847-Eが出力されます。

クラスタ環境でこのコマンドを実行する場合は，次の点に注意してください。

共有ディスクにアクセスできる状態で実行してください。

プロファイルを作成する場合，実行系だけでプロファイルを作成してください。待機系でプロファイルを作成する必要はありません。

メール送信ジョブの実行中にこのコマンドを実行しないでください。メール送信ジョブの実行中にこのコマンドを実行してプロファイルを追加，更新，または削除すると，次の問題が発生するおそれがあります。

コマンドの終了に時間が掛かる

コマンドがエラーになり，メッセージKAVT3847-Eが出力される

メール送信ジョブが遅延する

メール送信ジョブが異常終了する

戻り値

0

正常終了。

0以外の値

異常終了。

使用例1

認証が必要ないプロファイル「profile1」を作成します。

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

使用例2

POP before SMTP認証を使用するプロファイル「profile2」を作成します。

jpomailprof -add -k -n profile2 -m mail@mail.com -s testsmtp.com -i id -j pass -r testpop3.com

使用例3

SMTP-AUTH PLAIN認証を使用するプロファイル「profile3」を作成します。

jpomailprof -add -v -n profile3 -m mail@mail.com -s testsmtp.com -i id -j pass -q

使用例4

プロファイル「profile1」のSMTPサーバを変更します。

jpomailprof -alt -n profile1 -s testsmtp2.com

使用例5

登録されているプロファイルの一覧を表示します。

jpomailprof -show

使用例6

指定したプロファイル「profile1」を表示します。

jpomailprof -show -n profile1

使用例7

指定したプロファイル「profile1」を削除します。

jpomailprof -del -n profile1

出力例1

指定したプロファイル「profile1」を表示します。

jpomailprof -show -n profile1
SenderEmailAddress       xxx@xxx.xxx
ReplyEmailAddress        xxx@xxx.xxx
SMTPServer               smtptest.com:25
POP3Server               −
Authentication           −
USER ID                       −
Bind_IPaddress           192.168.0.2

出力内容の意味を次に示します。

SenderEmailAddress

送信元メールアドレスが出力されます。

ReplyEmailAddress

返信先メールアドレスが出力されます。

SMTPServer

使用するSMTPサーバが「SMTPサーバ名：使用するポート番号」の形式で出力されます。

POP3Server

使用するPOP3サーバを「POP3サーバ名：使用するポート番号」の形式で出力します。POP3サーバを使用しない場合は「−」が出力されます。

Authentication

メール送信時に実施する認証の方式が次の形式で出力されます。

認証方式

出力される文字列

なし

−

POP before SMTP認証

POP before SMTP

SMTP-AUTH PLAIN認証

SMTP-AUTH PLAIN

SMTP-AUTH LOGIN認証

SMTP-AUTH LOGIN

USER ID

メール送信時に実施する認証で使用する認証用アカウント名を出力します。認証をしない場合は「−」が出力されます。

Bind_IPaddress

送信元に使用されるIPアドレスが出力されます。ANYバインド方式の場合は「ANY」が出力されます。

出力例2

登録されているプロファイル名をすべて出力します。

jpomailprof -show
PATH = C:¥Program Files¥HITACHI¥JP1AJS2¥sys¥prf¥
[ProfileName]
test1
profile2
test3

出力内容の意味を次に示します。

PATH

プロファイルが格納されているディレクトリのパスが出力されます。

ProfileName

登録されているプロファイル名がすべて出力されます。

jpomanevreset

形式

jpomanevreset
     [-h 論理ホスト名]
     [-F サービス名]
     [-a 実行ホスト名|-all]
     [-s]
     [-e]
     [-dh マネージャーホスト名 -a 実行ホスト名]

機能

イベント・アクション制御マネージャーが保持する情報を削除します。また，-aオプションに指定された実行ホストと通信を行い，実行ホスト側の情報も削除します。

起動条件イベントが大量発生し，イベント・アクション制御が高負荷状態になって，システム全体でスローダウンなどの現象が発生している場合，このコマンドを実行することで，次回のJP1/AJS3の起動から正常な運用に戻せます。

なお，システムに複数のエージェントがある場合は，事前にjpomanevshowコマンドを使用して大量のイベントを発生させたエージェントを特定してください。

また，次のような場合に-dhオプションを指定してコマンドを実行することで，-aオプションに指定された実行ホストと通信し，実行ホスト側の情報を削除します。

ハードウェアのコピー・ミラーリング機能を使用してディザスター・リカバリー運用をする環境で，リモートサイト側のJP1/AJS3をディザスターリカバリースタートした

外部DBを利用する環境で，リカバリー後にJP1/AJS3をディザスターリカバリースタートした

バックアップ強化機能を使用する環境で，リカバリー後にJP1/AJS3をディザスターリカバリースタートした

標準構成の場合，このコマンドは，JP1/AJS3ホストサービスが起動していて，かつ対象とするJP1/AJS3スケジューラーサービスが停止しているときだけ実行できます。対象とするJP1/AJS3スケジューラーサービスが起動している状態で実行した場合，またはJP1/AJS3サービス全体が停止している状態で実行した場合はエラーとなります。ただし，-dhオプション指定時は，JP1/AJS3ホストサービスが起動していればJP1/AJS3スケジューラーサービスの起動，停止の状態に関係なく実行できます。

なお，スケジューラーサービスの停止方法は「3. 通常の運用で使用するコマンド　jajs_spmd_stop」を参照してください。

実行権限

Windowsの場合：Administrators 権限

UNIXの場合：スーパーユーザー権限

引数

-h 論理ホスト名

クラスタで運用している場合に，イベントリセットを行う論理ホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，自ホスト名が仮定されます。

-F サービス名

処理対象とする，スケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

-aオプションと同時に指定した場合は，-aオプションに指定した実行ホストで実行しているイベントジョブ，カスタムイベントジョブおよび起動条件付きジョブネットのうち，このオプションで指定したスケジューラーサービスから実行したジョブの情報を削除します。

このオプションを省略した場合，デフォルトスケジューラーサービス名が仮定されます。

-a 実行ホスト名|-all

イベントリセットを行うとき，特定の実行ホストの情報だけを削除したい場合に，-aオプションに実行ホスト名を指定します。このとき，実行ホスト名にはajsagtaddコマンドの-sオプションで指定した実行ホスト名を指定します。例えば，実行ホスト名をFQDN形式で指定した場合は，FQDN形式で指定します。

なお，実行エージェント名に対する実行ホスト名は，ajsagtshowコマンドで確認できます。

（例）　ajsagtshow -l

ajsagtaddコマンドについては「3. 通常の運用で使用するコマンド　ajsagtadd」を，ajsagtshowコマンドについては「3. 通常の運用で使用するコマンド　ajsagtshow」を参照してください。

指定できる文字数は，1〜255（単位：バイト）です。

-Fオプションで指定したスケジューラーサービスからジョブを実行したすべての実行ホストを対象にする場合は-allを指定してください。

このオプションを省略した場合，デフォルトの実行エージェントに対応した実行ホストが仮定されます。

-s

-aで指定した実行ホストと通信しないで，マネージャー側の情報だけを削除します。

次に示す条件の場合にこのオプションを指定してください。次に示した条件のときこのオプションを指定しなかった場合，コマンドが終了するまでに時間が掛かることがあります。

実行ホスト側のJP1/AJS3サービスをコールドスタートした場合

通信障害によってマネージャーと実行ホスト間で正常に通信できない場合

このオプションを省略した場合，-aオプションで指定した実行ホストと通信し，実行ホスト側の情報も削除されます。

-e

イベントジョブ，カスタムイベントジョブおよび起動条件の実行は継続したままとし，未処理データだけを削除します。ただし，実行ホスト側の監視状態をいったん終了させたあとに再実行するため，JP1/AJS3サービスが起動してから実行ホスト側で実際に監視が始まるまでに時間差があります。

このオプションを省略した場合，実行中のイベントジョブ，カスタムイベントジョブおよび起動条件を終了します。

このオプションを使用してコマンドを実行する場合は，次の表に示すことを実施してください。

表3‒36　JP1/AJS3起動前後の実施内容

タイミング

実施内容

JP1/AJS3起動前

実行ホスト側で，問題が発生した原因を取り除く。

JP1/AJS3起動後

JP1/AJS3 - View上でジョブの状態を確認し，必要に応じて再実行する。

-dh マネージャーホスト名 -a 実行ホスト名

次のような場合に，マネージャーホスト名を指定します。指定しなかった場合，エージェント側のJP1/AJS3サービスの起動に時間が掛かることがあります。

ハードウェアのコピー・ミラーリング機能を使用してディザスター・リカバリー運用をする環境で，リモートサイト側のJP1/AJS3をディザスターリカバリースタートした

外部DBを利用する環境で，リカバリー後にJP1/AJS3をディザスターリカバリースタートした

バックアップ強化機能を使用する環境で，リカバリー後にJP1/AJS3をディザスターリカバリースタートした

指定できる文字数は，1〜255（単位：バイト）です。

このオプションを指定する場合は，-aオプションを同時に指定してください。指定しないで実行した場合，メッセージKAVT8347-Eが出力されてコマンドが異常終了します。-aオプションには，通信できる実行ホスト名を指定してください。サービス停止，またはネットワーク未接続状態の実行ホスト名を指定した場合は，コマンドが終了するまでに時間が掛かり，かつメッセージKAVT8343-Wが出力されてコマンドが正常終了します。このメッセージが出力された場合，-aオプションに指定した実行ホストの情報は削除されません。そのため，-aオプションに指定する実行ホストのサービスが停止していた場合はサービスを起動し，通信できない状態の場合は通信できる状態にしたあと，コマンドを再実行してください。

-allオプション，-sオプション，-eオプションとは同時に指定できません。同時に指定した場合，メッセージKAVT8307-Eが出力され，コマンドは異常終了します。

実行ホストで，複数のスケジューラーサービスからイベントジョブおよびカスタムイベントジョブを実行している場合は，スケジューラーサービスごとにjpomanevresetコマンドを実行してください。

注意事項

オプションと値との間は，必ず1バイト以上の空白文字で区切ってください。

このコマンドは，複数を同時に実行できません。一つ目のコマンドの実行が終了してから，二つ目のコマンドを実行してください。

-aオプションに指定した実行ホストが複数の実行エージェントの実行ホストとして定義されている場合は，それらの実行エージェントの情報も削除されます。

-aオプションに指定した実行ホストが実行エージェントの実行ホストとしてエージェント管理情報に登録されているかはチェックされません。そのため，指定した実行ホストにJP1/AJS3をインストールしていない場合は，コマンドが終了するまでに時間が掛かることがあります。

イベント・アクション制御マネージャーが使用する，イベント・アクション制御マネージャー用情報格納フォルダがない状態でコマンドを実行した場合，データがないものとして動作し，コマンドは正常終了します。イベント・アクション制御マネージャー用情報格納フォルダについては，マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング　付録A.1 JP1/AJS3 - Managerのファイルおよびディレクトリ一覧」を参照してください。

ファイルの削除に失敗した場合，または実行ホストへの送信に失敗した場合でも，コマンドは正常終了します。標準エラー出力にメッセージ「KAVT8342-E ファイルアクセスエラーが発生しました（ファイル名）（保守情報）」，またはメッセージ「KAVT8343-W エージェントとの通信に失敗しました（エージェントホスト名）（保守情報）」が出力された場合，対処方法に従って手動でファイルを削除してください。

ファイルの削除に失敗した場合，失敗したファイルごとにメッセージ「KAVT8342-E ファイルアクセスエラーが発生しました（ファイル名）（保守情報）」が標準エラー出力に出力されます。削除に失敗したファイル数が多い場合は，大量のエラーメッセージが出力されるため，すべてのメッセージを参照できないおそれがあります。このため，このコマンドを実行する際は標準エラー出力をリダイレクトするようにしてください。

（例）

jpomanevreset 2> ファイル名

メッセージ「KAVT8343-W エージェントとの通信に失敗しました（エージェントホスト名）（保守情報）」が出力された場合，エラーが発生した実行ホストの情報は削除されません。必要に応じて，実行ホスト側のJP1/AJS3サービスをコールドスタートしてください。

-allオプションを指定した場合は，イベントジョブ，カスタムイベントジョブおよび起動条件付きジョブネットが「実行中」状態の実行ホスト，または未通知情報がある実行ホストに対して-Fオプションで指定したスケジューラーサービスのコールドスタートを通知します。-aオプションを指定した場合は，指定した実行ホストでイベントジョブ，カスタムイベントジョブおよび起動条件付きジョブネットが「実行中」状態でないときも，指定した実行ホストに対して-Fオプションで指定したスケジューラーサービスのコールドスタートを通知します。

実行ホストへのデータ送信時にネットワークエラーなどが発生した場合は，次のようにデータ送信を再試行します。

エージェントホストに接続できない（タイムアウトする）場合

再試行しません。

それ以外のネットワークエラーの場合

10秒間隔で2回再試行します。

このため，実行ホストまたは実行ホストのJP1/AJS3サービスが停止していると，コマンドが終了するまでに時間が掛かります。また，実行ホスト名のIPアドレスが解決できない場合も，1秒間隔で3回IPアドレスの取得を再試行します。

このコマンドは，JP1/AJS3運用時と同じ環境で実行してください。例えば，JP1/AJS3停止後に"DNSEstablish"を変更して，このコマンドを実行した場合，実行ホストと通信する際のホスト名が変更され，実行ホスト側でどのマネージャーの情報を削除してよいか判別できなくなります。その結果，実行ホスト側の情報が削除されないなどの問題が発生することがあります。

イベント・アクション制御マネージャー用情報格納フォルダ下にファイルが多い場合，検索や削除するファイル数が多いため，コマンドの終了までに時間が掛かります。

-hオプションに自ホスト名を指定した場合は，物理ホストが指定されたと仮定して動作します。

-eオプションを指定してコマンドを実行した場合，イベントジョブ，カスタムイベントジョブおよび起動条件の監視は続行しますが，イベントリセット前に発生したイベント情報やイベント開始情報は削除されます。そのため，イベントリセット前に事象が発生したジョブの状態が「実行中」のままになることや，すでに監視を開始しているジョブの状態が「キューイング」のままになることがあります。その場合，「実行中」のものに対しては，再度，条件に合致するイベントを発生させてください。「キューイング」中のものに対しては，そのまま使用するか，または一度終了させたあとに再登録してください。

実行ホスト側の情報削除については，実行ホストが管理している情報だけ削除され，ゴミとして残っているファイルは削除されません。実行ホスト側にゴミとして残っているファイルを削除したい場合は，実行ホスト側のJP1/AJS3サービスをコールドスタートしてください。

-eオプションを指定しないでコマンドを実行した場合，イベントジョブ，カスタムイベントジョブ，および起動条件の監視が終了するため，必要に応じて再登録してください。また，統合トレースログにメッセージKAVS1400-E，KAVS0265-Eが出力されますが，イベントジョブ，カスタムイベントジョブ，および起動条件の監視終了に伴うメッセージのため，無視してください。

-dhオプションを指定した場合，-dhオプションで指定したマネージャーホストから，-aオプションで指定した実行ホストで実行中のイベントジョブおよびカスタムイベントジョブがすべて終了します。このため，-dhオプションは引数の説明で挙げたどれかの状況に該当する場合だけ使用してください。

誤って引数の説明で挙げたどの状況にも該当しない状況で指定した場合は，-dhオプションで指定したマネージャーホストから，-aオプションで指定した実行ホストに対して実行しているすべてのイベントジョブおよびカスタムイベントジョブを強制終了し，再度実行登録してください。

-Fオプションの省略時に仮定されるデフォルトスケジューラーサービス名がコマンド実行時に登録されていない場合，標準エラー出力にメッセージKAVT8351-Eを出力して，コマンドが異常終了します。コマンド実行ホストにデフォルトスケジューラーサービス名が登録されているかを見直した上で，コマンドを再実行してください。

なお，コマンドが処理対象とするホストについては-hオプションを参照してください。

戻り値

0

正常終了。

1

引数の指定が不適切である。

2

初期化に失敗した。

論理ホストの定義または環境設定に誤りがある。

3

権限が不足している。

4

-Fオプションに指定したスケジューラーサービスが起動している。

5

同じコマンドを同時に実行している。

100

ファイルアクセスエラーが発生した。

101

メモリー不足が発生した。

255

システムエラーが発生した。

補足事項

JP1/AJS3を通常に起動した場合と，jpomanevresetコマンドによってイベント・アクション制御マネージャーの状態を回復させたあとで起動した場合では，JP1/AJS3 - Viewで表示される状態が異なります。また，jpomanevresetコマンドでの-eオプションの指定の有無（イベントジョブ，カスタムイベントジョブおよび起動条件を継続するかどうか）によっても状態が異なります。それぞれの場合の状態の差異について次に説明します。

JP1/AJS3をホットスタート（-hot）した場合

対象

状態

JP1/AJS3停止前の状態

通常時

jpomanevresetコマンド実行後

自ホストに対して実行中

他ホストに対して実行中

-e指定あり

-e指定なし

自ホストに対して実行中

他ホストに対して実行中

自ホストに対して実行中

他ホストに対して実行中

イベントジョブおよびカスタムイベントジョブ（ジョブネット中）

実行中

異常検出終了※1，※2

実行中※2

異常検出終了／終了状態不明

実行中／終了状態不明

終了状態不明

先行終了待ち

先行終了待ち※3

先行終了待ち※3

保留中

保留中※3

保留中※3

キューイング

実行中／異常検出終了

実行中

異常検出終了／終了状態不明

実行中／終了状態不明

終了状態不明

その他の状態

変更なし

変更なし

起動条件

監視中

監視中

監視中

監視打ち切り終了

その他の状態

変更なし

変更なし

起動条件内イベントジョブおよびカスタムイベントジョブ

実行中

実行中

実行中／終了状態不明

終了状態不明

キューイング

キューイング

キューイング／終了状態不明

その他の状態

変更なし

変更なし

注※1

システムダウンしたあとの再起動の場合は，実行中になります。

注※2

終了処理のタイミングによっては，終了状態不明になることがあります。

注※3

先行ユニットが異常終了扱いになった場合は，未実行終了になります。

JP1/AJS3をウォームスタート（-warm）した場合

対象

状態

JP1/AJS3停止前の状態

通常時

jpomanevresetコマンド実行後

自ホストに対して実行中

他ホストに対して実行中

-e指定あり

-e指定なし

自ホストに対して実行中

他ホストに対して実行中

自ホストに対して実行中

他ホストに対して実行中

イベントジョブおよびカスタムイベントジョブ（ジョブネット中）

実行中

終了状態不明

終了状態不明

先行終了待ち

未実行終了

未実行終了

保留中

未実行終了

未実行終了

キューイング

終了状態不明

終了状態不明

その他の状態

変更なし

変更なし

起動条件

監視中

監視中

監視中／監視打ち切り終了

監視打ち切り終了

その他の状態

変更なし

変更なし

起動条件内イベントジョブおよびカスタムイベントジョブ

実行中

実行中

実行中／終了状態不明

終了状態不明

キューイング

キューイング

キューイング／終了状態不明

その他の状態

変更なし

変更なし

JP1/AJS3をコールドスタート（-cold）した場合

対象

状態

JP1/AJS3停止前の状態

通常時

jpomanevresetコマンド実行後

自ホストに対して実行中

他ホストに対して実行中

-e指定あり

-e指定なし

自ホストに対して実行中

他ホストに対して実行中

自ホストに対して実行中

他ホストに対して実行中

イベントジョブおよびカスタムイベントジョブ（ジョブネット中）

実行中

未登録

未登録

先行終了待ち

保留中

キューイング

その他の状態

起動条件

監視中

その他の状態

起動条件内イベントジョブおよびカスタムイベントジョブ

実行中

キューイング

その他の状態

JP1/AJS3起動時に起動モードを指定しない場合

スケジューラーサービスの起動モードで起動した場合の状態については，前述のそれぞれの状態と同様になります。

使用例1

イベント・アクション制御マネージャーが保持する情報を削除する場合の使用例は，「3. 通常の運用で使用するコマンド　jpomanevshow」の使用例を参照してください。

使用例2

ハードウェアのコピー・ミラーリング機能を使用してリモートサイトに運用を切り替えた場合に，実行エージェント「AP1」が保持するメインサイトのマネージャーホスト「MAINHOST」の情報を削除します。

jpomanevreset -h LogicalHost -F AJSROOT2 -dh MAINHOST -a AP1

jpomanevshow

形式

jpomanevshow
     [-h 論理ホスト名]
     [-F サービス名]

機能

イベント・アクション制御マネージャーの内部ログを解析し，マネージャーへのデータ送信頻度が高い実行ホスト名と起動条件付きジョブネットの情報を表示します。このコマンドは，起動条件イベントを大量発生させたジョブと，jpomanevresetコマンドの引数に指定するエージェントの特定に使用します（使用例を参照）。

解析は，24時間以内に出力されたものを対象とし，ログがラップしている場合は残っているログに関してだけ，解析の対象とします。また，起動条件に関するログだけを対象とし，ジョブネット中に定義したイベントジョブは対象としません。

解析結果は，データの送信頻度が高い順に5起動条件分が表示されます。起動条件ごとに，起動条件を特定できる情報，および時間単位でのログ数が表示されます。

このコマンドを実行するには，JP1/AJS3ホストサービスを起動している必要があります。

実行権限

Windowsの場合：Administrators 権限

UNIXの場合：スーパーユーザー権限

引数

-h 論理ホスト名

クラスタで運用している場合に，情報を表示する論理ホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，自ホスト名が仮定されます。

-F サービス名

処理対象とする，スケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

このオプションを省略した場合，デフォルトスケジューラーサービス名が仮定されます。

注意事項

JP1/AJS3の起動処理中に，このコマンドを実行しないでください。

オプションと値との間は，必ず1バイト以上の空白文字で区切ってください。

このコマンドは，複数を同時に実行できません。一つ目のコマンドの実行が終了してから，二つ目のコマンドを実行してください。

イベント・アクション制御マネージャーの内部ログ格納フォルダがない状態で，このコマンドを実行した場合，データがないものとして動作し，コマンドは正常終了します。イベント・アクション制御マネージャーの内部ログ格納フォルダについては，マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング　1.2.5 ログファイルおよびディレクトリ一覧」を参照してください。

-hオプションに自ホスト名を指定した場合は，物理ホストが指定されたと仮定して動作します。

Windowsのマシンでこのコマンドを実行する際には，コマンドプロンプトを管理者として起動する必要があります。ただし，UAC機能が無効の場合は，コマンドプロンプトを管理者として起動する必要はありません。

-Fオプションの省略時に仮定されるデフォルトスケジューラーサービス名がコマンド実行時に登録されていない場合，標準エラー出力にメッセージKAVT8351-Eを出力して，コマンドが異常終了します。コマンド実行ホストにデフォルトスケジューラーサービス名が登録されているかを見直した上で，コマンドを再実行してください。

なお，コマンドが処理対象とするホストについては-hオプションを参照してください。

戻り値

0

正常終了。

1

引数の指定が不適切である。

2

初期化に失敗した。

論理ホスト名の定義または環境設定に誤りがある。

3

権限が不足している。

5

同じコマンドを同時に実行している。

100

ファイルアクセスエラーが発生した。

101

メモリー不足が発生した。

255

システムエラーが発生した。

出力例

マネージャーホストで実行した場合の出力例を次に示します。

Time for analysis=20XX/06/01 02:30:00 - 20XX/06/02 02:30:00

Agent=agent1
Scheduler service=AJSROOT1
Unit ID=2133
Execution ID=2000(ID:@A2000)
Total count=233
Target time                   Count
20XX/06/01 22:00:00-22:59:59      1
20XX/06/01 23:00:00-23:59:59      1
20XX/06/02 00:00:00-00:59:59      1
20XX/06/02 01:00:00-01:59:59     30
20XX/06/02 02:00:00-02:30:00    200

Agent=agent1
Scheduler service=AJSROOT1
Unit ID=2134
Execution ID=2000(ID:@A2000)
Total count=1
Target time                   Count
20XX/06/01 17:00:00-17:59:59      1

出力内容の意味を次に示します。

Time for analysis

解析の対象とした時間を示します。ここに表示する時間は内部ログ上での時間のため，システム時刻と異なる場合があります。

Agent

データの送信元実行ホスト名を示します。

Scheduler service

起動条件が定義してあるスケジューラーサービス名を示します。

Unit ID

起動条件に定義したイベントジョブのユニットIDを示します。

Execution ID

起動条件の実行IDを示します。この実行IDは，［デイリースケジュール］ウィンドウ，または［マンスリースケジュール］ウィンドウに表示される，「実行中」の世代となります。

括弧内はJP1/AJS3 - View上での表示です。

Total count

内部ログ中にあった，起動条件に関するログの総数を示します。

Target time

単位時間当たりのログ数を表示する際の，対象時間を示します。対象時間内にログがない場合は，対象時間自体を出力しません。

Count

対象時間内にあった，起動条件に関するログ数を示します。

使用例

起動条件の監視対象イベントが一度に大量に発生した場合，マネージャー・エージェント間の通信や，データの一時保存用のファイル入出力が頻発して，JP1/AJS3を運用しているシステム全体が極端な高負荷状態になります。このため，オペレーターの操作が効かなくなり，他プログラムの処理が大幅に遅延するなどの影響が生じます。この場合は，大量の起動条件イベントを発生させたジョブとエージェントをjpomanevshowコマンドで特定します。そして，該当ジョブの監視条件を大量に成立させた原因を排除して，該当エージェントからの大量のイベントデータをjpomanevresetコマンドで削除すると，通常の運用に戻せます。

なお，上記手順の詳細については，マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング　2.5 起動条件付きジョブネットの処理が遅延した場合の対処」を参照してください。

jpomanjobshow

形式

jpomanjobshow
     [-h ホスト名]
     [-F サービス名]
     [-a 実行エージェント名...|-all]

機能

現在，マネージャーで実行中のイベントジョブおよびカスタムイベントジョブの一覧を標準出力ファイルに出力します。

このコマンドはマネージャー実行ホストで実行します。マネージャーが保持している情報だけを表示するため，ジョブ実行エージェントの状況に関係なく実行できます。そのため，マネージャーとジョブ実行エージェントのバージョンが一致しない場合でも一覧は表示されます。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-h ホスト名

ジョブ情報を表示するマネージャーの自ホスト名，または論理ホスト名を指定します。指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，自ホスト名が仮定されます。

コマンドを実行するホスト上に，指定したマネージャーホスト名が定義されていない場合，このコマンドはエラーになります。

-F サービス名

ジョブ情報を表示するスケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

このオプションを省略した場合，デフォルトスケジューラーサービス名が仮定されます。

-a 実行エージェント名...|-all

-hオプションで指定したマネージャーがジョブ実行要求を出している実行エージェントのうち，特定の実行エージェントのジョブ情報を表示したい場合に，-aオプションに実行エージェント名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

実行エージェント名は複数指定できます。複数指定する場合は，実行エージェント名間を1バイト以上の空白文字で区切ってください。

すべて実行エージェントを対象にする場合は-allを指定してください。

このオプションを省略した場合は，デフォルトの実行エージェントが仮定されます。

指定した実行エージェントにジョブ情報がない場合でも，コマンドはエラーになりません。また，指定した実行エージェントが実在しない場合もコマンドはエラーになりません。

注意事項

このコマンドを使用する際は，JP1/AJS3サービスを起動しておく必要があります。

JP1/AJS3の起動処理中に，このコマンドを実行しないでください。

オプションと値との間は，必ず1バイト以上の空白文字で区切ってください。

オプションに値を指定する引数では，オプションの次に指定したものは値と見なされます。例えば，「-h -a」と入力した場合，-hオプションに論理ホスト名「-a」を入力したと見なされます。

このコマンドは，複数を同時に実行できません。一つ目のコマンドの実行が終了してから，二つ目のコマンドを実行してください。

-Fオプションの省略時に仮定されるデフォルトスケジューラーサービス名がコマンド実行時に登録されていない場合，標準エラー出力にメッセージKAVT8351-Eを出力して，コマンドが異常終了します。コマンド実行ホストにデフォルトスケジューラーサービス名が登録されているかを見直した上で，コマンドを再実行してください。

なお，コマンドが処理対象とするホストについては-hオプションを参照してください。

戻り値

0

正常終了。

0以外の値

異常終了。

補足事項

JP1/AJS3スケジューラーサービスが起動していない場合にこのコマンドを実行しても，エラーになりません。次回実行予定のジョブがある場合，そのジョブの情報が出力されます。

出力例

ファイル出力例と出力内容の意味を次に示します。

出力内容を次に示します。

COMMAND START TIME

コマンドの実行開始日時を「YYYY/MM/DD HH:MM:SS」の形式で示します。

MANAGER

マネージャーホスト名（自ホスト名，または論理ホスト名）を示します。

AJSPATH

ジョブネット名を「/ルートジョブネット名/ジョブネット名/」の形式で示します。

JOBNAME

ジョブネット内のジョブ名を示します。

AGENT

実行エージェント名を示します。

ジョブ要求先の実行エージェント名が表示されます。

Execution ID

実行IDを示します。

Unit ID

ユニットIDを示します。

Scheduler service name

スケジューラーサービス名を示します。

Kind

ジョブの種類を示します。

evwjb：JP1イベント受信監視ジョブ

revwjb：リカバリーJP1イベント受信監視ジョブ

flwjb：ファイル監視ジョブ

rflwjb：リカバリーファイル監視ジョブ

mlwjb：メール受信監視ジョブ

rmlwjb：リカバリーメール受信監視ジョブ

mqwjb：メッセージキュー受信監視ジョブ

rmqwjb：リカバリーメッセージキュー受信監視ジョブ

mswjb：MSMQ受信監視ジョブ

rmswjb：リカバリーMSMQ受信監視ジョブ

lfwjb：ログファイル監視ジョブ

rlfwjb：リカバリーログファイル監視ジョブ

ntwjb：Windowsイベントログ監視ジョブ

rntwjb：リカバリーWindowsイベントログ監視ジョブ

tmwjb：実行間隔制御ジョブ

rtmwjb：リカバリー実行間隔制御ジョブ

cewjb：カスタムイベントジョブ

rcewjb：リカバリーカスタムイベントジョブ

Information

ジョブ情報を示します。

unreported：

実行エージェントが起動していないなどの理由で，ジョブの実行開始要求が実行エージェントに届いていない（未通知情報ファイルに登録されている）。

（表示なし）：

特に通知する情報がない（未通知情報ファイルに登録されていない）。

この場合は，次の状態であることが考えられます。

・マネージャーで未処理であるため未通知情報ファイルに情報がない。

・未通知情報ファイルへのアクセスでエラーが発生した。

・実行エージェントに正しく要求が届いている。

実際にエージェントでジョブが実行しているかどうかは，jpoagtjobshowコマンドで確認できる。

COMMAND END TIME

コマンドの実行終了日時を「YYYY/MM/DD HH:MM:SS」の形式で示します。

なお，「YYYY/MM/DD HH:MM:SS」は「西暦年/月/日 時:分:秒」のことです。

jpqdbcond

形式

jpqdbcond
     [-h 論理ホスト名]
     [[-m] |
       [[-x][-k]
         [-d ディレクトリ名] [-p {出力先}]]|
     [[{-l|-L} [-a] [[-i {出力先}]|
       [-t {出力先,未使用領域サイズしきい値} [-v]]]]
        |[-t {出力先,未使用領域サイズしきい値} [-v]]]]

機能

ジョブ実行環境で使用するISAMファイルの未使用領域率が高くなった場合などに，無効領域を圧縮し，ファイルを再編成します。

ジョブ実行環境で使用するISAMファイルの未使用領域率や，データファイルフラグメント率および未使用領域サイズを標準出力に出力します。

ISAMファイルの未使用領域率については，ジョブ実行環境でISAMファイルを使用中の場合でも，情報を表示できます。

ジョブ実行環境で使用するISAMファイルの次に示す情報を，指定した出力先にメッセージとして出力します。

・再編成時の情報（開始・終了時刻，統計情報）

・未使用領域サイズ

・未使用領域サイズがしきい値に達していた

メッセージの出力先は，次の中から単独で指定することも，幾つか組み合わせて指定することもできます。

・標準エラー出力

・Windowsイベントログまたはsyslog

・JP1イベント

ジョブ実行環境で使用するISAMファイルの未使用領域サイズがしきい値に達しているかいないかを，このコマンドの戻り値に設定します。

ISAMファイルのフォーマットを変換します。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-h 論理ホスト名

処理対象とする論理ホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，自ホスト名が仮定されます。

-m

ジョブ実行環境データベースのISAMロックテーブルエントリー数とISAMファイルフォーマット（キー再利用機能が有効か無効か）を出力します。

このオプションは，-hオプション以外のオプションとは同時に指定できません。

-x

ジョブ実行環境で使用するISAMファイルのデータファイルおよびキーファイルを完全に再編成します。

-k

ジョブ実行環境を構成するすべてのISAMファイルをキー再利用機能が有効となるフォーマットに変換すると同時に，データファイルおよびキーファイルを完全に再編成します。

-d ディレクトリ名

ジョブ実行環境で使用するISAMファイルを再編成する場合に，キーソート時に使用するワークファイルのディレクトリ名を指定します。

省略した場合の扱いについては，マニュアル「JP1/Base 運用ガイド」のJiscondコマンドの説明を参照してください。

-p {出力先}

ジョブ実行環境で使用するISAMファイルの再編成開始および終了時にメッセージを出力します。

このオプションは，-xオプションと同時に指定します。

出力先

メッセージの出力先を，次の中から指定します。出力先は，単独で指定することも，幾つか組み合わせて指定することもできます。

e：標準エラー出力

s：Windowsイベントログまたはsyslog

j：JP1イベント

このオプションを指定したときの，メッセージの出力例を次に示します。

（例1）再編成開始時

KAVU5980-I ジョブ実行環境のデータベース再編成を開始しました 20XX/10/01 01:05:40

（例2）再編成正常終了時

KAVU5981-I ジョブ実行環境のデータベース再編成が正常終了しました 20XX/10/01 01:05:40 - 20XX/10/01 01:20:20 (00:14:40)

開始日時，終了日時，経過時間，実施前後の未使用領域サイズをあわせて出力します。

（例3）再編成異常終了時

KAVS5982-E ジョブ実行環境のデータベース再編成が異常終了しました 20XX/10/01 01:05:40 - 20XX/10/01 01:20:20 (00:14:40)

{-l|-L}

ジョブ実行環境で使用するISAMファイルの未使用領域率を表示する場合に指定します。

このオプションを，-aオプションと同時に指定した場合，より詳細なISAMファイルの情報を表示します。

-l

ISAMファイルを占有して情報を取得します。

このオプションは，ファイルを占有して情報を取得するため，-Lオプションを指定した場合より正確な情報が取得できます。ただし，他プロセスがISAMファイルを使用中の場合は，エラーになります。

-L

ISAMファイルを占有しないで情報を取得します。

このオプションは，ファイルを占有しないため，ジョブ実行環境でISAMファイルを使用中でも情報を取得できます。ただし，並行してISAMファイルを更新しているプロセスがある場合，情報取得の瞬間のISAMファイル更新分については誤差が生じます。

-a

ジョブ実行環境で使用するISAMファイルの詳細な情報を出力します。

このオプションは，-lまたは-Lオプションと同時に指定すると，未使用領域率に加え，データファイルフラグメント率と未使用領域サイズを出力します。

-i {出力先}

ジョブ実行環境で使用するISAMファイルの未使用領域サイズをメッセージに出力します。

出力先

メッセージの出力先を，次の中から指定します。出力先は，単独で指定することも，幾つか組み合わせて指定することもできます。

e：標準エラー出力

s：Windowsイベントログまたはsyslog

j：JP1イベント

このオプションを指定したときの，メッセージの出力例を次に示します。

（例）

KAVU5983-I ジョブ実行環境のISAM未使用領域サイズは 99MBです

-t {出力先}，未使用領域サイズしきい値

ジョブ実行環境で使用するISAMファイルが，指定した未使用領域サイズしきい値に達していた場合，メッセージを出力します。

このオプションを使用して，ジョブを大量に実行するなどの繁忙期でないときに，JP1/AJS3のジョブとしてjpqdbcondコマンドをスケジュール実行することで，定期的にISAMファイルの状態を確認して，警告メッセージを出力できます。

出力先

メッセージの出力先を，次の中から指定します。

出力先は，単独で指定することも，幾つか組み合わせて指定することもできます。

e：標準エラー出力

s：Windowsイベントログまたはsyslog

j：JP1イベント

未使用領域サイズしきい値

ISAMファイルの未使用領域サイズしきい値を指定します。

指定できる値は，1〜1024（単位：メガバイト（MB），1MB=1,024×1,024バイト）です。

このオプションを指定したときの，メッセージの出力例を次に示します。

（例）

KAVU5984-W ジョブ実行環境のISAM未使用領域サイズは101MBで，しきい値(100MB)に達しています

-v

未使用領域率に達していたかいないかを，このコマンドの戻り値（プロセス終了コード）に設定する場合に指定します。

このオプションは，-tオプションと同時に指定します。

このオプションの指定の有無と，jpqdbcondコマンドの戻り値の関係を次に示します。

-vオプションを指定しない場合の戻り値

0

正常終了。

0以外の値

異常終了。

-vオプションを指定した場合の戻り値

0

未使用領域サイズしきい値に達していない。

1

未使用領域サイズしきい値以上の未使用領域サイズがある。

100以上の値

異常終了。

注意事項

該当するファイルをバックアップして保存した上で，再編成を実施してください。jpqdbcondコマンドは，-dオプションで指定したディレクトリを作業ディレクトリとして使用します。-dオプションで指定したディレクトリがあるドライブまたはパーティションには，再編成対象のジョブ実行環境のISAMキーファイルの中で最もサイズが大きいキーファイルの2倍以上の空き容量が必要です。また，ジョブ実行環境データベースディレクトリがあるドライブまたはパーティションには，再編成対象のジョブ実行環境のISAMファイルの中で最もサイズが大きいファイルと同程度の空き容量が必要です。

-dオプションを指定しない場合は，OSの標準的なワークディレクトリを使用します。マニュアル「JP1/Base 運用ガイド」のJiscondコマンドについての説明を参照してください。

-x，-t，-l，-L，-k，-mオプションをすべて指定しない場合，-xオプションが仮定されます。

このコマンドに-xおよび-kオプションを指定した場合は，実行前（ISAMファイルを再編成する前）に，ファイルのバックアップを必ず取得してください。

このコマンドに-x，-lおよび-kオプションを指定した場合，ISAMファイルを閉じている状態で実行してください（ISAMファイルを閉じるには，JP1/AJS3を停止してください）。ファイルが開いている状態でこのコマンドを実行した場合，エラーになります。

このコマンドに-Lオプションを指定した場合，他プロセスが使用中のISAMファイルに対しても情報を取得できますが，並行してアクセスする他プロセスがISAMファイルを更新した場合，情報取得の瞬間のISAMファイル更新分については誤差が生じます。また，ISAMファイルの整合性を保つため，コマンド実行中は他プロセスのISAMファイルへのアクセスが待たされます。したがって，このコマンドを使用する場合は，ジョブを大量に実行するなどの繁忙期を避けてください。

-l，-Lオプションで出力される情報は，フラグメンテーションの割合ではなく，未使用領域率です。このため，ISAMファイル中にレコードがない場合や，レコードが非常に少ない件数の場合，まだ使用されていない予約済みの空き領域に対する未使用領域率として「100%」と出力されます。

ISAMファイルを再編成しても，未使用領域が完全に再編成されないで，多少残る場合があります。

このコマンドに-xオプション，または-kオプションを指定して実行する場合，jpqautocondコマンドおよびjajs_maintain -m managerコマンドを同時に実行しないでください。

このコマンドの-xオプションおよび-kオプションは同時に指定しないでください。

戻り値

0

正常終了。※

1

使用するISAMファイルに，未使用領域サイズしきい値以上の未使用領域サイズがある。

100

引数の指定が不適切である。

132

サブミットジョブ実行環境構成定義ファイルの記述内容が不適切である。

135

システム資源不足が発生した。

137

データベース格納ディレクトリがない。

138

データベースへのアクセス権限がない。

140

コマンドを実行する権限（Administrators権限（Windowsの場合），またはスーパーユーザー権限（UNIXの場合））がない。

141

環境設定が不適切である。または，論理ホスト名が不適切である。

145

メモリー不足が発生した。

146

ディスク容量不足が発生した。

147

内部的要因でエラーが発生した。

148

データベース再編成ISAM処理でエラーが発生した。

149

データベースのサイズが2ギガバイトを超えているため処理が行えない。

226

実行環境が不適切である。

注※

-tオプションと-vオプションを同時に指定している場合，ジョブ実行環境で使用するISAMファイルが，未使用領域サイズしきい値に達していないことを示します。

補足事項

-lおよび-Lオプション指定時の出力形式を，次に示します。

出力項目を次に示します。

テーブル名

テーブル名称を表示します。

レコード件数

レコード件数を表示します。

データ

データファイルの未使用領域率を表示します。

キー1

一つ目のキーファイルの未使用領域率を表示します。

キー2

二つ目のキーファイルの未使用領域率を表示します。

キーファイルが一つだけの場合は，空白です。

なお，キーファイルが三つ以上の場合はありません。

-lおよび-Lオプションと同時に，-aオプションを指定した場合の出力形式を，次に示します。

各テーブルについて，2段で出力されます。上段は，-lオプションおよび-Lオプションと同じです。下段は，それぞれのファイルの未使用領域サイズ（単位：メガバイト（MB），1MB=1,024×1,024バイト）を出力します。

表示項目の説明を次に示します。

テーブル名

テーブル名を表示します。

レコード件数

レコード件数を表示します。

データ

-aオプションを指定した場合は，各テーブルについて2段で出力を行い，上段は，-lまたは-Lオプションを単独で使用した場合と同じ出力です。下段は，未使用領域サイズを出力します。

フラグメント率

可変長レコードでは，レコードを更新すると，ISAMファイル中のデータが，複数のブロックに分かれて格納されることがあります。この項目では，全レコードに対するレコード分割が発生しているレコード件数の割合を出力します。可変長のISAMファイルについてだけ出力し，該当しないテーブルは，「-（ハイフン）」が出力されます。

キー1

-aオプションを指定した場合は，各テーブルについて2段で出力を行い，上段は，-lまたは-Lオプションを単独で使用した場合と同じ出力です。下段は，未使用領域サイズを出力します。

キー2

-aオプションを指定した場合は，各テーブルについて2段で出力を行い，上段は，-lまたは-Lオプションを単独で使用した場合と同じ出力です。下段は，未使用領域サイズを出力します。

未使用領域サイズ

各ISAMファイルを構成しているデータファイルおよびキーファイルの未使用領域サイズの合計を出力します。

未使用領域サイズ合計

ジョブ実行環境で使用しているISAMファイルの未使用領域サイズの合計を出力します。

-mオプションを指定した場合の出力形式を，次に示します。

出力項目を次に示します。

テーブル名

テーブル名を表示します。

キー再利用

ISAMファイル形式のキー再利用機能が有効となっている場合は，「有効」が出力されます。

ISAMファイル形式が従来形式の場合は，「無効」が出力されます。

セマフォ番号

セマフォ分割されている場合は，セマフォ番号を出力します。

セマフォ分割されていない場合は，「-（ハイフン）」が出力されます。

-p，-i，-tオプションの出力先として，j（JP1イベント）を指定した場合，次に示すJP1イベントが出力されます。

指定したオプション

イベントID

イベント名称

イベント発行契機

メッセージID

-p

00004160

ジョブ実行環境データベース再編成開始イベント

再編成が開始したとき

KAVU5980-I

-p

00004161

ジョブ実行環境データベース再編成正常終了イベント

再編成が正常終了したとき

KAVU5981-I

-p

00004162

ジョブ実行環境データベース再編成異常終了イベント

再編成が異常終了したとき

KAVU5982-E

-i

00004163

ISAM未使用領域サイズ情報イベント

ISAM未使用領域サイズ情報取得時

KAVU5983-I

-t

00004164

ISAM未使用領域サイズしきい値到達イベント

ISAM未使用領域サイズしきい値到達時

KAVU5984-W

注

JP1イベントの詳細については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　付録A JP1/AJS3が発行するJP1イベント」を参照してください。

データベースを再編成時に出力されるデータベース再編成ログを，次に説明します。

jpqdbcondコマンドを実行すると，データベース格納ディレクトリにCONDENSE{1|2}.logファイルを作成し，次に示す統計情報をデータベース再編成ログに出力します。

開始時刻，終了時刻，所要時間

データベース再編成前の未使用領域サイズ，総ファイルサイズ

データベース再編成後の未使用領域サイズ，総ファイルサイズ

出力形式は，HNTRログ形式です。ログのサイズは1面512キロバイト，面数は2面です。

データベース再編成時の統計情報は，メッセージKAVU5985-Iを使用して情報を埋め込み出力します。

出力例

KAVU5980-I ジョブ実行環境のデータベース再編成を開始しました 20XX/10/01 01:05:40
KAVU5985-I CONDENSE: データベース再編成前 未使用領域サイズ:102.020MB 総ファイルサイズ 542.245MB
KAVU5985-I CONDENSE: データベース再編成後 未使用領域サイズ:0.100MB 総ファイルサイズ 440.225MB
KAVU5981-I ジョブ実行環境のデータベース再編成が正常終了しました 20XX/10/01 01:05:40 - 20XX/10/01 01:20:20 (00:14:40)

4　特別な運用で使用するコマンド

この章では，JP1/AJS3の特別な運用で使用するコマンドを説明します。

ajslocaldate

形式

ajslocaldate
     [-F サービス名]
     [-y]
     {[-d [[年/]月/]日][-t 時[:分]]|[-s 秒]|[-u]}

機能

JP1/AJS3のスケジューラーサービスローカル日時（JP1/AJS3で管理する日時）を変更します。

-y，-d，-t，-s，-uオプションを指定しないで実行した場合は，JP1/AJS3のスケジューラーサービスローカル日時を標準出力ファイルに出力します。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-F サービス名

処理対象とする，スケジューラーサービスのサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

省略した場合，デフォルトスケジューラーサービス名が仮定されます。

-y

スケジューラーサービスローカル日時を変更する前に，メッセージおよび了解を求めるプロンプトを表示しません。

-d [[年/]月/]日

スケジューラーサービスローカル日付を指定します。

年

指定できる値は，1997〜環境設定パラメーターSCHEDULELIMITの値（単位：西暦年）です。環境設定パラメーターSCHEDULELIMITの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2(123) SCHEDULELIMIT」を参照してください。

月

指定できる値は，1〜12（単位：月）です。

日

指定できる値は，1〜31（単位：日）です。

-t 時[:分]

スケジューラーサービスローカル時刻を指定します。

時

指定できる値は，0〜23（単位：時）です。

分

指定できる値は，0〜59（単位：分）です。

-s 秒

現在のスケジューラーサービスローカル日時との差分を指定します。

指定できる値は，-4,294,967,295〜4,294,967,295（単位：秒）です。

結果が指定できる年の範囲を超える場合はエラーとなります。

-u

スケジューラーサービスローカル日時を，初期値（ホストの現在時刻）に戻します。

注意事項

スケジューラーサービスローカル日時を変更する場合は，スケジューラーサービスを停止してからこのコマンドを実行してください。次回のスケジューラーサービスの起動後に，変更したローカル日時がシステムに反映されます。スケジューラーサービス起動中にこのコマンドを実行すると，スケジュール計算や表示日時などが不正になる場合があります。

スケジューラーサービスローカル日時を過去に戻した場合，スケジューラーサービスを必ずコールドスタートで起動してください（スケジューラーサービスローカル日時を変更すると，スケジュール・モニター情報ファイルに記録されたジョブの終了時間などを元に戻せなくなり，ジョブネットがスケジュールどおりに実行できなくなります）。

スケジューラーサービスは，ajsstartコマンド（-cオプションを必ず指定してください）でコールドスタートできます。

ローカル時刻はシステム時刻を基に生成します。システム時刻を変更した場合は，その変更分がローカル時刻に正しく反映されているかどうか確認してください。

クラスタでローカル時刻を使用する場合，実行系と待機系の両方のマシンで同じローカル時刻となるようにajslocaldateコマンドを実行してください。

起動条件付きジョブネットを実行登録している状態で，ローカル時刻を変更する場合は，ajsstopコマンドに「-c」以外のオプション「-s」「-n」「-j」「-k」のどれかを指定してスケジューラーサービスを停止させてからajslocaldateコマンドを実行してください。ajsstopコマンドに「-c」を指定して停止した場合は，起動条件の有効範囲に指定した時間どおりに監視が打ち切られません。

スケジューラーサービスローカル日時を過去の時刻に変更する場合は，このコマンドでスケジューラーサービスローカル日時を変更する前に，リリース登録したジョブネットがないかを確認してください。過去にリリース登録を実施した実績があるジョブネットも含め，リリース登録したジョブネットがある場合は，ajsdeleteコマンドなどでリリース先ジョブネットを削除してから，時刻を変更してください。

リリース先ジョブネットを削除しないで日時を過去の時刻に変更すると，正常に動作しなくなるおそれがあります。その場合，日時を変更前の時刻に戻したあとで，リリース先ジョブネットを削除してから，再度日時を変更してください。

なお，削除したリリース先ジョブネットを復元するには，ジョブネットをリリース登録する前に，ajsprintコマンドなどでリリース先となるジョブネットの定義情報をバックアップしておく必要があります。バックアップしておいたジョブネットの定義情報をajsdefineコマンドなどで定義し直したあと，リリース元を指定して再度リリース登録することで，リリース先ジョブネットを復元できます。

戻り値

0

正常終了。

4〜124で4の倍数値

異常終了。

補足事項

スケジューラーサービスローカル日時の表示形式の例を次の表に示します。

表4‒1　スケジューラーサービスローカル日時の表示形式の例

言語種別

表示形式の例

日本語

20XX/12/01 12:00:00

英語

Dec 01 20XX 12:00:00

スケジューラーサービスローカル日時の変更時は，Windowsイベントログまたはsyslogに，メッセージKAVS0210-Iを出力します。

ajsqlalter

形式

ajsqlalter
     [-l 最大同時ジョブ実行数]
     [-b 最大待ちジョブ数]
     [-r]
     [-c クラス名]
     [-h 論理ホスト名]

機能

キューレスエージェントサービスの運用環境を一時的に変更します。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

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

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

UNIXの場合

/opt/jp1ajs2/bin/

引数

-l 最大同時ジョブ実行数

同時に実行できるキューレスジョブの最大数を指定します。

指定できる値は0〜1,024です。

このオプションを省略してコマンドを実行した場合，コマンドは正常終了しますが最大同時ジョブ実行数は変更されません。

最大同時ジョブ実行数だけを省略してコマンドを実行した場合，コマンドは異常終了します。

最大同時ジョブ実行数に設定された値より多くのキューレスジョブを実行しようとした場合，該当するジョブは実行されないでキューレスエージェントサービス上で最大待ちジョブ数の上限に達するまで蓄積されます。

特定のクラスの最大同時ジョブ実行数を変更する場合は，-cオプションを指定して実行してください。

キューレスエージェントサービス全体（デフォルトクラス）の最大同時ジョブ実行数を変更する場合は，-cオプションを省略してください。

論理ホスト上のクラスの最大同時ジョブ実行数を変更する場合は，-cおよび-hオプションを同時に指定してコマンドを実行してください。

-b 最大待ちジョブ数

キューレスエージェントサービスに蓄積できるキューレスジョブの最大数を指定します。

指定できる値は0〜102,400です。

このオプションを省略してコマンドを実行した場合，コマンドは正常終了しますが最大待ちジョブ数は変更されません。

最大待ちジョブ数だけを省略してコマンドを実行した場合，コマンドは異常終了します。

キューレスエージェントサービスに蓄積されたキューレスジョブの数が，最大待ちジョブ数の上限を超えた場合，該当するジョブは起動失敗になります。

特定のクラスの最大待ちジョブ数を変更する場合は，-cオプションを指定して実行してください。

キューレスエージェントサービス全体（デフォルトクラス）の最大待ちジョブ数を変更する場合は，-cオプションを省略してください。

論理ホスト上のクラスの最大待ちジョブ数を変更する場合は，-cおよび-hオプションを同時に指定してコマンドを実行してください。

-r

ユーザーマッピングキャッシュを消去します。

省略した場合，ユーザーマッピングキャッシュは消去されません。

-hまたは-cオプションと同時に指定した場合，論理ホストとクラスの指定は無視されます。

-c クラス名

一時的に運用環境を変更したいクラス名を指定します。

省略した場合，キューレスエージェントサービス全体（デフォルトクラス）が仮定されます。

-rオプションへの影響はありません。

-h 論理ホスト名

一時的に運用環境を変更したい論理ホスト名を指定します。自ホスト上の論理ホストだけを指定できます。

省略した場合，物理ホストが仮定されます。

-rオプションへの影響はありません。

-cオプションと同時に指定する必要があります。

注意事項

このコマンドを実行する前に，キューレスエージェントサービスを起動，および該当する論理ホストのキューレスジョブ実行環境をセットアップしておく必要があります。キューレスジョブ実行環境をセットアップしていない場合は，ajsqlsetupコマンドを実行して該当する論理ホストのキューレスジョブ実行環境をセットアップしてください。ajsqlsetupコマンドの詳細については，「4. 特別な運用で使用するコマンド　ajsqlsetup」を参照してください。

-rオプション指定時は，キューレスジョブを実行していない状態でコマンドを実行してください。

ログインシェル，パスワードなどキューレスジョブ実行OSユーザーの情報を変更した場合は，ユーザーマッピングキャッシュを消去する必要があります。-rオプションを指定して，ユーザーマッピングキャッシュを消去してください。ユーザーマッピングキャッシュを消去しないで運用を続けた場合，OSユーザーの情報を変更した以降に実行したキューレスジョブが起動失敗または異常検出終了となるおそれがあります。なお，ユーザーマッピングキャッシュは，キューレスエージェントサービス，およびキューレスファイル転送サービスの再起動時にも消去されます。

戻り値

0

正常終了。

0以外の値

異常終了。

使用例

キューレスエージェントサービス全体（デフォルトクラス）の最大同時ジョブ実行数を50に変更します。

ajsqlalter -l 50

ajsqlattach

形式

ajsqlattach
     [-h 論理ホスト名]

機能

キューレスエージェントサービスに論理ホストをアタッチ（接続）します。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

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

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

UNIXの場合

/opt/jp1ajs2/bin/

引数

-h 論理ホスト名

キューレスエージェントサービスにアタッチする論理ホスト名を指定します。

省略した場合，物理ホストが仮定されます。

論理ホスト名を省略してコマンドを実行した場合，コマンドは異常終了します。

注意事項

このコマンドを実行する前に，キューレスエージェントサービスを起動，および該当する論理ホストのキューレスジョブ実行環境をセットアップしておく必要があります。キューレスジョブ実行環境をセットアップしていない場合は，ajsqlsetupコマンドを実行して該当する論理ホストのキューレスジョブ実行環境をセットアップしてください。ajsqlsetupコマンドの詳細については，「4. 特別な運用で使用するコマンド　ajsqlsetup」を参照してください。

アタッチされていない論理ホストに対してキューレスジョブを実行すると，環境設定パラメーターAJSQL_NOATTACHREQの値に従って該当するキューレスジョブが物理ホストで実行されるか，または起動失敗となります。環境設定パラメーターAJSQL_NOATTACHREQの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.10 キューレスジョブ実行環境設定」を参照してください。

戻り値

0

正常終了。

0以外の値

異常終了。

使用例

キューレスエージェントサービスに論理ホスト名（newhost）をアタッチします。

ajsqlattach -h newhost

ajsqldetach

形式

ajsqldetach
     [-h 論理ホスト名]
     [-k]

機能

キューレスエージェントサービスから論理ホストをデタッチ（切断）します。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

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

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

UNIXの場合

/opt/jp1ajs2/bin/

引数

-h 論理ホスト名

キューレスエージェントサービスからデタッチする論理ホスト名を指定します。

このオプションを省略した場合，物理ホストが仮定されます。

論理ホスト名を省略してコマンドを実行した場合，コマンドは異常終了します。

-k

デタッチ対象論理ホストに実行中のキューレスジョブがある場合，実行中のキューレスジョブをすべて強制終了したあとにキューレスエージェントサービスから該当する論理ホストをデタッチします（このデタッチを「強制デタッチ」と呼びます）。

このオプションを省略した場合，デタッチ対象論理ホストで実行中のキューレスジョブがすべて終了するのを待ってからキューレスエージェントサービスから該当する論理ホストをデタッチします（このデタッチを「計画デタッチ」と呼びます）。

注意事項

このコマンドを実行する前に，キューレスエージェントサービスを起動，および該当する論理ホストのキューレスジョブ実行環境をセットアップしておく必要があります。キューレスジョブ実行環境をセットアップしていない場合は，ajsqlsetupコマンドを実行して該当する論理ホストのキューレスジョブ実行環境をセットアップしてください。ajsqlsetupコマンドの詳細については，「4. 特別な運用で使用するコマンド　ajsqlsetup」を参照してください。

アタッチされていない論理ホストに対してキューレスジョブを実行すると，環境設定パラメーターAJSQL_NOATTACHREQの値に従って該当するキューレスジョブが物理ホストで実行されるか，または起動失敗となります。環境設定パラメーターAJSQL_NOATTACHREQの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.10 キューレスジョブ実行環境設定」を参照してください。

強制デタッチの場合，デタッチ対象論理ホストに実行中のキューレスジョブがある場合，実行中のキューレスジョブをすべて強制終了したあとにキューレスエージェントサービスから該当する論理ホストをデタッチします。このため，大量のキューレスジョブ実行中の場合，強制デタッチに時間が掛かるおそれがあります。

戻り値

0

正常終了。

0以外の値

異常終了。

使用例

キューレスエージェントサービスから，論理ホスト名（newhost）をデタッチします。

ajsqldetach -h newhost

ajsqlexecsetsz

形式

JP1/AJS3 - Managerの場合

ajsqlexecsetsz
     [{-a [-h 論理ホスト名]|-f}]
     [-s サイズ]

JP1/AJS3 - Agentの場合

ajsqlexecsetsz
     [-a]
     [-h 論理ホスト名]
     [-s サイズ]

機能

キューレスジョブ実行内部ログファイルのファイルサイズを変更，または現在設定されているファイルサイズを標準出力へ出力します。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

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

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

UNIXの場合

/opt/jp1ajs2/bin/

引数

-a

キューレスエージェントサービスが出力する実行内部ログが保存されるajsqlexeclogファイルのファイルサイズを変更する，または現在設定されているajsqlexeclogファイルのファイルサイズを標準出力に出力する場合に指定します。

このオプションは-fオプションと同時には指定できません。

-h 論理ホスト名

コマンド実行対象のajsqlexeclogファイルがある論理ホスト名を指定します。このオプションを省略した場合，物理ホストが仮定されます。

このオプションは-fオプションと同時には指定できません。

-f

キューレスファイル転送サービスが出力する実行内部ログが保存されるajsqlexeclog_ftpdファイルのファイルサイズを変更する，または現在設定されているajsqlexeclog_ftpdファイルのファイルサイズを標準出力に出力する場合に指定します。

このオプションは-aオプションと同時には指定できません。

-s サイズ

変更したいキューレスジョブ実行内部ログファイルのファイルサイズをキロバイト単位で指定します。

指定できる値は，2,048〜2,097,151です。このオプションが省略された場合，引数に指定されたキューレスジョブ実行内部ログファイルの，現在設定されているサイズを標準出力に出力します。

注意事項

このコマンドを実行する前に，キューレスジョブ実行環境をセットアップしておく必要があります。キューレスジョブ実行環境をセットアップしていない場合は，ajsqlsetupコマンドを実行してキューレスジョブ実行環境をセットアップしてください。なお，クラスタ環境で使用する場合は，該当する論理ホストでセットアップしてください。

ajsqlsetupコマンドの詳細については，「4. 特別な運用で使用するコマンド　ajsqlsetup」を参照してください。

このコマンドで，キューレスジョブ実行内部ログファイルのサイズを現在設定されているサイズより小さくした場合，サイズ変更前のファイルの内容は削除されます。

キューレスジョブ実行内部ログファイルは，物理ホストまたは論理ホストに関係なく，ローカルディスク上に作成されます。このため，実行系および待機系それぞれでこのコマンドを実行してください。

戻り値

0

正常終了。

0以外の値

異常終了。

使用例

論理ホスト（Lhost）の，ajsqlexeclogファイルのファイルサイズを32メガバイト（32,768キロバイト）に拡張します。

ajsqlexecsetsz -a -h Lhost -s 32768

ajsqlftpstart（UNIX限定）

形式

ajsqlftpstart

機能

キューレスファイル転送サービスを起動します。

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1ajs2/bin/

引数

なし

注意事項

このコマンドを実行する前に，キューレスエージェントサービスを起動，およびキューレスジョブ実行環境をセットアップしておく必要があります。キューレスジョブ実行環境をセットアップしていない場合は，ajsqlsetupコマンドを実行してキューレスジョブ実行環境をセットアップしてください。なお，クラスタ環境で使用する場合は，該当する論理ホストでセットアップしてください。

ajsqlsetupコマンドの詳細については，「4. 特別な運用で使用するコマンド　ajsqlsetup」を参照してください。

このコマンドはUNIXだけで実行できます。Windowsでは実行できません。

このコマンドは，サービスの起動完了を待たないで終了します。サービスが起動したかどうかは，ajsqlstatusコマンドで確認してください。

戻り値

0

正常終了。

0以外の値

異常終了。

ajsqlftpstop

形式

ajsqlftpstop
     [-j|-c]

機能

キューレスファイル転送サービスを停止します。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

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

UNIXの場合

/opt/jp1ajs2/bin/

引数

-j

実行中の転送処理がすべて終了するのを待ってからキューレスファイル転送サービスを停止します。

このオプションは-cオプションと同時には指定できません。

-c

実行中の転送処理の終了を待たないでキューレスファイル転送サービスを即時に停止します。

このオプションは-jオプションと同時には指定できません。

注意事項

このコマンドを実行する前に，キューレスエージェントサービスを起動，およびキューレスジョブ実行環境をセットアップしておく必要があります。キューレスジョブ実行環境をセットアップしていない場合は，ajsqlsetupコマンドを実行してキューレスジョブ実行環境をセットアップしてください。なお，クラスタ環境で使用する場合は，該当する論理ホストでセットアップしてください。

ajsqlsetupコマンドの詳細については，「4. 特別な運用で使用するコマンド　ajsqlsetup」を参照してください。

オプションを省略した場合，-jオプションが仮定されます。

このコマンドは，キューレスファイル転送サービスへの停止要求を送信した時点で終了します。このため，このコマンドからではキューレスファイル転送サービスが停止したかどうかを確認できません。キューレスファイル転送サービスの停止を確認したい場合は，ajsqlstatusコマンドを実行して確認してください。ajsqlstatusコマンドの詳細については，「4. 特別な運用で使用するコマンド　ajsqlstatus」を参照してください。

このコマンドに-cオプションを指定してキューレスファイル転送サービスを停止した場合，停止時に実行中だったキューレスジョブの終了状態は起動失敗または異常検出終了となるおそれがあります。起動失敗または異常検出終了となったキューレスジョブがある場合は，必要に応じてキューレスファイル転送サービスを再起動し，再度該当するジョブを実行してください。

戻り値

0

正常終了。

0以外の値

異常終了。

ajsqlsetup

形式

JP1/AJS3 - Managerの場合

ajsqlsetup
     [-h 論理ホスト名]
     [-F スケジューラーサービス名]
     [-nc]
     [[-m][-a]]|[-r]|[-u]

JP1/AJS3 - Agentの場合

ajsqlsetup
     [-h 論理ホスト名]
     [-a]|[-u]

機能

キューレスジョブ実行環境をセットアップします。なお，JP1/AJS3 - Agent Minimal Editionでは，このコマンドは使用できません。

なお，キューレスジョブでは，実行エージェントや実行エージェントグループなどが使用できないため，キューレスジョブの使用は推奨しません。通常はキューレスエージェントを実行先に指定しないようにしてください。

このコマンドによって設定される情報を次に示します。

サービスの登録

キューレスジョブの実行で使用する次のサービスを登録します。

サービス

JP1/AJS3 - Manager

JP1/AJS3 - Agent

キューレスエージェントサービス

○※1

○※1

キューレスファイル転送サービス

○※2

−

サービスの依存関係の設定

JP1/AJS3サービスと，キューレスエージェントサービスまたはキューレスファイル転送サービスとの依存関係を設定します。

JP1/AJS3サービスが依存するサービス

JP1/AJS3 - Manager

JP1/AJS3 - Agent

キューレスエージェントサービス

○※3

−

キューレスファイル転送サービス

○※2

−

通信ポートの設定

キューレスジョブの実行で使用する次の通信ポートをservicesファイルに登録します。

通信ポート（サービス名：ポート番号）

JP1/AJS3 - Manager

JP1/AJS3 - Agent

キューレスジョブの実行（jp1ajs2qlagt：20300）

○

○

キューレスファイルの転送（jp1ajs2qlftp：20301）

○

○

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

キューレスジョブ実行で使用する環境設定パラメーターを設定します。

設定情報

JP1/AJS3 - Manager

JP1/AJS3 - Agent

定義キー

環境設定

パラメーター

[JP1_DEFAULT¥JP1AJSMANAGER]※6

"QLMANCHARCODE"=UTF-8

○※4

−

[JP1_DEFAULT¥JP1AJSMANAGER¥スケジューラーサービス名]

または

[論理ホスト名¥JP1AJSMANAGER¥スケジューラーサービス名]※6

"QUEUELESSMULTIREQ"=dword:00000001

○※2

−

[JP1_DEFAULT¥JP1QLAGENT]※6

Windowsの場合

"AJSQL_JOBMAX"=dword:00000005

UNIXの場合

"AJSQL_JOBMAX"=dword:00000400

○※1

○※1

Windowsの場合

"AJSQL_JOBWAITMAX"=dword:00000800

UNIXの場合

"AJSQL_JOBWAITMAX"=dword:00000000

○※1

○※1

"AJSQL_TRACELOGFILE"=※5

○

○※1

[JP1_DEFAULT¥JP1QLAGENT]

または

[論理ホスト名¥JP1QLAGENT]※6

"AJSQL_LOGFILE"=※5

○※1

○※1

"AJSQL_LOGSIZE"=dword:00002000

○※1

○※1

"AJSQL_STATFILE"=※5

○※1

○※1

"AJSQL_STATSIZE"=dword:00000800

○※1

○※1

ジョブID管理ファイルの作成

キューレスジョブ実行で，キューレスジョブに付加するジョブIDを管理するファイルを作成します。

ファイル名

JP1/AJS3 - Manager

JP1/AJS3 - Agent

Windows

スケジューラーサービスのDBフォルダ¥AJSQLJID.dat

UNIX

スケジューラーサービスのDBディレクトリ/AJSQLJID.dat

○※2

−

（凡例）

○：設定できる。

−：設定できない。

注※1

JP1/AJS3 - Manager上またはJP1/AJS3 - Agent上でエージェント機能を使用する場合，-aオプションを指定したときだけ設定されます。

注※2

JP1/AJS3 - Manager上でマネージャー機能を使用する場合，-mオプションを指定したときだけ設定されます。

注※3

JP1/AJS3 - Manager上でエージェント機能を使用する場合，-aオプションを指定したときだけ設定されます。

注※4

Linux版のJP1/AJS3 - Manager上でマネージャー機能を使用する場合，-mオプションを指定したときだけ設定されます。

注※5

値は，使用している環境によって異なります。環境設定パラメーターの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.10 キューレスジョブ実行環境設定」を参照してください。

注※6

設定された環境設定パラメーターの値を変更したい場合は，jajs_configコマンドを使用した変更方法を推奨します。jajs_configコマンドを使用して値を変更する場合，環境設定パラメーター名や定義内容がチェックされます。そのため，誤った内容が設定されることを防げます。jajs_configコマンドの詳細については，「2. セットアップコマンド　jajs_config」を参照してください。

なお，複数の環境設定パラメーターの値を同時に変更したい場合は，jbssetcnfコマンドを使用してください。jbssetcnfコマンドの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

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

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

UNIXの場合

/opt/jp1ajs2/bin/

引数

-h 論理ホスト名

クラスタ環境で使用する場合，セットアップする論理ホスト名（JP1/Baseで設定した論理ホスト名）を指定します。

省略した場合，物理ホストが仮定されます。ただし，環境変数JP1_HOSTNAMEが指定されている場合は，その値が仮定されます。

物理ホストを明示的に指定する場合は，オプションに「JP1_DEFAULT」を指定してください。

このオプションは，-m，-a，-rオプションを指定したときに有効です。

-F スケジューラーサービス名

セットアップする対象のスケジューラーサービス名を指定します。

このオプションは，JP1/AJS3 - Managerの場合だけ指定できます。JP1/AJS3 - Agentでは指定できません。

省略した場合，デフォルトのスケジューラーサービスが仮定されます。ただし，環境変数AJSCONFが指定されている場合は，その値が仮定されます。

このオプションは，-m，-rオプションを指定したときに有効です。

-nc

共有ディスク上で，ジョブID管理ファイルの作成およびファイルの有無のチェックを行いません。クラスタ環境の待機系セットアップ時にだけ指定してください。-mオプション指定時に有効なオプションです。

-m

キューレスジョブのマネージャー機能をセットアップします。

このオプションは，JP1/AJS3 - Managerの場合だけ指定できます。JP1/AJS3 - Agentでは指定できません。

このオプションは-r，-uオプションと同時には指定できません。

-a

キューレスジョブのエージェント機能をセットアップします。

このオプションは-r，-uオプションと同時には指定できません。

-r

JP1/AJS3サービスを停止し，-Fオプションまたは環境変数AJSCONFに指定したスケジューラーサービスに対するキューレスジョブのマネージャー機能を無効にします。マネージャー機能を無効にしたスケジューラーサービスからは，キューレスジョブを送信できません。

このオプションは，JP1/AJS3 - Managerの場合だけ指定できます。JP1/AJS3 - Agentでは指定できません。

このオプションは-m，-a，-uオプションと同時には指定できません。

-u

JP1/AJS3サービスを停止し，JP1/AJS3サービスからキューレスジョブ実行環境の設定を削除します。

Windowsの場合，Windowsの［管理ツール］のサービス一覧からキューレスエージェントサービス（JP1/AJS3 Queueless Agent）およびキューレスファイル転送サービス（JP1/AJS3 Queueless File Transfer）を削除します。

このオプションは-r，-m，-aオプションと同時には指定できません。

注意事項

-mオプションを指定してマネージャー機能をセットアップする場合，または-aオプションを指定してエージェント機能をセットアップする場合は，JP1/AJS3サービスが停止している状態で実行してください。また，ajsqlsetupコマンドによってすでにキューレスエージェントサービスおよびキューレスファイル転送サービスが登録されている場合は，それらのサービスもすべて停止している状態で実行してください。

-rオプションを指定してキューレスジョブのマネージャー機能の設定を無効にする場合，または-uオプションを指定してキューレスジョブ実行環境の設定を削除する場合は，JP1/AJS3の運用を停止した状態で実行してください。JP1/AJS3が運用中であってもキューレスジョブ機能の無効化や削除を優先するため，JP1/AJS3サービス，キューレスエージェントサービスおよびキューレスファイル転送サービスを停止します。そのため，JP1/AJS3の運用に影響するおそれがあります。

設定の種別を示すオプション（-m，-a，-r，-u）を省略した場合，次のオプションが仮定されます。

JP1/AJS3 - Managerの場合：-m，-a

JP1/AJS3 - Agentの場合：-a

07-50と同様のオプションで運用する場合， 07-50互換オプションを適用する。

次の手順に従ってください。

ajs2ql_0750.conf.modelをajs2ql_0750.confにコピーする。

ajs2ql_0750.confを必要に応じて編集する。

jbssetcnfコマンドを実行する。

（例）

jbssetcnf ajs2ql_0750.conf

Windowsのマシンでこのコマンドを実行する際には，コマンドプロンプトを管理者として起動する必要があります。ただし，UAC機能が無効の場合は，コマンドプロンプトを管理者として起動する必要はありません。

戻り値

0

正常終了。

0以外の値

異常終了。

ajsqlstart（UNIX限定）

形式

ajsqlstart

機能

キューレスエージェントサービスを起動します。

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1ajs2/bin/

引数

なし

注意事項

このコマンドを実行する前に，キューレスジョブ実行環境をセットアップしておく必要があります。キューレスジョブ実行環境をセットアップしていない場合は，ajsqlsetupコマンドを実行してキューレスジョブ実行環境をセットアップしてください。なお，クラスタ環境で使用する場合は，該当する論理ホストでセットアップしてください。

ajsqlsetupコマンドの詳細については，「4. 特別な運用で使用するコマンド　ajsqlsetup」を参照してください。

このコマンドはUNIXだけで実行できます。Windowsでは実行できません。

このコマンドは，サービスの起動完了を待たないで終了します。サービスが起動したかどうかは，ajsqlstatusコマンドで確認してください。ajsqlstatusコマンドの詳細については，「4. 特別な運用で使用するコマンド　ajsqlstatus」を参照してください。

戻り値

0

正常終了。

0以外の値

異常終了。

ajsqlstatus

形式

ajsqlstatus
     ［-h 論理ホスト名］

機能

キューレスエージェントサービスの詳細情報を出力します。

実行権限

なし

格納先ディレクトリ

Windowsの場合

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

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

UNIXの場合

/opt/jp1ajs2/bin/

引数

-h 論理ホスト名

詳細情報を出力したい論理ホスト名を指定します。

オプションを省略した場合は物理ホストが仮定されます。

論理ホスト名を省略してコマンドを実行した場合，コマンドは異常終了します。

戻り値

0

正常終了。

0以外の値

異常終了。

使用例

キューレスエージェントサービスの詳細情報を標準出力に出力します。

ajsqlstatus

出力例

表示項目の説明

表示項目を次に説明します。各表示項目の括弧は，UNIXでコマンド実行OSユーザーの環境変数LANGの値が「C」の場合の出力形式を示します。

ホストにJP1/AJS3 - Agentがインストールされている場合，キューレスファイル転送サービスがインストールされないため項目2は表示されません。

項目13はホストがWindowsの場合だけ表示されます。

項目15〜17は対象ホストに定義されているクラスの数だけ表示されます。また，出力の際は出力ごとに先頭に改行が入ります。

（1） キューレスエージェントサービス状態（Queueless agent service）

キューレスエージェントサービスの起動状態を示します。

運用中（active）：キューレスエージェントサービスの運用を開始しています。

停止（inactive）：キューレスエージェントサービスの運用を停止しています。

制限処理中（restricted processing...）：キューレスエージェントサービスが停止処理中のため，ジョブやコマンドの実行要求を受け付けられない状態です。実行中のジョブが終了すると，キューレスエージェントサービスは停止します。

強制停止中（forcibly stopping...）：キューレスエージェントサービスが停止処理中のため，ジョブやコマンドの実行要求を受け付けられない状態です。実行中のジョブの終了を待たずに，キューレスエージェントサービスは停止します。ただし，ファイル転送中の場合は，ファイル転送が終了するのを待ってから，キューレスエージェントサービスは停止します。

（2） キューレスファイル転送サービス状態（Queueless file transfer service）

キューレスファイル転送サービスの起動状態を示します。

運用中（active）：キューレスファイル転送サービスの運用を開始しています。

停止（inactive）：キューレスファイル転送サービスが停止しています。

制限処理中（restricted processing...）：キューレスファイル転送サービスが停止処理中のため，コマンドの実行要求を受け付けられない状態です。ファイル転送処理が終了すると，キューレスファイル転送サービスは停止します。

また，キューレスファイル転送サービスがセットアップされていない場合は，「停止」と出力します。

（3） ホスト名（Hostname）

対象ホスト名を示します。

（4） キューレスジョブ実行可否（Queueless job）

対象ホストのキューレスジョブの実行可否を示します。

実行可（can execute）：対象ホストでキューレスジョブが実行できます。

実行不可（cannot execute）：対象ホストではキューレスジョブは実行できません。

デタッチ処理中（detach processing...）：対象ホストはデタッチ処理中のため，キューレスジョブは実行できません。

（5） 処理対象外論理ホストへの実行要求（Execution request to logical host）

キューレスジョブ処理対象でない論理ホストへのジョブ実行要求時の処理を示します。

物理ホストで実行（executes in physical host）：ジョブを物理ホストで実行します。

実行しない（does not execute）：ジョブを実行しません。

（6）サービス起動時のアタッチ可否（Attach when service starts）

キューレスエージェントサービス起動時に対象ホストをアタッチするかどうかを示します。

アタッチ可（attach）：キューレスエージェントサービス起動時に対象ホストのアタッチを行います。

アタッチ不可（do not attach）：キューレスエージェントサービス起動時に対象ホストのアタッチを行いません。

（7） ログファイル格納ディレクトリ名（Log file installation directory name）

キューレスエージェントサービスのログファイル格納ディレクトリ名を示します。

（8） ログファイルサイズ（Log file size）

キューレスエージェントサービスのログファイルサイズ(単位：キロバイト)を示します。

（9） ステータスファイル名（Status file name）

キューレスエージェントサービスのステータスファイル名を示します。

（10）ステータスファイルサイズ（Status file size）

キューレスエージェントサービスのステータスファイルサイズ(単位：キロバイト)を示します。

（11）トレースログファイル名（Trace log file name）

キューレストレースログファイル名を示します。

（12）文字コード種別（Character code）

キューレスエージェントサービスに設定されている文字コードを示します。

C（C）：キューレスエージェントサービスには文字コード「ASCII」が設定されています。

SJIS（SJIS）：キューレスエージェントサービスには文字コード「SJIS」が設定されています。

EUC（EUC）：キューレスエージェントサービスには文字コード「EUC」が設定されています。

UTF-8（UTF-8）：キューレスエージェントサービスには文字コード「UTF-8」が設定されています。

（13）ユーザープロファイル使用有無（Using user profile）

ユーザープロファイルの使用有無を示します。

使用する（use）：ユーザープロファイルを使用します。

使用しない（do not use）：ユーザープロファイルを使用しません。

（14）テンポラリファイル用ディレクトリ名（Directory name for temporary files）

キューレスエージェントサービスが使用するテンポラリファイル用ディレクトリ名を示します。

（15）クラス名（Class name）

対象ホストに定義されているクラス名を示します。

キューレスエージェントサービス全体（デフォルトクラス）の場合は，クラス名を「デフォルト」と表示します。

（16）最大同時ジョブ実行数（Maximum number of executing jobs）

対象ホストの各クラスの最大同時ジョブ実行数を示します。

（17）最大待ちジョブ数（Maximum number of waiting jobs）

対象ホストの各クラスの最大待ちジョブ数を示します。

ajsqlstop

形式

ajsqlstop
     [-j|-c]

機能

キューレスエージェントサービスを停止します。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

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

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

UNIXの場合

/opt/jp1ajs2/bin/

引数

-j

実行中のキューレスジョブがすべて終了するのを待ってからキューレスエージェントサービスを停止します。

このオプションは-cオプションと同時には指定できません。

-c

実行中のキューレスジョブの終了を待たないでキューレスエージェントサービスを即時に停止します。

このオプションは-jオプションと同時には指定できません。

注意事項

このコマンドを実行する前に，キューレスエージェントサービスを起動，およびキューレスジョブ実行環境をセットアップしておく必要があります。キューレスジョブ実行環境をセットアップしていない場合は，ajsqlsetupコマンドを実行してキューレスジョブ実行環境をセットアップしてください。なお，クラスタ環境で使用する場合は，該当する論理ホストでセットアップしてください。

ajsqlsetupコマンドの詳細については，「4. 特別な運用で使用するコマンド　ajsqlsetup」を参照してください。

オプションを省略した場合，-jオプションが仮定されます。

このコマンドは，キューレスエージェントサービスへの停止要求を送信した時点で終了します。このため，このコマンドからではキューレスエージェントサービスが停止したかどうかを確認できません。キューレスエージェントサービスの停止を確認したい場合は，ajsqlstatusコマンドを実行して確認してください。ajsqlstatusコマンドの詳細については，「4. 特別な運用で使用するコマンド　ajsqlstatus」を参照してください。

このコマンドに-cオプションを指定してキューレスエージェントサービスを停止した場合，停止時に実行中だったキューレスジョブの終了状態は起動失敗または異常検出終了となるおそれがあります。起動失敗または異常検出終了となったキューレスジョブがある場合は，必要に応じてキューレスエージェントサービスを再起動し，再度該当するジョブを実行してください。

戻り値

0

正常終了。

0以外の値

異常終了。

ajsqltrsetsz

形式

ajsqltrsetsz
     [-s サイズ]

機能

キューレストレースログファイルのファイルサイズを変更，または現在設定されているファイルサイズを標準出力へ出力します。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

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

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

UNIXの場合

/opt/jp1ajs2/bin/

引数

-s サイズ

キューレストレースログファイルのファイルサイズをキロバイト単位で指定します。

指定できる値は，64〜2,097,151です。

注意事項

このコマンドを実行する前に，キューレスジョブ実行環境をセットアップしておく必要があります。キューレスジョブ実行環境をセットアップしていない場合は，ajsqlsetupコマンドを実行してキューレスジョブ実行環境をセットアップしてください。クラスタ環境で使用する場合は，該当する論理ホストでセットアップしてください。

ajsqlsetupコマンドの詳細については，「4. 特別な運用で使用するコマンド　ajsqlsetup」を参照してください。

このコマンドでキューレストレースログファイルのサイズを小さくした場合，サイズ変更前のキューレストレースログファイルの内容は削除されます。

オプションと値との間は，必ず1バイト以上の空白で区切ってください。

戻り値

0

正常終了。

0以外の値

異常終了。

使用例

キューレストレースログファイルのサイズを16メガバイト（16,384キロバイト）に拡張します。

ajsqltrsetsz -s 16384

ajssosetup

形式

ajssosetup
     [-h 論理ホスト名]
     [-F スケジューラーサービス名]
     -u
     [-nc]

機能

JP1/AJS2 - Scenario Operationとの連携機能（シナリオ管理グループの作成，環境設定）を無効にします。

このコマンドによって，構成定義情報としてJP1/AJS2 - Scenario Operationとの連携可否，およびシナリオ管理グループ名が環境設定パラメーターに設定されます。

設定される環境設定パラメーターと値を次に示します。

定義キー

環境設定パラメーター

値

[JP1_DEFAULT¥JP1AJSMANAGER¥スケジューラーサービス名]

または

[論理ホスト名¥JP1AJSMANAGER¥スケジューラーサービス名]

"SORELATION"

dword:00000000

"SOGROUP"

設定値が削除されます。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

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

UNIXの場合

/opt/jp1ajs2/bin/

引数

-h 論理ホスト名

クラスタ環境で使用する場合に論理ホスト名（JP1/Baseで設定した論理ホスト名）を指定します。

指定できる文字数は1〜255（単位：バイト）です。

省略した場合，物理ホストが仮定されます。ただし，環境変数JP1_HOSTNAMEが指定されている場合は，その値が仮定されます。物理ホストを明示的に指定する場合は，「JP1_DEFAULT」を指定してください。また，論理ホスト名として，IPアドレスは指定できません。

-F スケジューラーサービス名

スケジューラーサービス名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

このオプションを省略した場合，環境変数AJSCONFの内容が仮定されます。環境変数AJSCONFを設定していない場合は，デフォルトスケジューラーサービス名が仮定されます。

-u

シナリオ管理グループを削除し，JP1/AJS2 - Scenario Operationとの連携を無効にします。シナリオ管理グループ配下に登録済みユニットが含まれる場合，またはシナリオ管理グループ配下が参照・更新されている場合は，シナリオ管理グループを削除できません。

-nc

シナリオ管理グループを削除しないで，環境設定パラメーターだけ変更します。クラスタ環境の退避系セットアップ時にだけ指定してください。

注意事項

特になし。

戻り値

0

正常終了。

0以外の値

異常終了。

使用例

JP1/AJS2 - Scenario Operationとの連携を行うため，スケジューラーサービスAJSROOT1のシナリオ管理グループを削除します。

ajssosetup -F AJSROOT1 -u

エラー発生時の対処

コマンド実行時に発生するエラーと対処方法について次の表に示します。

表4‒2　エラー発生時の原因と対処方法

メッセージID

原因

対処方法

KAVS0101-E

KAVS0102-E

KAVS0103-E

KAVS0104-E

KAVS0116-E

KAVS0785-E

KAVS3601-E

指定されたオプションおよび値が不正である。

オプションおよびオプションに指定する値を修正してから実行する。

KAVS0162-E

KAVS0291-E

指定されたオプションの値または環境変数が不正である。

指定されたオプションの値または環境変数を正しく設定してから実行する。

KAVS0108-E

コマンドを実行するユーザーに権限がない。

Administratorsまたはスーパーユーザー権限を持つユーザーで実行する。

KAVS0119-E

シナリオ管理グループ配下が他で使用されているため，シナリオ管理グループを削除できない。

使用が終了してから実行する。

KAVS0582-E

環境変数の値が不正である。

環境変数を修正するか，または対応するオプション-hまたは-Fを指定してから実行する。

KAVS0622-E

シナリオ管理グループ配下に登録されているジョブネットがあるため，シナリオ管理グループを削除できない。

シナリオ管理グループ配下にある登録されているジョブネットをすべて登録解除してから実行する。

KAVS0654-E

シナリオ管理グループ配下を参照・更新中である。

参照・更新が終了してから実行する。

KAVS0902-E

コマンドを実行するためのメモリーが不足している。

十分なメモリーを確保してから実行する。

KAVS0986-E

文字コードの変換によって，引数の文字最大長を超えた。

データベースのキャラクターセットと，JP1/AJS3で使用する文字コードを統一してから実行する。

KAVS0987-E

データベース操作の実行権限がない。

適切な権限を持ったユーザーを指定してから実行する。

KAVS0992-E

レジストリーキーに対して権限がない。

レジストリーキーに権限を持つユーザーで実行する。

KAVS1003-E

構成定義が不正である。

構成定義を正しく設定してから実行する。

KAVS1724-E

指定したスケジューラーサービスがセットアップされていない。

指定したスケジューラーサービスが起動されているか，指定したスケジューラーサービスがセットアップされているか確認する。

jajs_maintain

形式

jajs_maintain
     [-h 論理ホスト名]
     [-F スケジューラーサービス名]
     {-m {manager|scheduler} | -show | -r start}
     [-x 再編成実施スケジューラーサービスの多重度]
     [-c 切断状況監視時間]

機能

JP1/AJS3のISAMデータベースのメンテナンスを行います。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-h 論理ホスト名

クラスタ運用している場合に，メンテナンスモードにする対象論理ホスト名を指定します。

省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，自ホスト名が仮定されます。

指定できる文字数は，1〜255（単位：バイト）です。

-F スケジューラーサービス名

メンテナンスモードにする対象スケジューラーサービス名を指定します。スケジューラーサービスを縮退モードにする場合，このオプションで指定したサービスだけがメンテナンス対象になります。

省略した場合，物理ホストまたは論理ホスト配下のすべてのスケジューラーサービスが縮退モードになります。

マネージャー機能を縮退モードに指定した場合にこのオプションを同時に指定したときは，このコマンドは異常終了します。

指定できる文字数は，1〜30（単位：バイト）です。

-m {manager|scheduler}

メンテナンスモードのレベルを指定します。

manager

マネージャー機能縮退モードでメンテナンスします。

標準構成の場合：

ジョブ実行環境のメンテナンスを行います。

互換用ISAM構成の場合：

ジョブ実行環境およびスケジューラーサービスのメンテナンスを行います。

このオプションは，-hオプションと同時に指定できます。

scheduler

スケジューラーサービス縮退モードでメンテナンスします。

標準構成の場合：

メンテナンスは行いません。

互換用ISAM構成の場合：

スケジューラーサービスのメンテナンスを行います。

このオプションは，-h，-Fオプションと同時に指定できます。

各メンテナンスモードの注意事項については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　7.1.3(3)(c) メンテナンスモードの注意事項」を参照してください。

-show

ジョブ実行環境の運用状態を表示します。このオプションは-m，-r，-x，-cオプションと同時に指定できません。

ジョブ実行環境の状態は，次のどれかが出力されます。

運用中（active）：JP1/AJS3による運用が開始している

停止（inactive）：JP1/AJS3による運用が停止している

開始処理中（Now starting）：JP1/AJS3による運用の開始処理を行っている

計画停止処理中（Planned terminating）：JP1/AJS3による運用の計画停止処理を行っている

停止処理中（Now terminating）：JP1/AJS3による運用の停止処理を行っている

メンテナンス中（Maintenance）：JP1/AJS3による運用のメンテナンスをしている

-r start

jajs_maintainコマンドの処理が何らかの原因で打ち切られ，メンテナンス状態のままとなったジョブ実行環境，およびスケジューラーサービスを運用状態に回復します。

-Fオプションを同時に指定した場合，ジョブ実行環境，および指定されたスケジューラーサービスだけを運用状態に回復します。

回復しようとするジョブ実行環境，およびスケジューラーサービスが，ほかでメンテナンス中の場合，このコマンドは異常終了します。回復しようとするジョブ実行環境，およびスケジューラーサービスが，停止または運用中の場合は回復処理を行いません。このとき，このコマンドは正常終了します。

このオプションは-m，-show，-x，-cオプションと同時に指定できません。

-x 再編成実施スケジューラーサービスの多重度

再編成を並列実行するスケジューラーサービスの多重度を指定します。指定できる値は，1〜20です。

-c 切断状況監視時間

縮退モードに入る際に，スケジューラーデータベースへの接続が切断されるまでどの程度の時間を監視し続けるかを指定します。指定した時間内に，10秒間隔で監視が行われます。

指定できる値は，0〜86,400（単位：秒）です。デフォルトは60秒です。

注意事項

ジョブ実行環境をメンテナンスしている間は，ジョブの投入およびジョブの実行に使用するコマンドは実行できません。実行した場合，エラーメッセージKAVU0950-Eが標準エラー出力ファイルに出力されます。

スケジューラーサービスのメンテナンス実施中に，JP1/AJS3 - View から接続してユニットを操作した場合は，「KAVV461-E 指定したスケジューラーサービスはメンテナンス中のため接続できません」というメッセージがメッセージボックスに出力されます。

ユニットを操作するコマンドを実行した場合は，「KAVS1717-E メンテナンス中のため実行できません」というメッセージが標準エラー出力に出力されます。

このコマンドを実行すると，メンテナンスログファイルに再編成時のログ情報が格納されます。

メンテナンス処理が異常終了した場合は，メンテナンスログファイルを参照し，メンテナンス処理が異常終了した原因を取り除いた上で，メンテナンス処理を再実行してください。

メンテナンスログファイルの格納先は，マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング　1.2.5 ログファイルおよびディレクトリ一覧」の「メンテナンスログファイル」を参照してください。

マネージャー機能が縮退中にJP1/AJS3サービスを停止した場合，縮退中に状態が変わったジョブの情報が消失します。縮退中にJP1/AJS3を停止しないでください。

JP1/AJS3停止時にマネージャー機能の縮退指定でコマンドを実行した場合，コマンドの終了に時間が掛かるため注意してください。

メンテナンスの対象となるスケジューラーサービスが運用中のとき，jajs_maintainコマンドの処理が何らかの原因で打ち切られると，スケジューラーサービスおよびイベント・アクション制御マネージャーの状態が，メンテナンス中のままになることがあります。回復するには，jajs_maintain -r start，ajsstartまたはjajs_spmdコマンドで該当するサービスを起動する必要があります。

また，同じ条件で，ジョブ実行環境の状態がメンテナンス中のままになることがあります。回復するには，jajs_maintain -r startを実行する，またはJP1/AJS3サービスを再起動してください。

このコマンドに次の指定をした場合は，同時に複数実行しないでください。

-m manager

-m scheduler

-r start

このコマンドの-m manager指定と，次のコマンドまたはスクリプトを同時に実行しないでください。

jpqdbcondコマンドの-x，-k指定

jpqautocondスクリプト

ジョブ実行環境のコマンドやAPIが終了していない状態で-m manager指定を実行しないでください。

ジョブ実行環境のジョブ情報削除処理中に-m manager指定を実行しないでください。

ジョブ情報削除処理中にマネージャー機能縮退モードでメンテナンスを実行した場合，ジョブ情報削除処理はメンテナンスが完了するまで中断されます。メンテナンスが完了すると，ジョブ情報削除処理が再開されます。

JP1/AJS3の起動処理中や停止処理中にjajs_maintain -m managerを実行しないでください。また，jajs_maintain -m manager実行中にJP1/AJS3の起動や停止を行わないでください。

このコマンドの-m manager指定とjpqexportコマンドを同時に実行しないでください。

このコマンドに次の指定をした場合は，ajsautocondスクリプトを同時に実行しないでください。

-m manager

-m scheduler

JP1/AJS3の起動処理中や停止処理中にjajs_maintain -showまたは-r startを実行した場合，統合ログにメッセージKAVU2227-EやメッセージKAVU0215-EまたはメッセージKAVU0220-Eが出力されることがあります。JP1/AJS3サービスの起動処理および停止処理と競合した場合に出力されるこれらのメッセージについては，実際の運用には問題ありませんが，jajs_maintainコマンドの実行に時間が掛かる場合があります。なお，コマンドが異常終了した場合は再度実行してください。

スケジューラーサービスのメンテナンスは，実行しようとしているすべてのジョブの実行依頼が完了してからスケジューラーサービスを停止します。このため，キューレスジョブ実行環境の設定で，最大同時ジョブ実行数の設定が0で，かつ最大待ちジョブ数が1以上になっている場合に，キューレスジョブ起動処理中にメンテナンスモードに入ると，スケジューラーサービスが停止処理に入れないため，jajs_maintainコマンドが終了できない状態になります。jajs_maintainコマンドはジョブを実行できる状態で実行してください。また，このような状態になった場合，ajsqlalterコマンドによって，最大同時ジョブ実行数の設定を 1 以上に変更してジョブを実行させてください。

イベントジョブおよびカスタムイベントジョブ（起動条件内のものを含む）を実行中のスケジューラーサービスをメンテナンスする場合の注意事項については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　7.6.8 イベントジョブを実行したままサービスを再起動する場合の注意事項」またはマニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　7.10.2 カスタムイベントジョブを実行したままサービスを再起動する場合の注意事項」を参照してください。

戻り値

0

正常終了。

0以外の値

異常終了。

使用例

メンテナンス作業を定期的に実行する場合，jajs_maintainコマンドを，JP1/AJS3のジョブとして定義して実行できます。

毎年12月の最終運用日の23:00に，マネージャー機能を縮退モードにしてデータベースの再編成を行う場合，次のユニット定義情報パラメーターでジョブネットを定義し，計画実行を登録しておきます。WindowsおよびUNIXの例を次に示します。

Windowsの場合

unit=maintain-net;
{
  ty=n;
  sd=1,12/*b;
  st=1,23:00;
  cy=1,(1,y);
  sh=1,ca;
  unit=maintain-job;
  {
    ty=pj;
    sc="jajs_maintain.exe";
    prm="-m manager";
  }
}

UNIXの場合

unit=maintain-net;
{
  ty=n;
  sd=1,12/*b;
  st=1,23:00;
  cy=1,(1,y);
  sh=1,ca;
  unit=maintain-job;
  {
    ty=j;
    te="/opt/jp1ajs2/bin/jajs_maintain -m manager";
  }
}

jajsacfg（Windows限定）

形式

jajsacfg

機能

［エージェント環境設定］ダイアログボックスを起動します。

［エージェント環境設定］ダイアログボックスは，バージョン8以前のJP1/AJS2との互換用として提供しています。

環境設定の変更には，jajs_configコマンドを使用することを推奨します。jajs_configコマンドの詳細については，「2. セットアップコマンド　jajs_config」を参照してください。

実行権限

Administrators権限

jpqagtadd

形式

jpqagtadd
     [-mh マネージャーホスト名]
     -ah エージェントホスト名
     [-cp 時刻-時刻=ジョブ実行多重度...]

機能

マネージャーホストにエージェントホストを登録します。同時に，そのエージェントホストが接続するにデフォルトキューを作成します。

実行権限

次に示すJP1権限レベルを与えられたユーザー

JP1_JPQ_Admin権限

引数

-mh マネージャーホスト名

エージェントホストを登録したいマネージャーホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，自ホスト名が仮定されます。

-ah エージェントホスト名

登録したいエージェントホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

-cp 時刻-時刻=ジョブ実行多重度...

ジョブ実行多重度を指定する期間と，その期間のジョブ実行多重度を指定します。

ジョブ実行多重度を指定すると，このエージェントホストで同時に実行できるジョブ数を制限できます。このコマンドで同時実行数が制限されるジョブは，QUEUEジョブおよびサブミットジョブです。同時に実行しようとしたジョブ数が実行多重度に達した場合，実行多重度を超えた分のジョブは，実行中のジョブが終了するまでキューイング（実行待ち）の状態になります。

期間は，時刻と時刻とを「-（ハイフン）」でつないで指定します。時刻は30分単位で「hh:mm」の形式で指定します。

hhに指定できる値は，0または00〜23（単位：時）です。

mmに指定できる値は，0，00，または30（単位：分）です。

実行多重度に指定できる値は，0〜4,294,967,295です。

省略した場合，「0:00-0:00=0」（24時間，実行多重度は0）が仮定されます。

ジョブ実行多重度が0の場合，ジョブは実行できません。ジョブを実行する場合は1以上を指定するか，jpqagtaltコマンドでジョブ実行多重度を変更してください。

ジョブ実行多重度の指定例については，jpqagtaltコマンドの補足事項も参照してください。

日をまたいで指定できます（例えば，「-cp 3:00-3:00=10」と指定した場合，午前3時から翌日の午前3時の間，実行多重度は10になります）。

期間と実行多重度は複数指定できます。期間を重複して指定した場合は，あとで指定した値が反映されます（例えば，「-cp 1:00-2:30=5 2:00-4:00=10」と指定した場合，重複している2:00〜2:30の実行多重度は10です）。

注意事項

このコマンドは，JP1/AJS3からJP1/OJE for VOS3への要求には使用できません。

ジョブ実行多重度を指定しなかった期間には，実行多重度0が仮定されます（例えば，「-cp 10:00-22:00=10」だけ指定した場合，00:00〜10:00の実行多重度は0，10:00〜22:00の実行多重度は10，22:00〜00:00の実行多重度は0になります）。

このコマンドは複数を並行して実行した場合，処理にかなり時間が掛かります。複数のエージェントホストを登録する場合は，一つずつ登録してください。

戻り値

0

正常終了。

1

引数の指定が不適切である。

2

jpqagtaddコマンドを実行したホストの内部的要因で，エージェントホストの登録に失敗した。

5

初期化に失敗した。

論理ホスト名の定義または環境設定に誤りがある。

6

jpqagtaddコマンドを実行したホストでメモリー不足が発生した。

7

jpqagtaddコマンドを実行したホストで論理不正が発生した。

100

TCP/IP通信でjpqagtaddコマンドを実行したホストからマネージャーホストに接続できない。

TCP/IPが正しく設定されていないため，jpqagtaddコマンドを実行したホストからマネージャーホストに接続できない。

マネージャーホスト名に誤りがある。または，マネージャーホストがプロセス停止状態である。

102

jpqagtaddコマンドを実行したホストでマネージャーホスト名のIPアドレスの解決に失敗した。

200

マネージャーホストがエージェントホストの登録を受け付けない。

マネージャーホストが運用開始処理中，運用停止処理中，運用停止中，または縮退運転中である。

202

マネージャーホストから応答がない。

203

マネージャーホストの内部的要因で，エージェントホストの登録に失敗した。

206

エージェントホストを登録する権限がない。

219

マネージャーホストがビジー状態である。

220

マネージャーホストでメモリー不足が発生した。

222

致命的なエラーが発生した。

システムコールでエラーが発生した。

223

マネージャーホストで論理不正が発生した。

224

JP1/AJS3以外のホストに要求した。

226

実行環境が不適切である。

232

登録しようとしたエージェントホストと同じ名称のエージェントホストがすでにある。

235

エージェントホストの最大定義数を超える。

240

イベント・アクション制御マネージャーがエージェントの構成定義を変更中である。

補足事項

このコマンドの実行によって，エージェントホストの登録と同時に作成されるデフォルトキューの属性と，属性を変更したい場合に使用するコマンドを次の表に示します。

デフォルトキューの

設定項目

属性

属性を変更したい場合に

使用するコマンド

ジョブ実行多重度

-cpオプションに指定した値

jpqagtalt

ジョブ数の最大値

4,294,967,295

jpqquealt

ジョブ数の警告値

4,294,967,295

jpqquealt

ジョブの受付口の状態

close

jpqqueopen

ジョブの取出口の状態

open

jpqqueclose

接続するエージェントホスト

-ahオプションに指定したエージェントホスト名

jpqagtunlink，

jpqagtlink

エージェントホストの優先順位

16

jpqagtlink

jpqagtaddコマンドでエージェントホストを登録した直後は，キューの受付口は閉じているのでジョブの登録はできません。jpqqueopenコマンドを使用してキューの受付口を開いてください。また，登録したエージェントホスト名はIPアドレス解決できることを確認しておく必要があります。jpqimportコマンドで登録したときのデフォルト値と同じ設定のエージェントホストを登録する場合の手順は次のようになります。

該当するマネージャーホストにエージェントホストを登録し，ジョブ実行多重度を設定する。

jpqsetup.confのデフォルト値は，24時間 ジョブ実行多重度5です。

　jpqagtadd -ah エージェントホスト名 -cp ジョブ実行多重度の設定

デフォルトキューの受付口を開く。

　jpqqueopen -ah エージェントホスト名 -en

デフォルトキューのジョブ数の最大値，ジョブ数の警告値を変更する。

jpqsetup.confのデフォルト値は，ジョブ数の最大値は「100」ジョブ数の警告値は「80」です。

　jpqquealt -ah エージェントホスト名 -mj ジョブ数の最大値 -wj ジョブ数の警告値

接続するエージェントホストの優先順位を変更する。

jpqsetup.confのデフォルト値は，優先順位に「1」を設定しています。

　jpqagtlink -ah エージェントホスト名 -lh エージェントホスト名 -clp 接続先エージェントホストの優先順位

なお，jpqagtaddコマンドでエージェントホストを登録する場合，エージェントIDは自動的に割り当てられます。エージェントIDを明示的に指定したい場合は，jpqimportコマンドでエージェントホストを登録してください。

jpqagtalt

形式

jpqagtalt
     [-mh マネージャーホスト名]
     -ah エージェントホスト名
     -cp 時刻-時刻=ジョブ実行多重度...
     [-em]

機能

マネージャーホストに登録されているエージェントホストの，同時に実行できるジョブ数（ジョブ実行多重度）を変更します。

実行権限

次に示すJP1権限レベルを与えられたユーザー

JP1_JPQ_Admin権限

ただし，-emオプションを指定する場合は次の権限が必要です（JP1_JPQ_Admin権限は必要ありません）。

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-mh マネージャーホスト名

ジョブ実行多重度を変更したいエージェントホストが登録されているマネージャーホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，自ホスト名が仮定されます。

-emオプションと同時に指定する場合，指定できるホスト名は，自ホスト名または自ホスト上の論理ホスト名だけです。それ以外の値が指定された場合はエラー（エラーコード25）となります。また，-mhオプションにエイリアスホスト名を指定することはできません。

-ah エージェントホスト名

ジョブ実行多重度を変更したいエージェントホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

-cp 時刻-時刻=ジョブ実行多重度

ジョブ実行多重度を変更する期間と，その期間のジョブ実行多重度を指定します。

ジョブ実行多重度を指定すると，このエージェントホストで同時に実行できるジョブ数を制限できます。このコマンドで同時実行数が制限されるジョブは，QUEUEジョブおよびサブミットジョブです。同時に実行しようとしたジョブ数が実行多重度に達した場合，実行多重度を超えた分のジョブは，実行中のジョブが終了するまでキューイング（実行待ち）の状態になります。

期間は，時刻と時刻とを「-（ハイフン）」でつないで指定します。時刻は30分単位で「hh:mm」の形式で指定します。

hhに指定できる値は，0または00〜23（単位：時）です。

mmに指定できる値は，0，00，または30（単位：分）です。

実行多重度に指定できる値は，0〜4,294,967,295です。

コマンド投入時刻を含む期間を指定した場合，実行多重度はすぐに変更されます。

期間と実行多重度は複数指定できます。ただし，期間を重複して指定した場合は，あとで指定した値が反映されます（例えば，「-cp 1:00-2:30=5 2:00-4:00=10」と指定した場合，重複している2:00〜2:30の実行多重度は10です）。

後述の「補足事項」に，ジョブ実行多重度の指定例が記載されています。必要に応じて参照してください。

-em

緊急実行時に指定します。

このオプションを指定すると，通常とは異なる通信経路に対して要求するため，障害時などに緊急で実行できるようになります。

このオプションを指定する場合，マネージャーホスト名にIPアドレスは指定できません。

注意事項

このコマンドは，JP1/AJS3からJP1/OJE for VOS3への要求には使用できません。

このコマンドで指定するジョブ実行多重度には，イベントジョブおよびカスタムイベントジョブの実行多重度は含まれません。

ジョブ実行多重度を指定しなかった期間には，実行多重度0が仮定されます（例えば，「-cp 10:00-22:00=10」だけ指定した場合，00:00〜10:00の実行多重度は0，10:00〜22:00の実行多重度は10，22:00〜00:00の実行多重度は0になります）。

-emオプションは，エージェントホストの障害から復旧する目的でだけ指定してください。常に-emオプションを指定して運用する場合，障害発生時に対応できなくなるおそれがあります。

標準入力ファイル，標準出力ファイル，標準エラー出力ファイル，または転送ファイルに含まれるデータ中に使用できる文字については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.4.2(7)(a) 使用できる文字の範囲」を参照してください。

戻り値

0

正常終了。

1

引数の指定が不適切である。

2

jpqagtaltコマンドを実行したホストの内部的要因で，ジョブ実行多重度の変更に失敗した。

5

初期化に失敗した。

論理ホスト名の定義または環境設定に誤りがある。

6

jpqagtaltコマンドを実行したホストでメモリー不足が発生した。

7

jpqagtaltコマンドを実行したホストで論理不正が発生した。

25

マネージャーホスト名の指定に自ホスト名および論理ホスト名以外を指定した。

100

TCP/IP通信でjpqagtaltコマンドを実行したホストからマネージャーホストに接続できない。

TCP/IPが正しく設定されていないため，jpqagtaltコマンドを実行したホストからマネージャーホストに接続できない。

マネージャーホスト名に誤りがある。または，マネージャーホストがプロセス停止状態である。

102

jpqagtaltコマンドを実行したホストでマネージャーホスト名のIPアドレスの解決に失敗した。

200

マネージャーホストがジョブ実行多重度の変更を受け付けない。

マネージャーホストが運用開始処理中，運用停止処理中，運用停止中，または縮退運転中である。

201

指定したエージェントホストが使用できない。

指定したエージェントホストがない。

202

マネージャーホストから応答がない。

203

マネージャーホストの内部的要因で，ジョブ実行多重度の変更に失敗した。

206

ジョブ実行多重度を変更する権限がない。

219

マネージャーホストがビジー状態である。

220

マネージャーホストでメモリー不足が発生した。

222

致命的なエラーが発生した。

システムコールでエラーが発生した。

223

マネージャーホストで論理不正が発生した。

224

JP1/AJS3以外のホストに要求した。

226

実行環境が不適切である。

補足事項

ジョブ実行多重度の指定例を次に示します。

1:00〜5:00のジョブ実行多重度を1にする場合

-cp 01:00-05:00=1

23:00〜24:00のジョブ実行多重度を1にする場合

-cp 23:00-00:00=1

24:00は，00:00または0:0と指定します。

23:00〜24:00および翌日の00:00〜05:00のジョブ実行多重度を1にする場合

-cp 23:00-05:00=1

日をまたいでジョブ実行多重度を設定できます。

1日のジョブ実行多重度を1にする場合

-cp 00:00-00:00=1

jpqagtdel

形式

jpqagtdel
     [-mh マネージャーホスト名]
     -ah エージェントホスト名

機能

マネージャーホストに登録されているエージェントホストを削除します。同時に，そのエージェントホストが接続しているデフォルトキューも削除します。

実行権限

次に示すJP1権限レベルを与えられたユーザー

JP1_JPQ_Admin権限

引数

-mh マネージャーホスト名

削除したいエージェントホストが登録されているマネージャーホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，自ホスト名が仮定されます。

-ah エージェントホスト名

削除したいエージェントホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

注意事項

このコマンドは，JP1/AJS3からJP1/OJE for VOS3への要求には使用できません。

このコマンドを実行する前に必要な準備を次に示します。

jpqquecloseコマンドなどを使って，削除したいエージェントホストが接続しているデフォルトキューのジョブ受付口または投入口を閉じて，ジョブが実行していない状態およびジョブがデフォルトキュー内にない状態にしておいてください。

実行中のジョブ（標準ジョブ（PCジョブ，UNIXジョブ，およびQUEUEジョブ），カスタムジョブ，アクションジョブ，イベントジョブ，またはカスタムイベントジョブ）がある場合，エージェントホストは削除できません。

デフォルトキューを削除すると，デフォルトキュー内の実行待ち，保留，および時間待ち状態のジョブは，強制終了します。

jpqagtunlinkコマンドなどを実行して，削除したいエージェントホストが接続しているキュー（デフォルトキュー以外のキュー）との接続をすべて解除してください。

削除したいエージェントホストがデフォルトキュー以外のキューに接続している場合，該当するエージェントホストは削除できません。

このコマンドは複数を並行して実行した場合，処理にかなり時間が掛かります。複数のエージェントホストを削除する場合は，一つずつ削除するようにしてください。

このコマンドで削除したエージェントホストで，過去にイベントジョブ，カスタムイベントジョブまたは起動条件付きジョブネットを実行したことがある場合は，エージェントホストがこのコマンドの-mhオプションで指定したマネージャーホスト名を記憶しています。そのエージェントホスト上で，このコマンドの-mhオプションで指定したマネージャーホスト名を削除してください。

手順を次に示します。

1. エージェントホストがこのコマンドの-mhオプションで指定したマネージャーホスト名を記憶しているか確認する。

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

jpoagoec -p

2. このコマンドの-mhオプションで指定したマネージャーホスト名を削除する。

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

jpoagoec -d -mhオプションで指定したマネージャーホスト名

これによって，エージェントホストの起動時または停止時に，マネージャーホストに対して不要な通信（起動した旨または停止した旨の通知）をしないようにできます。jpoagoecコマンドについては，「3. 通常の運用で使用するコマンド　jpoagoec」を参照してください。

イベントジョブ，カスタムイベントジョブまたは起動条件付きジョブネットをエージェントホストで実行した状態で，エージェントホスト上でJP1/AJS3サービスを停止する前にOSを停止したり，マシンを電源オフしたりしないでください。そのような状態でこのコマンドを実行しても，該当するエージェントホストを削除できません。そのような状態になった場合は，マネージャーホストのJP1/AJS3サービスを停止させてコールドスタートするか，または該当するエージェントホストで実行中のイベントジョブ，カスタムイベントジョブもしくは起動条件付きジョブネットの情報を削除してからこのコマンドを実行してください。

エージェントホストで実行中のイベントジョブ，カスタムイベントジョブまたは起動条件付きジョブネットの情報を削除する手順を次に示します。

1. マネージャーホストのJP1/AJS3サービスを停止する。

2. マネージャーホスト上で，該当するエージェントホストで実行中のイベントジョブ，カスタムイベントジョブまたは監視中の起動条件付きジョブネットがあることを確認する。

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

jpomanjobshow -h マネージャーホスト名 -a 削除したいエージェントホスト名

3. マネージャーホスト上で，該当するエージェントホストで実行中のイベントジョブ，カスタムイベントジョブまたは監視中の起動条件付きジョブネットの情報を削除する。

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

jpomanevreset -h マネージャーホスト名 -a エージェントホスト名 -s

jpomanjobshowコマンドについては，「3. 通常の運用で使用するコマンド　jpomanjobshow」を，jpomanevresetコマンドについては，「3. 通常の運用で使用するコマンド　jpomanevreset」を参照してください。

戻り値

0

正常終了。

1

引数の指定が不適切である。

2

jpqagtdelコマンドを実行したホストの内部的要因で，エージェントホストの削除に失敗した。

5

初期化に失敗した。

論理ホスト名の定義または環境設定に誤りがある。

6

jpqagtdelコマンドを実行したホストでメモリー不足が発生した。

7

jpqagtdelコマンドを実行したホストで論理不正が発生した。

100

TCP/IP通信でjpqagtdelコマンドを実行したホストからマネージャーホストに接続できない。

TCP/IPが正しく設定されていないため，jpqagtdelコマンドを実行したホストからマネージャーホストに接続できない。

マネージャーホスト名に誤りがある。または，マネージャーホストがプロセス停止状態である。

102

jpqagtdelコマンドを実行したホストでマネージャーホスト名のIPアドレスの解決に失敗した。

200

マネージャーホストがエージェントホストの削除を受け付けない。

マネージャーホストが運用開始処理中，運用停止処理中，運用停止中，または縮退運転中である。

202

マネージャーホストから応答がない。

203

マネージャーホストの内部的要因で，エージェントホストの削除に失敗した。

206

エージェントホストを削除する権限がない。

214

マネージャーホストに接続しているエージェントホストがない。

219

マネージャーホストがビジー状態である。

220

マネージャーホストでメモリー不足が発生した。

222

致命的なエラーが発生した。

システムコールでエラーが発生した。

223

マネージャーホストで論理不正が発生した。

224

JP1/AJS3以外のホストに要求した。

226

実行環境が不適切である。

233

実行中のジョブ（標準ジョブ，カスタムジョブ，またはアクションジョブ）がある。

234

実行中のジョブ（イベントジョブまたはカスタムイベントジョブ）がある。

236

エージェントホストとキューが接続されている。

240

イベント・アクション制御マネージャーがエージェントホストの構成定義を変更中である。

jpqagtlink

形式

jpqagtlink
     [-mh マネージャーホスト名]
     {-q キュー名|-ah エージェントホスト名}
     -lh 接続エージェントホスト名
     {[-lp 未接続エージェントホストの優先順位]|
          -clp 接続済みエージェントホストの優先順位}
     [-em]

機能

キューにエージェントホストを接続します。また，キューに接続するエージェントホストの優先順位を設定します。

実行権限

次に示すJP1権限レベルを与えられたユーザー

JP1_JPQ_Admin権限

ただし，-emオプションを指定する場合は次の権限が必要です（JP1_JPQ_Admin権限は必要ありません）。

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-mh マネージャーホスト名

エージェントホストを接続したいキューが作成されているマネージャーホスト名，または優先順位を設定したいエージェントホストが接続されているキューが作成されているマネージャーホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，自ホスト名が仮定されます。

-emオプションと同時に指定する場合，指定できるホスト名は，自ホスト名または自ホスト上の論理ホスト名だけです。それ以外の値が指定された場合はエラー（エラーコード25）となります。また，-mhオプションにエイリアスホスト名を指定することはできません。

-q キュー名

デフォルトキューを除くキューにエージェントホストを接続したい場合，または該当するキューに優先順位を設定したいエージェントホストが接続されている場合に，そのキュー名を指定します。

指定できる文字数は，1〜63（単位：バイト）です。

-ah エージェントホスト名

デフォルトキューにエージェントホストを接続したい場合，または該当するデフォルトキューに優先順位を設定したいエージェントホストが接続されている場合に，そのデフォルトキュー作成時にマネージャーホストに登録したエージェントホスト名（デフォルトキュー名）を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

-lh 接続エージェントホスト名

該当するキューに接続したいエージェントホスト名，または優先順位を設定したいエージェントホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

-lp 未接続エージェントホストの優先順位

接続先エージェントホストの優先順位を指定します。

指定できる値は，1〜16です。優先順位がいちばん低いのが1，いちばん高いのが16です。優先順位が高いほど，ジョブが優先的に実行されます。

省略した場合，16が仮定されます。

このオプションは，このコマンドを実行して-lhオプションに指定したエージェントホストを-qオプションで指定したキューまたは-ahオプションで指定したデフォルトキューに接続する際に，接続するエージェントホストの優先順位を設定したい場合に使用してください。

-clp 接続済みエージェントホストの優先順位

接続先エージェントホストの優先順位を指定します。

指定できる値は，1〜16です。優先順位がいちばん低いのが1，いちばん高いのが16です。優先順位が高いほど，ジョブが優先的に実行されます。

このオプションは，このコマンドの実行時に-lhオプションに指定したエージェントホストが-qで指定したキューまたは-ahオプションで指定したデフォルトキューに接続済みの際に，該当するエージェントホストの優先順位を変更したい場合に指定してください。

-em

緊急実行時に指定します。

このオプションを指定すると，通常とは異なる通信経路に対して要求するため，障害時などに緊急で実行できるようになります。

なお，このオプションを指定する場合，マネージャーホスト名にIPアドレスは指定できません。

注意事項

このコマンドは，JP1/AJS3からJP1/OJE for VOS3への要求には使用できません。

-emオプションは，エージェントホストの障害から復旧する目的でだけ指定してください。常に-emオプションを指定して運用する場合，障害発生時に対応できなくなるおそれがあります。

戻り値

0

正常終了。

1

引数の指定が不適切である。

2

jpqagtlinkコマンドを実行したホストの内部的要因で，エージェントホストの接続または優先順位の変更に失敗した。

5

初期化に失敗した。

論理ホスト名の定義または環境設定に誤りがある。

6

jpqagtlinkコマンドを実行したホストでメモリー不足が発生した。

7

jpqagtlinkコマンドを実行したホストで論理不正が発生した。

25

マネージャーホスト名の指定に自ホスト名および論理ホスト名以外を指定した。

100

TCP/IP通信でjpqagtlinkコマンドを実行したホストからマネージャーホストに接続できない。

TCP/IPが正しく設定されていないため，jpqagtlinkコマンドを実行したホストからマネージャーホストに接続できない。

マネージャーホスト名に誤りがある。または，マネージャーホストがプロセス停止状態である。

102

jpqagtlinkコマンドを実行したホストでマネージャーホスト名のIPアドレスの解決に失敗した。

200

マネージャーホストがエージェントホストの接続または優先順位の変更を受け付けない。

マネージャーホストが運用開始処理中，運用停止処理中，運用停止中，または縮退運転中である。

201

指定したキューが使用できない。

指定したキューがない。

指定したデフォルトキューがない。

202

マネージャーホストから応答がない。

203

マネージャーホストの内部的要因で，エージェントホストの接続または優先順位の変更に失敗した。

206

エージェントホストを接続する権限または優先順位を変更する権限がない。

214

マネージャーホストに接続しているエージェントホストがない。

219

マネージャーホストがビジー状態である。

220

マネージャーホストでメモリー不足が発生した。

222

致命的なエラーが発生した。

システムコールでエラーが発生した。

223

マネージャーホストで論理不正が発生した。

224

JP1/AJS3以外のホストに要求した。

226

実行環境が不適切である。

232

接続済みのエージェントホストに対して接続しようとしている。

239

未接続のエージェントホストに対して，-clpオプションで優先順位を変更しようとしている。

jpqagtshow

形式

jpqagtshow
     [-mh マネージャーホスト名]
     {-ah エージェントホスト名|-a|-n}
     [-em]

機能

エージェントホストの情報（エージェントホスト名，1日のジョブ実行多重度のスケジュールなど）を標準出力に出力します。

実行権限

次に示すJP1権限レベルを与えられたユーザー

JP1_JPQ_Admin権限

ただし，-emオプションを指定する場合は次の権限が必要です（JP1_JPQ_Admin権限は必要ありません）。

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-mh マネージャーホスト名

エージェントホストの情報を出力したいエージェントホストが登録されているマネージャーホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，自ホスト名が仮定されます。

-emオプションと同時に指定する場合，指定できるホスト名は，自ホスト名または自ホスト上の論理ホスト名だけです。それ以外の値が指定された場合はエラー（エラーコード25）となります。また，-mhオプションにエイリアスホスト名を指定することはできません。

-ah エージェントホスト名

エージェントホストの情報を出力したいエージェントホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

-a

-mhオプションで指定したマネージャーホストに登録されているすべてのエージェントホストの情報を出力します。

-n

-mhオプションで指定したマネージャーホストに登録されているすべてのエージェントホストの名称だけを出力します。

-em

緊急実行時に指定します。

このオプションを指定すると，通常とは異なる通信経路に対して要求するため，障害時などに緊急で実行できるようになります。

このオプションを指定する場合，マネージャーホスト名にIPアドレスは指定できません。

注意事項

このコマンドは，JP1/AJS3からJP1/OJE for VOS3への要求には使用できません。

-aオプションの場合，エージェントホスト名として出力できるバイト数は57バイトです。エージェントホスト名が58バイト以上の場合，56バイト以降は「..」になります。

-emオプションは，エージェントホストの障害から復旧する目的でだけ指定してください。常に-emオプションを指定して運用する場合，障害発生時に対応できなくなるおそれがあります。

戻り値

0

正常終了。

1

引数の指定が不適切である。

2

jpqagtshowコマンドを実行したホストの内部的要因で，エージェントホスト情報の出力に失敗した。

5

初期化に失敗した。

論理ホスト名の定義または環境設定に誤りがある。

6

jpqagtshowコマンドを実行したホストでメモリー不足が発生した。

7

jpqagtshowコマンドを実行したホストで論理不正が発生した。

25

マネージャーホスト名の指定に自ホスト名および論理ホスト名以外を指定した。

100

TCP/IP通信でjpqagtshowコマンドを実行したホストからマネージャーホストに接続できない。

TCP/IPが正しく設定されていないため，jpqagtshowコマンドを実行したホストからマネージャーホストに接続できない。

マネージャーホスト名に誤りがある。または，マネージャーホストがプロセス停止状態である。

102

jpqagtshowコマンドを実行したホストでマネージャーホスト名のIPアドレスの解決に失敗した。

200

マネージャーホストがエージェントホスト情報の出力を受け付けない。

マネージャーホストが運用開始処理中，運用停止処理中，運用停止中，または縮退運転中である。

201

指定したエージェントホストが使用できない。

指定したエージェントホストがない。

202

マネージャーホストから応答がない。

203

マネージャーホストの内部的要因で，エージェントホスト情報の出力に失敗した。

206

エージェントホスト情報を出力する権限がない。

エージェントホスト名を出力する権限がない。

212

エージェントホストの追加・変更処理中のため，エージェントホスト情報の出力に失敗した。

214

マネージャーホストに接続しているエージェントホストがない。

219

マネージャーホストがビジー状態である。

220

マネージャーホストでメモリー不足が発生した。

222

致命的なエラーが発生した。

システムコールでエラーが発生した。

223

マネージャーホストで論理不正が発生した。

224

JP1/AJS3以外のホストに要求した。

226

実行環境が不適切である。

出力例1

-ahオプションを指定した場合のファイル出力例と出力内容の意味を次に示します。

出力内容の意味を次に示します。

AGENT

エージェントホスト名を示します。

CUREXECHGNUM

現在のジョブ実行多重度を示します。

EXECUTING

現在実行中のジョブ数を示します。

CHANGEPOINT

「多重度設定開始時刻-多重度設定終了時刻(ジョブ実行多重度)」の形式で，1日のジョブ実行多重度のスケジュールを示します。

出力例2

-aオプションを指定した場合のファイル出力例と出力内容の意味を次に示します。

出力内容の意味を次に示します。

AGENT

エージェントホスト名を示します。

57バイト分出力されます。

CUREXECHG

現在のジョブ実行多重度を示します。

EXECUTING

現在実行中のジョブ数を示します。

出力例3

-nオプションを指定した場合のファイル出力例と出力内容の意味を次に示します。

出力内容の意味を次に示します。

AGENT

エージェントホスト名を示します。

jpqagtunlink

形式

jpqagtunlink
     [-mh マネージャーホスト名]
     {-q キュー名|-ah エージェントホスト名}
     -lh 接続解除エージェントホスト名

機能

キューとエージェントホストの接続を解除します。

実行権限

次に示すJP1権限レベルを与えられたユーザー

JP1_JPQ_Admin権限

引数

-mh マネージャーホスト名

エージェントホストとの接続を解除したいキューが作成されているマネージャーホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，自ホスト名が仮定されます。

-q キュー名

デフォルトキューを除くキューに接続しているエージェントホストとの接続を解除したい場合に，該当するキュー名を指定します。

指定できる文字数は，1〜63（単位：バイト）です。

-ah エージェントホスト名

デフォルトキューに接続しているエージェントホストとの接続を解除したい場合に，該当するデフォルトキュー作成時にマネージャーホストに登録したエージェントホスト名（デフォルトキュー名）を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

-lh 接続解除エージェントホスト名

接続を解除したいエージェントホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

注意事項

このコマンドは，JP1/AJS3からJP1/OJE for VOS3への要求には使用できません。

接続していないエージェントホストに対して接続解除すると，エラーになります。

実行中のジョブ（QUEUEジョブまたはサブミットジョブ）があるエージェントホストは，接続解除できません。

戻り値

0

正常終了。

1

引数の指定が不適切である。

2

jpqagtunlinkコマンドを実行したホストの内部的要因で，エージェントホストの接続解除に失敗した。

5

初期化に失敗した。

論理ホスト名の定義または環境設定に誤りがある。

6

jpqagtunlinkコマンドを実行したホストでメモリー不足が発生した。

7

jpqagtunlinkコマンドを実行したホストで論理不正が発生した。

100

TCP/IP通信でjpqagtunlinkコマンドを実行したホストからマネージャーホストに接続できない。

TCP/IPが正しく設定されていないため，jpqagtunlinkコマンドを実行したホストからマネージャーホストに接続できない。

マネージャーホスト名に誤りがある。または，マネージャーホストがプロセス停止状態である。

102

jpqagtunlinkコマンドを実行したホストでマネージャーホスト名のIPアドレスの解決に失敗した。

200

マネージャーホストがエージェントホストの接続解除を受け付けない。

マネージャーホストが運用開始処理中，運用停止処理中，運用停止中，または縮退運転中である。

201

指定したキューが使用できない。

指定したキューがない。

指定したデフォルトキューがない。

202

マネージャーホストから応答がない。

203

マネージャーホストの内部的要因で，エージェントホストの接続解除に失敗した。

206

エージェントホストを接続解除する権限がない。

214

マネージャーホストに接続しているエージェントホストがない。

219

マネージャーホストがビジー状態である。

220

マネージャーホストでメモリー不足が発生した。

222

致命的なエラーが発生した。

システムコールでエラーが発生した。

223

マネージャーホストで論理不正が発生した。

224

JP1/AJS3以外のホストに要求した。

226

実行環境が不適切である。

232

エージェントホストに接続していない。

233

実行中のジョブ（QUEUEジョブまたはサブミットジョブ）がある。

jpqendjobshow

形式

jpqendjobshow
     [-mh マネージャーホスト名]
     [-u 所有者名]
     [-sa 日時]
     [-sp 日時]
     [-rn 出力するジョブ情報の数]
     [-qn]

機能

終了ジョブ情報（ジョブ番号，サブミット先キュー名など）の一覧を標準出力に出力します。

JP1/OJE for VOS3ホストの終了ジョブ情報も出力できます。

また，AS/400システムの終了ジョブ情報も出力できます。

このコマンドで操作対象となるジョブは次のとおりです。

データベースが標準構成の場合

サブミットジョブ，QUEUEジョブ

データベースが標準構成（ISAMレス構成）の場合

なし

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

JP1_JPQ_Admin権限

JP1_JPQ_Operator権限

JP1_JPQ_User権限（ユーザー自身が所有するジョブだけ操作可）

引数

-mh マネージャーホスト名

ジョブ情報を出力したいジョブをサブミットしたマネージャーホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，自ホスト名が仮定されます。

-u 所有者名

ジョブの所有者名を指定します。

指定できる文字数は，1〜63（単位：バイト）です。省略した場合，JP1_JPQ_Admin権限またはJP1_JPQ_Operator権限を持つユーザーがこのコマンドを実行しているときはすべてのユーザーが，JP1_JPQ_User権限を持つユーザーが実行しているときは自ユーザーが仮定されます。

-sa 日時

その日時以降に実行が終了したジョブのジョブ情報を出力したい場合に，日時をこのコマンドを実行したホストに設定された日時で指定します。日時は「YYYY/MM/DD.hh:mm:ss」の形式で指定します。指定できる日時は，1980/01/01.00:00:00〜2099/12/31.23:59:59です。省略した場合，最も古いジョブ情報の日時が仮定されます。

YYYY

西暦年を指定します。指定できる値は，1980〜2099（単位：西暦年）です。

MM

月を指定します。指定できる値は，01〜12（単位：月）です。

DD

日を指定します。指定できる値は，01〜31（単位：日）です。

hh

時を指定します。指定できる値は，00〜23（単位：時）です。

mm

分を指定します。指定できる値は，00〜59（単位：分）です。

ss

秒を指定します。指定できる値は，00〜59（単位：秒）です。

-sp 日時

その日時以前に実行が終了したジョブのジョブ情報を出力したい場合に，日時をこのコマンドを実行したホストのローカル日時で指定します。日時は「YYYY/MM/DD.hh:mm:ss」の形式で指定します。指定できる日時は，1980/01/01.00:00:00〜2099/12/31.23:59:59です。省略した場合，最も新しいジョブ情報の日時が仮定されます。

YYYY

西暦年を指定します。指定できる値は，1980〜2099（単位：西暦年）です。

MM

月を指定します。指定できる値は，01〜12（単位：月）です。

DD

日を指定します。指定できる値は，01〜31（単位：日）です。

hh

時を指定します。指定できる値は，00〜23（単位：時）です。

mm

分を指定します。指定できる値は，00〜59（単位：分）です。

ss

秒を指定します。指定できる値は，00〜59（単位：秒）です。

-rn 出力するジョブ情報の数

出力するジョブ情報の数を指定します（-saオプションおよび-spオプションで指定した範囲の終了ジョブ情報について，ジョブ終了日時の新しいジョブ情報から，このオプションで指定した数分のジョブ情報を出力します）。

指定できる値は，0〜4,294,967,295です。省略した場合，0が仮定されます。

なお，0を指定した場合，-mhオプションで指定したマネージャーホスト内のすべてのジョブ情報を出力します。

-qn

ジョブ情報として，ジョブ番号，キュー種別，およびキュー名を出力します。

注意事項

各出力項目に対して，出力できるバイト数が決まっています。出力項目の内容が出力制限値を超えると，内容の末尾は「..」になります（例えば，ジョブ名の出力制限値は26バイトです。ジョブ名が27バイト以上の場合，25バイト以降は「..」になります）。ただし，-qnオプションで出力できるキュー名は，すべての内容が出力されます。

各出力項目に対してすべての内容を出力したい場合は，jpqjobgetコマンドを利用してください。

戻り値

0

正常終了。

1

引数の指定が不適切である。

2

jpqendjobshowコマンドを実行したホストの内部的要因で終了ジョブ情報の出力に失敗した。

5

初期化に失敗した。

論理ホスト名の定義または環境設定に誤りがある。

6

jpqendjobshowコマンドを実行したホストでメモリー不足が発生した。

7

jpqendjobshowコマンドを実行したホストで論理不正が発生した。

100

TCP/IP通信でjpqendjobshowコマンドを実行したホストからマネージャーホストに接続できない。

TCP/IPが正しく設定されていないため，jpqendjobshowコマンドを実行したホストからマネージャーホストに接続できない。

マネージャーホスト名に誤りがある。または，マネージャーホストがプロセス停止状態である。

102

jpqendjobshowコマンドを実行したホストでマネージャーホスト名のIPアドレスの解決に失敗した。

200

マネージャーホストが終了ジョブ情報の出力を受け付けない。

マネージャーホストが運用開始処理中，運用停止処理中，運用停止中，または縮退運転中である。

202

マネージャーホストから応答がない。

203

マネージャーホストの内部的要因で，終了ジョブ情報の出力に失敗した。

206

終了ジョブ情報を出力する権限がない。

207

指定したジョブがない。

指定したジョブがデータベース上にない。

指定した終了ジョブ情報は削除済みである。

指定したユーザーのジョブにアクセスできないため，終了ジョブ情報を出力できない。

219

マネージャーホストがビジー状態である。

222

致命的なエラーが発生した。

システムコールでエラーが発生した。

223

マネージャーホストで論理不正が発生した。

224

サポートしていないホストに終了ジョブ情報の出力を依頼した。

226

実行環境が不適切である。

出力例1

-qnオプションを指定した場合のファイル出力例と出力内容の意味を次に示します。

出力内容の意味を次に示します。

JOBID

ジョブ番号を示します。

T

キュー種別を示します。

q：キュー

a：エージェントホスト

QUEUE

キュー名（または，エージェントホスト名）を示します。

出力例2

-qnオプションを指定しなかった場合のファイル出力例と出力内容の意味を次に示します。

出力内容の意味を次に示します。

JOBID

ジョブ番号を示します。

JOBNAME

ジョブ名を示します。

26バイト分出力されます。

QUEUEジョブまたはjpqjobsubコマンドでジョブ名を指定している場合はそのジョブ名を設定し，省略した場合は実行ファイル名を設定します。

また，ジョブネットでPCジョブを定義した場合は，実行ファイル名を設定します。ジョブネットでUNIXジョブを定義した場合は，スクリプトファイル名を設定します。スクリプトファイル名を省略してコマンド文で指定した場合は，ジョブ名に「script_job」を設定します。

アクションジョブの場合は，各アクションジョブで実行する固定の実行ファイル名をジョブ名として設定します。なお，実行ファイル名の場合，パス情報を除いたファイル名部分の先頭から63バイト分までの文字列をジョブ名として設定し，そのうち先頭から26バイト分までを表示します。

T

キュー種別を示します。

q：キュー

a：エージェントホスト

QUEUE

キュー名（または，エージェントホスト名）を示します。

27バイト分出力されます。

EXITCODE

終了コード（符号を含む）を示します。

jpqexport

形式

jpqexport
     -dt {isam}
     -co ファイル名
     [-mh 論理ホスト名]
     [-dp データベース格納ディレクトリ名]

機能

現時点でのジョブ実行環境（ジョブ実行エージェント，キュー，および排他実行リソース）をファイルに出力します。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-dt {isam}

ジョブ実行環境のデータベースの種類を指定します。

isam

ISAMを利用したデータベース

-co ファイル名

ジョブ実行環境を出力するファイル名を，絶対パスで指定します。

指定できる文字数は，1〜511（単位：バイト）です。

-mh 論理ホスト名

論理ホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，物理ホスト名が仮定されます。

このオプションは，最初に指定してください。

-dp データベース格納ディレクトリ名

ジョブ実行環境のデータベースであるISAMファイルを格納しているディレクトリ名を指定します。

指定できる文字数は，1〜511（単位：バイト）です。

省略した場合，環境設定時にジョブ実行環境のデータベース格納ディレクトリとして定義したディレクトリ名が仮定されます。

注意事項

ジョブ実行環境を出力するファイルは，情報の上書きができません。ジョブ実行環境をファイルに出力する前には，必ず作成済みのファイルを削除または退避しておいてください。

ジョブ実行環境のファイルへの出力処理は，ジョブ実行環境によっては，数十分掛かる場合があります。

-mhオプションを省略した場合，環境変数JP1_HOSTNAMEは参照しません。論理ホストで運用している場合は，-mhオプションは省略しないでください。

このコマンドとjajs_maintain -m managerを同時に実行しないでください。

戻り値

0

正常終了。

1

引数の指定が不適切である。

130

指定したファイル，またはパスがない。

131

指定したファイルは作成済みである。

133

指定したファイルへのアクセス権限がない。

135

データベースがない。または，システム資源が不足している。

137

データベース格納ディレクトリがない。

138

データベースへのアクセス権限がない。

140

ジョブ実行環境を出力する権限（Administrators権限（Windowsの場合），またはスーパーユーザー権限（UNIXの場合））がない。

141

環境設定が不適切である。または，論理ホスト名が不適切である。

145

メモリーが不足している。

146

ディスクの空き領域が不足している。

147

内部的要因エラーが発生した。

149

データベースのサイズが2ギガバイトを超えているため処理が行えない。

150

データベースへ接続できない。

jpqimport

形式

jpqimport
     -dt {isam}
     -ci サブミットジョブ実行環境構成定義ファイル名
     [-mh 論理ホスト名]
     [-dp データベース格納ディレクトリ名]

機能

サブミットジョブ実行環境構成定義ファイル（jpqsetup.conf）を使用して，ジョブ実行環境（ジョブ実行エージェント，キュー，および排他実行リソース）を一括定義します。

他ホストのエージェントでジョブを実行する場合は，ジョブ実行環境のジョブ実行エージェントを定義する必要があります。

また，次の場合は，キューを作成する必要があります。

目的別にキューを作成し，クライアントからのジョブの登録（サブミット）を受け付ける場合

ジョブを分散実行する場合

JP1/OJE for VOS3からのジョブを受け付ける場合

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-dt {isam}

ジョブ実行環境のデータベースの種類を指定します。

isam

ISAMを利用したデータベース

-ci サブミットジョブ実行環境構成定義ファイル名

使用するサブミットジョブ実行環境構成定義ファイル名（jpqsetup.conf）を指定します。

指定できる文字数は，1〜511（単位：バイト）です。

-ciオプションにファイル名（jpqsetup.conf）だけを指定した場合，コマンド実行時にファイル（jpqsetup.conf）がカレントディレクトリにあると仮定されます。そのため，カレントディレクトリにファイル（jpqsetup.conf）が存在しない場合は，コマンドがエラーになります。

カレントディレクトリを意識せずにコマンドを実行する場合は，-ciオプションに指定するファイル名（jpqsetup.conf）をフルパスで指定してください。

サブミットジョブ実行環境構成定義ファイルの定義方法については，後述の「サブミットジョブ実行環境構成定義ファイル（jpqsetup.conf）の定義方法」を参照してください。

-mh 論理ホスト名

論理ホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，物理ホスト名が仮定されます。

このオプションは，最初に指定してください。

-dp データベース格納ディレクトリ名

ジョブ実行環境のデータベースである，ISAMファイルを格納するディレクトリ名を指定します。

指定できる文字数は，1〜511（単位：バイト）です。

省略した場合，環境設定時にジョブ実行環境のデータベース格納ディレクトリとして定義したディレクトリ名が仮定されます。

注意事項

このコマンドで一括定義したジョブ実行環境はQUEUEジョブ，サブミットジョブで使用します。

なお，キューレスジョブではジョブ実行環境の定義は使用しません。

このコマンドでサブミットジョブ実行環境を一括定義する場合，情報の上書きができません。サブミットジョブ実行環境のデータベースを再作成する前には，必ずJP1/AJS3を停止し，作成済みのデータベースを削除または退避してください。削除するファイルは，-dpオプションに指定するディレクトリ以下すべて（環境設定時に指定したジョブ実行環境のデータベース格納ディレクトリ以下すべて）です。

Windowsの場合はエクスプローラなどで削除してください。

UNIXの場合はrmコマンドで削除してください。

-ciオプションに指定するファイル内で使用する文字コード※は，JP1/AJS3の運用時に使用する文字コードと同じ文字コードを使用してください。

注※

環境設定パラメーターAJSCHARCODEで指定した文字コード。

-dpオプションでデータベース格納ディレクトリ名を指定した場合は，指定したディレクトリ名を環境設定時にも指定する必要があります。

環境設定パラメーターDatabasePathに指定します。

同じ論理ホスト上のJP1/AJS3が起動している間にこのコマンドを実行すると，エラーになります。

ジョブ実行環境の一括定義の処理は，サブミットジョブ実行環境構成定義ファイルの内容によっては，数十分掛かる場合があります。

ジョブ実行環境を再作成するとき，残っているジョブの標準出力・標準エラー出力ファイルを削除します。ジョブを大量に実行したあとに，ジョブ実行環境を再作成するとこれらのファイルを削除するためにコマンドの実行時間が長くなる場合があります。

コマンドを使ってジョブ実行エージェント・キュー・排他実行リソースを追加したり，削除したりし，かつ，共通定義情報でエージェント，キュー，排他実行リソースの最大定義数を小さくした場合，jpqexportコマンドで出力したサブミットジョブ実行環境構成定義ファイルを使用しても，jpqimportコマンドでジョブ実行環境を一括定義できないおそれがあります。例えば，共通定義情報のエージェントの最大定義数を30に設定した環境では，エージェントIDが100のエージェントをサブミットジョブ実行環境構成定義ファイルに定義してjpqimportコマンドを実行すると，jpqimportコマンドはエラーになります。

この場合，サブミットジョブ実行環境構成定義ファイルに定義されているエージェントID，キューID，排他実行リソースIDが，環境設定時に指定した最大定義数以下になるように，サブミットジョブ実行環境構成定義ファイルの記述を修正してください。その後，jpqimportコマンドを再実行してください。

「#」を行頭に記載することで，その行はコメントとして扱われます。「#」は必ず行頭に記載してください。パラメーターのあとに記載するとエラーとなります。

-mhオプションを省略した場合，環境変数JP1_HOSTNAMEは参照しません。論理ホストで運用している場合は，-mhオプションは省略しないでください。

戻り値

0

正常終了。

1

引数の指定が不適切である。

130

サブミットジョブ実行環境構成定義ファイル，またはパスがない。

132

サブミットジョブ実行環境構成定義ファイルの記述内容が不適切である。

133

サブミットジョブ実行環境構成定義ファイルへのアクセス権限がない。

135

システム資源が不足しているため，データベースを作成できない。

136

データベースがすでに作成されている。

137

データベース格納ディレクトリがない。

138

データベースへのアクセス権限がない。

140

ジョブ実行環境を一括定義する権限（Administrators権限（Windowsの場合），またはスーパーユーザー権限（UNIXの場合））がない。

141

環境設定が不適切である。または，論理ホスト名が不適切である。

142

同じ論理ホスト上のマネージャーホストが起動している。

145

メモリーが不足している。

146

ディスクの空き領域が不足している。

147

内部的要因エラーが発生した。

149

データベースのサイズが2ギガバイトを超えているため処理が行えない。

150

データベースへ接続できない。

151

RDAREA不正，もしくはRDAREAがない。

153

コマンドを実行できる状態でない。

補足事項

ジョブ実行エージェント，キューおよび排他実行リソースを追加および削除するなど，ジョブ実行環境の構成定義を変更したい場合は，次に示すどちらかの方法で対応してください。

JP1/AJS3サービスを停止してから，このコマンドを使ってジョブ実行環境のデータベースを再作成する。ジョブをリモート実行していた場合は，リモートホストのJP1/AJS3サービスも停止する。

ジョブの運用を停止しないで，次に示すコマンドを使ってジョブ実行環境の構成定義を変更する。

jpqagtadd：エージェントの追加

jpqagtdel：エージェントの削除

jpqagtalt：エージェントの属性変更

jpqagtlink：キューとエージェントの接続・接続先エージェントの優先順位変更

jpqagtunlink：キューとエージェントの接続解除

jpqqueadd：キューの追加

jpqquedel：キューの削除

jpqquealt：キューの属性変更

jpqqueopen：キューのオープン

jpqqueclose：キューのクローズ

jpqresadd：排他実行リソースの追加

jpqresdel：排他実行リソースの削除

エイリアス名を使用してエージェントを作成すると，1台のマネージャーホスト上に複数のエージェントを作成できます。その際は，エイリアス名でアドレス解決（pingコマンドが正常に終了）できることを確認してください。

サブミットジョブ実行環境構成定義ファイル（jpqsetup.conf）の定義方法

サブミットジョブ実行環境構成定義ファイルには，次に示す3種類の情報を定義します。

エージェント定義

キュー定義

排他実行リソース定義

次に，各情報の定義方法を説明します。

エージェント定義

形式

$agent $エージェントID {エージェントホスト名|$system}
[exec_jobs 多重度設定開始時刻 多重度設定終了時刻
     ジョブ実行多重度]...
def_queue $デフォルトキューのID
[max_jobs キュー内のジョブ数の最大値]
[warn_jobs キュー内のジョブ数の警告値]
[queue_ent {open|close}]
[queue_exit {open|close}]
[connect $エージェントID 優先順位]...
$end

引数

$agent $エージェントID {エージェントホスト名|$system}

ジョブ実行エージェントホスト名を指定します。

$agent：固定

$エージェントID：「$an（nはマネージャーホスト内でユニークな値，0以外の値）」の形式で指定する。nは，環境設定時に指定したエージェント定義数以下の値を指定する（例えば，エージェント定義数を256とした場合，nには256以下の値を指定する。257以上の値を指定すると，エラーになる）。

エージェントホスト名：255バイト以内の文字列

$system：マネージャーホスト上のジョブ実行エージェント

exec_jobs 多重度設定開始時刻 多重度設定終了時刻 ジョブ実行多重度

ジョブ実行多重度を指定します。省略した場合，1日のジョブ実行多重度に0が仮定されます。

ジョブ実行多重度を指定すると，このエージェントホストで同時に実行できるジョブ数を制限できます。同時実行数が制限されるジョブは，標準ジョブ（UNIXジョブ，PCジョブ，QUEUEジョブ），アクションジョブ，およびカスタムジョブです。同時に実行しようとしたジョブ数が実行多重度に達した場合，実行多重度を超えた分のジョブは，実行中のジョブが終了するまでキューイング（実行待ち）の状態になります。

ジョブ実行多重度が0の場合，ジョブは実行できません。ジョブを実行する場合は1以上を指定してください。

多重度設定開始時刻：「hhmm」の形式で指定する。hhに指定できる値は，00〜23（単位：時）。mmに指定できる値は，00，または30（単位：分）。

多重度設定終了時刻：「hhmm」の形式で指定する。hhに指定できる値は，00〜23（単位：時）。mmに指定できる値は，00，または30（単位：分）。

ジョブ実行多重度：0〜4,294,967,295の値

def_queue $デフォルトキューのID

デフォルトキューのIDを指定します。

デフォルトキューとは，エージェントホスト名を指定してジョブを実行する場合に必要なキューです。ジョブをサブミットする際，ジョブのサブミット先や実行先としてエージェントホスト名を指定すると，ジョブはそのエージェントホストのデフォルトキューにサブミットされます。

$デフォルトキューのID：デフォルトキューのIDを，「$qn（nは，デフォルトキューのIDおよびデフォルトキュー以外のキューのIDを合わせてマネージャーホスト内でユニークな値，0以外の値）」の形式で指定する。nは，環境設定値のキュー定義数以下の値を指定する（例えば，キュー定義数を256とした場合，nには256以下の値を指定する。257以上の値を指定すると，エラーになる）。

max_jobs キュー内のジョブ数の最大値

デフォルトキューにためておけるジョブ数の最大値を指定します。省略した場合，4,294,967,295が仮定されます。ただし，この設定にかかわらず，システム内の最大ジョブ数と同数のジョブがキュー中に残っていると，サブミットに失敗します。

この設定は，実際に実行中になったジョブも含みます。ジョブ数は，jpqqueshowコマンドの-qオプションで表示される「QUEUING」と「EXECUTING」の両方を合わせた値です。

キュー内のジョブ数の最大値：1〜4,294,967,295の値

warn_jobs キュー内のジョブ数の警告値

デフォルトキュー内のジョブ数が，デフォルトキューにためておけるジョブ数の最大値に近づいたことを知らせる警告値を指定します。省略した場合，4,294,967,295が仮定されます。この設定（省略時の仮定値を含む）は，デフォルトキュー内のジョブ数を対象としており，実際に実行中になったジョブも含みます。jpqqueshowコマンドの-ahオプションで確認すると「QUEUING」「EXECUTING」の両方を合わせたジョブ数になります。

ジョブ数が警告値に達すると，警告メッセージKAVU4516-Wが統合トレースログに出力されます。

キュー内のジョブ数の警告値：キュー内のジョブ数の最大値以下で，1〜4,294,967,295の値

queue_ent {open|close}

デフォルトキューの，ジョブの受付口の状態を指定します。受付口が閉じている場合，デフォルトキューにジョブを投入できません。省略した場合，openが仮定されます。

open：受付口を開く。

close：受付口を閉じる。

queue_exit {open|close}

デフォルトキューの，ジョブの取出口の状態を指定します。取出口が閉じている場合，デフォルトキューでジョブを実行できません。ジョブはデフォルトキューにたまります。省略した場合，openが仮定されます。

open：取出口を開く。

close：取出口を閉じる。

connect $エージェントID 優先順位

デフォルトキューに接続するエージェントホストのIDを指定します。エージェントIDは複数指定できます。省略した場合，エージェントホスト名を指定したジョブは実行できません。

$エージェントID：接続するエージェントホストのIDを，「$an」の形式で指定する。

優先順位：1〜16の値（優先順位がいちばん低いのが1，いちばん高いのが16）。優先順位が高いほど，ジョブが優先的に実行される。

$end

エージェント情報の終端を指定します。

$end：固定

記述例

$agent $a1 $system
exec_jobs 0000 0730 10
exec_jobs 0730 2000 1
exec_jobs 2000 0000 5
def_queue $q1
max_jobs 10
warn_jobs 5
queue_ent open
queue_exit open
connect $a1 1
$end

$agent $a2 agent1
exec_jobs 0000 0000 10
def_queue $q2
max_jobs 10
warn_jobs 5
queue_ent open
queue_exit open
connect $a1 1
connect $a2 2
$end

キュー定義

形式

$queue $キューID キュー名
[max_jobs キュー内のジョブ数の最大値]
[warn_jobs キュー内のジョブ数の警告値]
[queue_ent {open|close}]
[queue_exit {open|close}]
[connect $エージェントID 優先順位]...
$end

引数

$queue $キューID キュー名

キュー名を指定します。

エージェント名は大文字・小文字が区別されませんが，キュー名は大文字・小文字が区別されるので注意してください。

$queue：固定

$キューID：「$qn（nは，デフォルトキューのIDおよびデフォルトキュー以外のキューのIDを合わせてマネージャーホスト内でユニークな値，0以外の値）」の形式で指定する。nは，環境設定時に指定したキュー定義数以下の値を指定する（例えば，キュー定義数を256とした場合，nには256以下の値を指定する。257以上の値を指定すると，エラーになる）。

キュー名：63バイト以内の文字列

max_jobs キュー内のジョブ数の最大値

キューにためておけるジョブ数の最大値を指定します。省略した場合，4,294,967,295が仮定されます。ただし，この設定にかかわらず，システム内の最大ジョブ数と同数のジョブがキュー中に残っていると，サブミットに失敗します。

この設定は，実際に実行中になったジョブも含みます。ジョブ数は，jpqqueshowコマンドの-qオプションで表示される「QUEUING」と「EXECUTING」の両方を合わせた値です。

キュー内のジョブ数の最大値：1〜4,294,967,295の値

warn_jobs キュー内のジョブ数の警告値

キュー内のジョブ数が，キューにためておけるジョブ数の最大値に近づいたことを知らせる警告値を指定します。省略した場合，4,294,967,295が仮定されます。

この設定は，実際に実行中になったジョブも含みます。ジョブ数は，jpqqueshowコマンドの-qオプションで表示される「QUEUING」と「EXECUTING」の両方を合わせた値です。

ジョブ数が警告値に達すると，警告メッセージKAVU4516-Wが統合トレースログに出力されます。

キュー内のジョブ数の警告値：キュー内のジョブ数の最大値以下で，1〜4,294,967,295の値

queue_ent {open|close}

キューの，ジョブの受付口の状態を指定します。受付口が閉じている場合，キューにジョブを投入できません。省略した場合，openが仮定されます。

open：受付口を開く。

close：受付口を閉じる。

queue_exit {open|close}

キューの，ジョブの取出口の状態を指定します。取出口が閉じている場合，キューでジョブを実行できません。ジョブはキューにたまります。省略した場合，openが仮定されます。

open：取出口を開く。

close：取出口を閉じる。

connect $エージェントID 優先順位

キューに接続するエージェントホストのIDを指定します。エージェントIDは複数指定できます。省略した場合，キュー名を指定したジョブは実行できません。

$エージェントID：接続するエージェントホストのIDを，「$an」の形式で指定する。

優先順位：1〜16の値（優先順位がいちばん低いのが1，いちばん高いのが16）。優先順位が高いほど，ジョブが優先的に実行される。

$end

キュー情報の終端を指定します。

$end：固定

記述例

$queue $q3 queue1
max_jobs 10
warn_jobs 5
queue_ent open
queue_exit close
connect $a1 1
connect $a2 2
$end

排他実行リソース定義

形式

$res $排他実行リソースID 排他実行リソース名
$end

引数

$res $排他実行リソースID 排他実行リソース名

排他実行リソース名を指定します。

$res：固定

$排他実行リソースID：「$rn（nはマネージャーホスト内でユニークな値，0以外の値）」の形式で指定する。nは，環境設定時に指定した排他実行リソース定義数以下の値を指定する（例えば，排他実行リソース定義数を256とした場合，nには256以下の値を指定する。257以上の値を指定すると，エラーになる）。

排他実行リソース名：63バイト以内の文字列

$end

排他実行リソース情報の終端を指定します。

$end：固定

記述例

$res $r1 DAT_System
$end

$res $r2 Temp_File01
$end

jpqjobalt

形式

jpqjobalt
     [-mh マネージャーホスト名]
     {-q キュー名|-ah エージェントホスト名}
     {-h|-hr}
     -j ジョブ番号

機能

ジョブを保留または保留解除します。

このコマンドで操作対象となるジョブは次のとおりです。

データベースが標準構成の場合

サブミットジョブ，QUEUEジョブ

データベースが標準構成（ISAMレス構成）の場合

なし

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

JP1_JPQ_Admin権限

JP1_JPQ_Operator権限

JP1_JPQ_User権限（ユーザー自身が所有するジョブだけ操作可）

引数

-mh マネージャーホスト名

保留または保留解除したいジョブをサブミットしたマネージャーホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，自ホスト名が仮定されます。

-q キュー名

保留または保留解除したいジョブをサブミットしたキュー名を指定します。

指定できる文字数は，1〜63（単位：バイト）です。

-ah エージェントホスト名

保留または保留解除したいジョブをサブミットしたエージェントホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

-h

ジョブを保留します。

-hr

ジョブの保留を解除します。

-j ジョブ番号

保留または保留解除したいジョブのジョブ番号を指定します。

ジョブ番号は，jpqjobshowコマンドで確認できます。

なお，ジョブ番号は，1〜999999の範囲で指定してください。

注意事項

このコマンドは，JP1/AJS3 からJP1/OJE for VOS3への要求には使用できません。

戻り値

0

正常終了。

1

引数の指定が不適切である。

2

保留または保留解除依頼側の内部的要因で，ジョブの保留または保留解除に失敗した。

5

初期化に失敗した。

論理ホスト名の定義または環境設定に誤りがある。

6

保留または保留解除依頼側でメモリー不足が発生した。

7

保留または保留解除依頼側で論理不正が発生した。

100

TCP/IP通信でマネージャーホストに接続できない。

TCP/IPが正しく設定されていないため，マネージャーホストに接続できない。

マネージャーホスト名に誤りがある。または，マネージャーホストがプロセス停止状態である。

102

マネージャーホスト名によるIPアドレスの解決に失敗した。

200

マネージャーホストがジョブの保留または保留解除を受け付けない。

マネージャーホストが運用開始処理中，運用停止処理中，運用停止中，または縮退運転中である。

201

指定したキューが使用できない。

指定したキューがない。

202

マネージャーホストから応答がない。

203

マネージャーホストの内部的要因で，ジョブの保留または保留解除に失敗した。

206

ジョブを保留または保留解除する権限がない。

207

保留または保留解除するジョブがない。

指定したジョブがデータベース上にない。

指定したジョブの実行はすでに終了している。

208

指定したジョブの実行はすでに開始している。

219

マネージャーホストがビジー状態である。

220

マネージャーホスト側でメモリー不足が発生した。

222

致命的なエラーが発生した。

システムコールでエラーが発生した。

223

マネージャーホスト側で論理不正が発生した。

224

サポートしていないホストにジョブの保留または保留解除を依頼した。

226

実行環境が不適切である。

補足事項

保留状態のジョブに-hオプションを指定した場合も，実行待ちおよび時間待ち状態のジョブに-hrオプションを指定した場合も，コマンドは正常終了します。ただし，ジョブの状態は変更されません。

jpqjobcan

形式

jpqjobcan
     [-mh マネージャーホスト名]
     {-q キュー名|-ah エージェントホスト名}
     -j ジョブ番号
     [-em]

機能

ジョブが実行待ち，保留，時間待ち状態の場合は，ジョブの実行をキャンセルします。

ジョブが実行中の場合は，ジョブの実行を強制終了します。

UNIXで実行しているジョブに対しては，SIGKILLを発行するので，シグナルを捕捉するようなアプリケーションでも強制終了できます。

JP1/OJE for VOS3ホストのジョブをキャンセルまたは強制終了できます。JP1/OJE for VOS3ホストのジョブをキャンセルまたは強制終了する場合は，ユーザー自身が所有するジョブだけを操作できます。

また，AS/400システムのジョブもキャンセルまたは強制終了できます。AS/400システムに対して指定できるのは，-mh，-q，-jオプションだけです。

このコマンドで操作対象となるジョブは次のとおりです。

データベースが標準構成の場合

サブミットジョブ，QUEUEジョブ

PCジョブ，UNIXジョブ，アクションジョブ，カスタムジョブを強制終了したい場合は，ajskillコマンドを使用してください。

データベースが標準構成（ISAMレス構成）の場合

なし

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

JP1_JPQ_Admin権限

JP1_JPQ_Operator権限

JP1_JPQ_User権限（ユーザー自身が所有するジョブだけ操作可）

ただし，-emオプションを指定する場合は次の権限が必要です（JP1_JPQ_Admin権限，JP1_JPQ_Operator権限，JP1_JPQ_User権限は必要ありません）。

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-mh マネージャーホスト名

キャンセルまたは強制終了したいジョブをサブミットしたマネージャーホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，自ホスト名が仮定されます。

-emオプションと同時に指定する場合，指定できるホスト名は，ローカルホスト名またはローカルホスト上の論理ホスト名だけです。それ以外の値が指定された場合はエラー（エラーコード25）となります。また，この場合，-mhオプションにエイリアスホスト名を指定することはできません。

-q キュー名

キャンセルまたは強制終了したいジョブをサブミットしたキュー名を指定します。

指定できる文字数は，1〜63（単位：バイト）です。

-ah エージェントホスト名

キャンセルまたは強制終了したいジョブをサブミットしたエージェントホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

このオプションは，JP1/AJS3からJP1/OJE for VOS3への要求には指定できません。

-j ジョブ番号

キャンセルまたは強制終了したいジョブのジョブ番号を指定します。

ジョブ番号は，jpqjobshowコマンドで確認できます。

なお，ジョブ番号は，1〜999999の範囲で指定してください。

-em

緊急実行時に指定します。

このオプションを指定すると，通常とは異なる通信経路に対して要求するため，障害時などに緊急で実行できるようになります。

なお，このオプションを指定する場合，マネージャーホスト名にIPアドレスは指定できません。

注意事項

-emオプションは，エージェント障害から復旧する目的でだけ指定してください。常に-emオプションを指定して運用する場合，障害発生時に対応できなくなるおそれがあります。

戻り値

0

正常終了。

1

引数の指定が不適切である。

2

キャンセルまたは強制終了依頼側の内部的要因で，ジョブのキャンセルまたは強制終了に失敗した。

5

初期化に失敗した。

論理ホスト名の定義または環境設定に誤りがある。

6

キャンセルまたは強制終了依頼側でメモリー不足が発生した。

7

キャンセルまたは強制終了依頼側で論理不正が発生した。

25

マネージャーホスト名の指定にローカルホスト名および論理ホスト名以外を指定した。

100

TCP/IP通信でマネージャーホストに接続できない。

TCP/IPが正しく設定されていないため，マネージャーホストに接続できない。

マネージャーホスト名に誤りがある。または，マネージャーホストがプロセス停止状態である。

102

マネージャーホスト名によるIPアドレスの解決に失敗した。

200

マネージャーホストがジョブのキャンセルまたは強制終了を受け付けない。

マネージャーホストが，運用開始処理中，運用停止処理中，運用停止中，または縮退運転中である。

201

指定したキューが使用できない。

指定したキューがない。

202

マネージャーホストから応答がない。

203

マネージャーホスト側の内部的要因で，ジョブのキャンセルまたは強制終了に失敗した。

206

ジョブをキャンセルまたは強制終了する権限がない。

207

キャンセルまたは強制終了するジョブがない。

指定したジョブがデータベース上にない。

指定したジョブの実行はすでに終了している。

219

マネージャーホストがビジー状態である。

220

マネージャーホスト側でメモリー不足が発生した。

221

JP1/OJE for VOS3のユーザー情報が不適切である。

222

致命的なエラーが発生した。

システムコールでエラーが発生した。

223

マネージャーホスト側で論理不正が発生した。

224

サポートしていないホストにジョブのキャンセルまたは強制終了を依頼した。

226

実行環境が不適切である。

230

ジョブの強制終了を実行したが，エージェントホストでのジョブの強制終了に失敗した。ジョブが終了しているかどうかわからない（ただし，jpqjobgetコマンドでジョブ情報を参照すると，「END」となる）。

jpqjobdel

形式

jpqjobdel
     [-mh マネージャーホスト名]
     -j ジョブ番号

機能

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

このコマンドで操作対象となるジョブは次のとおりです。

データベースが標準構成の場合

サブミットジョブ，QUEUEジョブ

データベースが標準構成（ISAMレス構成）の場合

なし

実行権限

次に示すJP1権限レベルのどちらかを与えられたユーザー

JP1_JPQ_Admin権限

JP1_JPQ_Operator権限

引数

-mh マネージャーホスト名

終了ジョブ情報を削除したいジョブをサブミットしたマネージャーホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，自ホスト名が仮定されます。

-j ジョブ番号

終了ジョブ情報を削除したいジョブのジョブ番号を指定します。

ジョブ番号は，jpqendjobshowコマンドで確認できます。

なお，ジョブ番号は，1〜999999の範囲で指定してください。

注意事項

このコマンドは，JP1/AJS3からJP1/OJE for VOS3への要求には使用できません。

戻り値

0

正常終了。

1

引数の指定が不適切である。

2

終了ジョブ情報の削除依頼側の内部的要因で，終了ジョブ情報の削除に失敗した。

5

初期化に失敗した。

論理ホスト名の定義または環境設定に誤りがある。

6

終了ジョブ情報の削除依頼側でメモリー不足が発生した。

7

終了ジョブ情報の削除依頼側で論理不正が発生した。

100

TCP/IP通信でマネージャーホストに接続できない。

TCP/IPが正しく設定されていないため，マネージャーホストに接続できない。

マネージャーホスト名に誤りがある。または，マネージャーホストがプロセス停止状態である。

102

マネージャーホスト名によるIPアドレスの解決に失敗した。

200

マネージャーホストが終了ジョブ情報の削除を受け付けない。

マネージャーホストが運用開始処理中，運用停止処理中，運用停止中，または縮退運転中である。

202

マネージャーホストから応答がない。

203

マネージャーホスト側の内部的要因で，終了ジョブ情報の削除に失敗した。

206

終了ジョブ情報を削除する権限がない。

207

削除するジョブ情報がない。

指定した終了ジョブ情報がデータベース上にない。

208

指定したジョブの実行がまだ終了していない。

219

マネージャーホストがビジー状態である。

220

マネージャーホスト側でメモリー不足が発生した。

222

致命的なエラーが発生した。

システムコールでエラーが発生した。

223

マネージャーホスト側で論理不正が発生した。

224

JP1/AJS3以外のホストに要求した。

226

実行環境が不適切である。

jpqjobget

形式

jpqjobget
     [-mh マネージャーホスト名]
     [{-q キュー名|-ah エージェントホスト名}]
     -j ジョブ番号
     [-oso 標準出力ファイル名]
     [-ose 標準エラー出力ファイル名]
     [-di]
     [-cc]
     [-ea]

機能

特定のジョブのジョブ情報を標準出力ファイルに出力します。

JP1/OJE for VOS3ホストのジョブ情報も出力できます。JP1/OJE for VOS3ホストのジョブ情報を出力する場合は，ユーザー自身が所有するジョブだけを操作できます。

また，AS/400システムのジョブ情報も標準出力ファイルに出力します。AS/400システムに対して指定できるのは，-mh，-q，-jオプションだけです。

このコマンドで操作対象となるジョブは次のとおりです。

データベースが標準構成の場合

サブミットジョブ，QUEUEジョブ

データベースが標準構成（ISAMレス構成）の場合

なし

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

JP1_JPQ_Admin権限

JP1_JPQ_Operator権限

JP1_JPQ_User権限（ユーザー自身が所有するジョブだけ操作可）

引数

-mh マネージャーホスト名

ジョブ情報を出力したいジョブをサブミットしたマネージャーホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，自ホスト名が仮定されます。

-q キュー名

ジョブ情報を出力したいジョブをサブミットしたキュー名を指定します。

指定できる文字数は，1〜63（単位：バイト）です。

-ah エージェントホスト名

ジョブ情報を出力したいジョブをサブミットしたエージェントホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

このオプションは，JP1/AJS3からJP1/OJE for VOS3への要求には指定できません。

-j ジョブ番号

ジョブ情報を出力したいジョブのジョブ番号を指定します。

なお，ジョブ番号は，1〜999999の範囲で指定してください。

-oso 標準出力ファイル名

-jオプションに指定したジョブを実行したときに出力された，標準出力ファイルのデータを取得するためのファイル名を指定します。

指定できる文字数は，1〜511（単位：バイト）です。

-ose 標準エラー出力ファイル名

-jオプションに指定したジョブを実行したときに出力された，標準エラー出力ファイルのデータを取得するためのファイル名を指定します。

指定できる文字数は，1〜511（単位：バイト）です。

-di

-jオプションに指定したジョブの詳細情報を出力します。

-cc

-jオプションに指定したジョブを実行したエージェントが使用している文字コードを出力します。

-ea

-jオプションに指定したジョブの実行先のエージェントホスト名を出力します。

注意事項

ジョブの実行によって標準出力ファイルや標準エラー出力ファイルが移動されたり削除されたりした場合，標準出力ファイルや標準エラー出力ファイルの情報は取得できません。

ジョブ登録時の転送ファイルや，ジョブ情報取得時に取得する結果ファイルとして数メガバイトのファイルを転送すると，転送に失敗したり時間が掛かったりする場合があります。

戻り値

0

正常終了。

1

引数の指定が不適切である。

2

ジョブ情報の出力依頼側の内部的要因で，ジョブ情報の出力に失敗した。

5

初期化に失敗した。

論理ホスト名の定義または環境設定に誤りがある。

6

ジョブ情報の出力依頼側でメモリー不足が発生した。

7

ジョブ情報の出力依頼側で論理不正が発生した。

13

標準出力ファイル，標準エラー出力ファイルのデータを取得するファイルのファイルパスがないため，ファイルを作成できない。

14

標準出力ファイル，標準エラー出力ファイルのデータを取得するファイルへのアクセス権がないため，ファイルを作成できない。

15

ディスクに空き容量が不足しているため，標準出力ファイル，標準エラー出力ファイルのデータをファイルに書き込めない。

16

標準出力ファイル，標準エラー出力ファイルのデータを取得するファイルが他プロセスで使用されているため，ファイルを開けない。

17

戻り値13，14，15，16以外の要因で，標準出力ファイル，標準エラー出力ファイルのデータを取得するファイルを作成できない。

18

戻り値13，14，15，16以外の要因で，標準出力ファイル，標準エラー出力ファイルの書き込みに失敗した。

19

マネージャーホストから標準出力ファイル，標準エラー出力ファイルのデータを取得できなかったため，ファイルを作成できない。

100

TCP/IP通信でマネージャーホストに接続できない。

TCP/IPが正しく設定されていないため，マネージャーホストに接続できない。

マネージャーホスト名に誤りがある。または，マネージャーホストがプロセス停止状態である。

102

マネージャーホスト名によるIPアドレスの解決に失敗した。

200

マネージャーホストがジョブ情報の出力を受け付けない。

マネージャーホストが運用開始処理中，運用停止処理中，運用停止中，または縮退運転中である。

201

指定したキューが使用できない。

指定したキューがない。

202

マネージャーホストから応答がない。

203

マネージャーホスト側の内部的要因で，ジョブ情報の出力に失敗した。

206

ジョブ情報を出力する権限がない。

207

指定したジョブがない。

指定したジョブがデータベース上にない。

指定したジョブのジョブ情報は削除済みである。

219

マネージャーホストがビジー状態である。

220

マネージャーホスト側でメモリー不足が発生した。

222

致命的なエラーが発生した。

システムコールでエラーが発生した。

223

マネージャーホスト側で論理不正が発生した。

224

サポートしていないホストにジョブ情報の出力を依頼した。

226

実行環境が不適切である。

出力例

ファイル出力例と出力内容の意味を次に示します。

出力内容の意味を次に示します。

JOBID

ジョブ番号を示します。

OWNER

ジョブの所有者名を示します。

JOBNAME

ジョブ名を示します。

QUEUEジョブまたはjpqjobsubコマンドでジョブ名を指定している場合はそのジョブ名を設定し，省略した場合は実行ファイル名を設定します。

また，ジョブネットでPCジョブを定義した場合は，実行ファイル名を設定します。ジョブネットでUNIXジョブを定義した場合は，スクリプトファイル名を設定します。スクリプトファイル名を省略してコマンド文で指定した場合は，ジョブ名に「script_job」を設定します。

アクションジョブの場合は，各アクションジョブで実行する固定の実行ファイル名をジョブ名として設定します。なお，実行ファイル名の場合，パス情報を除いたファイル名部分の先頭から63バイト分までの文字列をジョブ名として設定します。

QUEUE

キュー名（または，エージェントホスト名）を示します。

STATUS

ジョブの状態を示します。

ROUTING：配送中

SCHEDULED：時間待ち

WAITING：実行待ち

EXECUTING：実行中

HOLDING：保留

END：終了

EXITCODE

ジョブの終了コードを示します。ジョブの終了コードの詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　7.11.3 ジョブの終了コードを確認する」を参照してください。

ENTRYTIME

ジョブのサブミット日時を「YYYY/MM/DD.hh:mm:ss」の形式で示します。

STARTTIME

ジョブの実行開始日時を「YYYY/MM/DD.hh:mm:ss」の形式で示します。

ENDTIME

ジョブの実行終了日時を「YYYY/MM/DD.hh:mm:ss」の形式で示します。

DETAILEDSTATUS

ジョブの詳細情報を示します。-diオプションを指定したときだけ出力されます。

END IN ANOTHER SYSTEM：他システムで終了状態（詳細情報が取得できなかった）

WAITING：実行待ち

HOLDING：保留中

SCHEDULED：時間待ち

ROUTING：配送中

EXECUTING：実行中

NORMAL END：正常終了※1

WARNING END：警告終了※1

ABNORNAL END：異常終了※1

EXECUTION TIMED OUT：実行打ち切り終了

CANCELED END：キャンセル終了（実行開始前にキャンセルを要求した）

FORCIBLY TERMINATED：強制終了（実行開始後にキャンセルを要求した）

FAILURE WHILE STARTING EXECUTION：実行開始中の失敗

FAILURE WHILE ENDING EXECUTION：実行終了中の失敗※2

注※1

ジョブネットで作成したジョブで終了判定を設定した場合，判定方法に従った終了状態になります。

なお，jpqjobsubコマンドの場合，ジョブの終了判定を設定できないため，警告しきい値および異常しきい値は0となります。したがって，ジョブの詳細情報は，終了コードが0で終了した場合は正常終了，0以外の値で終了した場合は異常終了となります。

注※2

ジョブのプロセス実行後の終了処理中，またはジョブの終了後にエージェントホストとマネージャーホスト間で終了情報をやり取りする際に，何らかの障害が生じた場合にこの状態になることがあります。エラーの詳細については，統合トレースログに出力されたメッセージKAVUxxxxで確認してください。

エージェントホストで実行していたジョブのプロセス自身は終了しています。ジョブのプロセス自身の終了状態は，ジョブのプロセスの実行履歴などで確認してください。

CHARCODE

ジョブを実行したエージェントで使用している文字コードを示します。-ccオプションを指定したときだけ出力されます。

ASCII：ASCIIコード

SJIS：シフトJISコード

JP_EUC：日本語EUCコード

UTF-8：UTF-8コード

ジョブの実行が終了していない場合，または他システムのジョブの場合

UNKNOWN：文字コード不明

AGENTNAME

ジョブの実行先のエージェントホスト名を示します。-eaオプションを指定したときだけ出力されます。

エージェントホスト名が取得できない場合は，「AGENTNAME : 」と表示されます。

なお，「YYYY/MM/DD.hh:mm:ss」は「西暦年/月/日.時:分:秒」のことです。

jpqjobmove

形式

jpqjobmove
     [-mh マネージャーホスト名]
     {-q キュー名|-ah エージェントホスト名}
     {-dq 移動先キュー名|{-p+|-p-} 実行順}
     -j ジョブ番号

機能

キュー内のジョブを移動します。

移動には次に示す制限があります。

移動できるのは，実行中，および終了状態以外のジョブだけ。

ジョブの移動先として指定できるキューは，移動元と同じマネージャーホスト内のキューだけ。

デフォルトキューのジョブの場合

キュー間の移動はできない。

デフォルトキュー内で，ジョブの実行順を任意に指定できる。

デフォルトキュー以外のキューのジョブの場合

移動先にデフォルトキューは指定できない。

移動元と移動先のキューが同じ場合で，かつ，移動先キューの名称を指定した場合は，ジョブの実行順は末尾になる。

移動元と移動先のキューが同じ場合で，かつ，ジョブの実行順を指定した場合は，実行順を任意に指定できる。

移動元と移動先のキューが異なる場合は，ジョブの実行順は末尾になる。

ジョブネットから登録したQUEUEジョブの場合

キュー間の移動はできない。

このコマンドで操作対象となるジョブは次のとおりです。

データベースが標準構成の場合

サブミットジョブ，QUEUEジョブ

データベースが標準構成（ISAMレス構成）の場合

なし

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

JP1_JPQ_Admin権限

JP1_JPQ_Operator権限

JP1_JPQ_User権限（キュー間のジョブの移動だけ操作可）

引数

-mh マネージャーホスト名

移動したいジョブをサブミットしたマネージャーホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，自ホスト名が仮定されます。

-q キュー名

移動したいジョブをサブミットしたキュー名を指定します。デフォルトキュー以外のキュー内のジョブの実行順を変更したい場合，およびジョブをキュー間で移動したい場合は，このオプションを指定します。

指定できる文字数は，1〜63（単位：バイト）です。

-ah エージェントホスト名

移動したいジョブをサブミットしたエージェントホスト名を指定します。デフォルトキュー内のジョブの実行順を変更したい場合は，このオプションを指定します。

指定できる文字数は，1〜255（単位：バイト）です。

このオプションは，-dqオプションと同時には指定できません。

-dq 移動先キュー名

ジョブ移動先のキュー名を指定します。

指定できる文字数は，1〜63（単位：バイト）です。

このオプションは，-ahオプションと同時には指定できません。

-p+，-p-オプションと同時には指定できません。

{-p+|-p-} 実行順

キュー内でのジョブの実行順を指定します。

-p+

ジョブの実行順を前方向に移動します。

-p-

ジョブの実行順を後方向に移動します。

実行順

ジョブの実行順を，現時点の実行順からの相対順で指定します（例えば，現在の実行順が5で，実行順を3に変更したい場合は，「-p+ 2」と指定します）。

なお，実行順として指定した値だけのジョブがキューにない場合，「-p+」を指定した場合はキューの先頭に，「-p-」を指定した場合はキューの末尾に移動されます（例えば，「-p+ 5」と指定したにもかかわらず，キュー内のジョブ数が5未満であった場合は，実行順1として扱われます）。

このオプションは，-dqオプションと同時には指定できません。

-j ジョブ番号

移動したいジョブのジョブ番号を指定します。

ジョブ番号は，jpqjobshowコマンドで確認できます。

なお，ジョブ番号は，1〜999999の範囲で指定してください。

注意事項

このコマンドは，JP1/AJS3からJP1/OJE for VOS3への要求には使用できません。

戻り値

0

正常終了。

1

引数の指定が不適切である。

2

ジョブの移動依頼側の内部的要因で，ジョブの移動に失敗した。

5

初期化に失敗した。

論理ホスト名の定義または環境設定に誤りがある。

6

ジョブの移動依頼側でメモリー不足が発生した。

7

ジョブの移動依頼側で論理不正が発生した。

100

TCP/IP通信でマネージャーホストに接続できない。

TCP/IPが正しく設定されていないため，マネージャーホストに接続できない。

マネージャーホスト名に誤りがある。または，マネージャーホストがプロセス停止状態である。

102

マネージャーホスト名によるIPアドレスの解決に失敗した。

200

マネージャーホストがジョブの移動を受け付けない。

マネージャーホストが運用開始処理中，運用停止処理中，運用停止中，または縮退運転中である。

201

指定したキューが使用できない。

指定したキューがない。

202

マネージャーホストから応答がない。

203

マネージャーホスト側の内部的要因で，ジョブの移動に失敗した。

206

ジョブを移動する権限がない。

207

移動するジョブがない。

指定したジョブがデータベース上にない。

指定したジョブは実行が終了している。

208

指定したジョブの実行はすでに開始している。

209

移動先として指定したキューがない。

210

移動先として指定したキューはサブミットジョブ数がすでに最大値に達しているため，ジョブを移動できない。

219

マネージャーホストがビジー状態である。

220

マネージャーホスト側でメモリー不足が発生した。

222

致命的なエラーが発生した。

システムコールでエラーが発生した。

223

マネージャーホスト側で論理不正が発生した。

224

JP1/AJS3以外のホストに要求した。

226

実行環境が不適切である。

jpqjobshow

形式

jpqjobshow
     [-mh マネージャーホスト名]
     {-q キュー名|-ah エージェントホスト名}
     [-u 所有者名]
     -s {e|h|w|s|r}

機能

未終了ジョブ情報（ジョブ番号，ジョブ名，ジョブ状態など）の一覧を標準出力ファイルに出力します。

JP1/OJE for VOS3ホストのジョブ情報も出力できます。

また，AS/400システムのジョブ情報も出力できます。AS/400システムに対して指定できるのは，-mh，-q，-u，-sオプションだけです。

このコマンドで操作対象となるジョブは次のとおりです。

データベースが標準構成の場合

サブミットジョブ，QUEUEジョブ

データベースが標準構成（ISAMレス構成）の場合

なし

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

JP1_JPQ_Admin権限

JP1_JPQ_Operator権限

JP1_JPQ_User権限（ユーザー自身が所有するジョブだけ操作可）

引数

-mh マネージャーホスト名

ジョブ情報を出力したいジョブをサブミットしたマネージャーホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，自ホスト名が仮定されます。

-q キュー名

ジョブ情報を出力したいジョブをサブミットしたキュー名を指定します。

指定できる文字数は，1〜63（単位：バイト）です。

-ah エージェントホスト名

ジョブ情報を出力したいジョブをサブミットしたエージェントホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

このオプションは，JP1/AJS3からJP1/OJE for VOS3への要求には指定できません。

-u 所有者名

そのユーザーがサブミットしたジョブのジョブ情報を出力したい場合に，ジョブの所有者名を指定します。

指定できる文字数は，1〜63（単位：バイト）です。

省略した場合，JP1_JPQ_Admin権限またはJP1_JPQ_Operator権限を持つユーザーがこのコマンドを実行している場合はすべてのユーザーが，JP1_JPQ_User権限を持つユーザーが実行しているときは，自ユーザーが仮定されます。

-s {e|h|w|s|r}

特定の状態のジョブの情報を出力します。状態は複数指定できます。

e

実行中ジョブの情報を出力します。

h

保留ジョブの情報を出力します。

w

実行待ちジョブの情報を出力します。

s

時間待ちジョブの情報を出力します。

r

配送中ジョブの情報を出力します。

注意事項

各出力項目に対して，出力できるバイト数が決まっています。出力項目の内容が出力制限値を超えると，内容の末尾は「..」になります（例えば，ジョブ名の出力制限値は26バイトです。ジョブ名が27バイト以上の場合，25バイト以降は「..」になります）。

各出力項目に対してすべての内容を出力したい場合は，jpqjobgetコマンドを利用してください。

戻り値

0

正常終了。

1

引数の指定が不適切である。

2

未終了ジョブ情報の出力依頼側の内部的要因で，未終了ジョブ情報の出力に失敗した。

5

初期化に失敗した。

論理ホスト名の定義または環境設定に誤りがある。

6

未終了ジョブ情報の出力依頼側でメモリー不足が発生した。

7

未終了ジョブ情報の出力依頼側で論理不正が発生した。

100

TCP/IP通信でマネージャーホストに接続できない。

TCP/IPが正しく設定されていないため，マネージャーホストに接続できない。

マネージャーホスト名に誤りがある。または，マネージャーホストがプロセス停止状態である。

102

マネージャーホスト名によるIPアドレスの解決に失敗した。

200

マネージャーホストが未終了ジョブ情報の出力を受け付けない。

マネージャーホストが運用開始処理中，運用停止処理中，運用停止中，または縮退運転中である。

201

指定したキューが使用できない。

指定したキューがない。

202

マネージャーホストから応答がない。

203

マネージャーホスト側の内部的要因で，未終了ジョブ情報の出力に失敗した。

206

未終了ジョブ情報を出力する権限がない。

207

指定したジョブがない。

指定したジョブがデータベース上にない。

指定したユーザーのジョブにアクセスできないため，未終了ジョブ情報を出力できない。

219

マネージャーホストがビジー状態である。

220

マネージャーホスト側でメモリー不足が発生した。

222

致命的なエラーが発生した。

システムコールでエラーが発生した。

223

マネージャーホスト側で論理不正が発生した。

224

サポートしていないホストに未終了ジョブ情報の出力を依頼した。

226

実行環境が不適切である。

出力例

ファイル出力例と出力内容の意味を次に示します。

出力内容の意味を次に示します。

JOBID

ジョブ番号を示します。

JOBNAME

ジョブ名を示します。

26バイト分出力されます。

QUEUEジョブまたはjpqjobsubコマンドでジョブ名を指定している場合はそのジョブ名を設定し，省略した場合は実行ファイル名を設定します。

また，ジョブネットでPCジョブを定義した場合は，実行ファイル名を設定します。ジョブネットでUNIXジョブを定義した場合は，スクリプトファイル名を設定します。スクリプトファイル名を省略してコマンド文で指定した場合は，ジョブ名に「script_job」を設定します。

アクションジョブの場合は，各アクションジョブで実行する固定の実行ファイル名をジョブ名として設定します。なお，実行ファイル名の場合，パス情報を除いたファイル名部分の先頭から63バイト分までの文字列をジョブ名として設定し，そのうち先頭から26バイト分までを表示します。

T

キュー種別を示します。

q：キュー

a：エージェントホスト

QUEUE

キュー名（または，エージェントホスト名）を示します。

27バイト分出力されます。

STATUS

ジョブの状態を示します。

EXECUTING：実行中

HOLDING：保留

WAITING：実行待ち

SCHEDULED：時間待ち

ROUTING：配送中

jpqjobsub

形式

jpqjobsub
     [-mh マネージャーホスト名]
     {-q キュー名|-ah エージェントホスト名}
     [-eu ユーザー名]
     [-jn ジョブ名]
     [-pr 実行優先順位]
     -sc 実行ファイル名
     [-arg "引数..."]
     [-w 作業用パス名]
     [-shl シェルパス名]
     [-res 排他実行リソース名]
     [-st 実行開始日時]
     [-el 実行打ち切り時間]
     [-si 標準入力ファイル名]
     [-rs {q|h|d}]
     [-so|-son 標準出力ファイル名|-soa 標準出力ファイル名]
     [-se|-sen 標準エラー出力ファイル名|-sea 標準エラー出力ファイル名]
     [-ev 環境変数ファイル名]
     [[-env 環境変数名=値]...]
     [-h]
     [-t 転送元ファイル名[=転送先ファイル名]]...
     [-td 転送元ファイル名[=転送先ファイル名]]...

機能

サブミットジョブを登録します。対象となるジョブは，PCジョブ，UNIXジョブ，およびQUEUEジョブ（キューに登録するジョブ）です。キューレスジョブは対象外です。また，JP1/OJE for VOS3ホスト，またはAS/400システムにもサブミットジョブを登録できます。なお，他システムに登録するジョブは，QUEUEジョブのため，他システムであらかじめキューを作成しておく必要があります。

登録先

指定できるオプション

JP1/OJE for VOS3ホスト

-mh，-q，-jn，-sc，-arg，-t

AS/400システム

-mh，-q，-jn，-pr，-sc，-arg，-t

これら以外を指定した場合，指定は無視されます。

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

JP1_JPQ_Admin権限

JP1_JPQ_Operator権限

JP1_JPQ_User権限（ユーザー自身が所有するジョブだけ操作可）

引数

-mh マネージャーホスト名

マネージャーホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，自ホスト名が仮定されます。

-q キュー名

キューにジョブを登録して実行するQUEUEジョブの場合，キュー名を指定します。

指定できる文字数は，1〜63（単位：バイト）です。他システムにジョブを登録する場合は，-ahオプションではなくこのオプションを指定します。

-ah エージェントホスト名

ジョブの実行先ホストを指定して実行するPCジョブやUNIXジョブの場合，エージェントホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。他システムにジョブを登録する場合は指定できません。

-eu ユーザー名

OSユーザー名を指定します。なお，このオプションに指定するOSユーザー名は，コマンドを実行するJP1ユーザー（コマンドを実行するOSユーザー名と同名のJP1ユーザー）に対してジョブを実行するエージェントホスト上でマッピングされている必要があります。

指定できる文字数は，1〜63（単位：バイト）です。

Windowsの場合，サブミットジョブの実行ユーザーをローカルホストのユーザーに限定させたいときは，OSユーザー名の指定方法を「ホスト名¥ユーザー名」としてください。

-jn ジョブ名

登録するサブミットジョブ名を指定します。

指定できる文字数は，1〜63（単位：バイト）です。省略した場合，-scオプションで指定した実行ファイル名のファイル名部分（パス名を除いた部分）の先頭から63バイト分の文字列が仮定されます。

-pr 実行優先順位

実行優先順位を指定します。

指定できる値は，1〜5です。省略した場合，1が仮定されます。

指定できる値と，値の意味を次の表に示します。

指定値

Windowsでの実行優先順位

UNIXでの実行優先順位

1

対話処理と比較して低い

nice値＋20

2

nice値＋10

3

対話処理と同等

nice値

4

対話処理と比較して高い

nice値−10

5

nice値−20

ジョブを実行するホストがUNIXの場合で，実行時のユーザーがスーパーユーザー権限を持たないユーザーのとき，実行優先順位として4または5を指定すると，ジョブ実行時に権限エラーになります。

補足事項

Windowsの場合，優先順位は3段階になります。次の三つの優先順位クラスを設定してジョブのプロセスを起動します。

指定値が1または2の場合は，システムがアイドル状態のときに実行されます（Windowsで規定されるIDLE_PRIORITY_CLASSを設定します）。

指定値が3の場合は，一般的なプロセスとして実行されます（Windowsで規定されるNORMAL_PRIORITY_CLASSを設定します）。

指定値が4または5の場合は，上記の優先順位クラスを割り当てられたプロセスのスレッドより先に実行されます（Windowsで規定されるHIGH_PRIORITY_CLASSを設定します）。

UNIXの場合，nice値のデフォルトとして，jajs_spmdコマンドを実行した際のJP1/AJS3サービスのnice値を基準とします。特に設定されていない場合のnice値は20が仮定されます。

指定値が［1］でnice値が20の場合，優先順位の値は次のようになります。

　39 ≒ 20(初期値) ＋ 20(増分値)

nice値の範囲（0〜39）を超える場合，最大値は39，最小値は0となります。

-sc 実行ファイル名

Windowsの場合，ジョブを実行するエージェントホスト上の実行ファイル名を指定します。UNIXの場合，ジョブを実行するエージェントホスト上にあるスクリプトファイル名を指定します。

指定できる文字数は，1〜511（単位：バイト）です。ファイル名は，絶対パスおよび相対パスで指定できます。相対パスで指定した場合，ジョブ実行時の作業用パス，または環境変数PATHで指定されたパスからの相対パスになります。有効となる環境変数PATHは，ジョブを実行するホストのOSによって異なります。

ジョブ実行ホストがWindowsの場合

システム環境変数

ジョブ実行ホストがUNIXの場合

ジョブを実行するOSユーザーの環境変数PATH

なお，実行ファイル名に空白文字が含まれる場合は，実行ファイル名を「"」で囲んでください。例えば，「aaa　bbb」は「"aaa　bbb"」と指定してください。

Windowsの場合，拡張子がEXE，COM，CMD，またはBAT以外のファイルで，パス名に空白を含むものを実行するときは，ファイル名を「"（ダブルクォーテーションマーク）」および「¥"」で囲んでください。

（例）

jpqjobsub -q q1 -sc "¥"C:¥PROGRAM FILES¥HITACHI¥SCRIPT¥DATA¥EXIT_0.SPT¥""

-arg "引数..."

実行ファイルに対する引数を指定します。

指定できる文字数は，1〜1,023（単位：バイト）です。

引数は複数指定できます。複数指定する場合は，引数間を1バイト以上の空白文字で区切ります。

-w 作業用パス名

ジョブの実行時の作業用パス（カレントパス）名を絶対パスで指定します。

指定できる文字数は，1〜511（単位：バイト）です。省略した場合，次に示すディレクトリが仮定されます。

Windowsの場合

エージェントの環境設定に設定されている，エージェントプロセス実行時の作業用フォルダ。

UNIXの場合

ジョブ実行ユーザーのホームディレクトリ。

-shl シェルパス名

ジョブの起動シェルをフルパスで指定します。

指定できる文字数は，1〜511（単位：バイト）です。

起動シェルとは，スクリプトファイルをUNIXで実行するためのシェルです。

スクリプトファイルの先頭行に実行シェルを記述していない場合，このオプションに指定した起動シェルを使用します。実行シェルとは，起動シェルと同様にスクリプトファイルをUNIXで実行するためのシェルで，スクリプトファイルの先頭行に指定します。スクリプトファイルの先頭行に実行シェルを記述している場合は，このオプションに指定した起動シェルを使用しません。

起動シェルも実行シェルも指定されていない場合は，実行先のエージェントホストの，実行OSユーザーのログインシェル（/etc/passwdファイルの内容）を使用します。ログインシェルも定義されていない場合は，/bin/shを使用します。

-res 排他実行リソース名

複数のサブミットジョブの同時実行を抑止したい場合に，それぞれのサブミットジョブで同一の排他実行リソース名を指定します。

指定できる文字数は，1〜63（単位：バイト）です。

排他実行リソースの詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　11.4.1(7) サブミットジョブ実行時の排他制御（排他実行リソース）」を参照してください。

-st 実行開始日時

サブミットジョブの実行開始日時を，コマンドを実行するホストのローカル日時で指定します。過去の日時を指定すると，ジョブ実行開始日時は指定されなかったと仮定されます（登録後，サブミットジョブはすぐに実行待ちまたは実行中状態になります）。

日時の指定方法は5種類あります。

YYYY/MM/DD.hh:mm:ss

指定日時よりもあとにサブミットジョブを登録した場合，サブミットジョブはすぐに実行待ちまたは実行中状態になります。

曜日.hh:mm:ss

指定した曜日がサブミットジョブを登録した曜日と同じで，かつ，指定時刻よりもあとにサブミットジョブを登録した場合，サブミットジョブはすぐに実行待ちまたは実行中状態になります。

hh:mm:ss

指定時刻よりもあとにサブミットジョブを登録した場合，サブミットジョブはすぐに実行待ちまたは実行中状態になります。

YYYY/MM/DD

サブミットジョブの実行開始時刻には，指定日付の「00:00:00」が仮定されます。指定日付の00:00:00よりもあとにジョブをサブミットした場合，ジョブはすぐに実行待ちまたは実行中状態になります。

n

サブミットジョブを登録した日からn日後に実行待ちまたは実行中状態になります。

各値の意味を次に示します。

YYYY

西暦年を指定します。指定できる値は，1980〜2099（単位：西暦年）

MM

月を指定します。指定できる値は，01〜12（単位：月）です。

DD

日を指定します。指定できる値は，01〜31（単位：日）です。

hh

時を指定します。指定できる値は，00〜23（単位：時）です。

mm

分を指定します。指定できる値は，00〜59（単位：分）です。

ss

秒を指定します。指定できる値は，00〜59（単位：秒）です。

曜日

指定できる文字列は，sun，mon，tue，wed，thu，fri，satです。

n

日を指定します。指定できる値は，0〜366（単位：日）です。

-el 実行打ち切り時間

ジョブの実行が終了しない場合に，実行を打ち切る時間をサブミットジョブ実行開始時刻からの相対時間を分で指定します。

指定できる値は，1〜1,440（単位：分）です。

-si 標準入力ファイル名

ジョブ実行時に使用する標準入力ファイル名（ジョブを実行するエージェントホストに存在する標準入力ファイル名）を指定します。

指定できる文字数は，1〜511（単位：バイト）です。ファイル名は，絶対パスおよび相対パスで指定できます。相対パスで指定した場合，ジョブ実行時の作業用パスからの相対パスになります。

-rs {q|h|d}

ジョブ実行中に，ジョブを実行しているエージェントホストで障害が発生した場合，またはエージェントプロセスが異常終了した場合に，マネージャーホストがジョブの終了通知を受信できないことがあります。この場合に設定するジョブの回復状態を指定します。省略した場合は，保留状態になります。

q

実行待ち状態にします。

h

保留状態にします。

d

強制終了状態にします。

-so

ジョブ終了後に，ジョブ実行時の標準出力ファイルのデータをjpqjobgetコマンドで取得できるようにします。

-son 標準出力ファイル名

ジョブを実行するとき，エージェントホストに作成される標準出力ファイルに情報を上書きする場合に，ファイル名を指定します。

指定できる文字数は，1〜511（単位：バイト）です。ファイル名は，絶対パスおよび相対パスで指定できます。相対パスで指定した場合，ジョブ実行時の作業用パスからの相対パスになります。

標準出力ファイル名を定義する場合の注意事項については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　7.11.1 標準出力ファイル・標準エラー出力ファイルの注意事項」を参照してください。

-soa 標準出力ファイル名

ジョブを実行するとき，エージェントホストに作成される標準出力ファイルに情報を追加書きする場合に，ファイル名を指定します。

指定できる文字数は，1〜511（単位：バイト）です。ファイル名は，絶対パスおよび相対パスで指定できます。相対パスで指定した場合，ジョブ実行時の作業用パスからの相対パスになります。

標準出力ファイル名を定義する場合の注意事項については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　7.11.1 標準出力ファイル・標準エラー出力ファイルの注意事項」を参照してください。

-se

ジョブ終了後に，ジョブ実行時の標準エラー出力ファイルのデータをjpqjobgetコマンドで取得できるようにします。

-sen 標準エラー出力ファイル名

ジョブを実行するとき，エージェントホストに作成される標準エラー出力ファイルに情報を上書きする場合に，ファイル名を指定します。

指定できる文字数は，1〜511（単位：バイト）です。ファイル名は，絶対パスおよび相対パスで指定できます。相対パスで指定した場合，ジョブ実行時の作業用パスからの相対パスになります。

標準エラー出力ファイル名を定義する場合の注意事項については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　7.11.1 標準出力ファイル・標準エラー出力ファイルの注意事項」を参照してください。

-sea 標準エラー出力ファイル名

ジョブを実行するとき，エージェントホストに作成される標準エラー出力ファイルに情報を追加書きする場合に，ファイル名を指定します。

指定できる文字数は，1〜511（単位：バイト）です。ファイル名は，絶対パスおよび相対パスで指定できます。相対パスで指定した場合，ジョブ実行時の作業用パスからの相対パスになります。

標準エラー出力ファイル名を定義する場合の注意事項については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　7.11.1 標準出力ファイル・標準エラー出力ファイルの注意事項」を参照してください。

-ev 環境変数ファイル名

環境変数ファイルを使用する場合に，エージェントホストに存在する環境変数ファイル名を指定します。

指定できる文字数は，1〜511（単位：バイト）です。ファイル名は，絶対パスおよび相対パスで指定できます。相対パスで指定した場合，ジョブ実行時の作業用パスからの相対パスになります。

環境変数を定義する際の注意事項については，「付録A 環境変数および環境変数ファイルを定義する場合の注意事項」を参照してください。

-env 環境変数名=値

環境変数を指定します。

環境変数を指定する際の注意事項を次に示します。

このオプションに指定した環境変数と同一の環境変数が環境変数ファイル内に定義してある場合，このオプションに指定した内容が有効になります。

環境変数は複数指定できます。

複数指定する場合は，「-env 環境変数名=値」間を1バイト以上の空白文字で区切ります。指定値（「環境変数名=値」）部分の文字数の合計が20キロバイトまで指定できます。

-envオプションの指定例と総バイト数算出の考え方を次に示します。

（指定例）

-env△a=1△-env△b=2△-env△C=3

（凡例）

△：1バイトの空白文字

（総バイト数算出の考え方）

この例の場合，下線部のバイト数の合計に，2バイトを足した値（13バイト）が総バイト数になります。

環境変数を定義する際の注意事項については，「付録A 環境変数および環境変数ファイルを定義する場合の注意事項」を参照してください。

-h

サブミットジョブを登録したときに，ジョブを保留状態にします。

-t 転送元ファイル名 [=転送先ファイル名]

ジョブ実行時にジョブの実行に関連するファイルを参照する場合に，転送するファイル名を指定します。必要に応じて，転送先で使用するファイル名も指定します。ただし，JP1/OJE for VOS3連携時は，転送先ファイル名を必ず指定してください。

転送元ファイルには，ジョブのサブミット元ホストにあるファイルを指定します。転送元ファイルは，エージェントホストおよびJP1/OJE for VOS3ホストに，転送先ファイル名で指定したファイル名として転送されます。また，転送先ファイル名を指定した場合は，ジョブの実行が終了したあとに転送先ファイルは削除されません。

転送先ファイル名に指定できる文字数は，1〜511（単位：バイト）です。ファイル名は，絶対パスおよび相対パスで指定できます。相対パスで指定した場合，ジョブ実行時の作業用パスからの相対パスになります。

転送先ファイル名を省略した場合，$JP1AJS2_JPQTEMPxx$変数が仮定されます（xxは，転送ファイルの番号で，01〜32の値）。-argオプションにこの変数を指定すると，ジョブ実行時に，転送先ファイル名を意識しないで，そのファイルを使用できます。また，ジョブの実行が終了したあとは，一時的に作成した転送先ファイルが削除されます。

実行ホストがWindowsの場合は，-scオプションにこの変数を指定することはできません。指定すると，ジョブの起動に失敗します。

実行ホストがUNIXの場合は，-scオプションにこの変数を指定してジョブを実行できます。

このオプションは，-tdオプションと合わせて32個まで同時に指定できます。

-tdオプションの説明も参照してください。

-td 転送元ファイル名 [=転送先ファイル名]

ジョブ実行時にジョブの実行に関連するファイルを参照する場合に，転送するファイル名を指定します（必要に応じて，転送先で使用するファイル名も指定します）。このオプションは，-tオプションと異なり，ジョブの実行が終了したあとに，転送先ホスト上の転送先ファイルを削除します。

転送元ファイルには，ジョブのサブミット元ホストにあるファイルを指定します。転送元ファイルは，エージェントホストに転送先ファイル名で指定したファイル名として転送されます。

転送先ファイル名に指定できる文字数は，1〜511（単位：バイト）です。ファイル名は，絶対パスおよび相対パスで指定できます。相対パスで指定した場合，ジョブ実行時の作業用パスからの相対パスになります。

転送先ファイル名を省略した場合，$JP1AJS2_JPQTEMPxx$変数が仮定されます（xxは，転送ファイルの番号で，01〜32の値）。-argオプションにこの変数を指定すると，ジョブの実行時に，転送先のファイル名を意識しないで，そのファイルを使用できます。また，ジョブの実行が終了したあとは，一時的に作成した転送先ファイルが削除されます。

実行ホストがWindowsの場合は，-scオプションにこの変数を指定することはできません。指定すると，ジョブの起動に失敗します。

実行ホストがUNIXの場合は，-scオプションにこの変数を指定してジョブを実行できます。

このオプションは，-tオプションと合わせて32個まで同時に指定できます。

注意事項

コマンドの引数にリダイレクトを指定しないでください。標準出力ファイルを出力する場合は，-so，-son，または-soaオプションを指定してください。標準エラー出力ファイルを出力する場合は，-se，-sen，または-seaオプションを指定してください。上記のオプションとリダイレクトを併用すると，ジョブ情報が正しく取得できない場合があります。

複数のジョブを1台のエージェントホストで同時実行する場合に，標準出力ファイル名，標準エラー出力ファイル名，転送先ファイル名に同じ名称を指定すると，指定したファイルが壊れ，ジョブが実行できなくなる場合があります。

ジョブ登録時の転送ファイルやジョブ情報取得時に取得する結果ファイルで数メガバイトのファイルを転送すると，要求が失敗したり時間が掛かったりする場合があります。

標準入力ファイル，標準出力ファイル，標準エラー出力ファイル，または転送ファイルとして指定できるファイルは，テキスト形式のファイルだけです。

JP1/AJS3では，マネージャーホストからエージェントホストにファイル転送をした場合，文字コードを変換します。また，エージェントホストからマネージャーホストに結果ファイル（標準入力ファイル・標準出力ファイル・標準エラー出力ファイル）を転送した場合も，文字コードを変換します。どちらの場合も，変換する文字コードは，転送先のJP1/AJS3サービスの文字コードです。実行ユーザーの文字コードではありません。

例えば，マネージャーホストのJP1/AJS3サービスを日本語シフトJISで，エージェントホストのJP1/AJS3サービスを日本語EUCで起動し，マネージャーホスト上の転送先ファイルを日本語シフトJISで作成した場合，このファイルをエージェントホストに転送すると，日本語EUCでファイルが作成されます。

なお，JP1/AJS3の文字コードの設定については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　13.4.1 言語環境の設定」の文字コード種別の変更の説明を参照してください。

標準入力ファイル，標準出力ファイル，標準エラー出力ファイル，または転送ファイルに含まれるデータ中に使用できる文字については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.4.2(7)(a) 使用できる文字の範囲」を参照してください。

JP1/OJE for VOS3と連携する場合に指定できるオプションを次に示します。これら以外のオプションを指定した場合，その指定は無視されます。

-mh

-q

-jn

-sc

-arg

-t

戻り値

0

正常終了。

1

引数の指定が不適切である。

2

サブミット要求元のホストの内部的要因で，サブミットジョブの登録に失敗した。

5

初期化に失敗した。

論理ホスト名の定義または共通定義情報に誤りがある。

6

サブミット要求元のホストでメモリー不足が発生した。

7

サブミット要求元のホストで論理不正が発生した。

8

転送元ファイルのファイルパスがない，または転送元ファイルがないため，ファイルを開けない。

9

転送元ファイルへのアクセス権がないため，ファイルを開けない。

10

転送元ファイルが他プロセスで使用されているため，ファイルを開けない。

11

戻り値8，9，10以外の要因で，転送元ファイルを開けない。

12

戻り値8，9，10以外の要因で，転送元ファイルの読み込みに失敗した。

100

TCP/IP通信でマネージャーホストに接続できない。

TCP/IPが正しく設定されていないため，マネージャーホストに接続できない。

マネージャーホストのホスト名に誤りがある。または，マネージャーホストがプロセス停止状態である。

102

マネージャーホスト名によるIPアドレスの解決に失敗した。

200

マネージャーホストがサブミットジョブの登録を受け付けない。

マネージャーホストが運用開始処理中，運用停止処理中，運用停止中，または縮退運転中である。

201

指定したキューが使用できない。

指定したキューがない。

202

マネージャーホストから応答がない。

203

マネージャーホスト側の内部的要因で，サブミットジョブの登録に失敗した。

204

指定したキューが閉じられている。

205

指定したキューのサブミットジョブ数がすでに最大値に達しているため，サブミットジョブを登録できない。

206

ジョブをサブミットする権限がない。

219

マネージャーホストがビジー状態である。

220

マネージャーホスト側でメモリー不足が発生した。

221

JP1/OJE for VOS3のユーザー情報が不適切である。

222

致命的なエラーが発生した。

システムコールでエラーが発生した。

223

マネージャーホスト側で論理不正が発生した。

225

サブミットジョブ登録後にエラーが発生した。

（サブミットジョブの登録は正常に終了した。ただし，サブミット先のマネージャーホストからジョブ番号が返されないため，そのジョブに対してジョブ番号を使った操作（ジョブの保留やキャンセルなど）ができない。）

226

実行環境が不適切である。

227

ジョブ実行環境データベースで，すでに同じIDのジョブ情報がある。

228

マネージャーホストで転送先ファイルの作成に失敗した。

229

マネージャーホストで転送先ファイルの書き込みに失敗した。

241

エージェントの自動定義に失敗した。

jpqqueadd

形式

jpqqueadd
     [-mh マネージャーホスト名]
     -q キュー名
     [-mj キュー内のジョブ数の最大値]
     [-wj キュー内のジョブ数の警告値]
     [-en {open|close}]
     [-ex {open|close}]

機能

キューを追加します。

実行権限

次に示すJP1権限レベルを与えられたユーザー

JP1_JPQ_Admin権限

引数

-mh マネージャーホスト名

キューを追加したいマネージャーホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，自ホスト名が仮定されます。

-q キュー名

追加したいキュー名を指定します。

指定できる文字数は，1〜63（単位：バイト）です。

エージェント名は大文字・小文字が区別されませんが，キュー名は大文字・小文字が区別されるので注意してください。

-mj キュー内のジョブ数の最大値

キューにためておけるジョブ数の最大値を指定します。

指定できる値は，1〜4,294,967,295です。

省略した場合，4,294,967,295が仮定されます。

この設定は，実際に実行中になったジョブも含みます。ジョブ数は，jpqqueshowコマンドの-qオプションで表示される「QUEUING」と「EXECUTING」の両方を合わせた値です。

この設定にかかわらず，システム内の最大ジョブ数と同数のジョブがキュー中に残っていると，サブミットに失敗してしまいます。

-wj キュー内のジョブ数の警告値

キュー内のジョブ数が，キューにためておけるジョブ数の最大値に近づいたことを知らせる警告値を指定します。

指定できる値は，1〜4,294,967,295で，かつ，-mjオプションに指定した値と同じ値か，またはそれより小さい値です。

この設定は，実際に実行中になったジョブも含みます。ジョブ数は，jpqqueshowコマンドの-qオプションで表示される「QUEUING」と「EXECUTING」の両方を合わせた値です。

省略した場合，-mjオプションに指定した値が仮定されます。-mjオプションを指定していない場合は，4,294,967,295が仮定されます。

-en {open|close}

キューの，ジョブの受付口の状態を指定します。

open

受付口を開きます。

close

受付口を閉じます。

省略した場合，openが仮定されます。

-ex {open|close}

キューの，ジョブの取出口の状態を指定します。

open

取出口を開きます。

close

取出口を閉じます。

省略した場合，openが仮定されます。

注意事項

このコマンドは，JP1/AJS3からJP1/OJE for VOS3への要求には使用できません。

戻り値

0

正常終了。

1

引数の指定が不適切である。

2

キューの追加依頼側の内部的要因で，キューの追加に失敗した。

5

初期化に失敗した。

論理ホスト名の定義または環境設定に誤りがある。

6

キューの追加依頼側でメモリー不足が発生した。

7

キューの追加依頼側で論理不正が発生した。

100

TCP/IP通信でマネージャーホストに接続できない。

TCP/IPが正しく設定されていないため，マネージャーホストに接続できない。

マネージャーホスト名に誤りがある。または，マネージャーホストがプロセス停止状態である。

102

マネージャーホスト名によるIPアドレスの解決に失敗した。

200

マネージャーホストがキューの追加を受け付けない。

マネージャーホストが運用開始処理中，運用停止処理中，運用停止中，または縮退運転中である。

202

マネージャーホストから応答がない。

203

マネージャーホスト側の内部的要因で，キューの追加に失敗した。

206

キューを追加する権限がない。

219

マネージャーホストがビジー状態である。

220

マネージャーホストでメモリー不足が発生した。

222

致命的なエラーが発生した。

システムコールでエラーが発生した。

223

マネージャーホスト側で論理不正が発生した。

224

JP1/AJS3以外のホストに要求した。

226

実行環境が不適切である。

232

追加したキューと同じ名称のキューがすでにある。

235

キューの最大定義数を超える。

jpqquealt

形式

jpqquealt
     [-mh マネージャーホスト名]
     {-q キュー名|-ah エージェントホスト名}
     {[-mj キュー内のジョブ数の最大値]|
          [-wj キュー内のジョブ数の警告値]|
          [-nq 変更後のキュー名]}
     [-em]

機能

キューの定義を変更します。

実行権限

次に示すJP1権限レベルを与えられたユーザー

JP1_JPQ_Admin権限

ただし，-emオプションを指定する場合は次の権限が必要です（JP1_JPQ_Admin権限は必要ありません）。

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-mh マネージャーホスト名

定義を変更したいキューが作成されているマネージャーホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，自ホスト名が仮定されます。

-emオプションと同時に指定する場合，指定できるホスト名は，自ホスト名または自ホスト上の論理ホスト名だけです。それ以外の値が指定された場合はエラー（エラーコード25）となります。また，-mhオプションにエイリアスホスト名を指定することはできません。

-q キュー名

定義を変更したいキュー名を指定します。

指定できる文字数は，1〜63（単位：バイト）です。

-ah エージェントホスト名

デフォルトキューの定義を変更したい場合に，マネージャーホストに登録したエージェントホスト名を指定します。デフォルトキューは，エージェントホストを登録した際にエージェントホスト名と同じ名前で作成されるキューです。

指定できる文字数は，1〜255（単位：バイト）です。

-nqオプションと同時には指定できません（デフォルトキューの名称は変更できません）。

-mj キュー内のジョブ数の最大値

キューにためておけるジョブ数の最大値を指定します。

指定できる値は，1〜4,294,967,295です。

この設定は，実際に実行中になったジョブも含みます。ジョブ数は，jpqqueshowコマンドの-qオプションで表示される「QUEUING」と「EXECUTING」の両方を合わせた値です。

省略した場合，ジョブ数の最大値は変更されません。

-wj キュー内のジョブ数の警告値

キュー内のジョブ数が，キューにためておけるジョブ数の最大値に近づいたことを知らせる警告値を指定します。

指定できる値は，1〜4,294,967,295で，かつ，-mjオプションに指定した値と同じ値か，またはそれより小さい値です。

この設定は，実際に実行中になったジョブも含みます。ジョブ数は，jpqqueshowコマンドの-qオプションで表示される「QUEUING」と「EXECUTING」の両方を合わせた値です。

省略した場合，警告値は変更されません。

-nq 変更後のキュー名

キューの名称を変更する場合に，変更後の名称を指定します。

指定できる文字数は，1〜63（単位：バイト）です。

省略した場合，キュー名は変更されません。

このオプションは，-qオプションを指定した場合にだけ指定できます。-ahオプションと同時には指定できません（デフォルトキューの名称は変更できません）。

-em

緊急実行時に指定します。

このオプションを指定すると，通常とは異なる通信経路に対して要求するため，障害時などに緊急で実行できるようになります。

なお，このオプションを指定する場合，マネージャーホスト名にIPアドレスは指定できません。

注意事項

このコマンドは，JP1/AJS3からJP1/OJE for VOS3への要求には使用できません。

-mj，-wj，または-nqオプションのうち，必ず一つ以上を指定してください。

-mjオプションに指定するジョブ数の最大値と，-wjオプションに指定するジョブ数の警告値の関係は，「最大値＝警告値」または「最大値＞警告値」です。

ジョブ数の最大値，または警告値を変更する場合，現在設定されている最大値，警告値と比較されます。つまり，-mjオプションで最大値だけを変更する場合は，現在のジョブ数の警告値と同じ値か，またはそれより大きい値を指定してください。-wjオプションで警告値だけを変更する場合は，現在のジョブ数の最大値と同じ値か，またはそれより小さい値を指定してください。

ジョブ数の最大値を，現在キューイングされているジョブ数よりも少ない値に変更した場合でも，キューイングされているジョブは実行されます。ただし，キューイングされているジョブ数が，変更後のジョブ数の最大値を下回るまで，新たなジョブは受け付けられません。

具体的には，現在のキューイングジョブ数が12である場合に，ジョブ数の最大値を10に変更したとき，12個のジョブは実行されますが，キューイングされているジョブが9個以下になるまで，新たなジョブは受け付けられません。

キュー内にジョブが残っているときにキュー名を変更すると，エラーになります。

デフォルトキューの名称は変更できません。

-emオプションは，エージェントホストの障害から復旧する目的でだけ指定してください。常に-emオプションを指定して運用する場合，障害発生時に対応できなくなるおそれがあります。

戻り値

0

正常終了。

1

引数の指定が不適切である。

2

jpqquealtコマンドを実行したホストの内部的要因で，キュー定義の変更に失敗した。

5

初期化に失敗した。

論理ホスト名の定義または環境設定に誤りがある。

6

jpqquealtコマンドを実行したホストでメモリー不足が発生した。

7

jpqquealtコマンドを実行したホストで論理不正が発生した。

25

マネージャーホスト名の指定に自ホスト名および論理ホスト名以外を指定した。

100

TCP/IP通信でjpqquealtコマンドを実行したホストからマネージャーホストに接続できない。

TCP/IPが正しく設定されていないため，jpqquealtコマンドを実行したホストからマネージャーホストに接続できない。

マネージャーホスト名に誤りがある。または，マネージャーホストがプロセス停止状態である。

102

jpqquealtコマンドを実行したホストでマネージャーホスト名のIPアドレスの解決に失敗した。

200

マネージャーホストがキュー定義の変更を受け付けない。

マネージャーホストが運用開始処理中，運用停止処理中，運用停止中，または縮退運転中である。

201

指定したキューが使用できない。

指定したキューがない。

202

マネージャーホストから応答がない。

203

マネージャーホストの内部的要因で，キュー定義の変更に失敗した。

206

キュー定義を変更する権限がない。

219

マネージャーホストがビジー状態である。

220

マネージャーホストでメモリー不足が発生した。

222

致命的なエラーが発生した。

システムコールでエラーが発生した。

223

マネージャーホストで論理不正が発生した。

224

JP1/AJS3以外のホストに要求した。

226

実行環境が不適切である。

232

名称変更後のキューと同じ名称のキューがすでにある。

233

キュー名変更時に，キュー内にジョブがある。

237

ジョブ数の警告値が，ジョブ数の最大値よりも大きい。

238

ジョブ数の最大値が，ジョブ数の警告値よりも小さい。

jpqqueclose

形式

jpqqueclose
     [-mh マネージャーホスト名]
     {-q キュー名|-ah エージェントホスト名}
     [{-en|-ex}]
     [-em]

機能

キューの，ジョブの受付口または取出口を閉じます。

実行権限

次に示すJP1権限レベルのどちらかを与えられたユーザー

JP1_JPQ_Admin権限

JP1_JPQ_Operator権限

ただし，-emオプションを指定する場合は次の権限が必要です（JP1_JPQ_Admin権限，JP1_JPQ_Operator権限は必要ありません）。

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-mh マネージャーホスト名

閉じたいキューがあるマネージャーホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，自ホスト名が仮定されます。

-emオプションと同時に指定する場合，指定できるホスト名は，自ホスト名または自ホスト上の論理ホスト名だけです。それ以外の値が指定された場合はエラー（エラーコード25）となります。また，-mhオプションにエイリアスホスト名を指定することはできません。

-q キュー名

閉じたいキュー名を指定します。

指定できる文字数は，1〜63（単位：バイト）です。

-ah エージェントホスト名

デフォルトキューを閉じたい場合に，マネージャーホストに登録したエージェントホスト名を指定します。デフォルトキューはエージェントホストを登録した際にエージェントホスト名と同じ名前で作成されるキューです。

指定できる文字数は，1〜255（単位：バイト）です。

-en

ジョブの受付口を閉じます。

-ex

ジョブの取出口を閉じます。

-em

緊急実行時に指定します。

このオプションを指定すると，通常とは異なる通信経路に対して要求するため，障害時などに緊急で実行できるようになります。

なお，このオプションを指定する場合，マネージャーホスト名にIPアドレスは指定できません。

注意事項

このコマンドは，JP1/AJS3からJP1/OJE for VOS3への要求には使用できません。

-emオプションは，エージェントホストの障害から復旧する目的でだけ指定してください。常に-emオプションを指定して運用する場合，障害発生時に対応できなくなるおそれがあります。

戻り値

0

正常終了。

1

引数の指定が不適切である。

2

jpqquecloseコマンドを実行したホストの内部的要因で，キューのクローズに失敗した。

5

初期化に失敗した。

論理ホスト名の定義または環境設定に誤りがある。

6

jpqquecloseコマンドを実行したホストでメモリー不足が発生した。

7

jpqquecloseコマンドを実行したホストで論理不正が発生した。

25

マネージャーホスト名の指定に自ホスト名および論理ホスト名以外を指定した。

100

TCP/IP通信でjpqquecloseコマンドを実行したホストからマネージャーホストに接続できない。

TCP/IPが正しく設定されていないため，jpqquecloseコマンドを実行したホストからマネージャーホストに接続できない。

マネージャーホスト名に誤りがある。または，マネージャーホストがプロセス停止状態である。

102

jpqquecloseコマンドを実行したホストでマネージャーホスト名のIPアドレスの解決に失敗した。

200

マネージャーホストがキューのクローズを受け付けない。

マネージャーホストが運用開始処理中，運用停止処理中，運用停止中，または縮退運転中である。

201

指定したキューが使用できない。

指定したキューがない。

202

マネージャーホストから応答がない。

203

マネージャーホストの内部的要因で，キューのクローズに失敗した。

206

キューをクローズする権限がない。

219

マネージャーホストがビジー状態である。

220

マネージャーホストでメモリー不足が発生した。

222

致命的なエラーが発生した。

システムコールでエラーが発生した。

223

マネージャーホストで論理不正が発生した。

224

JP1/AJS3以外のホストに要求した。

226

実行環境が不適切である。

補足事項

キューが閉じられている場合でも，キュー内のジョブを削除したり，保留・保留解除したりできます。

jpqquedel

形式

jpqquedel
     [-mh マネージャーホスト名]
     -q キュー名

機能

キューを削除します。

実行権限

次に示すJP1権限レベルを与えられたユーザー

JP1_JPQ_Admin権限

引数

-mh マネージャーホスト名

キューを削除したいマネージャーホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，自ホスト名が仮定されます。

-q キュー名

削除したいキュー名を指定します。

指定できる文字数は，1〜63（単位：バイト）です。

注意事項

このコマンドは，JP1/AJS3からJP1/OJE for VOS3への要求には使用できません。

このコマンドを実行する前に，jpqquecloseコマンドなどを使って，削除したいキューのジョブ受付口を閉じ，新たなジョブを受け付けない状態にしておいてください。また，キュー内のジョブの終了を確認してください。

実行中のジョブ（標準ジョブ（PCジョブ，UNIXジョブ，およびQUEUEジョブ），カスタムジョブ，またはアクションジョブ）がある場合，キューは削除できません。

キューを削除すると，キュー内の実行待ち，保留，および時間待ち状態のジョブは，キャンセル終了します。

戻り値

0

正常終了。

1

引数の指定が不適切である。

2

キューの削除依頼側の内部的要因で，キューの削除に失敗した。

5

初期化に失敗した。

論理ホスト名の定義または環境設定に誤りがある。

6

キューの削除依頼側でメモリー不足が発生した。

7

キューの削除依頼側で論理不正が発生した。

100

TCP/IP通信でマネージャーホストに接続できない。

TCP/IPが正しく設定されていないため，マネージャーホストに接続できない。

マネージャーホスト名に誤りがある。または，マネージャーホストがプロセス停止状態である。

102

マネージャーホスト名によるIPアドレスの解決に失敗した。

200

マネージャーホストがキューの削除を受け付けない。

マネージャーホストが運用開始処理中，運用停止処理中，運用停止中，または縮退運転中である。

201

指定したキューが使用できない。

指定したキューがない。

202

マネージャーホストから応答がない。

203

マネージャーホスト側の内部的要因で，キューの削除に失敗した。

206

キューを削除する権限がない。

219

マネージャーホストがビジー状態である。

220

マネージャーホストでメモリー不足が発生した。

222

致命的なエラーが発生した。

システムコールでエラーが発生した。

223

マネージャーホスト側で論理不正が発生した。

224

JP1/AJS3以外のホストに要求した。

226

実行環境が不適切である。

233

実行中のジョブ（標準ジョブ，カスタムジョブ，またはアクションジョブ）がある。

jpqqueopen

形式

jpqqueopen
     [-mh マネージャーホスト名]
     {-q キュー名|-ah エージェントホスト名}
     [{-en|-ex}]
     [-em]

機能

キューの，ジョブの受付口または取出口を開きます。

実行権限

次に示すJP1権限レベルのどちらかを与えられたユーザー

JP1_JPQ_Admin権限

JP1_JPQ_Operator権限

ただし，-emオプションを指定する場合は次の権限が必要です（JP1_JPQ_Admin権限，JP1_JPQ_Operator権限は必要ありません）。

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-mh マネージャーホスト名

開きたいキューがあるマネージャーホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，自ホスト名が仮定されます。

-emオプションと同時に指定する場合，指定できるホスト名は，自ホスト名または自ホスト上の論理ホスト名だけです。それ以外の値が指定された場合はエラー（エラーコード25）となります。また，-mhオプションにエイリアスホスト名を指定することはできません。

-q キュー名

開きたいキュー名を指定します。

指定できる文字数は，1〜63（単位：バイト）です。

-ah エージェントホスト名

デフォルトキューを開きたい場合に，マネージャーホストに登録したエージェントホスト名を指定します。デフォルトキューはエージェントホストを登録した際にエージェントホスト名と同じ名前で作成されるキューです。

指定できる文字数は，1〜255（単位：バイト）です。

-en

ジョブの受付口を開きます。

-ex

ジョブの取出口を開きます。

-em

緊急実行時に指定します。

このオプションを指定すると，通常とは異なる通信経路に対して要求するため，障害時などに緊急で実行できるようになります。

なお，このオプションを指定する場合，マネージャーホスト名にIPアドレスは指定できません。

注意事項

このコマンドは，JP1/AJS3からJP1/OJE for VOS3への要求には使用できません。

-emオプションは，エージェントホストの障害から復旧する目的でだけ指定してください。常に-emオプションを指定して運用する場合，障害発生時に対応できなくなるおそれがあります。

戻り値

0

正常終了。

1

引数の指定が不適切である。

2

jpqqueopenコマンドを実行したホストの内部的要因で，キューのオープンに失敗した。

5

初期化に失敗した。

論理ホスト名の定義または環境設定に誤りがある。

6

jpqqueopenコマンドを実行したホストでメモリー不足が発生した。

7

jpqqueopenコマンドを実行したホストで論理不正が発生した。

25

マネージャーホスト名の指定に自ホスト名および論理ホスト名以外を指定した。

100

TCP/IP通信でjpqqueopenコマンドを実行したホストからマネージャーホストに接続できない。

TCP/IPが正しく設定されていないため，jpqqueopenコマンドを実行したホストからマネージャーホストに接続できない。

マネージャーホスト名に誤りがある。または，マネージャーホストがプロセス停止状態である。

102

jpqqueopenコマンドを実行したホストでマネージャーホスト名のIPアドレスの解決に失敗した。

200

マネージャーホストがキューのオープンを受け付けない。

マネージャーホストが運用開始処理中，運用停止処理中，運用停止中，または縮退運転中である。

201

指定したキューが使用できない。

指定したキューがない。

202

マネージャーホストから応答がない。

203

マネージャーホストの内部的要因で，キューのオープンに失敗した。

206

キューをオープンする権限がない。

219

マネージャーホストがビジー状態である。

220

マネージャーホストでメモリー不足が発生した。

222

致命的なエラーが発生した。

システムコールでエラーが発生した。

223

マネージャーホストで論理不正が発生した。

224

JP1/AJS3以外のホストに要求した。

226

実行環境が不適切である。

jpqqueshow

形式

jpqqueshow
     [-mh マネージャーホスト名]
     {-q キュー名|-ah エージェントホスト名|-a|-ad|-n}
     [-em]

機能

キュー情報（キュー名，サブミットジョブ数の最大値・警告値，サブミットジョブ数など）を標準出力に出力します。

JP1/OJE for VOS3ホストのキュー情報も出力できます。

また，AS/400システムのキュー情報も出力できます。なお，AS/400システムに対して指定できるのは，-mh，-nオプションだけです。

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

JP1_JPQ_Admin権限

JP1_JPQ_Operator権限（-adオプションは指定不可）

JP1_JPQ_User権限（-adオプションは指定不可）

ただし，-emオプションを指定する場合は次の権限が必要です（JP1_JPQ_Admin権限，JP1_JPQ_Operator権限，JP1_JPQ_User権限は必要ありません）。

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

引数

-mh マネージャーホスト名

キュー情報を出力したいキューがあるマネージャーホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，自ホスト名が仮定されます。

-emオプションと同時に指定する場合，指定できるホスト名は，自ホスト名または自ホスト上の論理ホスト名だけです。それ以外の値が指定された場合はエラー（エラーコード25）となります。また，-mhオプションにエイリアスホスト名を指定することはできません。

-q キュー名

キュー情報を出力したいキュー名を指定します。

指定できる文字数は，1〜63（単位：バイト）です。

このオプションは，JP1/AJS3からJP1/OJE for VOS3への要求には指定できません。

-ah エージェントホスト名

デフォルトキュー情報を出力したい場合に，マネージャーホストに登録したエージェントホスト名を指定します。デフォルトキューはエージェントホストを登録した際にエージェントホスト名と同じ名前で作成されるキューです。

指定できる文字数は，1〜255（単位：バイト）です。

このオプションは，JP1/AJS3からJP1/OJE for VOS3への要求には指定できません。

-a

-mhオプションに指定したマネージャーホストの，すべてのキュー情報を出力します（ただし，デフォルトキューの情報は除く）。

このオプションは，JP1/AJS3からJP1/OJE for VOS3への要求には指定できません。

-ad

-mhオプションに指定したマネージャーホストの，すべてのキュー情報を出力します（デフォルトキューの情報を含む）。

このオプションは，JP1_JPQ_Admin権限を持つユーザーだけが指定できます。JP1/AJS3からJP1/OJE for VOS3への要求には指定できません。

-n

キュー情報として，-mhオプションに指定したマネージャーホスト内の，すべてのキュー名を出力します（ただし，デフォルトキューの情報は除く）。

-em

緊急実行時に指定します。

このオプションを指定すると，通常とは異なる通信経路に対して要求するため，障害時などに緊急で実行できるようになります。

なお，このオプションを指定する場合，マネージャーホスト名にIPアドレスは指定できません。

注意事項

-a，-adオプションの場合，キュー名として出力できるバイト数は21バイトです。キュー名が22バイト以上の場合，20バイト以降は「..」になります。

-emオプションは，エージェントホストの障害から復旧する目的でだけ指定してください。常に-emオプションを指定して運用する場合，障害発生時に対応できなくなるおそれがあります。

戻り値

0

正常終了。

1

引数の指定が不適切である。

2

jpqqueshowコマンドを実行したホストの内部的要因で，キュー情報の出力に失敗した。

5

初期化に失敗した。

論理ホスト名の定義または環境設定に誤りがある。

6

jpqqueshowコマンドを実行したホストでメモリー不足が発生した。

7

jpqqueshowコマンドを実行したホストで論理不正が発生した。

25

マネージャーホスト名の指定に自ホスト名および論理ホスト名以外を指定した。

100

TCP/IP通信でjpqqueshowコマンドを実行したホストからマネージャーホストに接続できない。

TCP/IPが正しく設定されていないため，jpqqueshowコマンドを実行したホストからマネージャーホストに接続できない。

マネージャーホスト名に誤りがある。または，マネージャーホストがプロセス停止状態である。

102

jpqqueshowコマンドを実行したホストでマネージャーホスト名のIPアドレスの解決に失敗した。

200

マネージャーホストがキュー情報の出力を受け付けない。

マネージャーホストが運用開始処理中，運用停止処理中，運用停止中，または縮退運転中である。

201

指定したキューが使用できない。

指定したキューがない。

202

マネージャーホストから応答がない。

203

マネージャーホストの内部的要因で，キュー情報の出力に失敗した。

206

キュー情報を出力する権限がない。

212

エージェントホスト，またはキューの追加・変更処理中のため，キュー情報の出力に失敗した。

213

マネージャーホストにキューがない。

219

マネージャーホストがビジー状態である。

220

マネージャーホストでメモリー不足が発生した。

222

致命的なエラーが発生した。

システムコールでエラーが発生した。

223

マネージャーホストで論理不正が発生した。

224

サポートしていないホストにキュー情報の出力を依頼した。

226

実行環境が不適切である。

出力例1

-q，または-ahオプションを指定した場合のファイル出力例と出力内容の意味を次に示します。

出力内容の意味を次に示します。

QUEUE

キューの情報を，「キュー種別:キュー名（または，エージェントホスト名）」の形式で示します。

キュー種別は次のとおりです。

q：キュー

a：エージェントホスト

MAXQUEUE

サブミットジョブ数の最大値を示します。

10バイト分出力されます。

WARNQUEUE

サブミットジョブ数の警告値を示します。

10バイト分出力されます。

ENTRYSTATUS

ジョブの受付口の状態を示します。

OPEN：開いている

CLOSE：閉じている

EXITSTATUS

ジョブの取出口の状態を示します。

OPEN：開いている

CLOSE：閉じている

QUEUING

現在のサブミットジョブ数（現在実行中のジョブ数を除く）を示します。

EXECUTING

現在実行中のジョブ数を示します。

LINKAGENT

接続されているエージェントホストの情報を，「接続されているエージェントホスト名:優先順位」の形式で示します。

出力例2

-a，または-adオプションを指定した場合のファイル出力例と出力内容の意味を次に示します。

出力内容の意味を次に示します。

T

キュー種別を示します。

q：キュー

a：エージェントホスト

QUEUE

キュー名（または，エージェントホスト名）を示します。

21バイト分出力されます。

MAXQUEUE

サブミットジョブ数の最大値を示します。

WARNQUEUE

サブミットジョブ数の警告値を示します。

ENT

ジョブの受付口の状態を示します。

OPEN：開いている

CLOSE：閉じている

EXIT

ジョブの取出口の状態を示します。

OPEN：開いている

CLOSE：閉じている

QUEUING

現在のサブミットジョブ数（現在実行中のジョブ数を除く）を示します。

EXECUTING

現在実行中のジョブ数を示します。

出力例3

-nオプションを指定した場合のファイル出力例と出力内容の意味を次に示します。

出力内容の意味を次に示します。

QUEUE

キュー名を示します。

jpqresadd

形式

jpqresadd
     [-mh マネージャーホスト名]
     -res 排他実行リソース名

機能

排他実行リソースを追加します。

実行権限

次に示すJP1権限レベルを与えられたユーザー

JP1_JPQ_Admin権限

引数

-mh マネージャーホスト名

排他実行リソースを追加したいマネージャーホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，自ホスト名が仮定されます。

-res 排他実行リソース名

追加したい排他実行リソース名を指定します。

指定できる文字数は，1〜63（単位：バイト）です。

排他実行リソース名に空白文字を含める場合は，排他実行リソース名を「"」で囲んでください。

注意事項

このコマンドは，JP1/AJS3からJP1/OJE for VOS3への要求には使用できません。

戻り値

0

正常終了。

1

引数の指定が不適切である。

2

排他実行リソースの追加依頼側の内部的要因で，排他実行リソースの追加に失敗した。

5

初期化に失敗した。

論理ホスト名の定義または環境設定に誤りがある。

6

排他実行リソースの追加依頼側でメモリー不足が発生した。

7

排他実行リソースの追加依頼側で論理不正が発生した。

100

TCP/IP通信でマネージャーホストに接続できない。

TCP/IPが正しく設定されていないため，マネージャーホストに接続できない。

マネージャーホスト名に誤りがある。または，マネージャーホストがプロセス停止状態である。

102

マネージャーホスト名によるIPアドレスの解決に失敗した。

200

マネージャーホストが排他実行リソースの追加を受け付けない。

マネージャーホストが運用開始処理中，運用停止処理中，運用停止中，または縮退運転中である。

202

マネージャーホストから応答がない。

203

マネージャーホスト側の内部的要因で，排他実行リソースの追加に失敗した。

206

排他実行リソースを追加する権限がない。

219

マネージャーホストがビジー状態である。

220

マネージャーホストでメモリー不足が発生した。

222

致命的なエラーが発生した。

システムコールでエラーが発生した。

223

マネージャーホスト側で論理不正が発生した。

224

JP1/AJS3以外のホストに要求した。

226

実行環境が不適切である。

232

追加した排他実行リソースと同じ名称の排他実行リソースがすでにある。

235

排他実行リソースの最大定義数を超える。

jpqresdel

形式

jpqresdel
     [-mh マネージャーホスト名]
     -res 排他実行リソース名

機能

排他実行リソースを削除します。

実行権限

次に示すJP1権限レベルを与えられたユーザー

JP1_JPQ_Admin権限

引数

-mh マネージャーホスト名

排他実行リソースを削除したいマネージャーホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，自ホスト名が仮定されます。

-res 排他実行リソース名

削除したい排他実行リソース名を指定します。

指定できる文字数は，1〜63（単位：バイト）です。

注意事項

このコマンドは，JP1/AJS3からJP1/OJE for VOS3への要求には使用できません。

削除対象の排他実行リソースを使用したジョブが実行前の場合，このコマンドを実行できます（ただし，ジョブ実行時，排他実行制御は無効になります）。

削除対象の排他実行リソースを使用したジョブが実行中の場合，このコマンドはエラーになります。

戻り値

0

正常終了。

1

引数の指定が不適切である。

2

jpqresdelコマンドを実行したホストの内部的要因で，排他実行リソースの削除に失敗した。

5

初期化に失敗した。

論理ホスト名の定義または環境設定に誤りがある。

6

jpqresdelコマンドを実行したホストでメモリー不足が発生した。

7

jpqresdelコマンドを実行したホストで論理不正が発生した。

100

TCP/IP通信でjpqresdelコマンドを実行したホストからマネージャーホストに接続できない。

TCP/IPが正しく設定されていないため，jpqresdelコマンドを実行したホストからマネージャーホストに接続できない。

マネージャーホスト名に誤りがある。または，マネージャーホストがプロセス停止状態である。

102

jpqresdelコマンドを実行したホストでマネージャーホスト名のIPアドレスの解決に失敗した。

200

マネージャーホストが排他実行リソースの削除を受け付けない。

マネージャーホストが運用開始処理中，運用停止処理中，運用停止中，または縮退運転中である。

201

指定した排他実行リソースが使用できない。

指定した排他実行リソースがない。

202

マネージャーホストから応答がない。

203

マネージャーホストの内部的要因で，排他実行リソースの削除に失敗した。

206

排他実行リソースを削除する権限がない。

219

マネージャーホストがビジー状態である。

220

マネージャーホストでメモリー不足が発生した。

222

致命的なエラーが発生した。

システムコールでエラーが発生した。

223

マネージャーホストで論理不正が発生した。

224

JP1/AJS3以外のホストに要求した。

226

実行環境が不適切である。

233

実行中のジョブ（標準ジョブ，カスタムジョブ，またはアクションジョブ）がある。

jpqresshow

形式

jpqresshow
     [-mh マネージャーホスト名]
     {-res 排他実行リソース名|-a|-n}

機能

排他実行リソース情報（名称，その排他実行リソースを使用しているジョブの状態とジョブID）を標準出力ファイルに出力します。

実行権限

次に示すJP1権限レベルのどれかを与えられたユーザー

JP1_JPQ_Admin権限

JP1_JPQ_Operator権限

JP1_JPQ_User権限

引数

-mh マネージャーホスト名

情報を出力したい排他実行リソースが登録されているマネージャーホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

省略した場合，自ホスト名が仮定されます。

-res 排他実行リソース名

その排他実行リソースについて，名称，排他実行リソースを使用しているジョブの状態やジョブIDを表示したい場合に，排他実行リソース名を指定します。

指定できる文字数は，1〜63（単位：バイト）です。

-a

-mhオプションに指定したマネージャーホストに登録されているすべての排他実行リソースについて，名称，その排他実行リソースを使用しているジョブの状態とジョブIDを出力します。

-n

-mhオプションに指定したマネージャーホストに登録されているすべての排他実行リソースについて，名称だけを出力します。

注意事項

このコマンドは，JP1/AJS3からJP1/OJE for VOS3への要求には使用できません。

戻り値

0

正常終了。

1

引数の指定が不適切である。

2

排他実行リソース情報の出力依頼側の内部的要因で，排他実行リソース情報の出力に失敗した。

5

初期化に失敗した。

論理ホスト名の定義または環境設定に誤りがある。

6

排他実行リソース情報の出力依頼側でメモリー不足が発生した。

7

排他実行リソース情報の出力依頼側で論理不正が発生した。

100

TCP/IP通信でマネージャーホストに接続できない。

TCP/IPが正しく設定されていないため，マネージャーホストに接続できない。

マネージャーホスト名に誤りがある。または，マネージャーホストがプロセス停止状態である。

102

マネージャーホスト名によるIPアドレスの解決に失敗した。

200

マネージャーホストが排他実行リソース情報の出力を受け付けない。

マネージャーホストが運用開始処理中，運用停止処理中，運用停止中，または縮退運転中である。

201

指定した排他実行リソースが使用できない。

指定した排他実行リソースがない。

202

マネージャーホストから応答がない。

203

マネージャーホスト側の内部的要因で，排他実行リソース情報の出力に失敗した。

206

排他実行リソース情報を出力する権限がない。

212

排他実行リソースの追加・変更処理中のため，排他実行リソース情報の出力に失敗した。

213

マネージャーホストに排他実行リソースがない。

219

マネージャーホストがビジー状態である。

220

マネージャーホスト側でメモリー不足が発生した。

222

致命的なエラーが発生した。

システムコールでエラーが発生した。

223

マネージャーホスト側で論理不正が発生した。

224

JP1/AJS3以外のホストに要求した。

226

実行環境が不適切である。

出力例1

-resオプションを指定した場合のファイル出力例と出力内容の意味を次に示します。

出力内容の意味を次に示します。

RESOURCE

排他実行リソース名を示します。

STATUS

排他実行リソースを使用しているジョブの状態を示します。

EXECUTING：ジョブは実行中である。

WAITING：ジョブは実行中ではない。

JOBID

排他実行リソースを使用しているジョブのジョブIDを示します。

出力例2

-aオプションを指定した場合のファイル出力例と出力内容の意味を次に示します。

出力内容の意味を次に示します。

RESOURCE

排他実行リソース名を示します。出力できるバイト数は57バイトです。排他実行リソース名が58バイト以上の場合，56バイト以降は「..」になります。

STATUS

排他実行リソースを使用しているジョブの状態を示します。

EXECUTING：ジョブは実行中である。

WAITING：ジョブは実行中ではない。

JOBID

排他実行リソースを使用しているジョブのジョブIDを示します。

出力例3

-nオプションを指定した場合のファイル出力例と出力内容の意味を次に示します。

出力内容の意味を次に示します。

RESOURCE

排他実行リソース名を示します。

第2編　情報定義ファイル編

5　情報定義ファイルの作成

この章では，各種の情報定義ファイルの作成方法について説明します。

5.1　ユニット定義ファイルの作成

ユニット定義ファイルには，ユニットの構成や内容を定義します。ajsdefineコマンドでユニットを定義する場合は，このユニット定義ファイルを指定します。

この節では，ユニット定義ファイルの作成方法について説明します。

5.1.1　ユニット定義ファイルの記述形式

ユニット定義ファイルに定義する，ユニット定義パラメーターの記述形式を次に示します。

図5‒1　ユニット定義パラメーターの記述形式

記述項目について説明します。

(A)コメント文

コメントを追加したい場合は，コメントを「/*」と「*/」で囲んで記述します。

コメントは，ユニット属性パラメーターを定義した行，およびユニット定義パラメーターを定義した行には記述できません。また，「/*/*xxxxx*/*/」のように，コメントを入れ子にすることはできません。

(B)ユニット属性パラメーター

ユニットの属性を記述します。

記述形式を次に示します。

記述項目について説明します。

ユニット名

ユニット名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。ただし，文字コードがUTF-8の場合で，環境設定パラメーターDEFLENTYPEが「sjis」のときは，文字数をシフトJISに換算して1〜30（単位：バイト）です。

ユニット名には，ルートジョブグループ「/」は指定できません。

許可モード

ユニットの許可モードを指定します。

指定できる値は，4けたの8進数の値です。

各けたの意味を次に示します。

なお，各定義情報にeuパラメーターが指定してある場合，各定義情報のeuパラメーターの指定値が有効になります。

1けた目

ジョブ実行時のユーザーの扱いを指定します。

0〜3：ジョブネットを登録したJP1ユーザーを，ジョブ実行時のユーザーとします。

4〜7：ジョブを所有するJP1ユーザーを，ジョブ実行時のユーザーとします。

2〜4けた目

任意の値を指定します。

JP1ユーザー名

ユニットの所有者となるJP1ユーザー名を指定します。

指定できる文字数は，1〜31（単位：バイト）です。

省略した場合，ユニットを作成したユーザーのJP1ユーザー名が仮定されます。

なお，イベント受信ジョブは，指定しても無視されます。

JP1資源グループ名

JP1資源グループ名を指定します。

指定できる文字数は，1〜63（単位：バイト）です。

指定できる文字は，英数字，および「_（アンダーバー）」です。

省略した場合，何も仮定されません。

なお，イベント受信ジョブは，指定しても無視されます。

(C)ユニット定義パラメーターの記述開始

「{」を記述します。

対応する「}」までの内容が，ユニット属性パラメーターで指定したユニットのユニット定義パラメーターです。

(D)ユニット定義パラメーター群

ユニット定義パラメーターを記述します。

詳細については，「5.2 定義情報の形式およびパラメーター」を参照してください。

(E)下位ユニットのユニット属性パラメーター

下位ユニットのユニット属性パラメーターを記述します。

下位ユニットのユニット属性パラメーターは，必ず上位ユニットのユニット定義パラメーター群の末尾に指定してください。

詳細については，「(B) ユニット属性パラメーター」を参照してください。

(F)ユニット定義パラメーターの記述終了

「}」を記述します。

5.1.2　ユニット定義パラメーター定義時の注意事項

どの種別のユニットを定義したいかによって，ファイルに定義する定義情報が異なります。

ここでは，まず，ユニットを定義するためには，どの定義情報が必要なのかを説明します。次に，各定義情報の記述方法を説明します。

定義したいユニットと，必要な定義情報の関係を表5-1に示します。なお，表5-1の定義情報1〜8の意味は次のとおりです。

定義情報1

属性定義情報

定義情報2

ユニット構成定義情報

定義情報3

ジョブグループ定義情報

定義情報4

ジョブネット定義情報

定義情報5

ジョブ定義情報

ジョブとは，次のジョブのことです。

UNIX／PCジョブ

QUEUEジョブ

判定ジョブ

JP1イベント受信監視ジョブ

ファイル監視ジョブ

メール受信監視ジョブ

メッセージキュー受信監視ジョブ

MSMQ受信監視ジョブ

ログファイル監視ジョブ

Windowsイベントログ監視ジョブ

実行間隔制御ジョブ

JP1イベント送信ジョブ

メール送信ジョブ

メッセージキュー送信ジョブ

MSMQ送信ジョブ

JP1/Cm2状態通知ジョブ

ローカル電源制御ジョブ

リモート電源制御ジョブ

UNIX／PCカスタムジョブ

引き継ぎ情報設定ジョブ

フレキシブルジョブ

HTTP接続ジョブ

カスタムイベントジョブ

定義情報6

マネージャーユニット定義情報

マネージャーユニットとは，マネージャージョブグループとマネージャージョブネットのことです。

定義情報7

起動条件定義情報

定義情報8

ジョブネットコネクタ定義情報

表5‒1　必要な定義情報

定義

情報

1

定義

情報

2

定義

情報

3

定義

情報

4

定義

情報

5

定義

情報

6

定義

情報

7

定義

情報

8

ジョブグループ

○

○

○※3

×

×

×

×

×

ジョブネット

○

○

×

○※3

×

×

×

×

ジョブ※1

○

×

×

×

○

×

×

×

マネージャーユニット※2

○

×

×

×

×

○

×

×

起動条件

○

×

×

×

×

×

○

×

ジョブネットコネクタ

○

×

×

×

×

×

×

○

（凡例）

○：必ず定義する

×：定義しなくてよい

注※1

ジョブの種類については，前述の「定義情報5」の説明を参照してください。

注※2

マネージャーユニットの種類については，前述の「定義情報6」の説明を参照してください。

注※3

ジョブネットコネクタを使ってルートジョブネットまたはプランニンググループ直下のルートジョブネットの実行順序を制御するためには，ジョブネットコネクタの実行順序制御方法の指定が必要になります。

各定義情報の記述方法については，「5.2 定義情報の形式およびパラメーター」を参照してください。

5.2　定義情報の形式およびパラメーター

ユニットを定義するための定義情報の記述形式を説明します。

5.2.1　属性定義情報の記述方法

属性定義情報の記述方法を説明します。

属性定義情報は，各ユニット定義パラメーターの先頭に指定します。

属性定義情報の形式，およびパラメーターを次に示します。

形式

ty={g|mg|n|rn|rm|rr|rc|mn|j|rj|pj|
     rp|qj|rq|jdj|rjdj|orj|rorj|evwj|
     revwj|flwj|rflwj|mlwj|rmlwj|mqwj|
     rmqwj|mswj|rmswj|lfwj|rlfwj|ntwj|
     rntwj|tmwj|rtmwj|evsj|revsj|mlsj|
     rmlsj|mqsj|rmqsj|mssj|rmssj|cmsj|
     rcmsj|pwlj|rpwlj|pwrj|rpwrj|cj|rcj|
     cpj|rcpj|fxj|rfxj|htpj|rhtpj|hln|nc|
     cewj|rcewj};
[cm="コメント";]

パラメーター

ty=

ユニット種別を指定します。

g：ジョブグループまたはプランニンググループを定義します。

mg：マネージャージョブグループを定義します。

n：ジョブネットを定義します。

rn：リカバリージョブネットを定義します。

rm：リモートジョブネットを定義します。

rr：リカバリーリモートジョブネットを定義します。

rc：ルートジョブネットに起動条件を定義します。

mn：マネージャージョブネットを定義します。

j：UNIXジョブを定義します。

rj：リカバリーUNIXジョブを定義します。

pj：PCジョブを定義します。

rp：リカバリーPCジョブを定義します。

qj：QUEUEジョブを定義します。

rq：リカバリーQUEUEジョブを定義します。

jdj：判定ジョブを定義します。

rjdj：リカバリー判定ジョブを定義します。

orj：ORジョブを定義します。

rorj：リカバリーORジョブを定義します。

evwj：JP1イベント受信監視ジョブを定義します。

revwj：リカバリーJP1イベント受信監視ジョブを定義します。

flwj：ファイル監視ジョブを定義します。

rflwj：リカバリーファイル監視ジョブを定義します。

mlwj：メール受信監視ジョブを定義します。

rmlwj：リカバリーメール受信監視ジョブを定義します。

mqwj：メッセージキュー受信監視ジョブを定義します。

rmqwj：リカバリーメッセージキュー受信監視ジョブを定義します。

mswj：MSMQ受信監視ジョブを定義します。

rmswj：リカバリーMSMQ受信監視ジョブを定義します。

lfwj：ログファイル監視ジョブを定義します。

rlfwj：リカバリーログファイル監視ジョブを定義します。

ntwj：Windowsイベントログ監視ジョブを定義します。

rntwj：リカバリーWindowsイベントログ監視ジョブを定義します。

tmwj：実行間隔制御ジョブを定義します。

rtmwj：リカバリー実行間隔制御ジョブを定義します。

evsj：JP1イベント送信ジョブを定義します。

revsj：リカバリーJP1イベント送信ジョブを定義します。

mlsj：メール送信ジョブを定義します。

rmlsj：リカバリーメール送信ジョブを定義します。

mqsj：メッセージキュー送信ジョブを定義します。

rmqsj：リカバリーメッセージキュー送信ジョブを定義します。

mssj：MSMQ送信ジョブを定義します。

rmssj：リカバリーMSMQ送信ジョブを定義します。

cmsj：JP1/Cm2状態通知ジョブを定義します。

rcmsj：リカバリーJP1/Cm2状態通知ジョブを定義します。

pwlj：ローカル電源制御ジョブを定義します。

rpwlj：リカバリーローカル電源制御ジョブを定義します。

pwrj：リモート電源制御ジョブを定義します。

rpwrj：リカバリーリモート電源制御ジョブを定義します。

cj：カスタムUNIXジョブを定義します。

rcj：リカバリーカスタムUNIXジョブを定義します。

cpj：カスタムPCジョブを定義します。

rcpj：リカバリーカスタムPCジョブを定義します。

fxj：フレキシブルジョブを定義します。

rfxj：リカバリーフレキシブルジョブを定義します。

htpj：HTTP接続ジョブを定義します。

rhtpj：リカバリーHTTP接続ジョブを定義します。

nc：ジョブネットコネクタを定義します。

cewj：カスタムイベントジョブを定義します。

rcewj：リカバリーカスタムイベントジョブを定義します。

cm="コメント";

コメントを定義します。

指定できる文字数は，1〜80（単位：バイト）です。ただし，文字コードがUTF-8の場合で，環境設定パラメーターDEFLENTYPEが「sjis」のときは，文字数をシフトJISに換算して1〜80（単位：バイト）です。

コメントに「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

5.2.2　ユニット構成定義情報の記述方法

ユニット構成定義情報の記述方法を説明します。

ユニット構成定義情報の形式，およびパラメーターを次に示します。

形式

[el=ユニット名,ユニット種別,+H +V;]...
[sz=横アイコン数＊縦アイコン数;]

パラメーター

el=ユニット名,ユニット種別,+H +V;

ユニットに含まれるユニットの情報を指定します。ユニットに含まれるユニットが複数の場合，このパラメーターを複数回指定します。

ユニット名：ユニットに含まれるユニット名を指定します。

指定できる文字数は，1〜30（単位：バイト）です。

ユニット種別：ユニットに含まれるユニットの種別を指定します。

ユニットの種別の詳細については，「5.2.1 属性定義情報の記述方法」のtyパラメーターを参照してください。

+H

ユニットをJP1/AJS3 - Viewのウィンドウに表示する際の，ユニットアイコンの水平位置をピクセル値で指定します。

指定できる値は，0〜16,000（単位：ピクセル）です。

ピクセル値は，次の計算式から求めます。

H=80＋160x（x：0〜横アイコン数−1）

なお，計算式から求まる値以外の値が指定された場合，適切な値が自動設定されます。

ジョブグループ，および起動条件に含まれるユニットの場合，0が仮定されます。

+V

ユニットをJP1/AJS3 - Viewのウィンドウに表示する際の，ユニットアイコンの垂直位置をピクセル値で指定します。

指定できる値は，0〜10,000（単位：ピクセル）です。

ピクセル値は，次の計算式から求めます。

V=48＋96y（y：0〜縦アイコン数−1）

なお，計算式から求まる値以外の値が指定された場合，適切な値が自動設定されます。

ジョブグループ，および起動条件に含まれるユニットの場合，0が仮定されます。

sz=横アイコン数＊縦アイコン数;

JP1/AJS3 - Viewのウィンドウに表示するユニットアイコン数の最大値を定義します。ジョブネット，およびリモートジョブネットに対してだけ有効です。

横アイコン数：指定できる値は，1〜100です。省略した場合，10が仮定されます。

縦アイコン数：指定できる値は，1〜100です。省略した場合，8が仮定されます。

5.2.3　ジョブグループ定義情報の記述方法

ジョブグループ（またはプランニンググループ）定義情報の記述方法を説明します。

ジョブグループ定義情報の形式，およびパラメーターを次に示します。

形式

[op={yyyy/mm/dd
     |{su|mo|tu|we|th|fr|sa}};]...
[cl={yyyy/mm/dd
     |{su|mo|tu|we|th|fr|sa}};]...
[sdd={dd|{su|mo|tu|we|th|fr|sa}:n};]
[md={th|ne};]
[stt=hh:mm;]
[gty={p|n};]
[ncl={y|n};]
[ncn=ジョブネットコネクタ名;]
[ncs={y|n};]
[ncex={y|n};]
[nchn="接続ホスト名";]
[ncsv=接続サービス名;]

パラメーター

op={yyyy/mm/dd|{su|mo|tu|we|th|fr|sa}};

カレンダー情報として，運用日を定義します。運用日を複数指定する場合，このパラメーターを複数回指定します。

yyyy：運用日の西暦年を指定します。指定できる値は，1994〜環境設定パラメーターSCHEDULELIMITの値（単位：西暦年）です。環境設定パラメーターSCHEDULELIMITの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2(123) SCHEDULELIMIT」を参照してください。

mm：運用日の月を指定します。指定できる値は，1〜12（単位：月）です。

dd：運用日の日を指定します。指定できる値は，1〜31（単位：日）です。

su：日曜日を運用日とします。

mo：月曜日を運用日とします。

tu：火曜日を運用日とします。

we：水曜日を運用日とします。

th：木曜日を運用日とします。

fr：金曜日を運用日とします。

sa：土曜日を運用日とします。

cl={yyyy/mm/dd|{su|mo|tu|we|th|fr|sa}};

カレンダー情報として，休業日を定義します。休業日を複数指定する場合，このパラメーターを複数回指定します。

yyyy：休業日の西暦年を指定します。指定できる値は，1994〜環境設定パラメーターSCHEDULELIMITの値（単位：西暦年）です。環境設定パラメーターSCHEDULELIMITの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2(123) SCHEDULELIMIT」を参照してください。

mm：休業日の月を指定します。指定できる値は，1〜12（単位：月）です。

dd：休業日の日を示します。指定できる値は，1〜31（単位：日）です。

su：日曜日を休業日とします。

mo：月曜日を休業日とします。

tu：火曜日を休業日とします。

we：水曜日を休業日とします。

th：木曜日を休業日とします。

fr：金曜日を休業日とします。

sa：土曜日を休業日とします。

sdd={dd|{su|mo|tu|we|th|fr|sa}:n};

カレンダー情報として，基準日を定義します。

省略した場合，上位ジョブグループの基準日が仮定されます。上位のすべてのジョブグループに基準日が定義されていない場合は，1が仮定されます。

dd：基準日を暦日で指定します。指定できる値は，1〜31（単位：日）です。

su：日曜日を基準日とします。

mo：月曜日を基準日とします。

tu：火曜日を基準日とします。

we：水曜日を基準日とします。

th：木曜日を基準日とします。

fr：金曜日を基準日とします。

sa：土曜日を基準日とします。

n：何週目の曜日を基準日にするかを定義します。指定できる値は，1〜5（単位：週）です。

md={th|ne};

カレンダー情報として，月区分を定義します。省略した場合，上位ジョブグループの月区分が仮定されます。上位のすべてのジョブグループに月区分が定義されていない場合は，thが仮定されます。

th：基準日以降の日を基準日の月（当月）とします。

ne：基準日以降の日を翌月とします。

stt=hh:mm;

カレンダー情報として，基準時刻を定義します。省略した場合，上位ジョブグループの基準時刻が仮定されます。上位のすべてのジョブグループに基準時刻が定義されていない場合は，00:00が仮定されます。

hh：基準時刻の時を指定します。指定できる値は，0〜23（単位：時）です。

mm：基準時刻の分を指定します。指定できる値は，0〜59（単位：分）です。

gty={p|n}

ジョブグループの種別を指定します。省略した場合，nが仮定されます。

p：プランニンググループ

n：ジョブグループ

ncl={y|n};

プランニンググループの場合，ジョブネットコネクタを使ってプランニンググループ直下のルートジョブネットの実行順序を制御するかどうかを定義します。省略した場合，nが仮定されます。このパラメーターは，プランニンググループ（パラメーターgtyにpを指定）だけに指定できます。

y：プランニンググループ直下のルートジョブネットの実行順序を制御します。

n：プランニンググループ直下のルートジョブネットの実行順序を制御しません。

ncn=ジョブネットコネクタ名;

プランニンググループ直下のルートジョブネットの実行順序を制御する場合，接続するジョブネットコネクタのユニット完全名を指定します。指定できる文字数は，1〜930（単位：バイト）です。次のようなユニット名を指定した場合はエラーになります。

「/（スラント）」で始まっていない

「/」と「/」の間が30バイトを超えている個所がある

「/」で終了している

このパラメーターは，プランニンググループ（パラメーターgtyにpを指定）だけに指定できます。また，パラメーターnclにyが設定されていない場合，このパラメーターを指定するとエラーになります。

ncs={y|n};

プランニンググループ直下のルートジョブネットの実行順序を制御する場合，その実行順序制御方式を定義します。省略した場合，nが仮定されます。このパラメーターは，プランニンググループ（パラメーターgtyにpを指定）だけに指定できます。また，パラメーターnclにyが設定されていない場合，このパラメーターを指定するとエラーになります。

y：ジョブネットコネクタと同期して実行します。

n：ジョブネットコネクタと非同期で実行します。

ncex={y|n};

プランニンググループ配下のルートジョブネットの実行順序を制御する場合に，スケジューラーサービス間連携させるかどうかを定義します。省略した場合，nが仮定されます。

このパラメーターは，プランニンググループだけに指定できます。

また，パラメーターnclにyが設定されていない場合はエラーになります。

y：スケジューラーサービス間連携します。

別のホストまたは別のスケジューラーサービスに定義したジョブネットコネクタと連携します。

n：スケジューラーサービス間連携しません。

同一スケジューラーサービスに定義したジョブネットコネクタとだけ連携します。

nchn="接続ホスト名";

自身を接続対象としているジョブネットコネクタが定義されているホスト名を指定します。指定できる文字数は，1〜255（単位：バイト）です。半角スペース，タブ文字，改行文字は指定できません。

このパラメーターは，プランニンググループだけに指定できます。また，パラメーターncexにyが設定されていない場合はエラーになります。

ホスト名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

ncsv=接続サービス名;

自身を接続対象としているジョブネットコネクタが定義されているスケジューラーサービス名を指定します。指定できる文字数は，1〜30（単位：バイト）です。

このパラメーターは，プランニンググループだけに指定できます。また，パラメーターncexにyが設定されていない場合はエラーになります。

5.2.4　ジョブネット定義情報の記述方法

ジョブネット定義情報の記述方法を説明します。

複数のユニットを同時に定義する場合は，上位のユニット定義パラメーターに続いて，下位のユニット属性パラメーターを記述します。

ジョブネット定義情報の形式，およびパラメーターを次に示します。

形式

[sd=[N,]{[[yyyy/]mm/]{[+|*|@]dd
     |[+|*|@]b[-DD]|[+]{su|mo|tu|we|th|fr|sa}
     [:{n|b}]}|en|ud};]...
[st=[N,][+]hh:mm;]]...
[sy=[N,]hh:mm|{M|U|C}mmmm;]]...
[ey=[N,]hh:mm|{M|U|C}mmmm;]]...
[ln=[N,]n;]]...
[cy=[N,](n,{y|m|w|d});]]...
[sh=[N,]{be|af|ca|no};]]...
[shd=[N,]n;]]...
[wt=[N,]{no|hh:mm|mmmm|un};]]...
[wc=[N,]{no|n|un};]]...
[cftd=[N,]{no|be|af|db|da}[,n[,N]];]]...
[ed=yyyy/mm/dd;]
[rg=n;]
[pr=n;]
[ni=n;]
[ha={y|w|a|n};]
[ejn=排他ジョブネット名;]
[cd={no|un|n};]
[de={y|n};]
[ms={sch|mlt};]
[mp={y|n};]
[jc=ジョブグループ完全名;]
[rh="実行マネージャー名";]
[ex="実行エージェント名";]
[fd=実行所要時間;]
[ar=(f=先行ユニット名,t=後続ユニット名[,接続種別]);]...
[ncl={y|n};]
[ncn=ジョブネットコネクタ名;]
[ncs={y|n};]
[ncex={y|n};]
[nchn="接続ホスト名";]
[ncsv=接続サービス名;]
[mm={and|or};]
[nmg={y|n};]
[eun=待ち合わせ対象ユニット名;]...
[ega={exec|execdeffer|none};]
[uem={y|n};]

パラメーター

sd=[N,]{[[yyyy/]mm/]{[+|*|@]dd|[+|*|@]b[-DD]|[+]{su|mo|tu|we|th|fr|sa} [:{n|b}]}|en|ud};

ジョブネットの実行開始日を定義します。実行開始日を複数指定する場合，このパラメーターを複数回指定します。実行開始日は，最大で144個定義できます。ルートジョブネットで省略した場合，「1, en」が仮定されます。

N：ジョブネットの実行開始日を複数定義する場合のルール番号を指定します。指定できる値は，0〜144です。

この番号は，実行開始時刻，開始遅延時刻，終了遅延時刻，対応する上位ジョブネットのルール番号，処理サイクル，振り替え方法，振り替え猶予日数のルール番号に対応します。

「sd=0, ud」と定義すると，すべて未定義にできます。

yyyy：ジョブネットの実行開始日の西暦年を指定します。指定できる値は，1994〜環境設定パラメーターSCHEDULELIMITの値（単位：西暦年）です。環境設定パラメーターSCHEDULELIMITの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2(123) SCHEDULELIMIT」を参照してください。

省略した場合，ジョブネットを実行登録した日の年が仮定されます。なお，2/29を指定する場合は，2/29が存在する年を指定してください。

mm：ジョブネットの実行開始日の月を指定します。指定できる値は，1〜12（単位：月）です。省略した場合，ジョブネットを実行登録した日の月が仮定されます。

+：ジョブネットの実行開始日を相対日で指定します。

*：ジョブネットの実行開始日を運用日で指定します。

@：ジョブネットの実行開始日を休業日で指定します。

dd：ジョブネットの実行開始日の日を定義します。

絶対日指定の場合

年月日指定：1〜指定年月の最終日（単位：日）です。

月日指定：1〜指定月の最終日（単位：日）です。ただし，2月の場合は，1〜29です。

日指定：1〜31（単位：日）です。

相対日，運用日，休業日指定の場合

1〜35（単位：日）です。

b：ジョブネットの実行開始日を，その月の最終日とします。

-DD：ジョブネットの実行開始日として，月末または最終運用日から何日前かを指定します。省略した場合，月末または最終運用日が仮定されます。

絶対日指定の場合

年月日指定：1〜指定年月の最終日−1（単位：日）です。

月日指定：0〜指定月の最終日−1（単位：日）です。ただし，2月の場合は，0〜28です。

日指定：0〜30（単位：日）です。

相対日，運用日，休業日指定の場合

0〜34（単位：日）です。

su：日曜日をジョブネットの実行開始日とします。

mo：月曜日をジョブネットの実行開始日とします。

tu：火曜日をジョブネットの実行開始日とします。

we：水曜日をジョブネットの実行開始日とします。

th：木曜日をジョブネットの実行開始日とします。

fr：金曜日をジョブネットの実行開始日とします。

sa：土曜日をジョブネットの実行開始日とします。

n：指定した曜日が，月初めを基準に何週目の曜日かを指定します。指定できる値は，1〜5（単位：週）です。省略した場合，年（yyyy）と月（mm）を指定しているときは1が，年と月を指定していないときは実行登録日からいちばん近い指定曜日の週が仮定されます。

en：ジョブネットを実行登録した日を実行開始日とします。

ud：ジョブネットのスケジュールをすべて未定義にします。この場合，Nに必ず0を指定してください。

st=[N,][+]hh:mm;

ジョブネットの実行開始時刻を定義します。省略した場合，+00:00（相対時刻の0時00分）が仮定されます。このパラメーターは，実行開始日のルール番号ごとに指定できます。

N：ジョブネットの実行開始日のルール番号に対応する，実行開始時刻のルール番号を指定します。指定できる値は，1〜144です。省略した場合，1が仮定されます。

+：hhおよびmmで指定するジョブネットの実行開始時刻を，相対時刻として扱います。省略した場合，絶対時刻として扱われます。

hh：ジョブネットの実行開始時刻の時を指定します。指定できる値は，0〜47（単位：時）です。省略した場合，0が仮定されます。

mm：ジョブネットの実行開始時刻の分を指定します。指定できる値は，0〜59（単位：分）です。省略した場合，0が仮定されます。

sy=[N,]hh:mm|{M|U|C}mmmm;

ジョブネットの開始遅延時刻を定義します。このパラメーターは，実行開始日のルール番号ごとに指定できます。

N：ジョブネットの実行開始日のルール番号に対応する，開始遅延時刻のルール番号を指定します。指定できる値は，1〜144です。省略した場合，1が仮定されます。

hh：ジョブネットの開始遅延時刻の時を指定します。指定できる値は，0〜47（単位：時）です。

mm：ジョブネットの開始遅延時刻の分を指定します。指定できる値は，0〜59（単位：分）です。

M：mmmmで指定した分を，ルートジョブネットの実行開始時刻からの相対分とします。

U：mmmmで指定した分を，上位ジョブネットの実行開始時刻からの相対分とします。

C：mmmmで指定した分を，自ジョブネットの実行開始時刻からの相対分とします。

mmmm：開始遅延時刻を，ルートジョブネット，上位ジョブネット，または自ジョブネットの実行開始時刻からの相対分で指定します。指定できる値は，1〜2,879（単位：分）です。

ey=[N,]hh:mm|{M|U|C}mmmm;

ジョブネットの終了遅延時刻を定義します。このパラメーターは，実行開始日のルール番号ごとに指定できます。

N：ジョブネットの実行開始日のルール番号に対応する，終了遅延時刻のルール番号を指定します。指定できる値は，1〜144です。省略した場合，1が仮定されます。

hh：ジョブネットの終了遅延時刻の時を指定します。指定できる値は，0〜47（単位：時）です。

mm：ジョブネットの終了遅延時刻の分を指定します。指定できる値は，0〜59（単位：分）です。

M：mmmmで指定した分を，ルートジョブネットの実行開始時刻からの相対分とします。

U：mmmmで指定した分を，上位ジョブネットの実行開始時刻からの相対分とします。

C：mmmmで指定した分を，自ジョブネットの実行開始時刻からの相対分とします。

mmmm：終了遅延時刻を，ルートジョブネット，上位ジョブネット，または自ジョブネットの実行開始時刻からの相対分で指定します。指定できる値は，1〜2,879（単位：分）です。

ln=[N,]n;

対応する上位ジョブネットの，スケジュールのルール番号を定義します。ルートジョブネットに指定しても無視されます。このパラメーターは，実行開始日のルール番号ごとに指定できます。

N：ジョブネットの実行開始日のルール番号を指定します。指定できる値は，1〜144です。省略した場合，1が仮定されます。

n：対応する上位ジョブネットの，実行開始日のルール番号を指定します。指定できる値は，1〜144です。

cy=[N,](n,{y|m|w|d});

ジョブネットの処理サイクルを定義します。省略した場合，処理サイクルなしと仮定されます。このパラメーターは，実行開始日のルール番号ごとに指定できます。

N：ジョブネットの実行開始日のルール番号を指定します。指定できる値は，1〜144です。省略した場合，1が仮定されます。

n：処理サイクルの数を指定します。指定できる値は，続いて指定するパラメーター（y，m，w，またはd）によって異なります。

y：処理サイクルの単位を年とします。nに指定できる値は，1〜9（単位：年）です。

m：処理サイクルの単位を月とします。nに指定できる値は，1〜12（単位：月）です。

w：処理サイクルの単位を週とします。nに指定できる値は，1〜5（単位：週）です。ただし，このパラメーターは，実行開始日を運用日，または休業日で定義している場合は（「sd=*」または「sd=@」を指定している場合は）指定できません。指定した場合，1週を7運用日，または7休業日としてスケジュールが算出されますが，日単位で指定することを推奨します（例えば，「1,w」の代わりに，「7,d」と指定することを推奨します）。

d：処理サイクルの単位を日とします。nに指定できる値は，1〜31（単位：日）です。

sh=[N,]{be|af|ca|no};

ジョブネットの実行予定日がJP1/AJS3上のカレンダーで休業日の場合の，実行日の振り替え方法を定義します。このパラメーターは，実行開始日のルール番号ごとに指定できます。

N：ジョブネットの実行開始日のルール番号を指定します。指定できる値は，1〜144です。省略した場合，1が仮定されます。

be：実行予定日が休業日に当たる場合は，実行予定日の前の日に振り替えます。

af：実行予定日が休業日に当たる場合は，実行予定日のあとの日に振り替えます。

ca：実行予定日が休業日に当たる場合は，ジョブネットを実行しません。

no：JP1/AJS3のサービスが起動している場合にだけ，実行予定日が休業日であっても強制的に実行します。

shd=[N,]n;

ジョブネットの実行振り替えの猶予日数を定義します。このパラメーターは，実行開始日のルール番号ごとに指定できます。

N：ジョブネットの実行開始日のルール番号を指定します。指定できる値は，1〜144です。省略した場合，1が仮定されます。

n：ジョブネットの実行振り替えの猶予日数を指定します。指定できる値は，1〜31（単位：日）です。省略した場合，2が仮定されます。

wt=[N,]{no|hh:mm|mmmm|un};

起動条件の監視終了時刻を定義します。省略した場合，noが仮定されます。このパラメーターは，wcパラメーターと同時に指定してください。このパラメーターは，実行開始日のルール番号ごとに指定できます。

N：ジョブネットの実行開始日のルール番号を指定します。指定できる値は，1〜144です。省略した場合，1が仮定されます。

no：起動条件を使用しません。この値を指定すると，wcパラメーターに起動条件が監視を終了するまでの実行世代の実行回数を定義しても無効となります。

hh：起動条件の監視終了時刻の時を指定します。指定できる値は，0〜47（単位：時）です。

mm：起動条件の監視終了時刻の分を指定します。指定できる値は，0〜59（単位：分）です。

mmmm：起動条件の監視終了時刻を，起動条件の監視を開始した時刻からの相対分で指定します。指定できる値は，1〜2,879（単位：分）です。

un：起動条件の監視終了時刻に無制限を指定します。

wc=[N,]{no|n|un};

起動条件が監視を開始してから，起動条件が監視を終了するまでの実行世代の実行回数を定義します。省略した場合，noが仮定されます。このパラメーターは，wtパラメーターと同時に指定してください。このパラメーターは，実行開始日のルール番号ごとに指定できます。

N：ジョブネットの実行開始日のルール番号を指定します。指定できる値は，1〜144です。省略した場合，1が仮定されます。

no：起動条件を使用しません。この値を指定すると，wtパラメーターに起動条件の監視終了時刻を定義しても無効となります。

n：起動条件が監視を終了するまでの実行世代の実行回数を指定します。指定できる値は，1〜999（単位：回）です。省略した場合，1が仮定されます。

un：起動条件が監視を終了するまでの実行世代の実行回数に無制限を指定します。

cftd=[N,]{no|be|af|db|da}[,n[,N]];

ジョブネットの起算スケジュールを定義します。省略した場合，noが仮定されます。このパラメーターは，実行開始日のルール番号ごとに指定できます。

N：ジョブネットの実行開始日のルール番号を指定します。指定できる値は，1〜144です。省略した場合，1が仮定されます。

no：起算スケジュールを利用しません。

be：ジョブネットの実行日を，起点日（処理サイクル指定や，振り替え指定によって求まった実行予定日）から前日以前の運用日に振り替えます。

af：ジョブネットの実行日を，起点日（処理サイクル指定や，振り替え指定によって求まった実行予定日）から翌日以降の運用日に振り替えます。

db：ジョブネットの実行日を， 起点日（処理サイクル指定や，振り替え指定によって求まった実行予定日）から前日以前に振り替えます。この指定では，休業日も振り替えの対象になります。

da：ジョブネットの実行日を， 起点日（処理サイクル指定や，振り替え指定によって求まった実行予定日）から翌日以降に振り替えます。この指定では，休業日も振り替えの対象になります。

n：起算日数を指定します。指定できる値は，1〜31（単位：日）です。省略した場合，1が仮定されます。なお，「cftd=no」を指定した場合，この指定は無効になります。

N：起算猶予日数を指定します。指定できる値は，1〜31（単位：日）です。省略した場合，10が仮定されます。なお，「cftd=no」，「cftd=db」，または「cftd=da」を指定した場合，この指定は無効になります。

ed=yyyy/mm/dd;

定義したスケジュールの有効期日を定義します。省略した場合，満了日付はチェックされません。

yyyy：有効期日の年を西暦年で指定します。指定できる値は，1994〜環境設定パラメーターSCHEDULELIMITの値（単位：西暦年）です。環境設定パラメーターSCHEDULELIMITの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2(123) SCHEDULELIMIT」を参照してください。

mm：有効期日の月を指定します。指定できる値は，1〜12（単位：月）です。

dd：有効期日の日を指定します。指定できる値は，1〜31（単位：日）です。

rg=n;

ジョブネットの保存世代数を定義します。指定できる値は，1〜99（単位：世代）です。ただし，システム設定オプションを有効にしておくと，最大999（単位：世代）まで拡張できます。

省略した場合，1が仮定されます。このパラメーターは，ルートジョブネットだけに定義できます。ネストジョブネットは，ルートジョブネットに定義された値を引き継ぎます。

pr=n;

ジョブネット中のジョブの，実行優先順位の仮定値を定義します。指定できる値は，1〜5です。実行優先順位がいちばん低いのが1，いちばん高いのが5です。省略した場合，上位ジョブネットの定義に依存します。

ジョブネット中のジョブに対してprパラメーターが省略された場合に，このパラメーターに指定する値が使用されます。最上位までのすべての上位ジョブネットに対してこのパラメーターを指定しなかった場合で，かつ，niパラメーターも指定しなかった場合，ジョブの実行優先順位として1が仮定されます。

niパラメーターと同時に指定した場合，あとで指定したパラメーターの値が有効になります。

ni=n;

ジョブネット中のジョブの，実行優先順位の仮定値を定義します。指定できる値は，−39〜39です。

指定した値は，prパラメーターの，ジョブ実行優先順位の仮定値に置き換えられます。対応を次の表に示します。

niパラメーターの指定値

ジョブ実行時の優先順位の仮定値

39〜11

5

10〜1

4

0

3

−1〜−10

2

−11〜−39

1

省略した場合，上位ジョブネットの定義に依存します。

ジョブネット中のジョブに対してprパラメーターが省略された場合に，このパラメーターに指定する値が使用されます。最上位までのすべての上位ジョブネットに対してこのパラメーターを指定しなかった場合で，かつ，prパラメーターも指定しなかった場合，ジョブの実行優先順位として1が仮定されます。

prパラメーターと同時に指定した場合，あとで指定したパラメーターの値が有効になります。

ha={y|w|a|n};

ジョブネットの実行を保留するかを定義します。省略した場合，nが仮定されます。ネストジョブネットにwまたはaを指定した場合，nが仮定されます。

y：ジョブネットの実行を保留します。

w：前回のジョブネットの終了結果が「警告検出終了」，「異常検出終了」，「繰り越し未実行」，「順序不正」，「中断」，または「強制終了」の場合にだけ，実行を保留します。このパラメーターは，「mp=y」と同時に指定できません。

a：前回のジョブネットの終了結果が「異常検出終了」，「繰り越し未実行」，「順序不正」，「中断」，または「強制終了」の場合にだけ，実行を保留します。このパラメーターは，「mp=y」と同時に指定できません。

n：実行を保留しません。

ejn=排他ジョブネット名;

ジョブネット実行時に，同時に実行させたくないジョブネット名（同じ階層上のジョブネット名）を定義します。

指定できる文字数は，1〜30（単位：バイト）です。ただし，文字コードがUTF-8の場合で，環境設定パラメーターDEFLENTYPEが「sjis」のときは，文字数をシフトJISに換算して1〜30（単位：バイト）です。

cd={no|un|n};

「保留」，「起動条件待ち」，または「開始時刻待ち」状態のジョブネットに，待ち状態を打ち切る日数を定義します。省略した場合，noが仮定されます。

no：待ち状態を打ち切る日数を設定しません。この場合，待ち状態を打ち切る時間はシステムオプションに設定した値になります。

un：待ち状態を打ち切らないで，無制限に待ち続けます。

n：待ち状態を続ける日数を，ジョブネットが属するジョブグループの基準日からの相対日で指定します。指定できる値は，1〜2（単位：日）です。

de={y|n};

上位ジョブネットのスケジュールとの依存関係を定義します。省略した場合，yが仮定されます。このパラメーターはルートジョブネットには定義できません。

y：上位ジョブネットのスケジュールに依存します。sdパラメーターと同時に指定できません。

n：上位ジョブネットのスケジュールに依存しません。

ms={sch|mlt};

ジョブネット実行のスケジューリング方式を定義します。省略した場合，schが仮定されます。

sch：スケジュールスキップ方式を使用します。

mlt：多重スケジュール方式を使用します。

mp={y|n};

ジョブネット実行の多重起動の許可を定義します。省略した場合，nが仮定されます。

y：多重起動を許可します。「ha=w」「ha=a」と同時に指定できません。

n：多重起動を許可しません。

jc=ジョブグループ完全名;

ジョブネット単位に指定するカレンダー情報が定義されているジョブグループ名を定義します。

指定できる文字数は，1〜930（単位：バイト）です。

rh="実行マネージャー名";

リモートジョブネットの実行先となるJP1/AJS3 - Managerホスト名を定義します。

指定できる文字数は，1〜255（単位：バイト）です。省略した場合，リモートジョブネットの実行結果にメッセージKAVS0289-Eが出力されエラーになります。

ホスト名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

ex="実行エージェント名";

ジョブを実行する実行エージェント名または実行エージェントグループ名を定義します。

指定できる文字数は，1〜255（単位：バイト）です。

実行エージェント名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

マクロ変数を指定できます。

ジョブの定義情報に実行エージェント名の指定がない場合，ここで定義した名称が使用されます。このパラメーターも指定されていない場合，次の値が仮定されます。

ルートジョブネットの場合は，自ホスト名が仮定されます。

ネストジョブネットの場合は，上位ジョブネットの値が仮定されます。

リモートジョブネットの場合は，実行マネージャーに指定された値が仮定されます。

fd=実行所要時間;

終了遅延監視するジョブネットまたはリモートジョブネットの実行所要時間を定義します。

指定できる値は，10進数の値で，1〜2,879（単位：分）です。

ar=(f=先行ユニット名,t=後続ユニット名[,接続種別]);

ユニット中の，ユニットとユニットの実行順序関係を定義します（JP1/AJS3 - Viewの［ジョブネットエディタ］ウィンドウのマップエリアで，アイコンとアイコンの間に関連線を引いて実行順序を定義する操作と同じです）。実行順序関係を複数指定する場合，このパラメーターを複数回指定します。

f=先行ユニット名：先行して実行するユニット名，または判定ジョブ名を指定します。指定できる文字数は，1〜30（単位：バイト）です。

t=後続ユニット名：後続で実行するユニット名，または従属ユニット名を指定します。指定できる文字数は，1〜30（単位：バイト）です。

接続種別：接続方法を定義します。省略した場合，seqが仮定されます。

seq：順接続します。

con：判定ジョブを従属ユニットとして，条件接続します。先行ユニット名に判定ジョブを指定した場合にだけ指定できます。

ncl={y|n};

ルートジョブネットの場合は，ジョブネットコネクタを使って実行順序を制御するかどうかを定義します。省略した場合，nが仮定されます。

このパラメーターは，ルートジョブネットだけに指定できます。

y：ルートジョブネットの実行順序を制御します。

n：ルートジョブネットの実行順序を制御しません。

ncn=ジョブネットコネクタ名;

ルートジョブネットの実行順序を制御する場合，接続するジョブネットコネクタのユニット完全名を指定します。指定できる文字数は，1〜930（単位：バイト）です。次のようなユニット名を指定した場合はエラーになります。

「/（スラント）」で始まっていない

「/」と「/」の間が30バイトを超えている個所がある

「/」で終了している

このパラメーターは，ルートジョブネットだけに指定できます。また，パラメーターnclにyが設定されていない場合，このパラメーターを指定するとエラーになります。

ncs={y|n};

ルートジョブネットの実行順序を制御する場合，その実行順序制御方式を定義します。省略した場合，nが仮定されます。このパラメーターは，ルートジョブネットだけに指定できます。また，パラメーターnclにyが設定されていない場合，このパラメーターを指定するとエラーになります。

y：ジョブネットコネクタと同期して実行します。

n：ジョブネットコネクタと非同期で実行します。

ncex={y|n};

ルートジョブネットの実行順序を制御する場合に，スケジューラーサービス間連携させるかどうかを定義します。省略した場合，nが仮定されます。

このパラメーターは，ルートジョブネットだけに指定できます。

また，パラメーターnclにyが設定されていない場合はエラーになります。

y：スケジューラーサービス間連携します。

別のホストまたは別のスケジューラーサービスに定義したジョブネットコネクタと連携します。

n：スケジューラーサービス間連携しません。

同一スケジューラーサービスに定義したジョブネットコネクタとだけ連携します。

nchn="接続ホスト名";

自身を接続対象としているジョブネットコネクタが定義されているホスト名を指定します。指定できる文字数は，1〜255（単位：バイト）です。半角スペース，タブ文字，改行文字は指定できません。

このパラメーターは，ルートジョブネットだけに指定できます。また，パラメーターncexにyが設定されていない場合はエラーになります。

ホスト名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

ncsv=接続サービス名;

自身を接続対象としているジョブネットコネクタが定義されているスケジューラーサービス名を指定します。指定できる文字数は，1〜30（単位：バイト）です。

このパラメーターは，ルートジョブネットだけに指定できます。また，パラメーターncexにyが設定されていない場合はエラーになります。

mm={and|or};

指定した待ち合わせ対象ユニットとの待ち合わせ方法を指定します。

省略した場合はandが仮定されます。

and：すべての待ち合わせ対象ユニットが終了したら実行を開始する。

or：待ち合わせ対象ユニットが一つでも終了したら実行を開始する。

nmg={y|n};

指定した待ち合わせ対象ユニットのルートジョブネットに待ち合わせる世代がないときの動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

eun=待ち合わせ対象ユニット名;

待ち合わせ対象ユニットとするユニットを，完全名で指定します。

待ち合わせ対象ユニットを複数指定する場合，このパラメーターを複数回指定します。最大で32個指定できます。

待ち合わせ対象ユニット名に指定できる文字数は1〜930（単位：バイト）です。

ega={exec|execdeffer|none};

起動条件付きジョブネットを待ち合わせ対象に指定していて，実行世代に異常終了がある場合の動作を指定します。

省略した場合はnoneが仮定されます。

exec：実行を開始する。

execdeffer：実行を開始しない。ただし，実行世代が「繰り越し未実行」状態の場合は，実行を開始する。

none：実行を開始しない。

uem={y|n};

起動条件付きジョブネットを待ち合わせ対象に指定していて，監視世代が監視未起動終了の場合の動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

5.2.5　マネージャーユニット定義情報の記述方法

マネージャーユニット定義情報の記述方法を説明します。

マネージャーユニット定義情報の形式，およびパラメーターを次に示します。

形式

[mh="マネージャーホスト名";]
[mu=マネージャーユニット名;]

パラメーター

mh="マネージャーホスト名";

JP1/AJS3 - Managerのホスト名を定義します。

指定できる文字数は，1〜255（単位：バイト）です。

mu=マネージャーユニット名;

マネージャーのユニット名をフルパス名で定義します。

指定できる文字数は，1〜961（単位：バイト）です。

5.2.6　UNIX／PCジョブ定義情報の記述方法

UNIX／PCジョブ定義情報の記述方法を説明します。

UNIX／PCジョブ定義情報の形式，およびパラメーターを次に示します。

形式

[te="コマンドテキスト";]
[sc="スクリプトファイル名";]
[prm="パラメーター";]
[wkp="作業用パス名";]
[ev="環境変数ファイル名";]
[env="環境変数";]...
[si="標準入力ファイル名";]
[so="標準出力ファイル名";]
[se="標準エラー出力ファイル名";]
[soa={new|add};]
[sea={new|add};]
[etm=n;]
[fd=実行所要時間;]
[pr=n;]
[ex="実行エージェント名";]
[un="実行ユーザー名";]
[jd={nm|ab|cod|mdf|exf};]
[wth=n;]
[tho=n;]
[jdf="終了判定ファイル名";]
[abr={y|n};]
[rjs=自動リトライする終了コードの下限;]
[rje=自動リトライする終了コードの上限;]
[rec=最大リトライ回数;]
[rei=リトライ間隔;]
[ts1="転送元ファイル名1";]
[td1="転送先ファイル名1";]
[top1={sav|del};]
[ts2="転送元ファイル名2";]
[td2="転送先ファイル名2";]
[top2={sav|del};]
[ts3="転送元ファイル名3";]
[td3="転送先ファイル名3";]
[top3={sav|del};]
[ts4="転送元ファイル名4";]
[td4="転送先ファイル名4";]
[top4={sav|del};]
[ha={y|n};]
[eu={ent|def};]
[jty={q|n};]
[mm={and|or};]
[nmg={y|n};]
[eun=待ち合わせ対象ユニット名;]...
[ega={exec|execdeffer|none};]
[uem={y|n};]

パラメーター

te="コマンドテキスト";

コマンドテキストを定義します。

指定できる文字数は，1〜1,023（単位：バイト）です。

コマンドテキスト中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

コマンドテキストには，マクロ変数を指定できます。マクロ変数で指定する場合，指定できる文字数は，「マクロ変数名:引き継ぎ情報名」の形式で，1〜1,023（単位：バイト）です。マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

sc="スクリプトファイル名";

UNIXジョブの場合，ジョブを実行するエージェントホスト上のスクリプトファイル名を定義します。PCジョブの場合，エージェントホスト上の実行ファイル名を定義します。

指定できる文字数は，1〜511（単位：バイト）です。ファイル名は，絶対パスおよび相対パスで指定できます。相対パスで指定した場合，ジョブ実行時の作業用パスからの相対パスになります。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

ファイル名には，マクロ変数を指定できます。マクロ変数で指定する場合，指定できる文字数は，「マクロ変数名:引き継ぎ情報名」の形式で，1〜511（単位：バイト）です。マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

prm="パラメーター";

実行ファイルに対するパラメーターを定義します。

指定できる文字数は，1〜1,023（単位：バイト）です。

パラメーター中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

パラメーターには，マクロ変数を指定できます。マクロ変数で指定する場合，指定できる文字数は，「マクロ変数名:引き継ぎ情報名」の形式で，1〜1,023（単位：バイト）です。マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

wkp="作業用パス名";

作業用パス名をフルパス名で定義します。

指定できる文字数は，1〜511（単位：バイト）です。

作業用パス名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

キューイング属性あり（jty=q）の場合は，マクロ変数を指定できます。

ev="環境変数ファイル名";

エージェントホスト上の環境変数ファイル名を定義します。

指定できる文字数は，1〜511（単位：バイト）です。ファイル名は，絶対パスおよび相対パスで指定できます。相対パスで指定した場合，ジョブ実行時の作業用パスからの相対パスになります。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

キューイング属性あり（jty=q）の場合は，マクロ変数を指定できます。

env="環境変数";

環境変数を「環境変数名=値」の形式で定義します。

指定できる文字数は，1〜20,479（単位：バイト）です。環境変数を複数指定する場合，このパラメーターを複数回指定します（「env="環境変数名=値";」の形式で，バイト数の合計が20,479バイトまで複数指定できます）。

環境変数中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

環境変数には，マクロ変数を指定できます。マクロ変数で指定する場合，指定できる文字数は，「マクロ変数名:引き継ぎ情報名」の形式で，1〜20,479（単位：バイト）です。マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

si="標準入力ファイル名";

ジョブを実行するエージェントホスト上の標準入力ファイル名を定義します。

指定できる文字数は，1〜511（単位：バイト）です。ファイル名は，絶対パスおよび相対パスで指定できます。相対パスで指定した場合，ジョブ実行時の作業用パスからの相対パスになります。

「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

キューイング属性あり（jty=q）の場合は，マクロ変数を指定できます。

so="標準出力ファイル名";

ジョブを実行するエージェントホスト上の標準出力ファイル名を定義します。

指定できる文字数は，1〜511（単位：バイト）です。ファイル名は，絶対パスおよび相対パスで指定できます。相対パスで指定した場合，ジョブ実行時の作業用パスからの相対パスになります。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

キューイング属性あり（jty=q）の場合は，「$JP1AJS2_JPQSTDOUTTEMP$」を指定すると，標準出力ファイルが一時ファイルに出力されます。

また，キューイング属性あり（jty=q）の場合は，マクロ変数を指定できます。

se="標準エラー出力ファイル名";

ジョブを実行するエージェントホスト上の標準エラー出力ファイル名を定義します。

指定できる文字数は，1〜511（単位：バイト）です。ファイル名は，絶対パスおよび相対パスで指定できます。相対パスで指定した場合，ジョブ実行時の作業用パスからの相対パスになります。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

キューイング属性あり（jty=q）の場合は，マクロ変数を指定できます。

soa={new|add};

標準出力ファイル名の追加書きオプションを定義します。省略した場合，newが仮定されます。soパラメーターで標準出力ファイル名を指定しなかった場合，このパラメーターは無効になります。

new：ファイルを新規に作成します。

add：既存のファイルに情報を追加します。

sea={new|add};

標準エラー出力ファイル名の追加書きオプションを定義します。省略した場合，newが仮定されます。seパラメーターで標準エラー出力ファイル名を指定しなかった場合，このパラメーターは無効になります。

new：ファイルを新規に作成します。

add：既存のファイルに情報を追加します。

etm=n;

実行打ち切り時間を，実行開始時刻からの相対分で定義します。

指定できる値は，1〜1,440（単位：分）です。

fd=実行所要時間;

終了遅延監視するジョブの実行所要時間を定義します。

指定できる値は，10進数の値で1〜1,440（単位：分）です。

pr=n;

ジョブの実行優先順位を定義します。

指定できる値は，「1」〜「5」です。実行優先順位がいちばん低いのが「1」，いちばん高いのが「5」です。省略した場合，上位ジョブネットの定義に依存します。このパラメーターを省略し，かつ，最上位までのすべての上位ジョブネットに対してpr，またはniパラメーターを指定しなかった場合，ジョブの実行優先順位は環境設定パラメーターDEFAULTPRIORITYの設定値によって決まります。環境設定パラメーターDEFAULTPRIORITYの設定も省略した場合は，「1」が仮定されます。

環境設定パラメーターDEFAULTPRIORITYの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2(108) DEFAULTPRIORITY」を参照してください。

ex="実行エージェント名";

ジョブを実行する実行エージェント名または実行エージェントグループ名を定義します。

指定できる文字数は，1〜255（単位：バイト）です。

実行エージェント名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

キューイング属性あり（jty=q）の場合は，マクロ変数を指定できます。

un="実行ユーザー名";

エージェントホストでジョブを実行する場合の，ジョブを実行するOSユーザー名を定義します。

指定できる文字数は，1〜63（単位：バイト）です。ユーザー名中に空白文字は指定できません。

ユーザー名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

キューイング属性あり（jty=q）の場合は，マクロ変数を指定できます。

jd={nm|ab|cod|mdf|exf};

終了判定種別を定義します。省略した場合，codが仮定されます。

cod以外を指定した場合，rjs，rje，rec，およびreiパラメーターを指定できません。また，abrパラメーターにyを指定できません。指定した場合はユニットの作成に失敗します。

nm：すべて正常終了とします。

ab：すべて異常終了とします。

cod：終了コードが指定値以下の場合は，正常終了とします。

mdf：ジョブの実行開始から実行終了までの間にファイルが更新されている場合は，正常終了とします。

exf：ジョブの実行終了時にファイルが作成されている場合は，正常終了とします。

wth=n;

警告しきい値を定義します。

指定できる値は，0〜2,147,483,647です。

tho=n;

異常しきい値を定義します。

指定できる値は，0〜2,147,483,647です。省略した場合，0が仮定されます。

jdf="終了判定ファイル名";

ジョブを実行するエージェントホスト上の終了判定ファイル名を定義します。

指定できる文字数は，1〜511（単位：バイト）です。ファイル名は，絶対パスおよび相対パスで指定できます。相対パスで指定した場合，ジョブ実行時の作業用パスからの相対パスになります。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

キューイング属性あり（jty=q）の場合は，マクロ変数を指定できます。

abr={y|n};

異常終了時リトライを定義します。省略した場合，nが仮定されます。

jdパラメーターにcodを指定した場合にだけ，yを指定できます。

y：異常終了時に自動リトライします。

n：異常終了時に自動リトライしません。

rjs=自動リトライする終了コードの下限;

異常終了時に自動リトライする終了コードの下限を定義します。

異常終了時に自動リトライする場合（abrパラメーターにyを指定した場合）にだけ指定できます。

指定できる値は，1〜4,294,967,295です。異常しきい値（thoパラメーター）以下の値および自動リトライする終了コードの上限（rieパラメーター）より大きな値を指定した場合は，ユニットの作成に失敗します。

省略した場合，自動リトライする終了コードの下限は定義されないで，ジョブ実行時に「異常しきい値＋1」が仮定されます。

rje=自動リトライする終了コードの上限;

異常終了時に自動リトライする終了コードの上限を定義します。

異常終了時に自動リトライする場合（abrパラメーターにyを指定した場合）にだけ指定できます。

指定できる値は，1〜4,294,967,295です。異常しきい値（thoパラメーター）以下の値および自動リトライする終了コードの下限（risパラメーター）より小さな値を指定した場合は，ユニットの作成に失敗します。

省略した場合，自動リトライする終了コードの上限は定義されないで，ジョブ実行時に最大値（4,294,967,295）が仮定されます。

rec=最大リトライ回数;

異常終了時に自動リトライする場合（abrパラメーターにyを指定した場合）にだけ，最大リトライ回数を定義します。

指定できる値は1〜12（単位：回）です。省略した場合，1が仮定されます。

rei=リトライ間隔;

異常終了時に自動リトライする場合（abrパラメーターにyを指定した場合）にだけ，リトライ間隔を定義します。

指定できる値は，1〜10（単位：分）です。省略した場合，1が仮定されます。

ts1="転送元ファイル名1";

転送元ファイル名をフルパス名で定義します。

指定できる文字数は，1〜511（単位：バイト）です。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

キューイング属性あり（jty=q）の場合は，マクロ変数を指定できます。

td1="転送先ファイル名1";

エージェントホストに転送する転送先ファイル名を定義します。

指定できる文字数は，1〜511（単位：バイト）です。省略した場合，$JP1AJS2_JPQTEMPxx$変数が仮定されます（xxは，転送ファイルの番号で，01〜04の値）。sc，prmパラメーターにこの変数を指定すると，転送先ファイル名を意識しないでジョブを実行できます。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

キューイング属性あり（jty=q）の場合は，マクロ変数を指定できます。

top1={sav|del};

転送先ファイルの自動削除オプションを定義します。

sav：ファイルを保存します。

del：ファイルを削除します。

転送元ファイル名および転送先ファイル名を指定し，このパラメーターを省略した場合，savが仮定されます。

転送元ファイル名を指定し，転送先ファイル名およびこのパラメーターを省略した場合，delが仮定されます。

ts2="転送元ファイル名2";

転送元ファイル名をフルパス名で定義します。

指定できる文字数は，1〜511（単位：バイト）です。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

キューイング属性あり（jty=q）の場合は，マクロ変数を指定できます。

td2="転送先ファイル名2";

エージェントホストに転送する転送先ファイル名を定義します。

指定できる文字数は，1〜511（単位：バイト）です。省略した場合，$JP1AJS2_JPQTEMPxx$変数が仮定されます（xxは，転送ファイルの番号で，01〜04の値）。sc，prmパラメーターにこの変数を指定すると，転送先ファイル名を意識しないでジョブを実行できます。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

キューイング属性あり（jty=q）の場合は，マクロ変数を指定できます。

top2={sav|del};

転送先ファイルの自動削除オプションを定義します。

sav：ファイルを保存します。

del：ファイルを削除します。

転送元ファイル名および転送先ファイル名を指定し，このパラメーターを省略した場合，savが仮定されます。

転送元ファイル名を指定し，転送先ファイル名およびこのパラメーターを省略した場合，delが仮定されます。

ts3="転送元ファイル名3";

転送元ファイル名をフルパス名で定義します。

指定できる文字数は，1〜511（単位：バイト）です。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

キューイング属性あり（jty=q）の場合は，マクロ変数を指定できます。

td3="転送先ファイル名3";

エージェントホストに転送する転送先ファイル名を定義します。

指定できる文字数は，1〜511（単位：バイト）です。省略した場合，$JP1AJS2_JPQTEMPxx$変数が仮定されます（xxは，転送ファイルの番号で，01〜04の値）。sc，prmパラメーターにこの変数を指定すると，転送先ファイル名を意識しないでジョブを実行できます。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

キューイング属性あり（jty=q）の場合は，マクロ変数を指定できます。

top3={sav|del};

転送先ファイルの自動削除オプションを定義します。

sav：ファイルを保存します。

del：ファイルを削除します。

転送元ファイル名および転送先ファイル名を指定し，このパラメーターを省略した場合，savが仮定されます。

転送元ファイル名を指定し，転送先ファイル名およびこのパラメーターを省略した場合，delが仮定されます。

ts4="転送元ファイル名4";

転送元ファイル名をフルパス名で定義します。

指定できる文字数は，1〜511（単位：バイト）です。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

キューイング属性あり（jty=q）の場合は，マクロ変数を指定できます。

td4="転送先ファイル名4";

エージェントホストに転送する転送先ファイル名を定義します。

指定できる文字数は，1〜511（単位：バイト）です。省略した場合，$JP1AJS2_JPQTEMPxx$変数が仮定されます（xxは，転送ファイルの番号で，01〜04の値）。sc，prmパラメーターにこの変数を指定すると，転送先ファイル名を意識しないでジョブを実行できます。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

キューイング属性あり（jty=q）の場合は，マクロ変数を指定できます。

top4={sav|del};

転送先ファイルの自動削除オプションを定義します。

sav：ファイルを保存します。

del：ファイルを削除します。

転送元ファイル名および転送先ファイル名を指定し，このパラメーターを省略した場合，savが仮定されます。

転送元ファイル名を指定し，転送先ファイル名およびこのパラメーターを省略した場合，delが仮定されます。

ha={y|n};

ジョブの実行を保留するかを定義します。省略した場合，nが仮定されます。

y：保留します。

n：保留しません。

eu={ent|def};

ジョブ実行時のJP1ユーザーを定義します。省略した場合，entが仮定されます。

ent：ジョブネットを登録したJP1ユーザーをジョブ実行時のJP1ユーザーとします。

def：ジョブを所有するJP1ユーザーをジョブ実行時のJP1ユーザーとします。

jty={q|n};

キューイング属性の種別を定義します。省略した場合，qが仮定されます。

q：キューイング属性あり。

n：キューイング属性なし。

mm={and|or};

指定した待ち合わせ対象ユニットとの待ち合わせ方法を指定します。

省略した場合はandが仮定されます。

and：すべての待ち合わせ対象ユニットが終了したら実行を開始する。

or：待ち合わせ対象ユニットが一つでも終了したら実行を開始する。

nmg={y|n};

指定した待ち合わせ対象ユニットのルートジョブネットに待ち合わせる世代がないときの動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

eun=待ち合わせ対象ユニット名;

待ち合わせ対象ユニットとするユニットを，完全名で指定します。

待ち合わせ対象ユニットを複数指定する場合，このパラメーターを複数回指定します。最大で32個指定できます。

待ち合わせ対象ユニット名に指定できる文字数は1〜930（単位：バイト）です。

ega={exec|execdeffer|none};

起動条件付きジョブネットを待ち合わせ対象に指定していて，実行世代に異常終了がある場合の動作を指定します。

省略した場合はnoneが仮定されます。

exec：実行を開始する。

execdeffer：実行を開始しない。ただし，実行世代が「繰り越し未実行」状態の場合は，実行を開始する。

none：実行を開始しない。

uem={y|n};

起動条件付きジョブネットを待ち合わせ対象に指定していて，監視世代が監視未起動終了の場合の動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

5.2.7　QUEUEジョブ定義情報の記述方法

QUEUEジョブ定義情報の記述方法を説明します。

QUEUEジョブ定義情報の形式，およびパラメーターを次に示します。

形式

[qu="キュー名";]
[qm="ホスト名";]
[req="ジョブ名";]
[sc="スクリプトファイル名";]
[prm="パラメーター";]
[fd=実行所要時間;]
[pr=n;]
[jd={nm|ab|cod};]
[wth=n;]
[tho=n;]
[abr={y|n};]
[rjs=自動リトライする終了コードの下限;]
[rje=自動リトライする終了コードの上限;]
[rec=最大リトライ回数;]
[rei=リトライ間隔;]
[ts1="転送元ファイル名1";]
[td1="転送先ファイル名1";]
[ts2="転送元ファイル名2";]
[td2="転送先ファイル名2";]
[ts3="転送元ファイル名3";]
[td3="転送先ファイル名3";]
[ts4="転送元ファイル名4";]
[td4="転送先ファイル名4";]
[ha={y|n};]
[eu={ent|def};]
[mm={and|or};]
[nmg={y|n};]
[eun=待ち合わせ対象ユニット名;]...
[ega={exec|execdeffer|none};]
[uem={y|n};]

パラメーター

qu="キュー名";

QUEUEジョブをサブミットするキュー名を定義します。

指定できる文字数は，1〜63（単位：バイト）です。

キュー名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

マクロ変数を指定できます。

qm="ホスト名";

連携するJP1/AJS3 - Managerホスト名，JP1/OJE for VOS3ホスト名を定義します。省略した場合，自ホスト名になります。

指定できる文字数は，1〜255（単位：バイト）です。

ホスト名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

マクロ変数を指定できます。

req="ジョブ名";

QUEUEジョブをサブミットする場合のジョブ名を定義します。

指定できる文字数は，1〜63（単位：バイト）です。省略した場合，QUEUEジョブのユニット名が仮定されます。

ジョブ名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

マクロ変数を指定できます。

sc="スクリプトファイル名";

実行ファイル名を定義します。

指定できる文字数は，1〜511（単位：バイト）です。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

マクロ変数を指定できます。

prm="パラメーター";

実行ファイルに対するパラメーターを定義します。

指定できる文字数は，1〜1,023（単位：バイト）です。

パラメーター中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

マクロ変数を指定できます。

fd=実行所要時間;

終了遅延監視するジョブの実行所要時間を定義します。

指定できる値は，10進数の値で1〜1,440（単位：分）です。

pr=n;

ジョブの実行優先順位を定義します。

指定できる値は，「1」〜「5」です。実行優先順位がいちばん低いのが「1」，いちばん高いのが「5」です。省略した場合，上位ジョブネットの定義に依存します。このパラメーターを省略し，かつ，最上位までのすべての上位ジョブネットに対してpr，またはniパラメーターを指定しなかった場合，ジョブの実行優先順位は環境設定パラメーターDEFAULTPRIORITYの設定値によって決まります。環境設定パラメーターDEFAULTPRIORITYの設定も省略した場合は，「1」が仮定されます。

環境設定パラメーターDEFAULTPRIORITYの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2(108) DEFAULTPRIORITY」を参照してください。

jd={nm|ab|cod};

終了判定種別を定義します。省略した場合，codが仮定されます。

cod以外を指定した場合は，abrパラメーターにyを指定できません。指定した場合はメッセージKAVS0674-Eが出力されて，ユニットの作成に失敗します。

nm：すべて正常終了とします。

ab：すべて異常終了とします。

cod：終了コードが指定値以下の場合に，正常終了とします。

wth=n;

警告終了のしきい値を定義します。

指定できる値は，0〜2,147,483,647です。

tho=n;

異常終了のしきい値を定義します。

指定できる値は，0〜2,147,483,647です。省略した場合，0が仮定されます。

abr={y|n};

異常終了時リトライを定義します。省略した場合，nが仮定されます。

jdパラメーターにcodを指定した場合にだけ，yを指定できます。

y：異常終了時に自動リトライします。

n：異常終了時に自動リトライしません。

rjs=自動リトライする終了コードの下限;

異常終了時に自動リトライする場合に，自動リトライする終了コードの下限を定義します。

abrパラメーターにyを指定した場合にだけ定義できます。

指定できる値は，1〜4,294,967,295です。異常しきい値以下の値および自動リトライする終了コードの上限より大きな値を指定した場合は，メッセージKAVS0668-Eが出力されて，ユニットの作成に失敗します。

省略した場合，実行時に「異常終了しきい値＋1」が仮定されます。

rje=自動リトライする終了コードの上限;

異常終了時に自動リトライする場合に，自動リトライする終了コードの上限を定義します。

abrパラメーターにyを指定した場合にだけ定義できます。

指定できる値は，1〜4,294,967,295です。異常しきい値以下の値および自動リトライする終了コードの下限より小さな値を指定した場合は，メッセージKAVS0668-Eが出力されて，ユニットの作成に失敗します。

省略した場合，実行時に最大値の「4,294,967,295」が仮定されます。

rec=最大リトライ回数;

異常終了時に自動リトライする場合に，最大リトライ回数を定義します。

abrパラメーターにyを指定した場合にだけ指定できます。

指定できる値は，1〜12（単位：回）です。省略した場合，1が仮定されます。

rei=リトライ間隔;

異常終了時に自動リトライする場合に，リトライ間隔を定義します。

abrパラメーターにyを指定した場合にだけ指定できます。

指定できる値は，1〜10（単位：分）です。省略した場合，1が仮定されます。

ts1="転送元ファイル名1";

転送元ファイル名をフルパス名で定義します。

指定できる文字数は，1〜511（単位：バイト）です。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

マクロ変数を指定できます。

td1="転送先ファイル名1";

エージェントホストに転送される転送先ファイル名を定義します。

指定できる文字数は，1〜511（単位：バイト）です。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

マクロ変数を指定できます。

ts2="転送元ファイル名2";

転送元ファイル名をフルパス名で定義します。

指定できる文字数は，1〜511（単位：バイト）です。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

マクロ変数を指定できます。

td2="転送先ファイル名2";

エージェントホストに転送される転送先ファイル名を定義します。

指定できる文字数は，1〜511（単位：バイト）です。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

マクロ変数を指定できます。

ts3="転送元ファイル名3";

転送元ファイル名をフルパス名で定義します。

指定できる文字数は，1〜511（単位：バイト）です。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

マクロ変数を指定できます。

td3="転送先ファイル名3";

エージェントホストに転送される転送先ファイル名を定義します。

指定できる文字数は，1〜511（単位：バイト）です。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

マクロ変数を指定できます。

ts4="転送元ファイル名4";

転送元ファイル名をフルパス名で定義します。

指定できる文字数は，1〜511（単位：バイト）です。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

マクロ変数を指定できます。

td4="転送先ファイル名4";

エージェントホストに転送される転送先ファイル名を定義します。

指定できる文字数は，1〜511（単位：バイト）です。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

マクロ変数を指定できます。

ha={y|n};

ジョブの実行を保留するかを定義します。省略した場合，nが仮定されます。

y：保留します。

n：保留しません。

eu={ent|def};

ジョブ実行時のJP1ユーザーを定義します。省略した場合，entが仮定されます。

ent：ジョブネットを登録したJP1ユーザーをジョブ実行時のJP1ユーザーとします。

def：ジョブを所有するJP1ユーザーをジョブ実行時のJP1ユーザーとします。

mm={and|or};

指定した待ち合わせ対象ユニットとの待ち合わせ方法を指定します。

省略した場合はandが仮定されます。

and：すべての待ち合わせ対象ユニットが終了したら実行を開始する。

or：待ち合わせ対象ユニットが一つでも終了したら実行を開始する。

nmg={y|n};

指定した待ち合わせ対象ユニットのルートジョブネットに待ち合わせる世代がないときの動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

eun=待ち合わせ対象ユニット名;

待ち合わせ対象ユニットとするユニットを，完全名で指定します。

待ち合わせ対象ユニットを複数指定する場合，このパラメーターを複数回指定します。最大で32個指定できます。

待ち合わせ対象ユニット名に指定できる文字数は1〜930（単位：バイト）です。

ega={exec|execdeffer|none};

起動条件付きジョブネットを待ち合わせ対象に指定していて，実行世代に異常終了がある場合の動作を指定します。

省略した場合はnoneが仮定されます。

exec：実行を開始する。

execdeffer：実行を開始しない。ただし，実行世代が「繰り越し未実行」状態の場合は，実行を開始する。

none：実行を開始しない。

uem={y|n};

起動条件付きジョブネットを待ち合わせ対象に指定していて，監視世代が監視未起動終了の場合の動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

5.2.8　判定ジョブ定義情報の記述方法

判定ジョブ定義情報の記述方法を説明します。

判定ジョブ定義情報の形式，およびパラメーターを次に示します。

形式

[ej={gt|ge|lt|le|eq|ne|ri|ro|ef|nf|vgt|vge|vlt|vle|veq|vne|vri|vro|sce|spe|sne|spn|snn|snl};]
[ejc=判定終了コード;]
[ejl=下限の判定終了コード;]
[ejh=上限の判定終了コード;]
[ejf="終了判定ファイル名";]
[ejv=変数名;]
[ejt="変数（文字列）の判定値";]
[eji=変数（数値）の判定値;]
[ejs=変数（数値）の下限の判定値;]
[ejg=変数（数値）の上限の判定値;]
[ejm={gt|ge};]
[eju={lt|le};]
[ha={y|n};]

パラメーター

ej={gt|ge|lt|le|eq|ne|ri|ro|ef|nf|vgt|vge|vlt|vle|veq|vne|vri|vro|sce|spe|sne|spn|snn|snl};

先行ジョブの終了コードと判定値を比較して判定する際の判定条件を定義します。指定できる判定条件は一つだけです。省略した場合，gtが仮定されます。

gt：先行ジョブの終了コードが判定値より大きいです。「ejf="終了判定ファイル名";」と同時に指定できません。

ge：先行ジョブの終了コードが判定値以上です。「ejf="終了判定ファイル名";」と同時に指定できません。

lt：先行ジョブの終了コードが判定値より小さいです。「ejf="終了判定ファイル名";」と同時に指定できません。

le：先行ジョブの終了コードが判定値以下です。「ejf="終了判定ファイル名";」と同時に指定できません。

eq：先行ジョブの終了コードが判定値と等しいです。「ejf="終了判定ファイル名";」と同時に指定できません。

ne：先行ジョブの終了コードが判定値と等しくないです。「ejf="終了判定ファイル名";」と同時に指定できません。

ri：先行ジョブの終了コードが判定値の範囲内です。「ejf="終了判定ファイル名";」と同時に指定できません。同時にejl，ejhの指定が必要です。必要に応じてejm，ejuも指定してください。

ro：先行ジョブの終了コードが判定値の範囲外です。「ejf="終了判定ファイル名";」と同時に指定できません。同時にejl，ejhの指定が必要です。必要に応じてejm，ejuも指定してください。

ef：ファイルが作成されています。「ejc=判定終了コード;」と同時に指定できません。

nf：ファイルが作成されていません。「ejc=判定終了コード;」と同時に指定できません。

vgt：指定された変数の値が判定値より大きいです。ejiを数値として処理します。

vge：指定された変数の値が判定値以上です。ejiを数値として処理します。

vlt：指定された変数の値が判定値より小さいです。ejiを数値として処理します。

vle：指定された変数の値が判定値以下です。ejiを数値として処理します。

veq：指定された変数の値が判定値と等しいです。ejiを数値として処理します。

vne：指定された変数の値が判定値と等しくないです。ejiを数値として処理します。

vri：指定された変数の値が判定値の範囲内です。ejsとejgを数値として処理します。同時にejs，ejgの指定が必要です。必要に応じてejm，ejuも指定してください。

vro：指定された変数の値が判定値の範囲外です。ejsとejgを数値として処理します。同時にejs，ejgの指定が必要です。必要に応じてejm，ejuも指定してください。

sce：指定された変数の値が判定値と等しいです。ejtを文字列として処理します。

spe：指定された変数の値が判定値を含んでいます。ejtを文字列として処理します。

sne：指定された変数の値が判定値と等しくないです。ejtを文字列として処理します。

spn：指定された変数の値が判定値を含んでいません。ejtを文字列として処理します。同時にejv，ejtの指定が必要です。

snn：指定された変数の値があります。ejtを処理しません。

snl：指定された変数の値がありません。ejtを処理しません。

ejc=判定終了コード;

判定の対象となる判定終了コードを定義します。省略した場合，0が仮定されます。

指定できる値は，0〜4,294,967,295です。

ejパラメーターにgt，ge，lt，le，eq，neを指定した場合に有効となります。その他の値を指定した場合は無効となります。

ejl=下限の判定終了コード;

判定の対象となる下限の判定終了コードを定義します。

指定できる値は，0〜4,294,967,295です。下限の判定終了コード（ejlパラメーター）と境界条件（ejmパラメーター），および上限の判定終了コード（ejhパラメーター）と境界条件（ejuパラメーター）から，終了コードを判定する範囲内に整数値が存在しない場合，エラーになります。

ejパラメーターにri，roを指定した場合に有効となります。その他の値を指定した場合は無効となります。

終了コードが負数の場合，符号なしに換算した値を指定することで判定できます。例えば，「-1」はWindowsでは「4,294,967,295」，UNIXでは「255」として扱われます。ただし，終了コードの負数を符号なしに換算すると「2,147,483,648」から「4,294,967,295」の範囲となるため，終了コードが「0」をまたがる場合は範囲指定できません。

ejh=上限の判定終了コード;

判定の対象となる上限の判定終了コードを定義します。

指定できる値は，0〜4,294,967,295です。下限の判定終了コード（ejlパラメーター）と境界条件（ejmパラメーター），および上限の判定終了コード（ejhパラメーター）と境界条件（ejuパラメーター）から，終了コードを判定する範囲内に整数値が存在しない場合，エラーになります。

ejパラメーターにri，roを指定した場合に有効となります。その他の値を指定した場合は無効となります。

終了コードが負数の場合，符号なしに換算した値を指定することで判定できます。例えば，「-1」はWindowsでは「4,294,967,295」，UNIXでは「255」として扱われます。ただし，終了コードの負数を符号なしに換算すると「2,147,483,648」から「4,294,967,295」の範囲となるため，終了コードが「0」をまたがる場合は範囲指定できません。

ejf="終了判定ファイル名";

終了判定の対象となるファイル名を定義します。

指定できる文字数は，1〜260（単位：バイト）です。

ejパラメーターにef，nfを指定した場合に有効となります。その他の値を指定した場合は無効となります。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

ejv=変数名;

先行ジョブで指定したマクロ変数名を「?AJS2xxxxx?」の形式で指定します。

ejパラメーターにvgt，vge，vlt，vle，veq，vne，vri，vro，sce，spe，sne，spn，snn，snlを指定した場合に有効となります。その他の値を指定した場合は無効となります。

変数名の文字列（「xxxxx」の部分）に指定できるのは，英（ただし，大文字だけ）数字と，「.（ピリオド）」だけです。

マクロ変数名に指定できる文字数は，1〜64（単位：バイト）です。

ejt="変数（文字列）の判定値";

判定の対象となる判定値を511バイト以内の文字列で指定します。

ejパラメーターにsce，spe，sne，spnを指定した場合に有効となります。その他の値を指定した場合は無効となります。

eji=変数（数値）の判定値;

判定の対象となる判定値を0〜2,147,483,647の数値で指定します。省略した場合，0が仮定されます。

ejパラメーターにvgt，vge，vlt，vle，veq，vneを指定した場合に有効となります。その他の値を指定した場合は無効となります。

ejs=変数（数値）の下限の判定値;

変数（数値）の判定の対象となる下限の判定値を0〜2,147,483,647の数値で指定します。変数（数値）の下限の判定値（ejsパラメーター）とその境界条件（ejmパラメーター），および変数（数値）の上限の判定値（ejgパラメーター）とその境界条件（ejuパラメーター）から，変数（数値）判定数値を判定する範囲内に整数値が存在しない場合，エラーになります。

ejパラメーターにvri，vroを指定した場合に有効となります。その他の値を指定した場合は無効となります。

ejg=変数（数値）の上限の判定値;

変数（数値）の判定の対象となる上限の判定値を0〜2,147,483,647の数値で指定します。変数（数値）の下限の判定値（ejsパラメーター）とその境界条件（ejmパラメーター），および変数（数値）の上限の判定値（ejgパラメーター）とその境界条件（ejuパラメーター）から，変数（数値）判定数値を判定する範囲内に整数値が存在しない場合，エラーになります。

ejパラメーターにvri，vroを指定した場合に有効となります。その他の値を指定した場合は無効となります。

ejm={gt|ge};

下限の判定終了コード（ejlパラメーター）または変数（数値）の下限の判定値（ejsパラメーター）を定義する場合の，境界条件を定義します。省略した場合，geが仮定されます。

ejパラメーターにri，ro，vri，vroを指定した場合に有効となります。その他の値を指定した場合は無効となります。

gt

先行ジョブの終了コードまたは変数の判定数値が，判定値より大きいことを示します。

ge

先行ジョブの終了コードまたは変数の判定数値が，判定値以上であることを示します。

eju={lt|le};

上限の判定終了コード（ejhパラメーター）または変数（数値）の上限の判定値（ejgパラメーター）を定義する場合の，境界条件を定義します。省略した場合，leが仮定されます。

ejパラメーターにri，ro，vri，vroを指定した場合に有効となります。その他の値を指定した場合は無効となります。

lt

先行ジョブの終了コードまたは変数の判定数値が，判定値より小さいことを示します。

le

先行ジョブの終了コードまたは変数の判定数値が，判定値以下であることを示します。

ha={y|n};

ジョブの実行を保留するかを定義します。省略した場合，nが仮定されます。

y：保留します。

n：保留しません。

5.2.9　JP1イベント受信監視ジョブ定義情報の記述方法

JP1イベント受信監視ジョブ定義情報の記述方法を説明します。

JP1イベント受信監視ジョブ定義情報の形式，およびパラメーターを次に示します。

形式

[evwid=イベントID;]
[evusr="イベント発行元ユーザー名";]
[evgrp="イベント発行元グループ名";]
[evhst="イベント発行元ホスト名";]
[evipa=イベント発行元IPアドレス;]
[evwms="メッセージ";]
[evdet="イベント詳細情報";]
[evwsv=em[:al[:cr[:er[:wr[:no[:in[:db]]]]]]];]
[evwfr=任意の拡張属性名:"値";]...
[evtmc={n|a|n:"ファイル名"|a:"ファイル名"
     |d:"ファイル名"|b:"ファイル名"};]
[evuid=イベント発行元ユーザーID;]
[evgid=イベント発行元グループID;]
[evpid=イベント発行元プロセスID;]
[jpoif=マクロ変数名:引き継ぎ情報名;]...
[etm=n;]
[fd=実行所要時間;]
[ex="実行エージェント名";]
[ha={y|n};]
[eu={ent|def};]
[evesc={no|分};]
[ets={kl|nr|wr|an};]
[mm={and|or};]
[nmg={y|n};]
[eun=待ち合わせ対象ユニット名;]...
[ega={exec|execdeffer|none};]
[uem={y|n};]

パラメーター

evwid=イベントID;

受信対象のイベントIDを定義します。

指定できる値は，16進数の値で，00000000:00000000〜FFFFFFFF:FFFFFFFFです。

evusr="イベント発行元ユーザー名";

受信対象のイベント基本情報中の，イベント発行元ユーザー名を定義します。

指定できる文字数は，1〜20（単位：バイト）です。

ユーザー名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

なお，ユーザー名には正規表現が使用できます。

evgrp="イベント発行元グループ名";

受信対象のイベント基本情報中の，イベント発行元グループ名を定義します。

指定できる文字数は，1〜20（単位：バイト）です。

グループ名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

なお，グループ名には正規表現が使用できます。

evhst="イベント発行元ホスト名";

受信対象のイベント基本情報中の，イベント発行元ホスト名を定義します。

指定できる文字数は，1〜255（単位：バイト）です。

ホスト名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

なお，ホスト名には正規表現が使用できます。

また，マクロ変数を指定できます。

evipa=イベント発行元IPアドレス;

受信対象のイベント基本情報中の，イベント発行元IPアドレスを定義します。

指定できる値は，「XXX.YYY.xxx.yyy」の形式で，0.0.0.0〜255.255.255.255です。「XXX」「YYY」「xxx」「yyy」に指定できる値は，それぞれ0〜255です。

evwms="メッセージ";

受信対象のイベントのメッセージ部分と比較する文字列を定義します。

指定できる文字数は，1〜1,024（単位：バイト）です。

メッセージ中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

なお，メッセージには正規表現が使用できます。

evdet="イベント詳細情報";

受信対象のイベントの詳細情報部分と比較する文字列を定義します。

指定できる文字数は，1〜1,024（単位：バイト）です。

詳細情報中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

なお，詳細情報には正規表現が使用できます。

evwsv=em[:al[:cr[:er[:wr[:no[:in[:db]]]]]]];

受信対象のイベント拡張属性の重大度を定義します。

em：「Emergency」を一致条件とします。

al：「Alert」を一致条件とします。

cr：「Critical」を一致条件とします。

er：「Error」を一致条件とします。

wr：「Warning」を一致条件とします。

no：「Notice」を一致条件とします。

in：「Information」を一致条件とします。

db：「Debug」を一致条件とします。

evwfr=任意の拡張属性名:"値";

受信対象のイベント拡張属性に対して，ユーザー任意の属性名および属性値を指定している場合に，「evwfr=任意の拡張属性名:"値"」の形式で定義します。

指定できる文字数は，1〜2,048（単位：バイト）です。複数指定できます（「evwfr=任意の拡張属性名:"値";」の形式で，バイト数の合計が2,048バイトまで複数指定できます）。

値中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

なお，値には正規表現およびマクロ変数が使用できます。

evtmc={n|a|n:"ファイル名"|a:"ファイル名"|d:"ファイル名"|b:"ファイル名"};

終了判定条件を定義します。省略した場合，nが仮定されます。

n：常に正常終了とします。

a：常に異常終了とします。

n:"ファイル名"：メッセージが指定したファイルの内容と一致すれば正常終了とします。

a:"ファイル名"：メッセージが指定したファイルの内容と一致すれば異常終了とします。

d:"ファイル名"：詳細情報が指定したファイルの内容と一致すれば正常終了とします。

b:"ファイル名"：詳細情報が指定したファイルの内容と一致すれば異常終了とします。

ファイル名に指定できる文字数は，1〜256（単位：バイト）です。

evuid=イベント発行元ユーザーID;

受信対象のイベント基本情報中の，イベント発行元ユーザーIDを定義します。

指定できる値は，−1〜9,999,999,999です。

evgid=イベント発行元グループID;

受信対象のイベント基本情報中の，イベント発行元グループIDを定義します。

指定できる値は，−1〜9,999,999,999です。

evpid=イベント発行元プロセスID;

受信対象のイベント基本情報中の，イベント発行元プロセスIDを定義します。

指定できる値は，−1〜9,999,999,999です。

jpoif=マクロ変数名:引き継ぎ情報名;

マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

マクロ変数を複数指定する場合，このパラメーターを複数回指定します（「jpoif=マクロ変数名:引き継ぎ情報名;」の形式で，バイト数の合計が2,048バイトまで複数指定できます）。

このパラメーターでは，後続のUNIXジョブ，PCジョブ，フレキシブルジョブ，HTTP接続ジョブ，およびアクションジョブに対してイベント情報を引き継げます。

etm=n;

実行打ち切り時間を，実行開始時刻からの相対分で定義します。指定できる値は，1〜1,440（単位：分）です。起動条件内のジョブの場合，このパラメーターは無効になります。

fd=実行所要時間;

終了遅延監視するジョブの実行所要時間を定義します。

指定できる値は，10進数の値で1〜1,440（単位：分）です。

起動条件として定義する場合，このパラメーターはジョブ実行時に無効になります。

ex="実行エージェント名";

ジョブを実行する実行エージェント名を定義します。

指定できる文字数は，1〜255（単位：バイト）です。

実行エージェント名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

マクロ変数を指定できます。

ha={y|n};

ジョブの実行を保留するかを定義します。省略した場合，nが仮定されます。起動条件内のジョブの場合，このパラメーターは無効になります。

y：保留します。

n：保留しません。

eu={ent|def};

ジョブ実行時のJP1ユーザーを定義します。省略した場合，entが仮定されます。イベントジョブの場合，このパラメーターの指定は無視されます。

ent：ジョブネットを登録したJP1ユーザーをジョブ実行時のJP1ユーザーとします。

def：ジョブを所有するJP1ユーザーをジョブ実行時のJP1ユーザーとします。

evesc={no|分};

JP1イベント受信監視ジョブが実行された直後（JP1イベントの監視を始める前）に，それ以前に発生したJP1イベントを受信監視の対象とするかどうかを定義します。省略した場合，noが仮定されます。

no：過去のJP1イベントを検索しません。

分：JP1イベント受信監視ジョブが実行された時刻から指定された時間だけさかのぼった時刻以降のJP1イベントを検索します。指定できる値は，10進数の値で，1〜720（単位：分）です。

ets={kl|nr|wr|an};

実行打ち切り時間が経過したあとのイベントジョブの状態を定義します。省略した場合，klが仮定されます。起動条件内のジョブの場合，このパラメーターは無効になります。

kl：強制終了

nr：正常終了

wr：警告検出終了

an：異常検出終了

mm={and|or};

指定した待ち合わせ対象ユニットとの待ち合わせ方法を指定します。

省略した場合はandが仮定されます。

and：すべての待ち合わせ対象ユニットが終了したら実行を開始する。

or：待ち合わせ対象ユニットが一つでも終了したら実行を開始する。

nmg={y|n};

指定した待ち合わせ対象ユニットのルートジョブネットに待ち合わせる世代がないときの動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

eun=待ち合わせ対象ユニット名;

待ち合わせ対象ユニットとするユニットを，完全名で指定します。

待ち合わせ対象ユニットを複数指定する場合，このパラメーターを複数回指定します。最大で32個指定できます。

待ち合わせ対象ユニット名に指定できる文字数は1〜930（単位：バイト）です。

ega={exec|execdeffer|none};

起動条件付きジョブネットを待ち合わせ対象に指定していて，実行世代に異常終了がある場合の動作を指定します。

省略した場合はnoneが仮定されます。

exec：実行を開始する。

execdeffer：実行を開始しない。ただし，実行世代が「繰り越し未実行」状態の場合は，実行を開始する。

none：実行を開始しない。

uem={y|n};

起動条件付きジョブネットを待ち合わせ対象に指定していて，監視世代が監視未起動終了の場合の動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

注意事項

イベントジョブの受信情報を引き継ぎ情報として，標準ジョブやアクションジョブのパラメーターに引き継ぐ場合で，引き継ぐ情報に「"（ダブルクォーテーションマーク）」が含まれるとき，「¥」を前に付けて指定する必要があります。「¥」を付けない場合，受信情報を引き継いでも「"（ダブルクォーテーションマーク）」が無視されるなどの現象が発生します。これを防止するためには，「"（ダブルクォーテーションマーク）」を含むデータを指定したとおりに引き継ぎ情報として引き継がせるオプションを設定してください。

設定については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　6.3.4 「"（ダブルクォーテーションマーク）」を含むデータをイベントジョブおよびカスタムイベントジョブの引き継ぎ情報に使用するための設定」（Windowsの場合）またはマニュアル「JP1/Automatic Job Management System 3 構築ガイド　15.3.4 「"（ダブルクォーテーションマーク）」を含むデータをイベントジョブおよびカスタムイベントジョブの引き継ぎ情報に使用するための設定」（UNIXの場合）を参照してください。

5.2.10　ファイル監視ジョブ定義情報の記述方法

ファイル監視ジョブ定義情報の記述方法を説明します。

ファイル監視ジョブ定義情報の形式，およびパラメーターを次に示します。

形式

[flwf="監視対象ファイル名";]
[flwc=c[:d[:{s|m}]];]
[flwi=監視間隔;]
[flco={y|n};]
[jpoif=マクロ変数名:引き継ぎ情報名;]...
[etm=n;]
[fd=実行所要時間;]
[ex="実行エージェント名";]
[ha={y|n};]
[eu={ent|def};]
[ets={kl|nr|wr|an};]
[mm={and|or};]
[nmg={y|n};]
[eun=待ち合わせ対象ユニット名;]...
[ega={exec|execdeffer|none};]
[uem={y|n};]

パラメーター

flwf="監視対象ファイル名";

監視対象ファイル名を定義します。

指定できる文字数は，1〜255（単位：バイト）です。ファイル名は，完全名，または「*（ワイルドカード）」を使用した総称名で指定できます。ただし，flwiパラメーターに監視間隔として1〜9を指定する場合，ファイル名は「*（ワイルドカード）」を使用した総称名では指定できません。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

ネットワークを介したファイルを指定する場合は，ファイル名をUNCパスで指定します。ネットワークドライブ名から始まるパスは指定できません。

マクロ変数を指定できます。

flwc=c[:d[:{s|m}]];

監視条件を定義します。複数指定できます。ただし，sとmは同時には指定できません。省略した場合，cが仮定されます。

c：ファイルの作成を監視します。

d：ファイルの削除を監視します。

s：ファイルのサイズ変更を監視します。

m：ファイルの最終書き込み時刻変更を監視します。

flwi=監視間隔;

ファイルを監視する時間間隔を定義します。

指定できる値は，1〜600（単位：秒）です。ただし，flwfパラメーターに監視対象ファイル名を「*（ワイルドカード）」を使用した総称名で指定する場合，監視間隔に1〜9は指定できません。省略した場合，60が仮定されます。

flco={y|n};

flwcパラメーターにcを指定している場合で，かつ，監視対象ファイルがファイル監視ジョブの実行時に存在していた場合に，監視条件を成立させるかどうかを定義します。このパラメーターは，flwcパラメーターにcを指定している場合にだけ指定できます。省略した場合，nが仮定されます。

y：監視条件成立とし，ジョブを正常終了します。

n：ファイル監視ジョブ実行後から，監視対象ファイルの作成を監視します。

jpoif=マクロ変数名:引き継ぎ情報名;

マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

マクロ変数を複数指定する場合，このパラメーターを複数回指定します（「jpoif=マクロ変数名:引き継ぎ情報名;」の形式で，バイト数の合計が2,048バイトまで複数指定できます）。

このパラメーターでは，後続のUNIXジョブ，PCジョブ，フレキシブルジョブ，HTTP接続ジョブ，およびアクションジョブに対してイベント情報を引き継げます。

etm=n;

実行打ち切り時間を，実行開始時刻からの相対分で定義します。指定できる値は，1〜1,440（単位：分）です。起動条件内のジョブの場合，このパラメーターは無効になります。

fd=実行所要時間;

終了遅延監視するジョブの実行所要時間を定義します。

指定できる値は，10進数の値で1〜1,440（単位：分）です。

起動条件として定義する場合，このパラメーターはジョブ実行時に無効になります。

ex="実行エージェント名";

ジョブを実行する実行エージェント名を定義します。

指定できる文字数は，1〜255（単位：バイト）です。

実行エージェント名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

マクロ変数を指定できます。

ha={y|n};

ジョブの実行を保留するかを定義します。省略した場合，nが仮定されます。起動条件内のジョブの場合，このパラメーターは無効になります。

y：保留します。

n：保留しません。

eu={ent|def};

ジョブ実行時のJP1ユーザーを定義します。省略した場合，entが仮定されます。イベントジョブの場合，このパラメーターの指定は無視されます。

ent：ジョブネットを登録したJP1ユーザーをジョブ実行時のJP1ユーザーとします。

def：ジョブを所有するJP1ユーザーをジョブ実行時のJP1ユーザーとします。

ets={kl|nr|wr|an};

実行打ち切り時間が経過したあとのイベントジョブの状態を定義します。省略した場合，klが仮定されます。起動条件内のジョブの場合，このパラメーターは無効になります。

kl：強制終了

nr：正常終了

wr：警告検出終了

an：異常検出終了

mm={and|or};

指定した待ち合わせ対象ユニットとの待ち合わせ方法を指定します。

省略した場合はandが仮定されます。

and：すべての待ち合わせ対象ユニットが終了したら実行を開始する。

or：待ち合わせ対象ユニットが一つでも終了したら実行を開始する。

nmg={y|n};

指定した待ち合わせ対象ユニットのルートジョブネットに待ち合わせる世代がないときの動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

eun=待ち合わせ対象ユニット名;

待ち合わせ対象ユニットとするユニットを，完全名で指定します。

待ち合わせ対象ユニットを複数指定する場合，このパラメーターを複数回指定します。最大で32個指定できます。

待ち合わせ対象ユニット名に指定できる文字数は1〜930（単位：バイト）です。

ega={exec|execdeffer|none};

起動条件付きジョブネットを待ち合わせ対象に指定していて，実行世代に異常終了がある場合の動作を指定します。

省略した場合はnoneが仮定されます。

exec：実行を開始する。

execdeffer：実行を開始しない。ただし，実行世代が「繰り越し未実行」状態の場合は，実行を開始する。

none：実行を開始しない。

uem={y|n};

起動条件付きジョブネットを待ち合わせ対象に指定していて，監視世代が監視未起動終了の場合の動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

5.2.11　メール受信監視ジョブ定義情報の記述方法

メール受信監視ジョブ定義情報の記述方法を説明します。

メール受信監視ジョブ定義情報の形式，およびパラメーターを次に示します。

形式

[pfm={u|p};]
[mlprf="プロファイル名";]
[mladr="差出人";]...
[mlsbj="件名";]...
[mltxt="本文";]...
[mlsav={y|n};]
[mllst="メール受信リスト";]
[mlstx="本文ファイル名";]
[mlsfd="添付ファイル保存先フォルダ名";]
[mlafl="リストファイル名";]
[jpoif=マクロ変数名:引き継ぎ情報名;]...
[etm=n;]
[fd=実行所要時間;]
[ex="実行エージェント名";]
[ha={y|n};]
[eu={ent|def};]
[ets={kl|nr|wr|an};]
[mm={and|or};]
[nmg={y|n};]
[eun=待ち合わせ対象ユニット名;]...
[ega={exec|execdeffer|none};]
[uem={y|n};]

パラメーター

pfm={u|p};

メール受信定義をプラットフォームごとに指定します。省略した場合，pが仮定されます。

p：Windows環境でメールを受信するための定義をします。

u：UNIX環境でメールを受信するための定義をします。

mlprf="プロファイル名";

メール受信監視ジョブを実行するエージェントホスト上の環境設定パラメーターProfileName1〜ProfileName4に設定したプロファイル名を定義します。

このパラメーターは，「pfm=p;」を指定した場合にだけ有効です。また，「pfm=p;」を指定した場合には，必須の項目になります。

指定できる文字数は，1〜256（単位：バイト）です。

プロファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

環境設定パラメーターの詳細については，マニュアル「JP1/Automatic Job Management System 3 連携ガイド　2.3.4 メールシステム連携のための環境設定をする」を参照してください。

mladr="差出人";

受信したメールの差出人を定義します。

指定できる文字数は，1〜256（単位：バイト）です。「mladr="差出人";」の形式で，20件まで同時に指定できます。

「mladr="差出人";」「mlsbj="件名";」「mltxt="本文";」をすべて省略することはできません。必ず，一つ以上の項目を定義する必要があります。

差出人名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

なお，メール受信監視ジョブを実行するホストがWindowsの場合，差出人の文字数は255文字以内で指定してください。バイト数は256バイト以内で指定できますが，文字数が256文字以上だと，メール受信の監視条件が成立しません。

mlsbj="件名";

受信したメールの件名を定義します。

指定できる文字数は，1〜256（単位：バイト）です。「mlsbj="件名";」の形式で，20件まで同時に指定できます。

「mladr="送信者";」「mlsbj="件名";」「mltxt="本文";」をすべて省略することはできません。必ず，一つ以上の項目を定義する必要があります。

件名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

なお，メール受信監視ジョブを実行するホストがWindowsの場合，件名の文字数は253文字以内で指定してください。バイト数は256バイト以内で指定できますが，文字数が254文字以上だと，メール受信の監視条件が成立しません。

mltxt="本文";

受信したメールの本文を定義します。

指定できる文字数は，1〜512（単位：バイト）です。「mltxt="本文";」の形式で，20件まで同時に指定できます。

「mladr="送信者";」「mlsbj="件名";」「mltxt="本文";」をすべて省略することはできません。必ず，一つ以上の項目を定義する必要があります。

本文中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

メール受信監視の実行ホストがUNIXの場合，本文に改行を入力しないでください。本文に改行を指定した場合，メール受信監視の監視条件と一致しなくなり，受信監視状態のままになります。

mlsav={y|n};

受信したメールを保存するかを定義します。省略した場合，yが仮定されます。このパラメーターは，「pfm=u;」を指定した場合にだけ有効です。

y：メールを保存します。

n：メールを保存しません。

mllst="メール受信リスト名";

監視条件に一致したメールのリストを作成する場合の，メール受信リスト名を定義します。このパラメーターは，「pfm=u;」を指定した場合にだけ有効です。

指定できる文字数は，1〜255（単位：バイト）です。

リスト名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

mlstx="本文ファイル名";

受信したメールの本文をファイルに保存する場合のファイル名を定義します。このパラメーターは，「pfm=p;」を指定した場合にだけ有効です。

指定できる文字数は，1〜256（単位：バイト）です。ファイル名はフルパスで指定します。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

mlsfd="添付ファイル保存先フォルダ名";

受信したメールの添付ファイルを保存する場合のフォルダ名を定義します。このパラメーターは，「pfm=p;」を指定した場合にだけ有効です。

指定できる文字数は，1〜256（単位：バイト）です。フォルダ名はフルパスで指定します。

フォルダ名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

mlafl="リストファイル名"

受信したメールの添付ファイルのファイル名一覧を作成する場合のファイル名を定義します。このパラメーターは，「pfm=p;」を指定した場合にだけ有効です。

指定できる文字数は，1〜256（単位：バイト）です。ファイル名はフルパス名で指定します。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

jpoif=マクロ変数名:引き継ぎ情報名;

マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

マクロ変数を複数指定する場合，このパラメーターを複数回指定します（「jpoif=マクロ変数名:引き継ぎ情報名;」の形式で，バイト数の合計が2,048バイトまで複数指定できます）。

このパラメーターでは，後続のUNIXジョブ，PCジョブ，フレキシブルジョブ，HTTP接続ジョブ，およびアクションジョブに対してイベント情報を引き継げます。

etm=n;

実行打ち切り時間を，実行開始時刻からの相対分で定義します。指定できる値は，1〜1,440（単位：分）です。起動条件内のジョブの場合，このパラメーターは無効になります。

fd=実行所要時間;

終了遅延監視するジョブの実行所要時間を定義します。

指定できる値は，10進数の値で1〜1,440（単位：分）です。

起動条件として定義する場合，このパラメーターはジョブ実行時に無効になります。

ex="実行エージェント名";

ジョブを実行する実行エージェント名を定義します。

指定できる文字数は，1〜255（単位：バイト）です。

実行エージェント名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

マクロ変数を指定できます。

ha={y|n};

ジョブの実行を保留するかを定義します。省略した場合，nが仮定されます。起動条件内のジョブの場合，このパラメーターは無効になります。

y：保留します。

n：保留しません。

eu={ent|def};

ジョブ実行時のJP1ユーザーを定義します。省略した場合，entが仮定されます。イベントジョブの場合，このパラメーターの指定は無視されます。

ent：ジョブネットを登録したJP1ユーザーをジョブ実行時のJP1ユーザーとします。

def：ジョブを所有するJP1ユーザーをジョブ実行時のJP1ユーザーとします。

ets={kl|nr|wr|an};

実行打ち切り時間が経過したあとのイベントジョブの状態を定義します。省略した場合，klが仮定されます。起動条件内のジョブの場合，このパラメーターは無効になります。

kl：強制終了

nr：正常終了

wr：警告検出終了

an：異常検出終了

mm={and|or};

指定した待ち合わせ対象ユニットとの待ち合わせ方法を指定します。

省略した場合はandが仮定されます。

and：すべての待ち合わせ対象ユニットが終了したら実行を開始する。

or：待ち合わせ対象ユニットが一つでも終了したら実行を開始する。

nmg={y|n};

指定した待ち合わせ対象ユニットのルートジョブネットに待ち合わせる世代がないときの動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

eun=待ち合わせ対象ユニット名;

待ち合わせ対象ユニットとするユニットを，完全名で指定します。

待ち合わせ対象ユニットを複数指定する場合，このパラメーターを複数回指定します。最大で32個指定できます。

待ち合わせ対象ユニット名に指定できる文字数は1〜930（単位：バイト）です。

ega={exec|execdeffer|none};

起動条件付きジョブネットを待ち合わせ対象に指定していて，実行世代に異常終了がある場合の動作を指定します。

省略した場合はnoneが仮定されます。

exec：実行を開始する。

execdeffer：実行を開始しない。ただし，実行世代が「繰り越し未実行」状態の場合は，実行を開始する。

none：実行を開始しない。

uem={y|n};

起動条件付きジョブネットを待ち合わせ対象に指定していて，監視世代が監視未起動終了の場合の動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

5.2.12　メッセージキュー受信監視ジョブ定義情報の記述方法

メッセージキュー受信監視ジョブ定義情報の記述方法を説明します。

メッセージキュー受信監視ジョブ定義情報の形式，およびパラメーターを次に示します。

形式

[mqcor=相関識別子;]
[mqque=メッセージ入力キュー名;]
[mqdsc=メッセージ識別子;]
[mqmdl=モデルキュー名;]
[mqsfn="メッセージ格納ファイル名";]
[jpoif=マクロ変数名:引き継ぎ情報名;]...
[etm=n;]
[fd=実行所要時間;]
[ex="実行エージェント名";]
[ha={y|n};]
[eu={ent|def};]
[ets={kl|nr|wr|an};]
[mm={and|or};]
[nmg={y|n};]
[eun=待ち合わせ対象ユニット名;]...
[ega={exec|execdeffer|none};]
[uem={y|n};]

パラメーター

mqcor=相関識別子;

受信したメッセージの相関識別子を定義します。

指定できる文字数は，1〜24（単位：バイト）です。ただし，指定できる文字は，英（大文字だけ）数字だけです。

mqque=メッセージ入力キュー名;

メッセージ受信を監視するキュー名を定義します。

指定できる文字数は，1〜48（単位：バイト）です。キュー名はMQ文字列で指定します。MQSeries連携を使用する場合，デフォルトのキューマネージャーに存在するキュー名を指定してください。

mqdsc=メッセージ識別子;

受信したメッセージのメッセージ識別子を定義します。

指定できる文字数は，1〜24（単位：バイト）です。ただし，指定できる文字は，英（大文字だけ）数字だけです。

mqmdl=モデルキュー名;

メッセージ受信を監視するキューのモデルキュー名を定義します。

指定できる文字数は，1〜48（単位：バイト）です。キュー名はMQ文字列で指定します。MQSeries連携を使用する場合，デフォルトのキューマネージャーに存在するキュー名を指定してください。

mqsfn="メッセージ格納ファイル名";

監視条件に一致したメッセージを格納するファイル名を定義します。

指定できる文字数は，1〜256（単位：バイト）です。ファイル名は完全名で指定します。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

jpoif=マクロ変数名:引き継ぎ情報名;

マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

マクロ変数を複数指定する場合，このパラメーターを複数回指定します（「jpoif=マクロ変数名:引き継ぎ情報名;」の形式で，バイト数の合計が2,048バイトまで複数指定できます）。

このパラメーターでは，後続のUNIXジョブ，PCジョブ，フレキシブルジョブ，HTTP接続ジョブ，およびアクションジョブに対してイベント情報を引き継げます。

etm=n;

実行打ち切り時間を，実行開始時刻からの相対分で定義します。指定できる値は，1〜1,440（単位：分）です。起動条件内のジョブの場合，このパラメーターは無効になります。

fd=実行所要時間;

終了遅延監視するジョブの実行所要時間を定義します。

指定できる値は，10進数の値で1〜1,440（単位：分）です。

起動条件として定義する場合，このパラメーターはジョブ実行時に無効になります。

ex="実行エージェント名";

ジョブを実行する実行エージェント名を定義します。

指定できる文字数は，1〜255（単位：バイト）です。

実行エージェント名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

ha={y|n};

ジョブの実行を保留するかを定義します。省略した場合，nが仮定されます。起動条件内のジョブの場合，このパラメーターは無効になります。

y：保留します。

n：保留しません。

eu={ent|def};

ジョブ実行時のJP1ユーザーを定義します。省略した場合，entが仮定されます。イベントジョブの場合，このパラメーターの指定は無視されます。

ent：ジョブネットを登録したJP1ユーザーをジョブ実行時のJP1ユーザーとします。

def：ジョブを所有するJP1ユーザーをジョブ実行時のJP1ユーザーとします。

ets={kl|nr|wr|an};

実行打ち切り時間が経過したあとのイベントジョブの状態を定義します。省略した場合，klが仮定されます。起動条件内のジョブの場合，このパラメーターは無効になります。

kl：強制終了

nr：正常終了

wr：警告検出終了

an：異常検出終了

mm={and|or};

指定した待ち合わせ対象ユニットとの待ち合わせ方法を指定します。

省略した場合はandが仮定されます。

and：すべての待ち合わせ対象ユニットが終了したら実行を開始する。

or：待ち合わせ対象ユニットが一つでも終了したら実行を開始する。

nmg={y|n};

指定した待ち合わせ対象ユニットのルートジョブネットに待ち合わせる世代がないときの動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

eun=待ち合わせ対象ユニット名;

待ち合わせ対象ユニットとするユニットを，完全名で指定します。

待ち合わせ対象ユニットを複数指定する場合，このパラメーターを複数回指定します。最大で32個指定できます。

待ち合わせ対象ユニット名に指定できる文字数は1〜930（単位：バイト）です。

ega={exec|execdeffer|none};

起動条件付きジョブネットを待ち合わせ対象に指定していて，実行世代に異常終了がある場合の動作を指定します。

省略した場合はnoneが仮定されます。

exec：実行を開始する。

execdeffer：実行を開始しない。ただし，実行世代が「繰り越し未実行」状態の場合は，実行を開始する。

none：実行を開始しない。

uem={y|n};

起動条件付きジョブネットを待ち合わせ対象に指定していて，監視世代が監視未起動終了の場合の動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

5.2.13　MSMQ受信監視ジョブ定義情報の記述方法

MSMQ受信監視ジョブ定義情報の記述方法を説明します。

MSMQ受信監視ジョブ定義情報の形式，およびパラメーターを次に示します。

形式

[msqpt="パス名";]
[msrer=相互関係;]
[mslbl="メッセージラベル";]
[msapl=アプリケーション情報;]
[mssvf="メッセージ格納ファイル名";]
[jpoif=マクロ変数名:引き継ぎ情報名;]...
[etm=n;]
[fd=実行所要時間;]
[ex="実行エージェント名";]
[ha={y|n};]
[eu={ent|def};]
[ets={kl|nr|wr|an};]
[mm={and|or};]
[nmg={y|n};]
[eun=待ち合わせ対象ユニット名;]...
[ega={exec|execdeffer|none};]
[uem={y|n};]

パラメーター

msqpt="パス名";

メッセージを監視するキューパス名を定義します。

指定できる文字数は，1〜259（単位：バイト）です。

パス名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

msrer=相互関係;

監視するメッセージの相互関係を定義します。

指定できる文字数は，1〜20（単位：バイト）です。ただし，指定できる文字は，英（大文字だけ）数字だけです。

mslbl="メッセージラベル";

監視するメッセージのメッセージラベルを定義します。

指定できる文字数は，1〜249（単位：バイト）です。

ラベル中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

msapl=アプリケーション情報;

監視するメッセージのアプリケーション情報を定義します。

指定できる値は，16進数の値で，0〜FFFFFFFFです。

mssvf="メッセージ格納ファイル名";

監視条件に一致したメッセージを格納するファイル名を定義します。

指定できる文字数は，1〜256（単位：バイト）です。ファイル名は完全名で指定します。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

jpoif=マクロ変数名:引き継ぎ情報名;

マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

マクロ変数を複数指定する場合，このパラメーターを複数回指定します（「jpoif=マクロ変数名:引き継ぎ情報名;」の形式で，バイト数の合計が2,048バイトまで複数指定できます）。

このパラメーターでは，後続のUNIXジョブ，PCジョブ，フレキシブルジョブ，HTTP接続ジョブ，およびアクションジョブに対してイベント情報を引き継げます。

etm=n;

実行打ち切り時間を，実行開始時刻からの相対分で定義します。指定できる値は，1〜1,440（単位：分）です。起動条件内のジョブの場合，このパラメーターは無効になります。

fd=実行所要時間;

終了遅延監視するジョブの実行所要時間を定義します。

指定できる値は，10進数の値で1〜1,440（単位：分）です。

起動条件として定義する場合，このパラメーターはジョブ実行時に無効になります。

ex="実行エージェント名";

ジョブを実行する実行エージェント名を定義します。

指定できる文字数は，1〜255（単位：バイト）です。

実行エージェント名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

ha={y|n};

ジョブの実行を保留するかを定義します。省略した場合，nが仮定されます。起動条件内のジョブの場合，このパラメーターは無効になります。

y：保留します。

n：保留しません。

eu={ent|def};

ジョブ実行時のJP1ユーザーを定義します。省略した場合，entが仮定されます。イベントジョブの場合，このパラメーターの指定は無視されます。

ent：ジョブネットを登録したJP1ユーザーをジョブ実行時のJP1ユーザーとします。

def：ジョブを所有するJP1ユーザーをジョブ実行時のJP1ユーザーとします。

ets={kl|nr|wr|an};

実行打ち切り時間が経過したあとのイベントジョブの状態を定義します。省略した場合，klが仮定されます。起動条件内のジョブの場合，このパラメーターは無効になります。

kl：強制終了

nr：正常終了

wr：警告検出終了

an：異常検出終了

mm={and|or};

指定した待ち合わせ対象ユニットとの待ち合わせ方法を指定します。

省略した場合はandが仮定されます。

and：すべての待ち合わせ対象ユニットが終了したら実行を開始する。

or：待ち合わせ対象ユニットが一つでも終了したら実行を開始する。

nmg={y|n};

指定した待ち合わせ対象ユニットのルートジョブネットに待ち合わせる世代がないときの動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

eun=待ち合わせ対象ユニット名;

待ち合わせ対象ユニットとするユニットを，完全名で指定します。

待ち合わせ対象ユニットを複数指定する場合，このパラメーターを複数回指定します。最大で32個指定できます。

待ち合わせ対象ユニット名に指定できる文字数は1〜930（単位：バイト）です。

ega={exec|execdeffer|none};

起動条件付きジョブネットを待ち合わせ対象に指定していて，実行世代に異常終了がある場合の動作を指定します。

省略した場合はnoneが仮定されます。

exec：実行を開始する。

execdeffer：実行を開始しない。ただし，実行世代が「繰り越し未実行」状態の場合は，実行を開始する。

none：実行を開始しない。

uem={y|n};

起動条件付きジョブネットを待ち合わせ対象に指定していて，監視世代が監視未起動終了の場合の動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

5.2.14　ログファイル監視ジョブ定義情報の記述方法

ログファイル監視ジョブ定義情報の記述方法を説明します。

ログファイル監視ジョブ定義情報の形式，およびパラメーターを次に示します。

形式

[lftpd=[!]"トラップデータ1"[:[!]"トラップデータ2"...];]...
[lffnm="ログファイル名";]...
[lfdft={s|s2|w1|w2};]
[lfrft={v:'[¥]区切り文字'|f:レコード長};]
[lfhds={l:ヘッダー行数|s:ヘッダーサイズ};]
[lfmks=[!]"ログ情報以外のデータ1"
     [:[!]"ログ情報以外のデータ2"...];]...
[lfsiv=ファイル監視間隔;]
[lfmxl=イベントデータの最大長;]
[lfsrc={y|n};]
[lfcre={y|n};]
[jpoif=マクロ変数名:引き継ぎ情報名;]...
[etm=n;]
[fd=実行所要時間;]
[ex="実行エージェント名";]
[ha={y|n};]
[eu={ent|def};]
[ets={kl|nr|wr|an};]
[mm={and|or};]
[nmg={y|n};]
[eun=待ち合わせ対象ユニット名;]...
[ega={exec|execdeffer|none};]
[uem={y|n};]

パラメーター

lftpd=[!]"トラップデータ1"[:[!]"トラップデータ2"...];

トラップするログファイル中のデータを定義します。

一つのlftpdパラメーターに複数のトラップデータを指定できます（AND条件が適用されます）。また，複数のlftpdパラメーターを指定できます（OR条件が適用されます）。バイト数の合計が2,048バイトまで複数指定できます。

トラップデータ中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

なお，トラップデータには正規表現が使用できます。

lffnm="ログファイル名";

監視するファイル名を定義します。

指定できる文字数は，1〜256（単位：バイト）です。「lffnm="ログファイル名"」の形式で，8件まで同時に指定できます。

ログファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

マクロ変数を指定できます。

lfdft={s|s2|w1|w2};

トラップするログファイルの出力形式を定義します。省略した場合，sが仮定されます。

s：シーケンシャルファイル（一つのログファイルに追加書き込みし続けるファイル。ログファイルが一定の容量に達すると，別のファイル名で新たにログファイルを作成して書き込むファイル）

s2：シーケンシャルファイル（ファイル名を変更して保存，またはファイルをいったん削除したあと，同じ名称のファイルを作成して新たにログを書き込むファイル）

ジョブの実行先ホストがWindowsの場合は，JP1/Baseが08-10以降で，JP1/AJS3，またはJP1/AJS2 08-00以降のときに指定できます。

UNIXの場合は，JP1/Baseが07-00以降で，JP1/AJS3，またはJP1/AJS2 07-00以降のときに指定できます。

w1：ラップアラウンド（ログファイルが一定の容量に達すると，ラップアラウンドして再び先頭からデータを上書きする形式のファイル）

w2：ラップアラウンド（ログファイルが一定の容量に達してラップアラウンドするとき，データを削除して再び先頭からデータを書き込む形式のファイル）

lfrft={v:'[¥]区切り文字'|f:レコード長};

トラップするログデータのレコード形式を定義します。省略した場合，v:'¥n'が仮定されます。

v:'[¥]区切り文字'：可変長レコードで行を区切ります。区切り文字に指定できる文字数は，1（単位：バイト）です。

f:レコード長：固定長レコードで行を区切ります。レコード長に指定できる文字数は，1〜9,999,999（単位：バイト）です。

lfhds={l:ヘッダー行数|s:ヘッダーサイズ};

ヘッダーを定義します。

l:ヘッダー行数：トラップするログファイルの先頭にヘッダーがある場合，ヘッダーの行数を指定します。

ヘッダー行数に指定できる値は，0〜99,999（単位：行）です。

s:ヘッダーサイズ：バイナリーデータやレコード形式がログレコードと異なっているなどの理由で，トラップするログファイルの先頭に行数で指定できないヘッダーがある場合，ヘッダーのサイズを指定します。

ヘッダーサイズに指定できる値は，0〜9,999,999（単位：バイト）です。

lfmks=[!]"ログ情報以外のデータ1"[:[!]"ログ情報以外のデータ2"...];

トラップするログファイル中にログ情報以外のデータが含まれる場合，そのデータを定義します。

データは複数指定できます（バイト数の合計が1,024バイトまで複数指定できます）。

データ中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

なお，データには正規表現が使用できます。

複数のlfmksパラメーターを指定した場合，OR条件が適用されます。一つのlfmksパラメーターに複数のデータを指定した場合は，AND条件が適用されます。

lfsiv=ファイル監視間隔;

ログファイルを検索する時間間隔を定義します。

指定できる値は，1〜86,400（単位：秒）です。省略した場合，10が仮定されます。

lfmxl=イベントデータの最大長;

入力する指定ログファイル1行の先頭何バイト分をイベントデータにするかを定義します。

指定できる値は，2〜512（単位：バイト）です。省略した場合，512が仮定されます。

lfsrc={y|n};

データの入力を先頭データから入力するかを定義します。省略した場合，nが仮定されます。

y：先頭データから入力します。

n：先頭データから入力しません。

lfcre={y|n};

ログファイル監視ジョブを開始した場合に，指定したログファイルがなかったときにエラーにするかを定義します。省略した場合，nが仮定されます。

y：エラーとします。

n：ログファイルが作成されるまで，ファイルのオープンを繰り返します。

jpoif=マクロ変数名:引き継ぎ情報名;

マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

マクロ変数を複数指定する場合，このパラメーターを複数回指定します（「jpoif=マクロ変数名:引き継ぎ情報名;」の形式で，バイト数の合計が2,048バイトまで複数指定できます）。

このパラメーターでは，後続のPCジョブ，UNIXジョブ，フレキシブルジョブ，HTTP接続ジョブ，およびアクションジョブに対してイベント情報を引き継げます。

etm=n;

実行打ち切り時間を，実行開始時刻からの相対分で定義します。指定できる値は，1〜1,440（単位：分）です。起動条件内のジョブの場合，このパラメーターは無効になります。

fd=実行所要時間;

終了遅延監視するジョブの実行所要時間を定義します。

指定できる値は，10進数の値で1〜1,440（単位：分）です。

起動条件として定義する場合，このパラメーターはジョブ実行時に無効になります。

ex="実行エージェント名";

ジョブを実行する実行エージェント名を定義します。

指定できる文字数は，1〜255（単位：バイト）です。

実行エージェント名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

マクロ変数を指定できます。

ha={y|n};

ジョブの実行を保留するかを定義します。省略した場合，nが仮定されます。起動条件内のジョブの場合，このパラメーターは無効になります。

y：保留します。

n：保留しません。

eu={ent|def};

ジョブ実行時のJP1ユーザーを定義します。省略した場合，entが仮定されます。イベントジョブの場合，このパラメーターの指定は無視されます。

ent：ジョブネットを登録したJP1ユーザーをジョブ実行時のJP1ユーザーとします。

def：ジョブを所有するJP1ユーザーをジョブ実行時のJP1ユーザーとします。

ets={kl|nr|wr|an};

実行打ち切り時間が経過したあとのイベントジョブの状態を定義します。省略した場合，klが仮定されます。起動条件内のジョブの場合，このパラメーターは無効になります。

kl：強制終了

nr：正常終了

wr：警告検出終了

an：異常検出終了

mm={and|or};

指定した待ち合わせ対象ユニットとの待ち合わせ方法を指定します。

省略した場合はandが仮定されます。

and：すべての待ち合わせ対象ユニットが終了したら実行を開始する。

or：待ち合わせ対象ユニットが一つでも終了したら実行を開始する。

nmg={y|n};

指定した待ち合わせ対象ユニットのルートジョブネットに待ち合わせる世代がないときの動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

eun=待ち合わせ対象ユニット名;

待ち合わせ対象ユニットとするユニットを，完全名で指定します。

待ち合わせ対象ユニットを複数指定する場合，このパラメーターを複数回指定します。最大で32個指定できます。

待ち合わせ対象ユニット名に指定できる文字数は1〜930（単位：バイト）です。

ega={exec|execdeffer|none};

起動条件付きジョブネットを待ち合わせ対象に指定していて，実行世代に異常終了がある場合の動作を指定します。

省略した場合はnoneが仮定されます。

exec：実行を開始する。

execdeffer：実行を開始しない。ただし，実行世代が「繰り越し未実行」状態の場合は，実行を開始する。

none：実行を開始しない。

uem={y|n};

起動条件付きジョブネットを待ち合わせ対象に指定していて，監視世代が監視未起動終了の場合の動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

注意事項

ログファイル名には，空白文字や記号なども使用できます。ただし，「"（ダブルクォーテーションマーク）」などの特殊文字を通常文字として扱う場合は，特殊文字の前に「¥」を指定してください。

（例）　log¥#"file

イベントジョブの受信情報を引き継ぎ情報として，標準ジョブやアクションジョブのパラメーターに引き継ぐ場合で，引き継ぐ情報に「"（ダブルクォーテーションマーク）」が含まれるとき，「¥」を前に付けて指定する必要があります。「¥」を付けない場合，受信情報を引き継いでも「"（ダブルクォーテーションマーク）」が無視されるなどの現象が発生します。これを防止するためには，「"（ダブルクォーテーションマーク）」を含むデータを指定したとおりに引き継ぎ情報として引き継がせるオプションを設定してください。

設定については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　6.3.4 「"（ダブルクォーテーションマーク）」を含むデータをイベントジョブおよびカスタムイベントジョブの引き継ぎ情報に使用するための設定」（Windowsの場合）またはマニュアル「JP1/Automatic Job Management System 3 構築ガイド　15.3.4 「"（ダブルクォーテーションマーク）」を含むデータをイベントジョブおよびカスタムイベントジョブの引き継ぎ情報に使用するための設定」（UNIXの場合）を参照してください。

5.2.15　Windowsイベントログ監視ジョブ定義情報の記述方法

Windowsイベントログ監視ジョブ定義情報の記述方法を説明します。

Windowsイベントログ監視ジョブ定義情報の形式，およびパラメーターを次に示します。

形式

[ntlgt={sys|sec|app|dns|dir|frs|oth};]
[ntolg="任意のログ種別";]
[ntevt=[v[:i[:w[:e[:s[:c[:f]]]]]]];]
[ntnsr={y|n};]
[ntsrc="ソース";]
[ntncl={y|n};]
[ntcls="分類";]
[ntnei={y|n};]
[nteid=イベントID;]
[ntdis="説明";]
[jpoif=マクロ変数名:引き継ぎ情報名;]...
[etm=n;]
[fd=実行所要時間;]
[ex="実行エージェント名";]
[ha={y|n};]
[eu={ent|def};]
[ets={kl|nr|wr|an};]
[mm={and|or};]
[nmg={y|n};]
[eun=待ち合わせ対象ユニット名;]...
[ega={exec|execdeffer|none};]
[uem={y|n};]

パラメーター

ntlgt={sys|sec|app|dns|dir|frs|oth};

ログ種別を定義します。省略した場合，sysが仮定されます。

sys：システムログを監視します。

sec：セキュリティログを監視します。

app：アプリケーションログを監視します。

dns：DNS Serverログを監視します。※

dir：Directory Serviceログを監視します。※

frs：ファイル複製サービスログを監視します。※

oth：任意のログ種別に指定したログ種別を監視します。同時にntolgパラメーターの指定が必要です。

注※　Windows 2000の場合だけ定義できます。

ntolg="任意のログ種別"

監視対象とする任意のログ種別を定義します。

指定できる文字数は，1〜255（単位:バイト）です。

任意のログ種別に「″（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「″」は「#″」，「#」は「##」と記述します。

ntlgtパラメーターにothを指定した場合，このパラメーターを指定していないとエラーになります。ntlgtパラメーターにoth以外を指定した場合，このパラメーターを指定するとエラーになります。

ntevt=[v[:i[:w[:e[:c[:s[:f]]]]]]];

イベントの種類を定義します。省略した場合，すべての種類が仮定されます。

v：詳細イベントを監視します。

i：情報イベントを監視します。

w：警告イベントを監視します。

e：エラーイベントを監視します。

c：重大イベントを監視します。

s：成功の監査イベントを監視します。

f：失敗の監査イベントを監視します。

ntnsr={y|n};

監視するソースの判定条件を定義します。省略した場合，yが仮定されます。

y：指定したソースを監視対象とします。

n：指定したソース以外のソースを監視対象とします。「NOT」指定。

ntsrc="ソース";

監視するソースを定義します。

指定できる文字数は，1〜255（単位：バイト）です。

ソース中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

ntncl={y|n};

監視するイベント分類の判定条件を定義します。省略した場合，yが仮定されます。

y：指定した分類を監視対象とします。

n：指定した分類以外の分類を監視対象とします。「NOT」指定。

ntcls="分類";

監視するイベントの分類を定義します。

指定できる文字列は，1〜255（単位：バイト）です。

Windowsイベントが分類できなかった場合，Windowsの［イベントビューア］には「なし」と表示されます。このような分類できなかったイベントを監視したい場合は，分類に「None」と指定してください。「なし」と指定しても条件は成立しませんので注意してください。

ntnei={y|n};

監視するイベントIDの判定条件を定義します。省略した場合，yが仮定されます。

y：指定したイベントIDを監視対象とします。

n：指定したイベントID以外のIDを監視対象とします。

nteid=イベントID;

監視するイベントのイベントIDを定義します。

指定できる値は，0〜4,294,967,295です。

ntdis="説明";

指定したイベントの説明を監視する場合に，比較対象となる文字列を定義します。

指定できる文字数は，1〜1,024（単位：バイト）です。

説明中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

なお，説明には正規表現が使用できます。

jpoif=マクロ変数名:引き継ぎ情報名;

マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

マクロ変数を複数指定する場合，このパラメーターを複数回指定します（jpoif=マクロ変数名:引き継ぎ情報名;」の形式で，バイト数の合計が2,048バイトまで複数指定できます）。

このパラメーターでは，後続のUNIXジョブ，PCジョブ，フレキシブルジョブ，HTTP接続ジョブ，およびアクションジョブに対してイベント情報を引き継げます。

etm=n;

実行打ち切り時間を，実行開始時刻からの相対分で定義します。指定できる値は，1〜1,440（単位：分）です。起動条件内のジョブの場合，このパラメーターは無効になります。

fd=実行所要時間;

終了遅延監視するジョブの実行所要時間を定義します。

指定できる値は，10進数の値で1〜1,440（単位：分）です。

起動条件として定義する場合，このパラメーターはジョブ実行時に無効になります。

ex="実行エージェント名";

ジョブを実行する実行エージェント名を定義します。

指定できる文字数は，1〜255（単位：バイト）です。

実行エージェント名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

マクロ変数を指定できます。

ha={y|n};

ジョブの実行を保留するかを定義します。省略した場合，nが仮定されます。起動条件内のジョブの場合，このパラメーターは無効になります。

y：保留します。

n：保留しません。

eu={ent|def};

ジョブ実行時のJP1ユーザーを定義します。省略した場合，entが仮定されます。イベントジョブの場合，このパラメーターの指定は無視されます。

ent：ジョブネットを登録したJP1ユーザーをジョブ実行時のJP1ユーザーとします。

def：ジョブを所有するJP1ユーザーをジョブ実行時のJP1ユーザーとします。

ets={kl|nr|wr|an};

実行打ち切り時間が経過したあとのイベントジョブの状態を定義します。省略した場合，klが仮定されます。起動条件内のジョブの場合，このパラメーターは無効になります。

kl：強制終了

nr：正常終了

wr：警告検出終了

an：異常検出終了

mm={and|or};

指定した待ち合わせ対象ユニットとの待ち合わせ方法を指定します。

省略した場合はandが仮定されます。

and：すべての待ち合わせ対象ユニットが終了したら実行を開始する。

or：待ち合わせ対象ユニットが一つでも終了したら実行を開始する。

nmg={y|n};

指定した待ち合わせ対象ユニットのルートジョブネットに待ち合わせる世代がないときの動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

eun=待ち合わせ対象ユニット名;

待ち合わせ対象ユニットとするユニットを，完全名で指定します。

待ち合わせ対象ユニットを複数指定する場合，このパラメーターを複数回指定します。最大で32個指定できます。

待ち合わせ対象ユニット名に指定できる文字数は1〜930（単位：バイト）です。

ega={exec|execdeffer|none};

起動条件付きジョブネットを待ち合わせ対象に指定していて，実行世代に異常終了がある場合の動作を指定します。

省略した場合はnoneが仮定されます。

exec：実行を開始する。

execdeffer：実行を開始しない。ただし，実行世代が「繰り越し未実行」状態の場合は，実行を開始する。

none：実行を開始しない。

uem={y|n};

起動条件付きジョブネットを待ち合わせ対象に指定していて，監視世代が監視未起動終了の場合の動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

5.2.16　実行間隔制御ジョブ定義情報の記述方法

実行間隔制御ジョブ定義情報の記述方法を説明します。

実行間隔制御ジョブ定義情報の形式，およびパラメーターを次に示します。

形式

[tmitv=待ち時間;]
[etn={y|n};]
[jpoif=マクロ変数名:引き継ぎ情報名;]...
[etm=n;]
[fd=実行所要時間;]
[ex="実行エージェント名";]
[ha={y|n};]
[eu={ent|def};]
[ets={kl|nr|wr|an};]
[mm={and|or};]
[nmg={y|n};]
[eun=待ち合わせ対象ユニット名;]...
[ega={exec|execdeffer|none};]
[uem={y|n};]

パラメーター

tmitv=待ち時間;

待ち時間を定義します。

指定できる値は，1〜1,440（単位：分）です。省略した場合，10が仮定されます。

etn={y|n};

実行間隔制御ジョブを起動条件として定義した場合，開始直後に満了するかどうかを指定します。省略した場合，nが仮定されます。

y：開始直後に満了して，すぐに最初の実行を開始する。

n：開始直後には満了しないで，待ち時間に指定した時間を待ってから，最初の実行を開始する。

起動条件ではなく，通常のジョブネットに定義する実行間隔制御ジョブでは，このパラメーターにyを指定できません。指定した場合，メッセージKAVS0669-Eが出力され，実行間隔制御ジョブの作成に失敗します。

jpoif=マクロ変数名:引き継ぎ情報名;

マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

マクロ変数を複数指定する場合，このパラメーターを複数回指定します（「jpoif=マクロ変数名:引き継ぎ情報名;」の形式で，バイト数の合計が2,048バイトまで複数指定できます）。

このパラメーターでは，後続のUNIXジョブ，PCジョブ，フレキシブルジョブ，HTTP接続ジョブ，およびアクションジョブに対してイベント情報を引き継げます。

etm=n;

実行打ち切り時間を，実行開始時刻からの相対分で定義します。指定できる値は，1〜1,440（単位：分）です。起動条件内のジョブの場合，このパラメーターは無効になります。

fd=実行所要時間;

終了遅延監視するジョブの実行所要時間を定義します。

指定できる値は，10進数の値で1〜1,440（単位：分）です。

起動条件として定義する場合，このパラメーターはジョブ実行時に無効になります。

ex="実行エージェント名";

ジョブを実行する実行エージェント名を定義します。

指定できる文字数は，1〜255（単位：バイト）です。

実行エージェント名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

マクロ変数を指定できます。

ha={y|n};

ジョブの実行を保留するかを定義します。省略した場合，nが仮定されます。起動条件内のジョブの場合，このパラメーターは無効になります。

y：保留します。

n：保留しません。

eu={ent|def};

ジョブ実行時のJP1ユーザーを定義します。省略した場合，entが仮定されます。イベントジョブの場合，このパラメーターの指定は無視されます。

ent：ジョブネットを登録したJP1ユーザーをジョブ実行時のJP1ユーザーとします。

def：ジョブを所有するJP1ユーザーをジョブ実行時のJP1ユーザーとします。

ets={kl|nr|wr|an};

実行打ち切り時間が経過したあとのイベントジョブの状態を定義します。省略した場合，klが仮定されます。起動条件内のジョブの場合，このパラメーターは無効になります。

kl：強制終了

nr：正常終了

wr：警告検出終了

an：異常検出終了

mm={and|or};

指定した待ち合わせ対象ユニットとの待ち合わせ方法を指定します。

省略した場合はandが仮定されます。

and：すべての待ち合わせ対象ユニットが終了したら実行を開始する。

or：待ち合わせ対象ユニットが一つでも終了したら実行を開始する。

nmg={y|n};

指定した待ち合わせ対象ユニットのルートジョブネットに待ち合わせる世代がないときの動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

eun=待ち合わせ対象ユニット名;

待ち合わせ対象ユニットとするユニットを，完全名で指定します。

待ち合わせ対象ユニットを複数指定する場合，このパラメーターを複数回指定します。最大で32個指定できます。

待ち合わせ対象ユニット名に指定できる文字数は1〜930（単位：バイト）です。

ega={exec|execdeffer|none};

起動条件付きジョブネットを待ち合わせ対象に指定していて，実行世代に異常終了がある場合の動作を指定します。

省略した場合はnoneが仮定されます。

exec：実行を開始する。

execdeffer：実行を開始しない。ただし，実行世代が「繰り越し未実行」状態の場合は，実行を開始する。

none：実行を開始しない。

uem={y|n};

起動条件付きジョブネットを待ち合わせ対象に指定していて，監視世代が監視未起動終了の場合の動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

5.2.17　JP1イベント送信ジョブ定義情報の記述方法

JP1イベント送信ジョブ定義情報の記述方法を説明します。

JP1イベント送信ジョブ定義情報の形式，およびパラメーターを次に示します。

形式

[evsid=イベントID;]
[evhst="イベント送信先ホスト名";]
[evsms="メッセージ";]
[evssv={em|al|cr|er|wr|no|in|db};]
[evsfr=拡張属性名:"値";]
[pfm={u|p};]
[etm=n;]
[fd=実行所要時間;]
[ex="実行エージェント名";]
[ha={y|n};]
[eu={ent|def};]
[evsrt={y|n};]
[evspl=確認間隔;]
[evsrc=確認回数;]
[jty={q|n};]
[mm={and|or};]
[nmg={y|n};]
[eun=待ち合わせ対象ユニット名;]...
[ega={exec|execdeffer|none};]
[uem={y|n};]

パラメーター

evsid=イベントID;

送信するイベントIDを定義します。

指定できる値は，16進数の値で，00000000〜00001FFF，7FFF8000〜7FFFFFFFです。

evhst="イベント送信先ホスト名";

イベント送信先ホスト名を定義します。evsrtパラメーターにyを指定した場合，このパラメーターの指定は必須です。

指定できる文字数は，1〜255（単位：バイト）です。

マクロ変数を指定できます。

evsms="メッセージ";

イベントに付加するメッセージを定義します。指定できる文字数は，1〜1,023（単位：バイト）です。

マクロ変数を指定できます。

evssv={em|al|cr|er|wr|no|in|db};

イベントに付加する重大度を定義します。省略した場合，noが仮定されます。

em：「Emergency」を設定します。

al：「Alert」を設定します。

cr：「Critical」を設定します。

er：「Error」を設定します。

wr：「Warning」を設定します。

no：「Notice」を設定します。

in：「Information」を設定します。

db：「Debug」を設定します。

evsfr=拡張属性名:"値";

イベントに付加する拡張属性を定義します。

指定できる文字数は，「evsfr=拡張属性名:"値";」の形式で，5〜128（単位：バイト）です。

値には，マクロ変数を指定できます。

pfm={u|p};

ジョブを実行するプラットフォーム種別を指定します。省略した場合，pが仮定されます。

p：Windows環境で実行します。

u：UNIX環境で実行します。

etm=n;

実行打ち切り時間を，実行開始時刻からの相対分で定義します。指定できる値は，1〜1,440（単位：分）です。

fd=実行所要時間;

終了遅延監視するジョブの実行所要時間を定義します。

指定できる値は，10進数の値で1〜1,440（単位：分）です。

ex="実行エージェント名";

ジョブを実行する実行エージェント名または実行エージェントグループ名を定義します。

指定できる文字数は，1〜255（単位：バイト）です。

実行エージェント名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

キューイング属性あり（jty=q）の場合は，マクロ変数を指定できます。

ha={y|n};

ジョブの実行を保留するかを定義します。省略した場合，nが仮定されます。

y：保留します。

n：保留しません。

eu={ent|def};

ジョブ実行時のJP1ユーザーを定義します。省略した場合，entが仮定されます。

ent：ジョブネットを登録したJP1ユーザーをジョブ実行時のJP1ユーザーとします。

def：ジョブを所有するJP1ユーザーをジョブ実行時のJP1ユーザーとします。

evsrt={y|n};

イベント到達確認を行うかどうかを定義します。省略した場合，nが仮定されます。

yを指定した場合，JP1イベントを送信してから3秒後に到達確認をします。

y：到達確認を行います。

n：到達確認を行いません。

evspl=確認間隔;

JP1イベントが到達していなかった場合，到達確認を行う間隔を定義します。指定できる値は，10進数の値で，3〜600（単位：秒）です。

省略した場合，10が仮定されます。

evsrc=確認回数;

JP1イベントが到達していなかった場合，到達確認を行う回数を定義します。指定できる値は，10進数の値で，0〜999（単位：回）です。

省略した場合，0が仮定されます。

jty={q|n};

キューイング属性の種別を定義します。省略した場合，qが仮定されます。

q：キューイング属性あり。

n：キューイング属性なし。

mm={and|or};

指定した待ち合わせ対象ユニットとの待ち合わせ方法を指定します。

省略した場合はandが仮定されます。

and：すべての待ち合わせ対象ユニットが終了したら実行を開始する。

or：待ち合わせ対象ユニットが一つでも終了したら実行を開始する。

nmg={y|n};

指定した待ち合わせ対象ユニットのルートジョブネットに待ち合わせる世代がないときの動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

eun=待ち合わせ対象ユニット名;

待ち合わせ対象ユニットとするユニットを，完全名で指定します。

待ち合わせ対象ユニットを複数指定する場合，このパラメーターを複数回指定します。最大で32個指定できます。

待ち合わせ対象ユニット名に指定できる文字数は1〜930（単位：バイト）です。

ega={exec|execdeffer|none};

起動条件付きジョブネットを待ち合わせ対象に指定していて，実行世代に異常終了がある場合の動作を指定します。

省略した場合はnoneが仮定されます。

exec：実行を開始する。

execdeffer：実行を開始しない。ただし，実行世代が「繰り越し未実行」状態の場合は，実行を開始する。

none：実行を開始しない。

uem={y|n};

起動条件付きジョブネットを待ち合わせ対象に指定していて，監視世代が監視未起動終了の場合の動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

注意事項

イベント送信先ホスト名，メッセージ，拡張属性の値の定義に関する注意事項は次のとおりです。

空白文字や記号なども使用できます。ただし，UNIXの場合，特殊文字「`」，「$」，「¥」を通常文字として扱うときは，これらの特殊文字の前に「¥」を指定してください。

（指定例）

「`」は「¥`」と指定します。

「$」は「¥$」と指定します。

「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストしてください。

（指定例）

「"」は「#"」と指定します。

「#」は「##」と指定します。

「"（ダブルクォーテーションマーク）」を通常文字として扱う場合は，キャストしたあと，キャスト文字（#）の前に「¥」を指定してください。

（指定例）

「"」は「¥#"」と指定します。

JP1イベント送信では，イベント送信先ホスト名，メッセージ，拡張属性の値に空白文字や記号などが使用されることを考慮して，イベント送信先ホスト名，メッセージ，拡張属性の値を「"（ダブルクォーテーションマーク）」で囲んでいます。このため，Windowsの場合で，文字列の最後の部分に「¥」を通常文字として指定するときは，「¥」の前にさらに「¥」を指定してください。

引き継ぎ情報に上記の特殊文字が含まれる場合は，正しく引き継がれなかったり，ジョブが異常終了したりすることがあります。ただし，引き継ぎ情報での「"（ダブルクォーテーションマーク）」有効オプションを使用する場合には，「"（ダブルクォーテーションマーク）」を含む引き継ぎ情報は正しく引き継がれます。

指定例

イベント送信先ホスト名，メッセージ，拡張属性の値に，特殊文字および「"」や「#」を通常文字として定義する場合の例を次に示します。

「`AAA`」は，「¥`AAA¥`」と指定します（UNIXの場合だけ）。

「$AAA$」は，「¥$AAA¥$」と指定します（UNIXの場合だけ）。

「#AAA#」は，「##AAA##」と指定します。

「"AAA"」は，「¥#"AAA¥#"」と指定します。

「¥AAA¥」は，「¥AAA¥¥」（Windowsの場合）または「¥¥AAA¥¥」（UNIXの場合）と指定します。

5.2.18　メール送信ジョブ定義情報の記述方法

メール送信ジョブ定義情報の記述方法を説明します。

メール送信ジョブ定義情報の形式，およびパラメーターを次に示します。

形式

[mladr={to|cc|bcc}:"宛先";]...
[mlprf="プロファイル名";]
[mlsbj="件名";]
[mltxt="本文";]
[mlftx="本文ファイル名";]
[mlatf="添付ファイル名";]...
[mlafl="添付ファイルリスト名";]
[pfm={u|p};]
[etm=n;]
[fd=実行所要時間;]
[ex="実行エージェント名";]
[ha={y|n};]
[eu={ent|def};]
[jty={q|n};]
[mm={and|or};]
[nmg={y|n};]
[eun=待ち合わせ対象ユニット名;]...
[ega={exec|execdeffer|none};]
[uem={y|n};]

パラメーター

mladr={to|cc|bcc}:"宛先";

送信先のメールアドレスを定義します。

「mladr={to|cc|bcc}:"宛先";」の形式で，20件まで同時に指定できます。

to：メールを宛先に送信します。

cc：メールのコピーを宛先に送信します。

bcc：メールをブラインドカーボンコピーで宛先に送信します。

アドレスに指定できる文字数は，1〜256（単位：バイト）です。

アドレス中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

アドレスには，マクロ変数を指定できます。

「pfm=p;」を指定した場合に使用できるアドレスの形式を，次の表に示します。

プロファイルの種類

形式

Exchange Server※

表示名

エイリアス

インターネットメールアドレス

インターネットメール

（SMTP/POP3）

インターネットメールアドレス

注※

X.400形式アドレスでは，送信できません。

X.400形式アドレスの例 ：

　c=JP;p=MailServer;o=Exchange;g=Taro;s=Hitachi;

なお，メール送信ジョブを実行するホストがWindowsで，かつOutlookを使用する場合，宛先の文字数は255文字以内で指定してください。バイト数は256バイト以内で指定できますが，文字数が256文字以上だと，文字列の255文字目までが宛先とみなされます。

mlprf="プロファイル名";

メール送信ジョブを実行するエージェントホスト上の環境設定パラメーターProfileName1〜ProfileName4に設定したプロファイル名を定義します。

このパラメーターは，「pfm=p;」を指定した場合にだけ有効です。また，「pfm=p;」を指定した場合には必須の項目になります。

指定できる文字数は，1〜256（単位：バイト）です。

プロファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

マクロ変数を指定できます。

環境設定パラメーターの詳細については，マニュアル「JP1/Automatic Job Management System 3 連携ガイド　2.3.4 メールシステム連携のための環境設定をする」を参照してください。

mlsbj="件名";

送信するメールの件名を定義します。

指定できる文字数は，0〜256（単位：バイト）です。

件名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

マクロ変数を指定できます。

なお，メール送信ジョブを実行するホストがWindowsで，かつOutlookを使用する場合，件名の文字数は255文字以内で指定してください。バイト数は256バイト以内で指定できますが，文字数が256文字以上だと，文字列の255文字目までが件名とみなされます。

mltxt="本文";

送信するメールの本文を定義します。

指定できる文字数は，改行を含めて1〜512（単位：バイト）です。なお，UNIXの場合は，最終行に改行がないと行として成りたたないため，最終行には必ず改行が入ります。

本文中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

マクロ変数を指定できます。

mlftx="本文ファイル名";

送信するメールの本文ファイル名を定義します。

指定できる文字数は，1〜256（単位：バイト）です。ファイル名はフルパスで指定します。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

マクロ変数を指定できます。

mlatf="添付ファイル名";

添付ファイル名を定義します。このパラメーターは，「pfm=p;」を指定した場合にだけ有効です。

「mlatf="添付ファイル名";」の形式で，20件まで同時に指定できます。

指定できる文字数は，1〜256（単位：バイト）です。ファイル名はフルパスで指定します。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

マクロ変数を指定できます。

mlafl="添付ファイルリスト名";

添付ファイルのリストファイル名を定義します。このパラメーターは，「pfm=p;」を指定した場合にだけ有効です。

指定できる文字数は，1〜256（単位：バイト）です。ファイル名はフルパスで指定します。

リスト名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

マクロ変数を指定できます。

添付ファイルのリストの形式については，マニュアル「JP1/Automatic Job Management System 3 連携ガイド　2.7.3 送信する添付ファイルのリスト（Windows限定）」を参照してください。

pfm={u|p};

ジョブを実行するプラットフォーム種別を指定します。省略した場合，pが仮定されます。

u：UNIX環境で実行します。

p：Windows環境で実行します。

etm=n;

実行打ち切り時間を，実行開始時刻からの相対分で定義します。指定できる値は，1〜1,440（単位：分）です。

fd=実行所要時間;

終了遅延監視するジョブの実行所要時間を定義します。

指定できる値は，10進数の値で1〜1,440（単位：分）です。

ex="実行エージェント名";

ジョブを実行する実行エージェント名または実行エージェントグループ名を定義します。

指定できる文字数は，1〜255（単位：バイト）です。

実行エージェント名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

キューイング属性あり（jty=q）の場合は，マクロ変数を指定できます。

ha={y|n};

ジョブの実行を保留するかを定義します。省略した場合，nが仮定されます。

y：保留します。

n：保留しません。

eu={ent|def};

ジョブ実行時のJP1ユーザーを定義します。省略した場合，entが仮定されます。

ent：ジョブネットを登録したJP1ユーザーをジョブ実行時のJP1ユーザーとします。

def：ジョブを所有するJP1ユーザーをジョブ実行時のJP1ユーザーとします。

jty={q|n};

キューイング属性の種別を定義します。省略した場合，qが仮定されます。

q：キューイング属性あり。

n：キューイング属性なし。

mm={and|or};

指定した待ち合わせ対象ユニットとの待ち合わせ方法を指定します。

省略した場合はandが仮定されます。

and：すべての待ち合わせ対象ユニットが終了したら実行を開始する。

or：待ち合わせ対象ユニットが一つでも終了したら実行を開始する。

nmg={y|n};

指定した待ち合わせ対象ユニットのルートジョブネットに待ち合わせる世代がないときの動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

eun=待ち合わせ対象ユニット名;

待ち合わせ対象ユニットとするユニットを，完全名で指定します。

待ち合わせ対象ユニットを複数指定する場合，このパラメーターを複数回指定します。最大で32個指定できます。

待ち合わせ対象ユニット名に指定できる文字数は1〜930（単位：バイト）です。

ega={exec|execdeffer|none};

起動条件付きジョブネットを待ち合わせ対象に指定していて，実行世代に異常終了がある場合の動作を指定します。

省略した場合はnoneが仮定されます。

exec：実行を開始する。

execdeffer：実行を開始しない。ただし，実行世代が「繰り越し未実行」状態の場合は，実行を開始する。

none：実行を開始しない。

uem={y|n};

起動条件付きジョブネットを待ち合わせ対象に指定していて，監視世代が監視未起動終了の場合の動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

5.2.19　メッセージキュー送信ジョブ定義情報の記述方法

メッセージキュー送信ジョブ定義情報の記述方法を説明します。

メッセージキュー送信ジョブ定義情報の形式，およびパラメーターを次に示します。

形式

[mqque=キュー名;]
[mqcor=相関識別子;]
[mqdsc=メッセージ識別子;]
[mqprm={y|n};]
[mqmgr=キューマネージャー名;]
[mqmdl=モデルキュー名;]
[mqpgm=接続キュー管理プログラム名;]
[mqmfn=フォーマット名;]
[mqmdn="メッセージデータファイル名";]
[mqhld=保持時間;]
[mqpri=優先度:]
[mqeqn=デッドレターキュー名;]
[pfm={u|p};]
[etm=n;]
[fd=実行所要時間;]
[ex="実行エージェント名";]
[ha={y|n};]
[eu={ent|def};]
[jty={q|n};]
[mm={and|or};]
[nmg={y|n};]
[eun=待ち合わせ対象ユニット名;]...
[ega={exec|execdeffer|none};]
[uem={y|n};]

パラメーター

mqque=キュー名;

メッセージを送信するキュー名を定義します。

指定できる文字数は，1〜48（単位：バイト）です。キュー名はMQ文字列で指定します。

mqcor=相関識別子;

送信メッセージに付加する相関識別子を定義します。

指定できる文字数は，1〜24（単位：バイト）です。ただし，指定できる文字は，英（大文字だけ）数字だけです。

mqdsc=メッセージ識別子;

送信メッセージに付加するメッセージ識別子を定義します。

指定できる文字数は，1〜24（単位：バイト）です。ただし，指定できる文字は，英（大文字だけ）数字だけです。

mqprm={y|n};

送信するメッセージの永続性を定義します。省略した場合，nが仮定されます。

y：永続性あり。

n：永続性なし。

mqmgr=キューマネージャー名;

メッセージを送信するキューマネージャー名を定義します。

指定できる文字数は，1〜48（単位：バイト）です。キューマネージャー名はMQ文字列で指定します。

mqmdl=モデルキュー名;

メッセージを送信するモデルキュー名を定義します。

指定できる文字数は，1〜48（単位：バイト）です。モデルキュー名はMQ文字列で指定します。

mqpgm=接続キュー管理プログラム名;

メッセージ送信先キュー管理プログラム名，およびキュー名を認識できるキュー管理プログラム名を定義します。

指定できる文字数は，1〜48（単位：バイト）です。プログラム名はMQ文字列で指定します。

mqmfn=フォーマット名;

メッセージデータに含まれている情報の形式を識別するための形式を定義します。

指定できる文字数は，1〜8（単位：バイト）です。ただし，指定できる文字は，英（大文字だけ）数字だけです。

mqmdn="メッセージデータファイル名";

メッセージとして送信するメッセージデータファイル名を定義します。

指定できる文字数は，1〜256（単位：バイト）です。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

マクロ変数を指定できます。

mqhld=保持時間;

送信するメッセージの保持時間を定義します。

指定できる値は，1〜9,999,999（単位：分）です。

mqpri=優先度;

送信するメッセージの優先度を定義します。

指定できる値は，0〜9です。

mqeqn=デッドレターキュー名;

メッセージ送信処理中にエラーが発生した場合に，メッセージを転送する接続キュー管理プログラムのキュー名を定義します。

指定できる文字数は，1〜48（単位：バイト）です。デッドレターキュー名はMQ文字列で指定します。

pfm={u|p};

ジョブを実行するプラットフォーム種別を指定します。省略した場合，pが仮定されます。

u：UNIX環境で実行します。

p：Windows環境で実行します。

etm=n;

実行打ち切り時間を，実行開始時刻からの相対分で定義します。指定できる値は，1〜1,440（単位：分）です。

fd=実行所要時間;

終了遅延監視するジョブの実行所要時間を定義します。

指定できる値は，10進数の値で1〜1,440（単位：分）です。

ex="実行エージェント名";

ジョブを実行する実行エージェント名または実行エージェントグループ名を定義します。

指定できる文字数は，1〜255（単位：バイト）です。

実行エージェント名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

ha={y|n};

ジョブの実行を保留するかを定義します。省略した場合，nが仮定されます。

y：保留します。

n：保留しません。

eu={ent|def};

ジョブ実行時のJP1ユーザーを定義します。省略した場合，entが仮定されます。

ent：ジョブネットを登録したJP1ユーザーをジョブ実行時のJP1ユーザーとします。

def：ジョブを所有するJP1ユーザーをジョブ実行時のJP1ユーザーとします。

jty={q|n};

キューイング属性の種別を定義します。省略した場合，qが仮定されます。

q：キューイング属性あり。

n：キューイング属性なし。

mm={and|or};

指定した待ち合わせ対象ユニットとの待ち合わせ方法を指定します。

省略した場合はandが仮定されます。

and：すべての待ち合わせ対象ユニットが終了したら実行を開始する。

or：待ち合わせ対象ユニットが一つでも終了したら実行を開始する。

nmg={y|n};

指定した待ち合わせ対象ユニットのルートジョブネットに待ち合わせる世代がないときの動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

eun=待ち合わせ対象ユニット名;

待ち合わせ対象ユニットとするユニットを，完全名で指定します。

待ち合わせ対象ユニットを複数指定する場合，このパラメーターを複数回指定します。最大で32個指定できます。

待ち合わせ対象ユニット名に指定できる文字数は1〜930（単位：バイト）です。

ega={exec|execdeffer|none};

起動条件付きジョブネットを待ち合わせ対象に指定していて，実行世代に異常終了がある場合の動作を指定します。

省略した場合はnoneが仮定されます。

exec：実行を開始する。

execdeffer：実行を開始しない。ただし，実行世代が「繰り越し未実行」状態の場合は，実行を開始する。

none：実行を開始しない。

uem={y|n};

起動条件付きジョブネットを待ち合わせ対象に指定していて，監視世代が監視未起動終了の場合の動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

5.2.20　MSMQ送信ジョブ定義情報の記述方法

MSMQ送信ジョブ定義情報の記述方法を説明します。

MSMQ送信ジョブ定義情報の形式，およびパラメーターを次に示します。

形式

[msqpt="キューパス名";]
[msqlb="キューラベル名";]
[msrer=相互関係;]
[mslmt={-2|-1|n};]
[mshld={-1|n};]
[msmod={h|r};]
[mspri=優先順位;]
[msjnl={y|n};]
[msunr={y|n};]
[mstfn="本文ファイル名";]
[msttp=本文タイプ;]
[mslbl="メッセージラベル";]
[msapl=アプリケーション情報;]
[etm=n;]
[fd=実行所要時間;]
[ex="実行エージェント名";]
[ha={y|n};]
[eu={ent|def};]
[jty={q|n};]
[mm={and|or};]
[nmg={y|n};]
[eun=待ち合わせ対象ユニット名;]...
[ega={exec|execdeffer|none};]
[uem={y|n};]

パラメーター

msqpt="キューパス名";

メッセージの送信先キューパス名を定義します。

指定できる文字数は，1〜259（単位：バイト）です。

パス名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

なお，「msqpt="キューパス名";」「msqlb="キューラベル名";」を両方定義した場合，「msqlb="キューラベル名";」は無効になります。

マクロ変数を指定できます。

msqlb="キューラベル名";

メッセージの送信先キューラベル名を定義します。

指定できる文字数は，1〜124（単位：バイト）です。

ラベル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

なお，「msqpt="キューパス名";」「msqlb="キューラベル名";」を両方定義した場合，「msqlb="キューラベル名";」の定義は無効になります。

マクロ変数を指定できます。

msrer=相互関係;

送信メッセージの相互関係を定義します。

指定できる文字数は，1〜20（単位：バイト）です。ただし，指定できる文字は，英（大文字だけ）数字だけです。

mslmt={-2|-1|n};

送信メッセージの配信制限時間を定義します。省略した場合，-2が仮定されます。

-2：LONG_LIVED

-1：INFINITE

n：配信制限時間を指定します。指定できる値は，0〜2,147,483,647（単位：秒）です。

mshld={-1|n};

送信メッセージを保持する時間を定義します。省略した場合，-1が仮定されます。

-1：INFINITE

n：保持時間を指定します。指定できる値は，0〜2,147,483,647（単位：秒）です。

msmod={h|r};

送信メッセージの配信モードを定義します。省略した場合，hが仮定されます。

h：高速モード

r：回復可能モード

mspri=優先順位;

送信メッセージの優先順位を定義します。

指定できる値は，0〜7です。省略した場合，3が仮定されます。

msjnl={y|n};

送信したメッセージをジャーナルキューに格納するかを定義します。省略した場合，nが仮定されます。

y：ジャーナルキューに格納します。

n：ジャーナルキューに格納しません。

msunr={y|n};

送信できなかったメッセージを配信不能メッセージキューに格納するかを定義します。省略した場合，nが仮定されます。

y：配信不能メッセージキューに格納します。

n：配信不能メッセージキューに格納しません。

mstfn="本文ファイル名";

送信メッセージのメッセージ本文として利用するデータが格納されているファイル名を定義します。

指定できる文字数は，1〜259（単位：バイト）です。ファイル名はフルパスで指定します。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

マクロ変数を指定できます。

msttp=本文タイプ;

送信メッセージ本文の内容の型を定義します。

指定できる値は，16進数の値で，0〜FFFFFFFFです。

mslbl="メッセージラベル";

送信メッセージのラベルを定義します。

指定できる文字数は，1〜249（単位：バイト）です。

ラベル中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

マクロ変数を指定できます。

msapl=アプリケーション情報;

送信メッセージのアプリケーション情報を定義します。

指定できる値は，16進数の値で，0〜FFFFFFFFです。

etm=n;

実行打ち切り時間を，実行開始時刻からの相対分で定義します。指定できる値は，1〜1,440（単位：分）です。

fd=実行所要時間;

終了遅延監視するジョブの実行所要時間を定義します。

指定できる値は，10進数の値で1〜1,440（単位：分）です。

ex="実行エージェント名";

ジョブを実行する実行エージェント名または実行エージェントグループ名を定義します。

指定できる文字数は，1〜255（単位：バイト）です。

実行エージェント名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

ha={y|n};

ジョブの実行を保留するかを定義します。省略した場合，nが仮定されます。

y：保留します。

n：保留しません。

eu={ent|def};

ジョブ実行時のJP1ユーザーを定義します。省略した場合，entが仮定されます。

ent：ジョブネットを登録したJP1ユーザーをジョブ実行時のJP1ユーザーとします。

def：ジョブを所有するJP1ユーザーをジョブ実行時のJP1ユーザーとします。

jty={q|n};

キューイング属性の種別を定義します。省略した場合，qが仮定されます。

q：キューイング属性あり。

n：キューイング属性なし。

mm={and|or};

指定した待ち合わせ対象ユニットとの待ち合わせ方法を指定します。

省略した場合はandが仮定されます。

and：すべての待ち合わせ対象ユニットが終了したら実行を開始する。

or：待ち合わせ対象ユニットが一つでも終了したら実行を開始する。

nmg={y|n};

指定した待ち合わせ対象ユニットのルートジョブネットに待ち合わせる世代がないときの動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

eun=待ち合わせ対象ユニット名;

待ち合わせ対象ユニットとするユニットを，完全名で指定します。

待ち合わせ対象ユニットを複数指定する場合，このパラメーターを複数回指定します。最大で32個指定できます。

待ち合わせ対象ユニット名に指定できる文字数は1〜930（単位：バイト）です。

ega={exec|execdeffer|none};

起動条件付きジョブネットを待ち合わせ対象に指定していて，実行世代に異常終了がある場合の動作を指定します。

省略した場合はnoneが仮定されます。

exec：実行を開始する。

execdeffer：実行を開始しない。ただし，実行世代が「繰り越し未実行」状態の場合は，実行を開始する。

none：実行を開始しない。

uem={y|n};

起動条件付きジョブネットを待ち合わせ対象に指定していて，監視世代が監視未起動終了の場合の動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

5.2.21　JP1/Cm2状態通知ジョブ定義情報の記述方法

JP1/Cm2状態通知ジョブ定義情報の記述方法を説明します。

JP1/Cm2状態通知ジョブ定義情報の形式，およびパラメーターを次に示します。

形式

[cmsts={un|no|wa|mi|ma|cr|re|te|di};]
[cmaif="付加情報";]
[pfm={u|p};]
[etm=n;]
[fd=実行所要時間;]
[ex="実行エージェント名";]
[ha={y|n};]
[eu={ent|def};]
[jty={q|n};]
[mm={and|or};]
[nmg={y|n};]
[eun=待ち合わせ対象ユニット名;]...
[ega={exec|execdeffer|none};]
[uem={y|n};]

パラメーター

cmsts={un|no|wa|mi|ma|cr|re|te|di};

HP NNMに通知する状態を定義します。省略した場合，unが仮定されます。

un：Unknown

no：Normal

wa：Warning

mi：Minor

ma：Major

cr：Critical

re：Restricted

te：Testing

di：Disabled

cmaif="付加情報";

HP NNMに通知するメッセージの付加情報を定義します。

指定できる文字数は，1〜256（単位：バイト）です。ただし，改行文字は使用できません。

付加情報中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

マクロ変数を指定できます。

pfm={u|p};

ジョブを実行するプラットフォーム種別を指定します。省略した場合，pが仮定されます。

u：UNIX環境で実行します。

p：Windows環境で実行します。

etm=n;

実行打ち切り時間を，実行開始時刻からの相対分で定義します。指定できる値は，1〜1,440（単位：分）です。

fd=実行所要時間;

終了遅延監視するジョブの実行所要時間を定義します。

指定できる値は，10進数の値で1〜1,440（単位：分）です。

ex="実行エージェント名";

ジョブを実行する実行エージェント名または実行エージェントグループ名を定義します。

指定できる文字数は，1〜255（単位：バイト）です。

実行エージェント名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

キューイング属性あり（jty=q）の場合は，マクロ変数を指定できます。

ha={y|n};

ジョブの実行を保留するかを定義します。省略した場合，nが仮定されます。

y：保留します。

n：保留しません。

eu={ent|def};

ジョブ実行時のJP1ユーザーを定義します。省略した場合，entが仮定されます。

ent：ジョブネットを登録したJP1ユーザーをジョブ実行時のJP1ユーザーとします。

def：ジョブを所有するJP1ユーザーをジョブ実行時のJP1ユーザーとします。

jty={q|n};

キューイング属性の種別を定義します。省略した場合，qが仮定されます。

q：キューイング属性あり。

n：キューイング属性なし。

mm={and|or};

指定した待ち合わせ対象ユニットとの待ち合わせ方法を指定します。

省略した場合はandが仮定されます。

and：すべての待ち合わせ対象ユニットが終了したら実行を開始する。

or：待ち合わせ対象ユニットが一つでも終了したら実行を開始する。

nmg={y|n};

指定した待ち合わせ対象ユニットのルートジョブネットに待ち合わせる世代がないときの動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

eun=待ち合わせ対象ユニット名;

待ち合わせ対象ユニットとするユニットを，完全名で指定します。

待ち合わせ対象ユニットを複数指定する場合，このパラメーターを複数回指定します。最大で32個指定できます。

待ち合わせ対象ユニット名に指定できる文字数は1〜930（単位：バイト）です。

ega={exec|execdeffer|none};

起動条件付きジョブネットを待ち合わせ対象に指定していて，実行世代に異常終了がある場合の動作を指定します。

省略した場合はnoneが仮定されます。

exec：実行を開始する。

execdeffer：実行を開始しない。ただし，実行世代が「繰り越し未実行」状態の場合は，実行を開始する。

none：実行を開始しない。

uem={y|n};

起動条件付きジョブネットを待ち合わせ対象に指定していて，監視世代が監視未起動終了の場合の動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

5.2.22　ローカル電源制御ジョブ定義情報の記述方法

ローカル電源制御ジョブ定義情報の記述方法を説明します。

ローカル電源制御ジョブ定義情報の形式，およびパラメーターを次に示します。

形式

[pwlt={f|r|s};]
[pwlf={m|r|f|p};]
[pfm={u|p};]
[etm=n;]
[fd=実行所要時間;]
[ex="実行エージェント名";]
[ha={y|n};]
[eu={ent|def};]
[jty={q|n};]
[mm={and|or};]
[nmg={y|n};]
[eun=待ち合わせ対象ユニット名;]...
[ega={exec|execdeffer|none};]
[uem={y|n};]

パラメーター

pwlt={f|r|s};

実行種別を定義します。省略した場合，fが仮定されます。

f：電源をオフします。電源オフ後，JP1/AJS3ホストはJP1/Power Monitorに設定されている時刻に起動されます。詳細については，マニュアル「JP1/Power Monitor」を参照してください。

r：シャットダウン後，再起動します。

s：シャットダウンします（「pfm=p;」を指定した場合にだけ指定できます）。

pwlf={m|r|f|p};

終了要求種別を定義します。省略した場合，fが仮定されます。

m：監視終了します（「pfm=u;」を指定した場合にだけ指定できます）。

r：制限終了します（「pfm=u;」を指定した場合にだけ指定できます）。

f：強制終了します。

p：計画終了します（「pfm=p;」を指定した場合にだけ指定できます）。

pfm={u|p};

ジョブを実行するプラットフォーム種別を指定します。省略した場合，pが仮定されます。

u：UNIX環境で実行します。

p：Windows環境で実行します。

etm=n;

実行打ち切り時間を，実行開始時刻からの相対分で定義します。指定できる値は，1〜1,440（単位：分）です。

fd=実行所要時間;

終了遅延監視するジョブの実行所要時間を定義します。

指定できる値は，10進数の値で1〜1,440（単位：分）です。

ex="実行エージェント名";

ジョブを実行する実行エージェント名または実行エージェントグループ名を定義します。

指定できる文字数は，1〜255（単位：バイト）です。

実行エージェント名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

キューイング属性あり（jty=q）の場合は，マクロ変数を指定できます。

ha={y|n};

ジョブの実行を保留するかを定義します。省略した場合，nが仮定されます。

y：保留します。

n：保留しません。

eu={ent|def};

ジョブ実行時のJP1ユーザーを定義します。省略した場合，entが仮定されます。

ent：ジョブネットを登録したJP1ユーザーをジョブ実行時のJP1ユーザーとします。

def：ジョブを所有するJP1ユーザーをジョブ実行時のJP1ユーザーとします。

jty={q|n};

キューイング属性の種別を定義します。省略した場合，qが仮定されます。

q：キューイング属性あり。

n：キューイング属性なし。

mm={and|or};

指定した待ち合わせ対象ユニットとの待ち合わせ方法を指定します。

省略した場合はandが仮定されます。

and：すべての待ち合わせ対象ユニットが終了したら実行を開始する。

or：待ち合わせ対象ユニットが一つでも終了したら実行を開始する。

nmg={y|n};

指定した待ち合わせ対象ユニットのルートジョブネットに待ち合わせる世代がないときの動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

eun=待ち合わせ対象ユニット名;

待ち合わせ対象ユニットとするユニットを，完全名で指定します。

待ち合わせ対象ユニットを複数指定する場合，このパラメーターを複数回指定します。最大で32個指定できます。

待ち合わせ対象ユニット名に指定できる文字数は1〜930（単位：バイト）です。

ega={exec|execdeffer|none};

起動条件付きジョブネットを待ち合わせ対象に指定していて，実行世代に異常終了がある場合の動作を指定します。

省略した場合はnoneが仮定されます。

exec：実行を開始する。

execdeffer：実行を開始しない。ただし，実行世代が「繰り越し未実行」状態の場合は，実行を開始する。

none：実行を開始しない。

uem={y|n};

起動条件付きジョブネットを待ち合わせ対象に指定していて，監視世代が監視未起動終了の場合の動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

5.2.23　リモート電源制御ジョブ定義情報の記述方法

リモート電源制御ジョブ定義情報の記述方法を説明します。

リモート電源制御ジョブ定義情報の形式，およびパラメーターを次に示します。

形式

[pwrh="対象ホスト名";]
[pwrf={o|m|r|f|p|s};]
[pwrn={n|a|c:[mm/dd.]hh:mm};]
[pwrr={y|n};]
[pwrw={y|n};]
[pwrp={p|u};]
[pfm={u|p};]
[etm=n;]
[fd=実行所要時間;]
[ex="実行エージェント名";]
[ha={y|n};]
[eu={ent|def};]
[jty={q|n};]
[mm={and|or};]
[nmg={y|n};]
[eun=待ち合わせ対象ユニット名;]...
[ega={exec|execdeffer|none};]
[uem={y|n};]

パラメーター

pwrh="対象ホスト名";

電源制御の対象とする，JP1/Power Monitorのエージェントホスト名を定義します。

指定できる文字数は，1〜255（単位：バイト）です。

ホスト名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

マクロ変数を指定できます。

pwrf={o|m|r|f|p|s};

JP1/Power Monitorのエージェントホストに対して，システム終了時に行う監視アプリケーションの終了方法の要求種別を定義します。省略した場合，pwrpにpを指定したときにはpが，uを指定したときにはmが仮定されます。

o：電源をオンします。

m：監視終了します（「pwrp=u;」を指定した場合にだけ指定できます）。

r：制限終了します（「pwrp=u;」を指定した場合にだけ指定できます）。

f：強制終了します。

p：計画終了します（「pwrp=p;」を指定した場合にだけ指定できます）。

s：強制停止します。

pwrn={n|a|c:[mm/dd.]hh:mm};

JP1/Power Monitorのエージェントホストの，次回電源投入時刻を定義します。省略した場合，aが仮定されます。

n：次回電源投入時刻を指定しません。

a：JP1/Power Monitorのエージェントホストに設定されている次回電源投入時刻を有効にします。

c:[mm/dd.]hh:mm：次回電源投入時刻を指定します。指定できる値を次に示します。

mmに指定できる値は，1〜12（単位：月）です。

ddに指定できる値は，1〜31（単位：日）です。

hhに指定できる値は，0〜23（単位：時）です。

mmに指定できる値は，0〜59（単位：分）です。

pwrr={y|n};

JP1/Power Monitorのエージェントホストのシャットダウン後に，再起動するかを定義します。省略した場合，nが仮定されます。

y：再起動します。

n：再起動しません。

pwrw={y|n};

JP1/Power Monitorのエージェントホストの電源オフの終了まで，リモート電源制御ジョブの完了を待つかを指定します。省略した場合，nが仮定されます。

y：電源オフの終了を待ちます。

n：電源オフの終了を待ちません。

電源オフの終了とは，エージェントホスト上のJP1/Power Monitorがシャットダウンの開始をJP1/Power Monitorのマネージャーホストに報告することを指します。

pwrp={p|u};

リモート電源制御ジョブで電源制御を行うJP1/Power Monitorの対象ホスト（エージェント）のプラットフォーム種別を指定します。省略した場合，pが仮定されます。

p：WindowsのJP1/Power Monitorのエージェントホストを制御します。

u：UNIXのJP1/Power Monitorのエージェントホストを制御します。

pfm={u|p};

ジョブを実行するプラットフォーム種別を指定します。省略した場合，pが仮定されます。

u：UNIX環境で実行します。

p：Windows環境で実行します。

etm=n;

実行打ち切り時間を，実行開始時刻からの相対分で定義します。指定できる値は，1〜1,440（単位：分）です。

fd=実行所要時間;

終了遅延監視するジョブの実行所要時間を定義します。

指定できる値は，10進数の値で1〜1,440（単位：分）です。

ex="実行エージェント名";

ジョブを実行する実行エージェント名または実行エージェントグループ名を定義します。

指定できる文字数は，1〜255（単位：バイト）です。

実行エージェント名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

キューイング属性あり（jty=q）の場合は，マクロ変数を指定できます。

ha={y|n};

ジョブの実行を保留するかを定義します。省略した場合，nが仮定されます。

y：保留します。

n：保留しません。

eu={ent|def};

ジョブ実行時のJP1ユーザーを定義します。省略した場合，entが仮定されます。

ent：ジョブネットを登録したJP1ユーザーをジョブ実行時のJP1ユーザーとします。

def：ジョブを所有するJP1ユーザーをジョブ実行時のJP1ユーザーとします。

jty={q|n};

キューイング属性の種別を定義します。省略した場合，qが仮定されます。

q：キューイング属性あり。

n：キューイング属性なし。

mm={and|or};

指定した待ち合わせ対象ユニットとの待ち合わせ方法を指定します。

省略した場合はandが仮定されます。

and：すべての待ち合わせ対象ユニットが終了したら実行を開始する。

or：待ち合わせ対象ユニットが一つでも終了したら実行を開始する。

nmg={y|n};

指定した待ち合わせ対象ユニットのルートジョブネットに待ち合わせる世代がないときの動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

eun=待ち合わせ対象ユニット名;

待ち合わせ対象ユニットとするユニットを，完全名で指定します。

待ち合わせ対象ユニットを複数指定する場合，このパラメーターを複数回指定します。最大で32個指定できます。

待ち合わせ対象ユニット名に指定できる文字数は1〜930（単位：バイト）です。

ega={exec|execdeffer|none};

起動条件付きジョブネットを待ち合わせ対象に指定していて，実行世代に異常終了がある場合の動作を指定します。

省略した場合はnoneが仮定されます。

exec：実行を開始する。

execdeffer：実行を開始しない。ただし，実行世代が「繰り越し未実行」状態の場合は，実行を開始する。

none：実行を開始しない。

uem={y|n};

起動条件付きジョブネットを待ち合わせ対象に指定していて，監視世代が監視未起動終了の場合の動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

5.2.24　UNIX／PCカスタムジョブ定義情報の記述方法

UNIX／PCカスタムジョブ定義情報の記述方法を説明します。

UNIX／PCカスタムジョブ定義情報の形式，およびパラメーターを次に示します。

形式

[cty="カスタムジョブクラス名";]
[te="コマンドテキスト";]
[sc="スクリプトファイル名";]
[prm="パラメーター";]
[env="環境変数";]...
[so="標準出力ファイル名";]
[se="標準エラー出力ファイル名";]
[etm=n;]
[fd=実行所要時間;]
[pr=n;]
[ex="ジョブ実行エージェントホスト名";]
[un="実行ユーザー名";]
[jd={nm|ab|cod|mdf|exf};]
[wth=n;]
[tho=n;]
[jdf="終了判定ファイル名";]
[abr={y|n};]
[rjs=自動リトライする終了コードの下限;]
[rje=自動リトライする終了コードの上限;]
[rec=最大リトライ回数;]
[rei=リトライ間隔;]
[ha={y|n};]
[eu={ent|def};]
[wkp="作業用パス名";]
[ev="環境変数ファイル名";]
[si="標準入力ファイル名";]
[soa={new|add};]
[sea={new|add};]
[ts1="転送元ファイル名1";]
[td1="転送先ファイル名1";]
[top1={sav|del};]
[ts2="転送元ファイル名2";]
[td2="転送先ファイル名2";]
[top2={sav|del};]
[ts3="転送元ファイル名3";]
[td3="転送先ファイル名3";]
[top3={sav|del};]
[ts4="転送元ファイル名4";]
[td4="転送先ファイル名4";]
[top4={sav|del};]
[mm={and|or};]
[nmg={y|n};]
[eun=待ち合わせ対象ユニット名;]...
[ega={exec|execdeffer|none};]
[uem={y|n};]

パラメーター

cty="カスタムジョブクラス名";

カスタムジョブクラス名を連携するプログラムごとに定義します。

定義できる種類を次に示します。

標準カスタムジョブの場合

JP1/AJS3で標準提供されているカスタムジョブを利用する場合に定義するクラス名を次の表に示します。

連携するプログラム名

クラス名

JP1/FTP

JP1FTP

JP1/AJS3 for Enterprise Applications

JP1AMR3

JP1/AJS3 for Enterprise Applications

JP1AMR3BW

JP1/AJS3 for Enterprise Applications

JP1AMR3CP

JP1/AJS3 for Enterprise Applications

JP1AMR3UX

JP1/AJS3 for Enterprise Applications

JP1AMR3BWUX

JP1/AJS3 for Enterprise Applications

JP1AMR3CPUX

Cosminexus Manager

COSMNGSV

Cosminexus Manager

COSMNGAP

JP1/DH - AJE

DHAJEW

JP1/CPA

CPALINK

カスタムPCジョブおよびカスタムUNIXジョブの場合

USER_任意の名称（「USER_」は必ず指定します）の形式で，総バイト数が16バイト以内の文字列で指定します。

クラス名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

次の文字を指定すると，［ジョブネットエディタ］ウィンドウのアイコンリストに，カスタムジョブのアイコンが表示されなくなります。

・"（ダブルクォーテーションマーク）

・*

・/

・:（コロン）

・<

・>

・?

・¥

・|

・MS-DOSのデバイス名（NUL，CON，AUX，CLOCK$，COM1〜COM9，LPT1〜LPT9，PRN）

・「MS-DOSのデバイス名.（ピリオド）」で始まる文字列

なお，次の文字は指定できません。

・半角スペース

・改行文字やタブ文字などの制御文字

te="コマンドテキスト";

コマンドテキストを定義します。

指定できる文字数は，1〜1,023（単位：バイト）です。

コマンドテキスト中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

マクロ変数を指定できます。

sc="スクリプトファイル名";

UNIXジョブの場合，スクリプトファイル名をフルパスで定義します。PCジョブの場合，実行ファイル名をフルパスで定義します。

指定できる文字数は，1〜511（単位：バイト）です。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

マクロ変数を指定できます。

prm="パラメーター";

実行ファイルに対するパラメーターを定義します。

指定できる文字数は，1〜1,023（単位：バイト）です。

パラメーター中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

マクロ変数を指定できます。

env="環境変数";

環境変数を定義します。

指定できる文字数は，1〜20,479（単位：バイト）です。環境変数を複数指定する場合，このパラメーターを複数回指定します（「env="環境変数名=値";」の形式で，バイト数の合計が20,479バイトまで複数指定できます）。

環境変数中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

環境変数を定義する際の注意事項については，「付録A 環境変数および環境変数ファイルを定義する場合の注意事項」を参照してください。

マクロ変数を指定できます。

so="標準出力ファイル名";

標準出力ファイル名をフルパスで定義します。

指定できる文字数は，1〜511（単位：バイト）です。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

「$JP1AJS2_JPQSTDOUTTEMP$」を指定すると，標準出力ファイルが一時ファイルに出力されます。

マクロ変数を指定できます。

se="標準エラー出力ファイル名";

標準エラー出力ファイル名をフルパスで定義します。

指定できる文字数は，1〜511（単位：バイト）です。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

マクロ変数を指定できます。

etm=n;

実行打ち切り時間を，実行開始時刻からの相対分で定義します。

指定できる値は，1〜1,440（単位：分）です。

fd=実行所要時間;

終了遅延監視するジョブの実行所要時間を定義します。

指定できる値は，10進数の値で1〜1,440（単位：分）です。

pr=n;

ジョブの実行優先順位を定義します。

指定できる値は，「1」〜「5」です。実行優先順位がいちばん低いのが「1」，いちばん高いのが「5」です。省略した場合，上位ジョブネットの定義に依存します。このパラメーターを省略し，かつ，最上位までのすべての上位ジョブネットに対してpr，またはniパラメーターを指定しなかった場合，ジョブの実行優先順位は環境設定パラメーターDEFAULTPRIORITYの設定値によって決まります。環境設定パラメーターDEFAULTPRIORITYの設定も省略した場合は，「1」が仮定されます。

環境設定パラメーターDEFAULTPRIORITYの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2(108) DEFAULTPRIORITY」を参照してください。

ex="ジョブ実行エージェントホスト名";

ジョブを実行するJP1/AJS3 - Agentホスト名を定義します。

指定できる文字数は，1〜255（単位：バイト）です。

ジョブ実行エージェントホスト名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

マクロ変数を指定できます。

un="実行ユーザー名";

JP1/AJS3 - Agentホストでジョブを実行する場合の，ジョブを実行するユーザー名を定義します。

指定できる文字数は，1〜63（単位：バイト）です。ユーザー名中に空白文字は指定できません。

ユーザー名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

マクロ変数を指定できます。

jd={nm|ab|cod|mdf|exf};

終了判定種別を定義します。省略した場合，codが仮定されます。

cod以外を指定した場合は，abrパラメーターにyを指定できません。指定した場合はメッセージKAVS0674-Eが出力されて，ユニットの作成に失敗します。

nm：すべて正常終了とします。

ab：すべて異常終了とします。

cod：終了コードが指定値以下の場合に，正常終了とします。

mdf：ファイルが更新されている場合に，正常終了とします。

exf：ファイルが作成されている場合に，正常終了とします。

wth=n;

警告終了のしきい値を定義します。

指定できる値は，0〜2,147,483,647です。

tho=n;

異常終了のしきい値を定義します。

指定できる値は，0〜2,147,483,647です。省略した場合，0が仮定されます。

jdf="終了判定ファイル名";

終了判定ファイル名をフルパスで定義します。

指定できる文字数は，1〜511（単位：バイト）です。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

マクロ変数を指定できます。

abr={y|n};

異常終了時リトライを定義します。省略した場合，nが仮定されます。

jdパラメーターにcodを指定した場合にだけ，yを指定できます。

y：異常終了時に自動リトライします。

n：異常終了時に自動リトライしません。

rjs=自動リトライする終了コードの下限;

異常終了時に自動リトライする場合に，自動リトライする終了コードの下限を定義します。

abrパラメーターにyを指定した場合にだけ指定できます。

指定できる値は，1〜4,294,967,295です。異常しきい値以下の値および自動リトライする終了コードの上限より大きな値を指定した場合は，メッセージKAVS0668-Eが出力されて，ユニットの作成に失敗します。

省略した場合は，実行時に「異常終了しきい値＋1」が仮定されます。

rje=自動リトライする終了コードの上限;

異常終了時に自動リトライする場合に，自動リトライする終了コードの上限を定義します。

abrパラメーターにyを指定した場合にだけ指定できます。

指定できる値は，1〜4,294,967,295です。異常しきい値以下の値および自動リトライする終了コードの下限より小さな値を指定した場合は，メッセージKAVS0668-Eが出力されて，ユニットの作成に失敗します。

省略した場合，実行時に最大値の「4,294,967,295」が仮定されます。

rec=最大リトライ回数;

異常終了時に自動リトライする場合に，最大リトライ回数を定義します。

abrパラメーターにyを指定した場合にだけ指定できます。

指定できる値は1〜12（単位：回）です。省略した場合，1が仮定されます。

rei=リトライ間隔;

異常終了時に自動リトライする場合に，リトライ間隔を定義します。

abrパラメーターにyを指定した場合にだけ指定できます。

指定できる値は，1〜10（単位：分）です。省略した場合，1が仮定されます。

ha={y|n};

ジョブの実行を保留するかを定義します。省略した場合，nが仮定されます。

y：保留します。

n：保留しません。

eu={ent|def};

ジョブ実行時のJP1ユーザーを定義します。省略した場合，entが仮定されます。

ent：ジョブネットを登録したJP1ユーザーをジョブ実行時のJP1ユーザーとします。

def：ジョブを所有するJP1ユーザーをジョブ実行時のJP1ユーザーとします。

wkp="作業用パス名";

作業用パス名をフルパス名で定義します。

指定できる文字数は，1〜511（単位：バイト）です。

作業用パス名中に，「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

カスタムPCジョブには指定できません。

マクロ変数を指定できます。

ev="環境変数ファイル名";

エージェントホスト上の環境変数ファイル名を定義します。

指定できる文字数は，1〜511（単位：バイト）です。ファイル名は，絶対パスまたは相対パスで指定します。相対パスで指定した場合，ジョブ実行時の作業用パスからの相対パスになります。

ファイル名中に，「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

カスタムPCジョブには指定できません。

マクロ変数を指定できます。

環境変数を定義する際の注意事項については，「付録A 環境変数および環境変数ファイルを定義する場合の注意事項」を参照してください。

si="標準入力ファイル名";

ジョブを実行するエージェントホスト上の標準入力ファイル名を定義します。

指定できる文字数は，1〜511（単位：バイト）です。ファイル名は，絶対パスまたは相対パスで指定します。相対パスで指定した場合，ジョブ実行時の作業用パスからの相対パスになります。

ファイル名中に，「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

カスタムPCジョブには指定できません。

マクロ変数を指定できます。

soa={new|add};

標準出力ファイル名の追加書きオプションを定義します。省略した場合，newが仮定されます。soパラメーターで標準出力ファイル名を指定しなかった場合，このパラメーターは無効になります。

カスタムPCジョブには指定できません。

new：ファイルを新規に作成します。

add：既存のファイルに情報を追加します。

sea={new|add};

標準エラー出力ファイル名の追加書きオプションを定義します。省略した場合，newが仮定されます。seパラメーターで標準エラー出力ファイル名を指定しなかった場合，このパラメーターは無効になります。

カスタムPCジョブには指定できません。

new：ファイルを新規に作成します。

add：既存のファイルに情報を追加します。

ts1="転送元ファイル名1";

転送元ファイル名をフルパス名で定義します。

指定できる文字数は，1〜511（単位：バイト）です。

ファイル名中に，「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

カスタムPCジョブには指定できません。

マクロ変数を指定できます。

td1="転送先ファイル名1";

エージェントホストに転送する転送先ファイル名を定義します。

指定できる文字数は，1〜511（単位：バイト）です。

省略した場合，$JP1AJS2_JPQTEMPxx$変数が仮定されます（xxは，転送ファイルの番号で，01〜04の値）。

sc，prmパラメーターにこの変数を指定すると，転送先ファイル名を意識しないでジョブを実行できます。

ファイル名中に，「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

カスタムPCジョブには指定できません。

マクロ変数を指定できます。

top1={sav|del};

転送先ファイルの自動削除オプションを定義します。

sav：ファイルを保存します。

del：ファイルを削除します。

転送元ファイル名および転送先ファイル名を指定し，このパラメーターを省略した場合，savが仮定されます。

転送元ファイル名を指定し，転送先ファイル名およびこのパラメーターを省略した場合，delが仮定されます。

カスタムPCジョブには指定できません。

ts2="転送元ファイル名2";

転送元ファイル名をフルパス名で定義します。

指定できる文字数は，1〜511（単位：バイト）です。

ファイル名中に，「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

カスタムPCジョブには指定できません。

マクロ変数を指定できます。

td2="転送先ファイル名2";

エージェントホストに転送する転送先ファイル名を定義します。

指定できる文字数は，1〜511（単位：バイト）です。

省略した場合，$JP1AJS2_JPQTEMPxx$変数が仮定されます（xxは，転送ファイルの番号で，01〜04の値）。

sc，prmパラメーターにこの変数を指定すると，転送先ファイル名を意識しないでジョブを実行できます。

ファイル名中に，「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

カスタムPCジョブには指定できません。

マクロ変数を指定できます。

top2={sav|del};

転送先ファイルの自動削除オプションを定義します。

sav：ファイルを保存します。

del：ファイルを削除します。

転送元ファイル名および転送先ファイル名を指定し，このパラメーターを省略した場合，savが仮定されます。

転送元ファイル名を指定し，転送先ファイル名およびこのパラメーターを省略した場合，delが仮定されます。

カスタムPCジョブには指定できません。

ts3="転送元ファイル名3";

転送元ファイル名をフルパス名で定義します。

指定できる文字数は，1〜511（単位：バイト）です。

ファイル名中に，「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

カスタムPCジョブには指定できません。

マクロ変数を指定できます。

td3="転送先ファイル名3";

エージェントホストに転送する転送先ファイル名を定義します。

指定できる文字数は，1〜511（単位：バイト）です。

省略した場合，$JP1AJS2_JPQTEMPxx$変数が仮定されます（xxは，転送ファイルの番号で，01〜04の値）。

sc，prmパラメーターにこの変数を指定すると，転送先ファイル名を意識しないでジョブを実行できます。

ファイル名中に，「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

カスタムPCジョブには指定できません。

マクロ変数を指定できます。

top3={sav|del};

転送先ファイルの自動削除オプションを定義します。

sav：ファイルを保存します。

del：ファイルを削除します。

転送元ファイル名および転送先ファイル名を指定し，このパラメーターを省略した場合，savが仮定されます。

転送元ファイル名を指定し，転送先ファイル名およびこのパラメーターを省略した場合，delが仮定されます。

カスタムPCジョブには指定できません。

ts4="転送元ファイル名4";

転送元ファイル名をフルパス名で定義します。

指定できる文字数は，1〜511（単位：バイト）です。

ファイル名中に，「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

カスタムPCジョブには指定できません。

マクロ変数を指定できます。

td4="転送先ファイル名4";

エージェントホストに転送する転送先ファイル名を定義します。

指定できる文字数は，1〜511（単位：バイト）です。

省略した場合，$JP1AJS2_JPQTEMPxx$変数が仮定されます（xxは，転送ファイルの番号で，01〜04の値）。

sc，prmパラメーターにこの変数を指定すると，転送先ファイル名を意識しないでジョブを実行できます。

ファイル名中に，「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

カスタムPCジョブには指定できません。

マクロ変数を指定できます。

top4={sav|del};

転送先ファイルの自動削除オプションを定義します。

sav：ファイルを保存します。

del：ファイルを削除します。

転送元ファイル名および転送先ファイル名を指定し，このパラメーターを省略した場合，savが仮定されます。

転送元ファイル名を指定し，転送先ファイル名およびこのパラメーターを省略した場合，delが仮定されます。

カスタムPCジョブには指定できません。

mm={and|or};

指定した待ち合わせ対象ユニットとの待ち合わせ方法を指定します。

省略した場合はandが仮定されます。

and：すべての待ち合わせ対象ユニットが終了したら実行を開始する。

or：待ち合わせ対象ユニットが一つでも終了したら実行を開始する。

nmg={y|n};

指定した待ち合わせ対象ユニットのルートジョブネットに待ち合わせる世代がないときの動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

eun=待ち合わせ対象ユニット名;

待ち合わせ対象ユニットとするユニットを，完全名で指定します。

待ち合わせ対象ユニットを複数指定する場合，このパラメーターを複数回指定します。最大で32個指定できます。

待ち合わせ対象ユニット名に指定できる文字数は1〜930（単位：バイト）です。

ega={exec|execdeffer|none};

起動条件付きジョブネットを待ち合わせ対象に指定していて，実行世代に異常終了がある場合の動作を指定します。

省略した場合はnoneが仮定されます。

exec：実行を開始する。

execdeffer：実行を開始しない。ただし，実行世代が「繰り越し未実行」状態の場合は，実行を開始する。

none：実行を開始しない。

uem={y|n};

起動条件付きジョブネットを待ち合わせ対象に指定していて，監視世代が監視未起動終了の場合の動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

5.2.25　引き継ぎ情報設定ジョブ定義情報の記述方法

引き継ぎ情報設定ジョブ定義情報の記述方法を説明します。

引き継ぎ情報設定ジョブ定義情報の形式，およびパラメーターを次に示します。

形式

ty={cpj|rcpj};
cty="AJSVAR";
sc="$JP1AJS2_JPOEXEPATH$/jpqpinfoset";
prm="-o 出力変数1 [-o 出力変数2...]";
env="AJS2SO_GLOBMACFILE=?AJS2SO_GLOBMACFILE?";
env="AJS2SO_STDOUTFILE=?AJS2SO_STDOUTFILE?";
env="AJS2SO_RE_出力変数1=正規表現1";
   [env="AJS2SO_RE_出力変数2=正規表現2";...]
[wth=n;]
[tho=n;]
[mm={and|or};]
[nmg={y|n};]
[eun=待ち合わせ対象ユニット名;]...
[ega={exec|execdeffer|none};]
[uem={y|n};]

パラメーター

ty={cpj|rcpj};

通常は，cpjを指定します。引き継ぎ情報設定ジョブをリカバリージョブとして定義する場合にはrcpjを指定します。

cty="AJSVAR";

固定です。

sc="$JP1AJS2_JPOEXEPATH$/jpqpinfoset";

固定です。

prm="-o 出力変数1 [-o 出力変数2...]";

出力変数として，マクロ変数名の先頭5文字「?AJS2」と末尾1文字「?」を取り除いたものを定義します。例えば，「?AJS2VAR?」という名前のマクロ変数に出力する場合，「-o VAR」と指定します。

指定できる文字数は，1〜1,023（単位：バイト）です。最大で32個まで指定できます。

env="AJS2SO_GLOBMACFILE=?AJS2SO_GLOBMACFILE?";

固定です。

env="AJS2SO_STDOUTFILE=?AJS2SO_STDOUTFILE?";

固定です。

env="AJS2SO_RE_出力変数1=正規表現1";[env="AJS2SO_RE_出力変数2=正規表現2";...]

「prm」で指定した出力変数の個数分，正規表現を定義します。「出力変数x」の部分は，「prm」の「出力変数x」の部分と同じ値を指定します。

ここで指定した正規表現によって切り出した結果が，出力変数に対応するマクロ変数の値として設定されます。

wth=n;

警告終了のしきい値を定義します。指定できる値は0〜2,147,483,647です。

tho=n;

異常終了のしきい値を定義します。

指定できる値は0〜2,147,483,647です。省略した場合，0が仮定されます。

mm={and|or};

指定した待ち合わせ対象ユニットとの待ち合わせ方法を指定します。

省略した場合はandが仮定されます。

and：すべての待ち合わせ対象ユニットが終了したら実行を開始する。

or：待ち合わせ対象ユニットが一つでも終了したら実行を開始する。

nmg={y|n};

指定した待ち合わせ対象ユニットのルートジョブネットに待ち合わせる世代がないときの動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

eun=待ち合わせ対象ユニット名;

待ち合わせ対象ユニットとするユニットを，完全名で指定します。

待ち合わせ対象ユニットを複数指定する場合，このパラメーターを複数回指定します。最大で32個指定できます。

待ち合わせ対象ユニット名に指定できる文字数は1〜930（単位：バイト）です。

ega={exec|execdeffer|none};

起動条件付きジョブネットを待ち合わせ対象に指定していて，実行世代に異常終了がある場合の動作を指定します。

省略した場合はnoneが仮定されます。

exec：実行を開始する。

execdeffer：実行を開始しない。ただし，実行世代が「繰り越し未実行」状態の場合は，実行を開始する。

none：実行を開始しない。

uem={y|n};

起動条件付きジョブネットを待ち合わせ対象に指定していて，監視世代が監視未起動終了の場合の動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

5.2.26　フレキシブルジョブ定義情報の記述方法

フレキシブルジョブ定義情報の記述方法を説明します。

フレキシブルジョブ定義情報の形式，およびパラメーターを次に示します。

形式

[ex="中継エージェント名";]
da="宛先または一斉配信エージェント";
[fxg={none|sync|async};]
sc="実行したいエージェントホスト上のファイル名";
[prm="パラメーター";]
[env="環境変数";]...
[jd={nm|ab|cod|mdf|exf};]
[wth=n;]
[tho=n;]
[jdf="終了判定ファイル名";]
[abr={y|n};]
[rjs=自動リトライする終了コードの下限;]
[rje=自動リトライする終了コードの上限;]
[rec=最大リトライ回数;]
[rei=リトライ間隔;]
[ha={y|n};]
[eu={ent|def};]
[mm={and|or};]
[nmg={y|n};]
[eun=待ち合わせ対象ユニット名;]...
[ega={exec|execdeffer|none};]
[uem={y|n};]

パラメーター

ex="中継エージェント名";

中継エージェントとなる実行エージェント名または実行エージェントグループ名を定義します。中継しない場合，このパラメーターの指定は不要です。

指定できる文字数は，1〜255（単位：バイト）です。

中継エージェント名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

中継エージェント名には，マクロ変数を指定できます。マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

da="宛先または一斉配信エージェント";

フレキシブルジョブの実行要求先のホスト名，IPアドレス，またはDNS名を定義します。jp1hosts情報またはjp1hosts2情報は参照しません。

一斉配信する場合は，実行要求先は一斉配信エージェントです。

一斉配信しない場合で，ロードバランサーを使用するときは，実行要求先はロードバランサーです。

一斉配信しない場合で，ロードバランサーを使用しないときは，実行要求先はフレキシブルジョブを実行するエージェントホストです。

指定できる文字数は1〜128（単位：バイト）です。このパラメーターの指定は必須です。

宛先に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

宛先には，マクロ変数を指定できます。マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

fxg={none|sync|async};

一斉実行の方式を指定します。省略した場合，noneが仮定されます。

none：一斉実行しないで，通常のフレキシブルジョブを実行します。

sync：同期モードで実行します。

async：非同期モードで実行します。

sc="実行したいエージェントホスト上のファイル名";

実行したいエージェントホスト上のファイル名を定義します。

指定できる文字数は，1〜511（単位：バイト）です。ファイル名は，絶対パスで指定してください。実行したいファイルが環境変数PATHで指定されたパスの直下にある場合は，ファイル名だけで指定できます。このパラメーターの指定は必須です。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

実行したいエージェントホスト上のファイル名には，マクロ変数を指定できます。マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

prm="パラメーター";

実行したいエージェントホスト上のファイルで使用するパラメーターを定義します。

指定できる文字数は，1〜1,023（単位：バイト）です。

パラメーター中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

パラメーターには，マクロ変数を指定できます。マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

env="環境変数";

ジョブ実行時は，ジョブ実行時に設定される環境変数，システム環境変数，または実行ユーザー（OSユーザー）のローカルログインスクリプトに設定されている環境変数が有効となります。その環境に新たな変数を付け加えてジョブを実行できます。付け加える環境変数を「環境変数名=値」の形式で定義します。

指定できる文字数は，1〜10,240（単位：バイト）です。環境変数を複数指定する場合，このパラメーターを複数回指定します（「env="環境変数名=値";」の形式で，バイト数の合計が10,240バイトまで複数指定できます）。

環境変数中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

環境変数には，マクロ変数を指定できます。マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

ジョブ実行時に設定される環境変数については，「1.4.2 JP1/AJS3から実行されるジョブ実行時に設定される環境変数」を参照してください。

環境変数を定義する際の注意事項については，「付録A 環境変数および環境変数ファイルを定義する場合の注意事項」を参照してください。

jd={nm|ab|cod|mdf|exf};

終了判定種別を定義します。省略した場合，codが仮定されます。

cod以外を指定した場合，rjs，rje，rec，およびreiパラメーターを指定できません。また，abrパラメーターにyを指定できません。指定した場合はユニットの作成に失敗します。

nm：すべて正常終了とします。

ab：すべて異常終了とします。

cod：終了コードが指定値以下の場合は，正常終了とします。

mdf：宛先エージェント上でのジョブプロセスの実行開始から実行終了までの間にファイルが更新されている場合は，正常終了とします。

exf：宛先エージェント上でのジョブプロセスの実行終了時にファイルが作成されている場合は，正常終了とします。

wth=n;

警告しきい値を定義します。

指定できる値は，0〜2,147,483,647です。

tho=n;

異常しきい値を定義します。

指定できる値は，0〜2,147,483,647です。省略した場合，0が仮定されます。

jdf="終了判定ファイル名";

フレキシブルジョブを実行するエージェントホスト上の終了判定ファイル名を定義します。

指定できる文字数は，1〜511（単位：バイト）です。ファイル名は，絶対パスで指定してください。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

終了判定ファイル名には，マクロ変数を指定できます。マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

abr={y|n};

異常終了時リトライを定義します。省略した場合，nが仮定されます。

jdパラメーターにcodを指定した場合にだけ，yを指定できます。

y：異常終了時に自動リトライします。

n：異常終了時に自動リトライしません。

rjs=自動リトライする終了コードの下限;

異常終了時に自動リトライする終了コードの下限を定義します。

異常終了時に自動リトライする場合（abrパラメーターにyを指定した場合）にだけ指定できます。

指定できる値は，1〜4,294,967,295です。異常しきい値（thoパラメーター）以下の値および自動リトライする終了コードの上限（rieパラメーター）より大きな値を指定した場合は，ユニットの作成に失敗します。

省略した場合，自動リトライする終了コードの下限は定義されないで，ジョブ実行時に「異常しきい値＋1」が仮定されます。

rje=自動リトライする終了コードの上限;

異常終了時に自動リトライする終了コードの上限を定義します。

異常終了時に自動リトライする場合（abrパラメーターにyを指定した場合）にだけ指定できます。

指定できる値は，1〜4,294,967,295です。異常しきい値（thoパラメーター）以下の値および自動リトライする終了コードの下限（risパラメーター）より小さな値を指定した場合は，ユニットの作成に失敗します。

省略した場合，自動リトライする終了コードの上限は定義されないで，ジョブ実行時に最大値（4,294,967,295）が仮定されます。

rec=最大リトライ回数;

異常終了時に自動リトライする場合（abrパラメーターにyを指定した場合）にだけ，最大リトライ回数を指定できます。

指定できる値は1〜12（単位：回）です。省略した場合，1が仮定されます。

rei=リトライ間隔;

異常終了時に自動リトライする場合（abrパラメーターにyを指定した場合）にだけ，リトライ間隔を定義します。

指定できる値は，1〜10（単位：分）です。省略した場合，1が仮定されます。

ha={y|n};

ジョブの実行を保留するかを定義します。省略した場合，nが仮定されます。

y：保留します。

n：保留しません。

eu={ent|def};

ジョブ実行時のJP1ユーザーを定義します。省略した場合，entが仮定されます。

ent：ジョブネットを登録したJP1ユーザーをジョブ実行時のJP1ユーザーとします。

def：ジョブを所有するJP1ユーザーをジョブ実行時のJP1ユーザーとします。

mm={and|or};

指定した待ち合わせ対象ユニットとの待ち合わせ方法を指定します。

省略した場合はandが仮定されます。

and：すべての待ち合わせ対象ユニットが終了したら実行を開始する。

or：待ち合わせ対象ユニットが一つでも終了したら実行を開始する。

nmg={y|n};

指定した待ち合わせ対象ユニットのルートジョブネットに待ち合わせる世代がないときの動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

eun=待ち合わせ対象ユニット名;

待ち合わせ対象ユニットとするユニットを，完全名で指定します。

待ち合わせ対象ユニットを複数指定する場合，このパラメーターを複数回指定します。最大で32個指定できます。

待ち合わせ対象ユニット名に指定できる文字数は1〜930（単位：バイト）です。

ega={exec|execdeffer|none};

起動条件付きジョブネットを待ち合わせ対象に指定していて，実行世代に異常終了がある場合の動作を指定します。

省略した場合はnoneが仮定されます。

exec：実行を開始する。

execdeffer：実行を開始しない。ただし，実行世代が「繰り越し未実行」状態の場合は，実行を開始する。

none：実行を開始しない。

uem={y|n};

起動条件付きジョブネットを待ち合わせ対象に指定していて，監視世代が監視未起動終了の場合の動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

5.2.27　HTTP接続ジョブ定義情報の記述方法

HTTP接続ジョブ定義情報の記述方法を説明します。

HTTP接続ジョブ定義情報の形式，およびパラメーターを次に示します。

形式

htcfl="接続設定ファイル名";
[htknd={GET|POST|PUT|DELETE};]
[htexm={y|n};]
[htrqf="送信情報ファイル名";]
[htrqu="送信情報ファイル（URLパラメーター）";]
[htrqm="送信情報ファイル（メッセージボディ）";]
htstf="ステータス格納ファイル名";
[htspt={diff|same};]
htrhf="受信ヘッダー格納ファイル名";
[htrbf="受信ボディ格納ファイル名";]
[htcdm=終了コード1:HTTPステータスコード1,[HTTPステータスコード2...];]...
[so="標準出力ファイル名";]
[se="標準エラー出力ファイル名";]
[etm=n;]
[fd=実行所要時間;]
[pr=n;]
[ex="実行エージェント名";]
[un="実行ユーザー名";]
[jd={nm|ab|cod|mdf|exf};]
[wth=n;]
[tho=n;]
[jdf="終了判定ファイル名";]
[abr={y|n};]
[rjs=自動リトライする終了コードの下限;]
[rje=自動リトライする終了コードの上限;]
[rec=最大リトライ回数;]
[rei=リトライ間隔;]
[ha={y|n};]
[eu={ent|def};]
[mm={and|or};]
[nmg={y|n};]
[eun=待ち合わせ対象ユニット名;]...
[ega={exec|execdeffer|none};]
[uem={y|n};]

パラメーター

htcfl="接続設定ファイル名";

HTTP接続をするための接続情報を定義した，エージェントホスト上の接続設定ファイル名を定義します。

指定できる文字数は，1〜511（単位：バイト）です。

接続設定ファイル名は，絶対パスで指定します。

接続設定ファイル名に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

接続設定ファイル名には，マクロ変数を指定できます。マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

htknd={GET|POST|PUT|DELETE};

HTTP通信をするときのリクエスト種別（HTTPメソッド）を定義します。省略した場合，GETが仮定されます。

GET

POST

PUT

DELETE

htexm={y|n};

拡張モードを使用するかどうかを定義します。JP1/AJS3 - ManagerおよびJP1/AJS3 - Agentのバージョンが12-50以降の場合に指定できます。

省略した場合，nが仮定されます。

y

拡張モードを使用します。送信情報ファイル名（URLパラメーター）および送信情報ファイル名（メッセージボディ）の内容をHTTPリクエストとして送信します。

n

拡張モードを使用しません。送信情報ファイル名の内容をHTTPリクエストとして送信します。

htrqf="送信情報ファイル名";

HTTPリクエストとして送信する情報を定義した，エージェントホスト上の送信情報ファイル名を定義します。

指定できる文字数は，1〜511（単位：バイト）です。

送信情報ファイル名は，絶対パスで指定します。

送信情報ファイル名に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

送信情報ファイル名には，マクロ変数を指定できます。マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

送信情報ファイルの内容をURLパラメーターとして送信するか，メッセージボディとして送信するかは，HTTPリクエストのリクエスト種別によって異なります。リクエスト種別にかかわらず送信する情報を指定したい場合は，「htexm={y|n};」に「y」を指定し，「htrqu="送信情報ファイル（URLパラメーター）";」および「htrqm="送信情報ファイル（メッセージボディ）";」を使用することを推奨します。

htexmパラメーターに「y」を指定した場合，このパラメーターの指定は無視されます。

htrqu="送信情報ファイル（URLパラメーター）";

HTTPリクエストのURLパラメーターとして送信する情報を定義した，エージェントホスト上の送信情報ファイル名（URLパラメーター）を定義します。JP1/AJS3 - ManagerおよびJP1/AJS3 - Agentのバージョンが12-50以降で，拡張モードを使用する場合に指定できます。

指定できる文字数は，1〜511（単位：バイト）です。

送信情報ファイル名（URLパラメーター）は，絶対パスで指定します。

送信情報ファイル名（URLパラメーター）に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

送信情報ファイル名（URLパラメーター）には，マクロ変数を指定できます。マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

htexmパラメーターに「n」を指定した場合，このパラメーターの指定は無視されます。

htrqm="送信情報ファイル（メッセージボディ）";

HTTPリクエストのメッセージボディとして送信する情報を定義した，エージェントホスト上の送信情報ファイル名（メッセージボディ）を定義します。JP1/AJS3 - ManagerおよびJP1/AJS3 - Agentのバージョンが12-50以降で，拡張モードを使用する場合に指定できます。

指定できる文字数は，1〜511（単位：バイト）です。

送信情報ファイル名（メッセージボディ）は，絶対パスで指定します。

送信情報ファイル名（メッセージボディ）に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

送信情報ファイル名（メッセージボディ）には，マクロ変数を指定できます。マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

htexmパラメーターに「n」を指定した場合，このパラメーターの指定は無視されます。

htstf="ステータス格納ファイル名";

HTTPレスポンスに含まれるHTTPステータスの情報を格納するためにエージェントホスト上に作成されるステータス格納ファイル名を定義します。

指定できる文字数は，1〜511（単位：バイト）です。

ステータス格納ファイル名は，絶対パスで指定します。

ステータス格納ファイル名に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

ステータス格納ファイル名には，マクロ変数を指定できます。マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

htspt={diff|same};

HTTPレスポンスとして受信したHTTPヘッダーとHTTPボディを，別のファイルに出力するか，同じファイルに出力するかを定義します。省略した場合，diffが仮定されます。

diff

受信データのヘッダー部分を受信ヘッダー格納ファイルに，ボディ部分を受信ボディ格納ファイルに記述します。

same

受信データのヘッダー部分とボディ部分を分けずに，受信ヘッダー格納ファイルだけに記述します。

htrhf="受信ヘッダー格納ファイル名";

HTTPレスポンスとして受信したHTTPヘッダーの情報を格納するためにエージェントホスト上に作成される受信ヘッダー格納ファイル名を定義します。

指定できる文字数は，1〜511（単位：バイト）です。

受信ヘッダー格納ファイル名は，絶対パスで指定します。

受信ヘッダー格納ファイル名に空白文字が含まれる場合，「"（ダブルクォーテーションマーク）」で受信ヘッダー格納ファイル名を囲んでください。

受信ヘッダー格納ファイル名に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

受信ヘッダー格納ファイル名には，マクロ変数を指定できます。マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

htrbf="受信ボディ格納ファイル名";

HTTPレスポンスとして受信したHTTPボディの情報を格納するためにエージェントホスト上に作成される受信ボディ格納ファイル名を定義します。

指定できる文字数は，1〜511（単位：バイト）です。

受信ボディ格納ファイル名は，絶対パスで指定します。

受信ボディ格納ファイル名に空白文字が含まれる場合，「"（ダブルクォーテーションマーク）」で受信ボディ格納ファイル名を囲んでください。

受信ボディ格納ファイル名に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

受信ボディ格納ファイル名には，マクロ変数を指定できます。マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

「htspt={diff|same};」で「diff」と定義した場合，「htrbf="受信ボディ格納ファイル名";」は省略できません。「same」を選択した場合は，「htrbf="受信ボディ格納ファイル名";」に定義されている値は無視されます。

htcdm=終了コード1:HTTPステータスコード1,[HTTPステータスコード2...];

HTTPステータスコードごとのジョブの終了コードを指定します。このパラメーターは，複数指定できます。複数のジョブの終了コードを指定する場合は，「htcdm=終了コード1:HTTPステータスコード1;htcdm=終了コード2:HTTPステータスコード2」のように指定してください。

指定できる文字数は，1〜511（単位：バイト）です。指定できるジョブの終了コードの値は0〜9です。指定できるHTTPステータスコードの値は100〜999です。指定できる文字列は，0〜9（アラビア数字），「:（コロン）」です。

so="標準出力ファイル名";

ジョブを実行するエージェントホスト上の標準出力ファイル名を定義します。

指定できる文字数は，1〜511（単位：バイト）です。ファイル名は絶対パスで指定することを推奨します。相対パスで指定した場合，HTTP接続ジョブを実行するOSがWindowsのときは，エージェントの環境設定で設定されているエージェントプロセス実行時のワークディレクトリ名からの相対パスになります。HTTP接続ジョブを実行するOSがLinuxのときは，実行ユーザーのホームディレクトリからの相対パス，ホームディレクトリが未定義のときは「/（ルート）」からの相対パスになります。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

標準出力ファイル名には，マクロ変数を指定できます。マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

「$JP1AJS2_JPQSTDOUTTEMP$」を指定した場合，標準出力ファイルは一時ファイルに出力されます。

se="標準エラー出力ファイル名";

ジョブを実行するエージェントホスト上の標準エラー出力ファイル名を定義します。

指定できる文字数は，1〜511（単位：バイト）です。ファイル名は絶対パスで指定することを推奨します。相対パスで指定した場合，HTTP接続ジョブを実行するOSがWindowsのときは，エージェントの環境設定で設定されているエージェントプロセス実行時のワークディレクトリ名からの相対パスになります。HTTP接続ジョブを実行するOSがLinuxのときは，実行ユーザーのホームディレクトリからの相対パス，ホームディレクトリが未定義のときは「/（ルート）」からの相対パスになります。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

標準エラー出力ファイル名には，マクロ変数を指定できます。マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

etm=n;

実行打ち切り時間を，実行開始時刻からの相対分で定義します。

指定できる値は，10進数の値で1〜1,440（単位：分）です。

fd=実行所要時間;

終了遅延監視するジョブの実行所要時間を定義します。

指定できる値は，10進数の値で1〜1,440（単位：分）です。

pr=n;

ジョブの実行優先順位を定義します。

指定できる値は，「1」〜「5」です。実行優先順位がいちばん低いのが「1」，いちばん高いのが「5」です。省略した場合，上位ジョブネットの定義に依存します。このパラメーターを省略し，かつ，最上位までのすべての上位ジョブネットに対してpr，またはniパラメーターを指定しなかった場合，ジョブの実行優先順位は環境設定パラメーターDEFAULTPRIORITYの設定値によって決まります。環境設定パラメーターDEFAULTPRIORITYの設定も省略した場合は，「1」が仮定されます。

環境設定パラメーターDEFAULTPRIORITYの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2(108) DEFAULTPRIORITY」を参照してください。

ex="実行エージェント名";

ジョブを実行する実行エージェント名または実行エージェントグループ名を定義します。

指定できる文字数は，1〜255（単位：バイト）です。

実行エージェント名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

実行エージェント名には，マクロ変数を指定できます。マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

un="実行ユーザー名";

エージェントホストでジョブを実行する場合の，ジョブを実行するOSユーザー名を定義します。

指定できる文字数は，1〜63（単位：バイト）です。ユーザー名中に空白文字は指定できません。

ユーザー名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

実行ユーザー名には，マクロ変数を指定できます。マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

jd={nm|ab|cod|mdf|exf};

終了判定種別を定義します。省略した場合，codが仮定されます。

cod以外を指定した場合，rjs，rje，rec，およびreiパラメーターを指定できません。また，abrパラメーターにyを指定できません。指定した場合はユニットの作成に失敗します。

nm：すべて正常終了とします。

ab：すべて異常終了とします。

cod：終了コードが指定値以下の場合は，正常終了とします。

mdf：ジョブの実行開始から実行終了までの間にファイルが更新されている場合は，正常終了とします。

exf：ジョブの実行終了時にファイルが作成されている場合は，正常終了とします。

wth=n;

警告しきい値を定義します。

指定できる値は，0〜2,147,483,647です。

tho=n;

異常しきい値を定義します。

指定できる値は，0〜2,147,483,647です。省略した場合，0が仮定されます。

jdf="終了判定ファイル名";

ジョブを実行するエージェントホスト上の終了判定ファイル名を定義します。

指定できる文字数は，1〜511（単位：バイト）です。ファイル名は，絶対パスで指定することを推奨します。相対パスで指定した場合，HTTP接続ジョブを実行するOSがWindowsのときは，エージェントの環境設定で設定されているエージェントプロセス実行時のワークディレクトリ名からの相対パスになります。HTTP接続ジョブを実行するOSがLinuxのときは，実行ユーザーのホームディレクトリからの相対パス，ホームディレクトリが未定義のときは「/（ルート）」からの相対パスになります。

ファイル名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

終了判定ファイル名には，マクロ変数を指定できます。マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

abr={y|n};

異常終了時リトライを定義します。省略した場合，nが仮定されます。

jdパラメーターにcodを指定した場合にだけ，yを指定できます。

y：異常終了時に自動リトライします。

n：異常終了時に自動リトライしません。

rjs=自動リトライする終了コードの下限;

異常終了時に自動リトライする終了コードの下限を定義します。

異常終了時に自動リトライする場合（abrパラメーターにyを指定した場合）にだけ指定できます。

指定できる値は，1〜4,294,967,295です。異常しきい値（thoパラメーター）以下の値および自動リトライする終了コードの上限（rieパラメーター）より大きな値を指定した場合は，ユニットの作成に失敗します。

省略した場合，自動リトライする終了コードの下限は定義されないで，ジョブ実行時に「異常しきい値＋1」が仮定されます。

rje=自動リトライする終了コードの上限;

異常終了時に自動リトライする終了コードの上限を定義します。

異常終了時に自動リトライする場合（abrパラメーターにyを指定した場合）にだけ指定できます。

指定できる値は，1〜4,294,967,295です。異常しきい値（thoパラメーター）以下の値および自動リトライする終了コードの下限（risパラメーター）より小さな値を指定した場合は，ユニットの作成に失敗します。

省略した場合，自動リトライする終了コードの上限は定義されないで，ジョブ実行時に最大値（4,294,967,295）が仮定されます。

rec=最大リトライ回数;

異常終了時に自動リトライする場合（abrパラメーターにyを指定した場合）にだけ，最大リトライ回数を定義します。

指定できる値は1〜12（単位：回）です。省略した場合，1が仮定されます。

rei=リトライ間隔;

異常終了時に自動リトライする場合（abrパラメーターにyを指定した場合）にだけ，リトライ間隔を指定できます。

指定できる値は，1〜10（単位：分）です。省略した場合，1が仮定されます。

ha={y|n};

ジョブの実行を保留するかを定義します。省略した場合，nが仮定されます。

y：保留します。

n：保留しません。

eu={ent|def};

ジョブ実行時のJP1ユーザーを定義します。省略した場合，entが仮定されます。

ent：ジョブネットを登録したJP1ユーザーをジョブ実行時のJP1ユーザーとします。

def：ジョブを所有するJP1ユーザーをジョブ実行時のJP1ユーザーとします。

mm={and|or};

指定した待ち合わせ対象ユニットとの待ち合わせ方法を指定します。

省略した場合はandが仮定されます。

and：すべての待ち合わせ対象ユニットが終了したら実行を開始する。

or：待ち合わせ対象ユニットが一つでも終了したら実行を開始する。

nmg={y|n};

指定した待ち合わせ対象ユニットのルートジョブネットに待ち合わせる世代がないときの動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

eun=待ち合わせ対象ユニット名;

待ち合わせ対象ユニットとするユニットを，完全名で指定します。

待ち合わせ対象ユニットを複数指定する場合，このパラメーターを複数回指定します。最大で32個指定できます。

待ち合わせ対象ユニット名に指定できる文字数は1〜930（単位：バイト）です。

ega={exec|execdeffer|none};

起動条件付きジョブネットを待ち合わせ対象に指定していて，実行世代に異常終了がある場合の動作を指定します。

省略した場合はnoneが仮定されます。

exec：実行を開始する。

execdeffer：実行を開始しない。ただし，実行世代が「繰り越し未実行」状態の場合は，実行を開始する。

none：実行を開始しない。

uem={y|n};

起動条件付きジョブネットを待ち合わせ対象に指定していて，監視世代が監視未起動終了の場合の動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

5.2.28　カスタムイベントジョブ定義情報の記述方法

カスタムイベントジョブ定義情報の記述方法を説明します。

カスタムイベントジョブ定義情報の形式，およびパラメーターを次に示します。

形式

cety="識別子";
[jpoif=マクロ変数名:引き継ぎ情報名;]...
[etm=n;]
[fd=実行所要時間;]
[ex="実行エージェント名";]
[ha={y|n};]
[eu={ent|def};]
[ets={kl|nr|wr|an};]
[mm={and|or};]
[nmg={y|n};]
[eun=待ち合わせ対象ユニット名;]...
[ega={exec|execdeffer|none};]
[uem={y|n};]
[cprm="任意の指定項目名=値";]...

パラメーター

cety="識別子";

カスタムイベントジョブで連携するプログラムを識別する情報を定義します。総バイト数が16バイト以内の先頭が「CE」で始まる文字列で指定します。

定義できる値は，連携するプログラムに応じて異なります。カスタムイベントジョブと連携する製品のマニュアルを参照してください。

連携するプログラムが提供する情報以外の値を指定した場合，ジョブは異常検出終了となります。

jpoif=マクロ変数名:引き継ぎ情報名;

マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

マクロ変数を複数指定する場合，このパラメーターを複数回指定します（「jpoif=マクロ変数名:引き継ぎ情報名;」の形式で，バイト数の合計が2,048バイトまで複数指定できます）。

このパラメーターでは，後続のUNIXジョブ，PCジョブ，フレキシブルジョブ，HTTP接続ジョブ，およびアクションジョブに対してイベント情報を引き継げます。

引き継ぎ情報名に指定できる値は，「CMTMOUT」および「OBJECT01〜OBJECT10」です。

etm=n;

実行打ち切り時間を，実行開始時刻からの相対分で定義します。指定できる値は，1〜1,440（単位：分）です。起動条件内のジョブの場合，このパラメーターは無効になります。

fd=実行所要時間;

終了遅延監視するジョブの実行所要時間を定義します。

指定できる値は，10進数の値で1〜1,440（単位：分）です。

起動条件として定義する場合，このパラメーターはジョブ実行時に無効になります。

ex="実行エージェント名";

ジョブを実行する実行エージェント名を定義します。

指定できる文字数は，1〜255（単位：バイト）です。

実行エージェント名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

マクロ変数を指定できます。

ha={y|n};

ジョブの実行を保留するかを定義します。省略した場合，nが仮定されます。起動条件内のジョブの場合，このパラメーターは無効になります。

y：保留します。

n：保留しません。

eu={ent|def};

ジョブ実行時のJP1ユーザーを定義します。省略した場合，entが仮定されます。

ent：ジョブネットを登録したJP1ユーザーをジョブ実行時のJP1ユーザーとします。

def：ジョブを所有するJP1ユーザーをジョブ実行時のJP1ユーザーとします。

ets={kl|nr|wr|an};

実行打ち切り時間が経過したあとのカスタムイベントジョブの状態を定義します。省略した場合，klが仮定されます。起動条件内のジョブの場合，このパラメーターは無効になります。

kl：強制終了

nr：正常終了

wr：警告検出終了

an：異常検出終了

mm={and|or};

指定した待ち合わせ対象ユニットとの待ち合わせ方法を指定します。

省略した場合はandが仮定されます。

and：すべての待ち合わせ対象ユニットが終了したら実行を開始する。

or：待ち合わせ対象ユニットが一つでも終了したら実行を開始する。

nmg={y|n};

指定した待ち合わせ対象ユニットのルートジョブネットに待ち合わせる世代がないときの動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

eun=待ち合わせ対象ユニット名;

待ち合わせ対象ユニットとするユニットを，完全名で指定します。

待ち合わせ対象ユニットを複数指定する場合，このパラメーターを複数回指定します。最大で32個指定できます。

待ち合わせ対象ユニット名に指定できる文字数は1〜930（単位：バイト）です。

ega={exec|execdeffer|none};

起動条件付きジョブネットを待ち合わせ対象に指定していて，実行世代に異常終了がある場合の動作を指定します。

省略した場合はnoneが仮定されます。

exec：実行を開始する。

execdeffer：実行を開始しない。ただし，実行世代が「繰り越し未実行」状態の場合は，実行を開始する。

none：実行を開始しない。

uem={y|n};

起動条件付きジョブネットを待ち合わせ対象に指定していて，監視世代が監視未起動終了の場合の動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

cprm="任意の指定項目名=値";

カスタムイベントジョブのユニット定義パラメーターを「任意の指定項目名=値」形式で指定します。

指定できる文字数は，2〜20,479（単位：バイト）です。このパラメーターを複数同時に指定した場合，指定した入力値すべての文字数の合計が，最大「20,479からcprmパラメーターの指定数を引き，1を足した値（単位：バイト）」です。例えば，cprmパラメーターを一つのユニットに同時に5個指定した場合，値として指定できる文字数の合計は最大「20479-5+1=20475」（単位：バイト）です。

指定値に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

「任意の指定項目名=値」の値部分には，マクロ変数を指定できます。マクロ変数で指定する場合，指定できる文字数は，「任意の指定項目名=マクロ変数名」の形式で，9〜20,479（単位：バイト）です。マクロ変数名は，「?AJS2xxxxx?」という形式の64バイト以内の文字列で指定します。xxxxxの部分に指定できる文字列は，A〜Z（大文字の英字），0〜9（アラビア数字），「.（ピリオド）」です。

5.2.29　起動条件定義情報の記述方法

起動条件定義情報の記述方法を説明します。

起動条件を定義する場合は，ルートジョブネットのユニット定義パラメーターに続いて，起動条件のユニット属性パラメーターを記述します。起動条件ユニットには「.CONDITION」という固有名称を付けます。起動条件ユニットには，イベントジョブおよびカスタムイベントジョブを32個まで定義できます。ただし，イベントジョブおよびカスタムイベントジョブのリカバリージョブは定義できません。

起動条件定義情報の形式，およびパラメーターを次に示します。

形式

[cond={and|or};]
[mcs={m|w|s};]
[cgs={y|n};]
[ab={exec|hold|stop};]

パラメーター

cond={and|or};

起動条件の接続種別を定義します。省略した場合，andが仮定されます。

and：and接続します。

or：or接続します。

mcs={m|w|s};

起動条件の監視を開始する際に，すでに「監視中」状態の監視世代があったときの動作を指定します。省略した場合は，mが仮定されます。

m：起動条件の監視を開始する際に，すでに「監視中」状態の監視世代があったとき，監視を開始して監視世代を多重起動します。監視世代を多重起動した場合，一つのイベント発生で多重起動している分の起動条件が成立します。

w：起動条件の監視を開始する際に，すでに「監視中」状態の監視世代があったとき，監視を開始しないで「監視中」状態の監視世代が終了するのを待ちます。この状態のままジョブネットの打ち切り時間に設定した時刻に到達した場合は，「繰り越し未実行」状態になります。

s：起動条件の監視を開始する際に，すでに「監視中」状態の監視世代があったとき，監視の開始をスキップして「繰り越し未実行」状態になります。

cgs={y|n};

多重起動しないように設定している起動条件付きジョブネットで，「実行中」状態の実行世代があるときに起動条件成立した場合，その実行を滞留させるかどうか指定します。省略した場合は，yが仮定されます。

y：繰り越さずに滞留させる

起動条件が成立した際に，すでに「実行中」状態の実行世代があったとき，「実行中」状態の実行世代が終了するまで次の実行世代を滞留させます。滞留している間は「起動条件待ち」状態になります。

n：繰り越して滞留させない

起動条件が成立した際に，すでに「実行中」状態の実行世代があったとき，次の実行世代を滞留させないで「繰り越し未実行」状態にします。

ab={exec|hold|stop};

起動条件付きジョブネットを実行時に，実行世代のジョブネットが異常終了した場合の，それ以降のジョブネットの動作を定義します。省略した場合，execが仮定されます。

exec：実行世代のジョブネットの実行を開始します。

hold：実行世代のジョブネットの開始を保留します。

stop：起動条件の成立を監視している監視世代のジョブネットを停止します。

5.2.30　ジョブネットコネクタ定義情報の記述方法

ジョブネットコネクタ定義情報の記述方法を説明します。

ジョブネットコネクタ定義情報の形式，およびパラメーターを次に示します。

形式

[ncr=接続先のルートジョブネット名;]
[ncex={y|n};]
[nchn="接続ホスト名";]
[ncsv=接続サービス名;]
[mm={and|or};]
[nmg={y|n};]
[eun=待ち合わせ対象ユニット名;]...
[ega={exec|execdeffer|none};]
[uem={y|n};]

パラメーター

ncr=接続先のルートジョブネット名;

このジョブネットコネクタによって実行順序を制御するルートジョブネット（対象がプランニンググループ直下のルートジョブネットの場合はプランニンググループ）のユニット完全名を指定します。指定できる文字数は，1〜930（単位：バイト）です。

ncex={y|n};

ルートジョブネットの実行順序を制御する場合に，スケジューラーサービス間連携させるかどうかを定義します。省略した場合，nが仮定されます。

y：スケジューラーサービス間連携します。

別のホストまたは別のスケジューラーサービスに定義したジョブネットコネクタと連携します。

n：スケジューラーサービス間連携しません。

同一スケジューラーサービスに定義したジョブネットコネクタとだけ連携します。

nchn="接続ホスト名";

接続先のジョブネットが定義されているホスト名を指定します。

指定できる文字数は，1〜255（単位：バイト）です。半角スペース，タブ文字，改行文字は指定できません。

パラメーターncexにyが設定されていない場合はエラーになります。

ホスト名中に「"（ダブルクォーテーションマーク）」や「#」が含まれる場合は，キャスト文字（#）でキャストします。「"」は「#"」，「#」は「##」と記述します。

ncsv=接続サービス名;

接続先のジョブネットが定義されているスケジューラーサービス名を指定します。指定できる文字数は，1〜30（単位：バイト）です。

パラメーターncexにyが設定されていない場合はエラーになります。

mm={and|or};

指定した待ち合わせ対象ユニットとの待ち合わせ方法を指定します。

省略した場合はandが仮定されます。

and：すべての待ち合わせ対象ユニットが終了したら実行を開始する。

or：待ち合わせ対象ユニットが一つでも終了したら実行を開始する。

nmg={y|n};

指定した待ち合わせ対象ユニットのルートジョブネットに待ち合わせる世代がないときの動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

eun=待ち合わせ対象ユニット名;

待ち合わせ対象ユニットとするユニットを，完全名で指定します。

待ち合わせ対象ユニットを複数指定する場合，このパラメーターを複数回指定します。最大で32個指定できます。

待ち合わせ対象ユニット名に指定できる文字数は1〜930（単位：バイト）です。

ega={exec|execdeffer|none};

起動条件付きジョブネットを待ち合わせ対象に指定していて，実行世代に異常終了がある場合の動作を指定します。

省略した場合はnoneが仮定されます。

exec：実行を開始する。

execdeffer：実行を開始しない。ただし，実行世代が「繰り越し未実行」状態の場合は，実行を開始する。

none：実行を開始しない。

uem={y|n};

起動条件付きジョブネットを待ち合わせ対象に指定していて，監視世代が監視未起動終了の場合の動作を指定します。

省略した場合はnが仮定されます。

y：実行を開始する。

n：実行を開始しない。

5.3　ユニット定義パラメーターの記述例

ユニット定義パラメーターの記述例として，次の6パターンを紹介します。

ジョブグループを定義する場合

ジョブネットを定義する場合

ジョブを定義する場合

関連設定されているネストジョブネットを定義する場合

ルートジョブネットに起動条件を定義する場合

ジョブネットコネクタを定義する場合

5.3.1　ジョブグループを定義する場合の記述例

(1)　ジョブグループの定義例

この例では，次の条件を満たすジョブグループを定義します。

一つのジョブグループを定義する。

ジョブグループ名は「group」とする。

ユニットの属性は「所有者：更新」「グループ：参照」「その他：参照」とする。

カレンダー情報として，土曜日および日曜日を休業日とする。基準時刻は6:00とする。

記述例を次に示します。

(2)　プランニンググループの定義例

この例では，次の条件を満たすプランニンググループを定義します。

一つのプランニンググループを定義する。

プランニンググループ名は「pgroup」とする。

記述例を次に示します。

5.3.2　ジョブネットを定義する場合の記述例

この例では，次の条件を満たすジョブネットを定義します。

一つのジョブネットを定義する。

ジョブネット名は「net」とする。

ユニットの属性は「所有者：更新」「グループ：操作」「その他：参照」とする。

ジョブネットの実行開始日時を，20XX年6月30日13:00とする。

ジョブネットは毎日実行するものとする。

記述例を次に示します。

5.3.3　ジョブを定義する場合の記述例

この例では，次の条件を満たすジョブを定義します。

一つのジョブを定義する。

ジョブ名は「job」とする。

記述例を次に示します。

5.3.4　関連設定されているネストジョブネットを定義する場合の記述例

この例では，次の条件を満たすジョブネットを新規に作成します。

次に示すジョブネットを定義する。

記述例を次に示します。

5.3.5　ルートジョブネットに起動条件を定義する場合の記述例

次の条件を満たすジョブネットを新規に作成します。

次に示すルートジョブネット「topnet（起動条件付き）」を定義する。

起動条件のジョブネット「.CONDITION」には，「イベントIDが「111」であるイベント，または「222」であるイベントのどちらかを受信した場合」を設定する。

記述例を次に示します。

5.3.6　ジョブネットコネクタを定義する場合の記述例

この例では，次の条件を満たすジョブネットコネクタを定義します。

jobnetA，jobnetBおよびjobnetCという三つのルートジョブネットの実行順序を制御するジョブネットコネクタを定義する。

三つのルートジョブネットの実行順序は，jobnetA→jobnetB→jobnetCの順とする。

ジョブネットコネクタを定義するジョブネットを「jobnetS」とする。また，ジョブネットコネクタ名は「JC1」「JC2」および「JC3」とする。

記述例を次に示します。

まず，ジョブネットコネクタを定義するjobnetSを作成し，その配下にjobnetA，jobnetB，およびjobnetCを制御するジョブネットコネクタJC1，JC2，およびJC3を定義します。

jobnetA，jobnetB，およびjobnetCに，実行順序制御をするための情報（それぞれを制御するジョブネットコネクタ名など）を定義します。

5.4　予定情報ファイルの作成

予定情報ファイルには，ジョブネットやジョブの実行予定を定義します。ajsentryコマンドでジョブネットを確定実行登録する場合は，この予定情報ファイルを指定して，確定スケジュールを決定します。

この節では，予定情報ファイルの作成方法について説明します。

5.4.1　予定情報ファイルの記述形式

予定情報ファイルに定義する，予定情報パラメーターの記述形式を次の図に示します。

図5‒2　予定情報パラメーターの記述形式

次に，記述項目について説明します。

(A)コメント文

コメントを追加したい場合は，コメントを「/*」と「*/」で囲んで記述します。

コメントは，ジョブネットの予定情報パラメーターを定義した行，およびジョブの予定情報パラメーターを定義した行には記述できません。

(B)ジョブネットの予定情報パラメーター

ジョブネットの予定情報パラメーターを記述します。

記述形式を次に示します。

記述項目について説明します。

情報1

ジョブネット名を指定します。指定できる文字数は，1〜30（単位：バイト）です。ただし，文字コードがUTF-8の場合で，環境設定パラメーターDEFLENTYPEが「sjis」のときは，文字数をシフトJISに換算して1〜30（単位：バイト）です。

情報2

ジョブネットの実行開始日時を「YYYYMMDDHHMM」の形式で指定します。

「YYYYMMDDHHMM」の内容は次のとおりです。

YYYY：実行年。指定できる値は，ジョブネットの実行登録日の年〜環境設定パラメーターSCHEDULELIMITの値（単位：西暦年）です。環境設定パラメーターSCHEDULELIMITの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2(123) SCHEDULELIMIT」を参照してください。

MM：実行月。指定できる値は，1〜12（単位：月）です。

DD：実行日。指定できる値は，1〜31（単位：日）です。

HH：実行時。指定できる値は，0〜47（単位：時）です。

MM：実行分。指定できる値は，0〜59（単位：分）です。

省略した場合，次の値が仮定されます。

ルートジョブネットの場合：実行登録日時

ネストジョブネットの場合：実行予定なし

情報3

ジョブネットの実行を保留するかを指定します。省略した場合，ジョブネットに定義された保留属性に従います。

h：保留します。

n：保留しません。

情報4

ジョブネットの開始遅延監視時刻を定義します。省略した場合，開始遅延を監視しません。

「HHMM」の形式で絶対時刻指定します。

HH：開始遅延監視時刻の時。指定できる値は，0〜47（単位：時）です。

MM：開始遅延監視時刻の分。指定できる値は，0〜59（単位：分）です。

「RMMMM」の形式で相対分指定します。

R：遅延監視開始位置を相対的に指定します。「'M'」の場合はルートジョブネットの実行開始時刻から，「'U'」の場合は上位ジョブネットの実行開始時刻から，「'C'」の場合は自ジョブネットの実行開始時刻からの相対分として扱います。

MMMM：遅延監視を開始するまでの時間を，ジョブネットの実行開始時刻からの相対分で指定します。指定できる値は，1〜2,879（単位：分）です。

情報5

ジョブネットの終了遅延監視時刻を指定します。省略した場合，終了遅延を監視しません。

「HHMM」の形式で，絶対時刻指定します。

HH：開始遅延監視時刻の時。指定できる値は，0〜47（単位：時）です。

MM：開始遅延監視時刻の分。指定できる値は，0〜59（単位：分）です。

「RMMMM」の形式で，相対分指定します。

R：遅延監視開始位置を相対的に指定します。「'M'」の場合はルートジョブネットの実行開始時刻から，「'U'」の場合は上位ジョブネットの実行開始時刻から，「'C'」の場合は自ジョブネットの実行開始時刻からの相対分として扱います。

MMMM：遅延監視を開始するまでの時間を，ジョブネットの開始時刻からの相対分で指定します。指定できる値は，1〜2,879（単位：分）です。

情報6

実行優先順位を指定します。指定できる値は，nまたは1〜5です。nを指定した場合，上位ジョブネットに定義された実行優先順位の値を引き継ぎます。数値で指定する場合，優先順位がいちばん低いのが1，いちばん高いのが5です。

省略した場合，ジョブネットに定義されたスケジュールの，実行優先順位の値が仮定されます。

情報7

ジョブネットのイベント待ち時刻を定義します。省略した場合，イベント待ち時刻を設定しません。

n：イベント待ち時刻を設定しません。

「HHMM」の形式で，絶対時刻指定します。

HH：イベント待ち開始時刻の時。指定できる値は，0〜47（単位：時）です。

MM：イベント待ち開始時刻の分。指定できる値は，0〜59（単位：分）です。

「RMMMM」の形式で，相対分指定します。

R：ジョブネットの実行開始時刻から相対分として扱います。

MMMM：イベント待ちを開始するまでの時間を，ジョブネットの実行開始時刻からの相対分で指定します。指定できる値は，1〜2,879（単位：分）です。

U：無制限に待ち続けます。

情報8

ジョブネットのイベント待ち回数を指定します。省略した場合，イベント待ちを設定しません。

n：イベント待ちを設定しません。

N：イベント待ち回数を指定します。指定できる値は，1〜999（単位：回）です。

U：無制限にイベントを待ちます。

情報9

ジョブネットのスケジュールルール番号を指定します。指定できる値は，1〜144です。

この情報は，確定実行登録したジョブネットをサスペンドし，そのジョブネットにジョブネットを追加した際に，追加したジョブネットのスケジュールを上位ジョブネットのスケジュールを利用して計算する場合に指定します（具体的には，確定実行登録したジョブネットAをサスペンドしてジョブネットBを追加した際に，ジョブネットBのスケジュールを，ジョブネットAのスケジュールから計算する場合に指定します）。

この情報を省略した場合，または上位のジョブネットのスケジュールルール番号と一致しない場合，サスペンド中に追加したジョブネットのスケジュールは設定されません。

(C)予定情報パラメーターの記述開始

「{」を記述します。

対応する「}」までの内容が，一つの予定情報パラメーターです。一つの予定情報パラメーターは，ジョブネットの1回分の実行予定です。

(D)ジョブの予定情報パラメーター群

ジョブの予定情報パラメーターを記述します。

このパラメーターは，ジョブが属するジョブネットの予定情報パラメーターの直後に記述します。ジョブの予定情報パラメーターの記述形式を次に示します。

記述項目について説明します。

情報1

ジョブ名を指定します。指定できる文字数は，1〜30（単位：バイト）です。ただし，環境設定パラメーターDEFLENTYPEが「sjis」の場合，文字数をシフトJISに換算して1〜30（単位：バイト）です。

情報2

ジョブを実行するかを指定します。省略した場合，yが仮定されます。

y：ジョブを実行します。

n：ジョブを実行しません。

情報3

ジョブの実行を保留するかを指定します。省略した場合，ジョブに定義された保留属性に従います。

h：保留します。

n：保留しません。

(E)予定情報パラメーターの記述終了

「}」を記述します。

5.4.2　予定情報パラメーター定義時の注意事項

予定情報パラメーターの定義時の注意事項を次に示します。

ajsdefineコマンドで定義していないユニットには，予定情報パラメーターでスケジュールを定義できません。

ジョブネットの1回分の実行予定として，複数の予定情報パラメーターが定義されている場合は，最後に定義されている予定情報パラメーターが有効になります。

ネストジョブネットの場合，ネストジョブネットに含まれるすべてのユニットに予定情報パラメーターでスケジュールを定義してください。ネストジョブネット中のユニットにスケジュールを定義しなかった場合，そのジョブネットは実行されません。

ジョブの予定情報パラメーターを省略した場合，ジョブネットが実行するのであれば，ジョブもジョブネットと同じスケジュールで実行されます。

下位ジョブネットの実行予定時刻が，上位ジョブネットの実行日の基準時刻から24時間以降の場合は，24時間の範囲への丸め処理をします。次に丸め処理の例を示します。

上記の構成のジョブネットの場合，ジョブネット「net1」の実行開始時刻は，丸め処理によって20XX年12月1日23:59になります。

5.5　予定情報パラメーターの記述例

次の条件を満たすジョブネットにスケジュールを定義する場合の，予定情報パラメーターの記述例を紹介します。

ユニットの構成を次の図に示します。

定義するスケジュールを次の表に示します。

ユニット名

実行開始日時

実行時の保留属性

net0

20XX/12/1　12:00

保留する

net1

20XX/12/1　12:00

保留しない

job1

実行する

保留しない

net2

20XX/12/1　14:00

保留しない

job2

実行する

保留しない

net3

20XX/12/1　13:00

保留する

job3

実行しない

対象外

job0

実行する

保留しない

記述例を次に示します。

5.6　登録予定情報ファイル

登録予定情報ファイルは，ajsrgexportコマンドを実行することによって取得できるジョブネットの実行登録情報を保存するファイルです。

また，ajsrgimportコマンドを実行することによって登録予定情報ファイルの内容をマネージャーにインポートします。

注意事項

登録予定情報ファイルは修正しないでください。修正した場合，正常に動作しないおそれがあります。

5.6.1　登録予定情報ファイルの記述形式

登録予定情報ファイルに定義される，登録予定情報パラメーターの記述形式を次の図に示します。

図5‒3　登録予定情報パラメーターの記述形式

次に，記述項目について説明します。

(A)エクスポート日時

登録予定情報をエクスポートした日時を出力します。

出力形式

日本語環境の場合：YYYY/MM/DD hh:mm:ss

英語環境の場合　：MMM DD YYYY hh:mm:ss

(B)エクスポートホスト名

登録予定情報をエクスポートしたホスト名を出力します。

出力形式

FQDN形式（DNS環境でない場合，ショート名が出力されます）

(C)エクスポートスケジューラーサービス名

登録予定情報をエクスポートしたスケジューラーサービス名を出力します。ajsrgexportコマンドにスケジューラーサービス名を指定していない場合，デフォルトスケジューラーサービス名が仮定されます。

(D)登録予定情報パラメーターの記述開始

「{」を記述します。この記述項目は，省略できません。

対応する「}」までの内容が，一つの登録予定情報パラメーター群です。一つの登録予定情報パラメーター群は，ジョブネットごとに指定します。

(E)コメント文

コメントを追加したい場合は，行の先頭に「#」を記述します。

ほかのパラメーターを定義した行には，コメントを記述できません。

コメントは任意の行に指定できます。

(F) UNIT=ルートジョブネット名

実行登録するルートジョブネット名をユニット完全名で指定します。指定できる文字数は，1〜930（単位：バイト）です。

このパラメーターは省略できません。また，このパラメーターは，複数指定できません。

ユニット完全名には，続けてホスト名，スケジューラーサービス名，および実行IDを指定できません。

(G) ENTRY={s|f}

実行登録方法を指定します。実行登録方法は，次のとおりです。

s：ジョブネットを計画実行登録します。

f：ジョブネットを確定実行登録します。

このパラメーターは省略できません。また，このパラメーターは，複数指定できません。

(H) EXCEEDSSCHEDULE={exec|skip}

スケジューラーサービスの起動時に実行開始予定時間を超過しているジョブネットの起動抑止を指定します。

exec

スケジューラーサービスの起動時に実行開始予定時間を超過していてもジョブネットを実行します。

skip

スケジューラーサービスの起動時に実行開始予定時間を超過していた場合は，ジョブネットを実行しません。

このパラメーターを省略した場合は「exec」を仮定します。

このパラメーターは，複数指定できません。

(I) MACRO=マクロ変数名：引き継ぎ情報

ジョブネット実行時のマクロ変数名，引き継ぎ情報を指定します。一つのマクロ変数名，引き継ぎ情報に対して「MACRO=」を指定します。

このパラメーターは32個まで指定できます。

マクロ変数を指定しない場合は記述しないでください。改行までが有効な値となります。「MACRO=」を複数指定した場合に，指定できる文字数の合計は4,085バイトです。

なお，ここで指定するマクロ変数は，インポートする予定だけでなく，ジョブが実行されて次回予定が作成されるたびに引き継がれます。そのため，計画実行登録（「ENTRY=s」），または確定実行登録の未来世代数指定（「ENTRY=f」かつ「FUTUREGENERATION=X」（X：1〜99の整数））の場合だけ有効になります。その他の実行登録（確定実行登録の期間指定（「ENTRY=f」かつ「FUTUREGENERATION=0または指定なし」））の場合，この項目に指定した内容は無視されます。確定実行登録の期間指定の場合は，「(R)予定情報パラメーター」に指定してください。

マクロ変数名

英大文字，数字，「.（ピリオド）」を指定できます。

指定できる文字数は62バイト（前後の「?」を除きます）以内です。

引き継ぎ情報

任意の文字列を指定します。

指定できる文字数は，1〜255（単位：バイト）です。

指定例1

マクロ変数の指定が一つだけの場合

　　MACRO=AJS2ENV:/data/job_report

指定例2

マクロ変数の指定が複数の場合

　　MACRO=AJS2ENV:/data/job_report
　　MACRO=AJS2COM:c:¥temp¥test.exe

(J) TIME=実行登録日時

ジョブネットの実行登録時間を「yyyy/mm/dd△hh:mm」（△：半角スペース）の形式で指定します。指定できる文字数は16バイトです。このパラメーターを省略した場合は，ajsrgimportコマンドを実行した時間を仮定します。指定できる範囲は，1994/01/01 00:00から2099/12/31 23:59です。ジョブネットのスケジュールルールに登録日を指定している場合は，この時間を基点としてスケジュールを計算します。

(K) TZ=タイムゾーン

タイムゾーンを指定します。指定できる文字数は99バイトです。このパラメーターを省略した場合は，タイムゾーンの指定がない場合のシステムの動作に従います。

(L) JP1USER=登録JP1ユーザー名

実行登録するJP1ユーザーを指定します。指定できる文字数は31バイトです。このパラメーターを省略した場合，ajsrgimportコマンドを実行したJP1ユーザーを仮定します。

(M) FUTUREGENERATION=未来世代数

確定スケジュールの，次回以降の実行予定世代数を指定します。指定できる値は，1〜99（単位：バイト）です。実行登録方法に計画実行登録を指定（「ENTRY=s」）した場合，この項目に指定した内容は無視されます。

(N) PRVTIME=擬似予定開始予定時刻

スケジュール計算用のパラメーターです。変更しないでください。

(O) PURGETTIME=擬似予定実行中止時刻

スケジュール計算用のパラメーターです。変更しないでください。

(P) SKIPTIME=擬似予定開始実行日

スケジュール計算用のパラメーターです。変更しないでください。

なお，インポート時は世代管理プロセスによってこのパラメーターの値が自動的に設定されます。そのため，インポート前の登録予定情報ファイルとインポート後すぐにエクスポートした登録予定情報ファイルを比較すると，差分が検出されますが，特に問題はありません。

(Q)予定情報セクション

「[SCHEDULEINFO]」を記述します。予定情報パラメーターを指定する場合，予定情報セクションは省略できません。実行登録方法に計画実行登録を指定（「ENTRY=s」）した場合，この項目に指定した内容は無視されます。

(R)予定情報パラメーター

確定実行登録する場合の実行予定が指定された，予定情報パラメーターを指定します。実行登録方法に計画実行登録を指定（「ENTRY=s」）した場合，この項目に指定した内容は無視されます。予定情報パラメーターの形式が実行登録するジョブネットの構造に合っていない場合，メッセージKAVS4826-Eを出力します。

記述形式を次に示します。

記述項目について説明します。

情報1〜情報9

情報1〜情報9については，「5.4.1 予定情報ファイルの記述形式」の「(B)ジョブネットの予定情報パラメーター」を参照してください。

情報10

ジョブネットの実行順序制御方式を指定します。

y：「同期」して実行します。

n：「非同期」で実行します。

この項目は，ルートジョブネットにだけ指定できます。省略した場合は，ルートジョブネットの定義に従って動作します。

ネストジョブネットに指定した場合，この項目は無効となります。

情報11

ジョブネットの「ジョブネット監視」（実行所要時間に該当）を指定します。指定できる値は，1〜2,879（単位：分）です。

指定なし：定義に従ってジョブネット監視を行います。

0：ジョブネット監視を行いません。

1〜2879：指定された値でジョブネット監視を行います。

情報12

サービスの起動時に開始時間超過ユニットの実行を抑止するかどうかを指定します。

exec：超過していても実行します。

skip：超過していた場合，実行しません。

この項目は，ルートジョブネットにだけ指定できます。省略した場合，「exec」を仮定します。

ネストジョブネットに指定した場合，この項目は無効となります。

情報13

実行登録日時を「YYYYMMDDTTMM」（日本語環境，英語環境ともに）の形式で指定します。この項目は省略できません。

この項目は，ルートジョブネットにだけ指定できます。

ネストジョブネットに指定した場合，この項目は無効となります。

情報14

タイムゾーンを99バイト以内で指定します。

この項目は，ルートジョブネットにだけ指定できます。省略した場合は，タイムゾーンの指定がない場合のシステムの動作に従います。

ネストジョブネットに指定した場合，この項目は無効となります。

なお，タイムゾーンは「"（ダブルクォーテーションマーク）」で囲んで指定します。

情報15

登録JP1ユーザー名（ajsentryコマンドを実行したJP1ユーザー名）を指定します。

この項目は，ルートジョブネットにだけ指定できます。省略した場合は，コマンドを実行したJP1ユーザーを仮定します。

ネストジョブネットに指定した場合，この項目は無効となります。

なお，登録JP1ユーザー名は「"（ダブルクォーテーションマーク）」で囲んで指定します。

情報16

マクロ変数の情報を設定します。

0：共通セクションのマクロ変数を使用しないで，予定情報セクションで指定したマクロ変数を使用します。予定情報セクションで指定したマクロ変数が「" "」（空）の場合，マクロ変数を使用しません。

1：共通セクションのマクロ変数を使用します。

この項目は，ルートジョブネットにだけ指定できます。ネストジョブネットに指定した場合，この項目は無効となります。

情報17

ジョブネット実行時のマクロ変数名，引き継ぎ情報を指定します。

この項目は，ルートジョブネットにだけ指定できます。ネストジョブネットに指定した場合，この項目は無効となります。

なお，マクロ変数は「"（ダブルクォーテーションマーク）」で囲んで指定してください。

ジョブの予定情報パラメーターには，次の項目を指定できます。

情報1〜情報3については，「5.4.1 予定情報ファイルの記述形式」の「(D)ジョブの予定情報パラメーター群」を参照してください。

(S)登録予定情報パラメーターの記述終了

「}」を記述します。この記述項目は，省略できません。

計画実行登録したルートジョブネットの登録予定情報をエクスポートした場合，インポート時には共通セクションの(A)〜(P)に従って予定が生成されます。

確定実行登録したルートジョブネットの登録予定情報をエクスポートした場合，エクスポート前にすでに生成されていた予定は，エクスポート時に予定情報セクションに出力されます。そのため，インポート時には予定情報セクションのパラメーターに従って予定が生成されます。また，未来世代数指定（「(M) FUTUREGENERATION」の値が1以上）の場合で，かつインポート時に生成された予定情報セクションの予定数が指定世代数に満たない場合，残りの予定は共通セクションの(A)〜(P)に従って生成されます。

第3編　API編

6　APIの概要

この章では，JP1/AJS3を操作するためのAPIの詳細について説明します。

6.1　API利用の流れ

JP1/AJS3で公開されているAPIを使用して，任意のユーザーアプリケーションからJP1/AJS3 - Managerのユニットを実行したり監視したりできます。ここでは，APIの利用の流れを説明します。

ユーザーアプリケーションは，HTTP通信のできる任意のプログラミング言語で作成します。ユーザーアプリケーションからリクエストを発行する際は， JP1ユーザーの認証情報を指定します。リクエストを発行すると，Web ConsoleサーバおよびJP1/AJS3 - Managerを経由して，JP1/Baseでユーザー認証が行われます。認証が成功すると，JP1/AJS3 - Managerで処理が実行され，ユーザーアプリケーションにレスポンスが返却されます。この認証は，リクエストを発行するたびに実施されます。処理の流れを次の図に示します。

図6‒1　API利用の流れ

APIを使ったユーザーアプリケーションでできることについては，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　9.3 ユーザーアプリケーションによるJP1/AJS3の操作」を参照してください。

補足事項

APIで使用する通信プロトコルは，HTTP/1.1です。通信プロトコルについては，次の規定を参照してください。

・HTTPプロトコルの場合

　RFC2616

・HTTPSプロトコルの場合

　RFC2818

JP1/AJS3では，ユーザーアプリケーションからのAPIの実行を制限することもできます。また，リクエストを発行できるJP1/AJS3 - Managerを制限することもできます。

APIの実行制限機能と，接続先JP1/AJS3 - Managerの制限機能は，Web Consoleサーバの環境設定ファイル（ajs3web.conf）の設定を変更することで有効にします。環境設定ファイル（ajs3web.conf）の詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　3.4.3 環境設定ファイル（ajs3web.conf）の設定項目の詳細」（Windowsの場合），またはマニュアル「JP1/Automatic Job Management System 3 構築ガイド　13.3.3 環境設定ファイル（ajs3web.conf）の設定項目の詳細」（Linuxの場合）を参照してください。

6.2　API利用時の認証

APIのリクエストを発行してレスポンスを得るには，リクエストのたびにJP1ユーザーによる認証が必要です。認証は，JP1/Baseのユーザー認証機能を使用します。

認証を受けるには，リクエストを発行するときに，リクエストヘッダーに「X-AJS-Authorization」を指定して，JP1ユーザー名とパスワードを送信します。リクエストを受けたマネージャーホストの認証サーバ（JP1/Base）で，指定されたJP1ユーザー名とパスワードの認証が行われます。JP1ユーザー名またはパスワードを指定しなかった場合，または誤っていた場合は，認証が必要なことを示すステータスコード「401」が返却されます。リクエストヘッダーおよびリクエストの形式については，「6.4 リクエストの形式」を参照してください。

リクエストヘッダーに記述する認証情報の形式を次に示します。

X-AJS-Authorization:userName:passwordをBase64エンコードで符号化した文字列

リクエストヘッダー「X-AJS-Authorization」に指定するパラメーターを次の表に示します。

表6‒1　「X-AJS-Authorization」に指定するパラメーター

パラメーター名

説明

必須・任意

userName

JP1ユーザー名を文字列で指定します。

JP1ユーザーは，あらかじめログイン先のJP1/AJS3 - Managerが使用する認証サーバに登録されている必要があります。

JP1ユーザー名に指定できる文字の詳細については，マニュアル「JP1/Base 運用ガイド」のユーザー管理の設定について記載している個所を参照してください。

必須

password

JP1ユーザーのパスワードを文字列で指定します。

パスワードに指定できる文字の詳細については，マニュアル「JP1/Base 運用ガイド」のユーザー管理の設定について記載している個所を参照してください。

必須

指定例

ユーザー名「user」パスワード「password」の場合は，user:passwordをBase64エンコードで符号化して，次の値を指定します。

X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

6.3　APIで利用できるデータ型

APIで利用できるデータ型を次の表に示します。

表6‒2　APIで利用できるデータ型

データ型

説明

boolean

trueまたはfalse

int

32bit符号付き整数

long

64bit符号付き整数

string※

テキストデータ

注※

JSON形式でダブルクォーテーションやバックスラッシュなどの文字を使用する場合は，次の表に示すようにエスケープする必要があります。

表6‒3　エスケープが必要な文字一覧

文字

エスケープ表記

「"（ダブルクォーテーションマーク）」

¥"

「¥（バックスラッシュ）」

¥¥

バックスペース

¥b

フォームフィード，改ページ

¥f

ラインフィード

¥n

キャリッジリターン

¥r

タブ

¥t

4桁の16進数で表記されたUnicode文字

¥uXXXX

日付と時間は，ISO8601形式で指定または返却される場合，次の形式で示されます。

形式

YYYY-MM-DDThh:mm:ssTZD

表6‒4　日付と時間の指定値

表記

説明

指定できる値

YYYY

年を指定します。

JP1/AJS3 - Web Consoleのバージョンが13-00以降，かつ接続先JP1/AJS3 - Managerのバージョンが13-00以降の場合：

1994〜接続先JP1/AJS3 - Managerの環境設定パラメーターSCHEDULELIMITに設定した西暦年※

上記以外：

1994〜2036

MM

月を指定します。

01〜12

DD

日にちを指定します。

01〜指定した月の最終日

hh

時間を指定します。

00〜23

mm

分を指定します。

00〜59

ss

秒を指定します。

00〜59

TZD

マネージャーホストの時刻と協定世界時（UTC）との時差を指定します。UTCの場合は「Z」を指定します。UTC以外の場合は「+hh:mm」または「-hh:mm」の形式で指定します。

Z，+hh:mm，-hh:mm

注※

接続先JP1/AJS3 - Managerの環境設定パラメーターSCHEDULELIMITの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2(123) SCHEDULELIMIT」を参照してください。

また，JP1/AJS3 - Web Consoleのバージョンはバージョン情報の取得APIの戻り値（productVersionNumber）を，接続先JP1/AJS3 - Managerのバージョンは，JP1/AJS3 - Managerのプロトコルバージョンの取得APIの戻り値（protocolVersionNumber）を確認してください。

バージョン情報の取得APIの詳細については，「7.1.38 バージョン情報の取得API」を参照してください。

JP1/AJS3 - Managerのプロトコルバージョンの取得APIの詳細については，「7.1.39 JP1/AJS3 - Managerのプロトコルバージョンの取得API」を参照してください。

例えば，協定世界時（UTC）が2015年1月16日午前0時0分0秒のとき，マネージャーホストが日本標準時で動作している場合，UTCとは+9時間の時差があるため，「2015-01-16T09:00:00+09:00」となります。マネージャーホストが中国標準時で動作している場合，UTCとは+8時間の時差があるため，「2015-01-16T08:00:00+08:00」となります。マネージャーホストがアメリカ東部標準時で動作している場合，UTCとは-5時間の時差があるため，「2015-01-15T19:00:00-05:00」となります。

また，夏時間を採用している国や地域の場合，夏時間を考慮して指定します。例えば，協定世界時（UTC）が2015年4月16日午前0時0分0秒のときに，マネージャーホストがアメリカ東部標準時（夏時間）で動作している場合，UTCとは-4時間の時差があるため，「2015-04-15T20:00:00-04:00」となります。

6.4　リクエストの形式

リクエストは，リクエスト行，リクエストヘッダー，およびメッセージボディで構成されます。リクエストは次の形式で指定します。

method△/application/component/apiVersion/domain/objectType/other?query△httpVersion
requestHeader

messageBody

（凡例）

△：半角スペース

表6‒5　リクエスト形式の表記と意味

区分

表記

指定内容

リクエスト行

method

メソッド

application

アプリケーション識別子

component

コンポーネント識別子

apiVersion

APIのバージョン

domain

ドメイン

objectType

リソース識別子

other

リソースおよびリソースの操作を一意に識別させるための値

query

クエリ文字列

httpVersion

プロトコルバージョン

リクエストヘッダー

requestHeader

リクエストヘッダー

メッセージボディ

messageBody

メッセージボディ

補足事項

リクエスト行，リクエストヘッダーはASCII文字で指定します。

URIで使用できない文字を指定する場合，URLエンコードが必要です。文字コードは，UTF-8を使用してください。

6.4.1　指定値の詳細

リクエストとして指定する値の詳細について次に説明します。

メソッド

リクエストのメソッドを指定します。APIがサポートするメソッドを次に示します。

GET

POST

アプリケーション識別子

APIを提供するアプリケーションの識別子を指定します。固定で「ajs」を指定してください。

コンポーネント識別子

コンポーネントの識別子を指定します。固定で「api」を指定してください。

APIのバージョン

APIごとに異なるため，各APIの説明を参照してください。

ドメイン

APIの操作対象となるドメインを指定します。APIで管理できるドメインおよびリソースを次の表に示します。

表6‒6　 APIで管理できるドメインおよびリソース

ドメイン

リソース識別子

リソース識別子の説明

objects

statuses

ステータス監視のリソース

definitions

ユニット定義のリソース

リソース識別子

APIの操作対象となるリソース識別子を指定します。APIで管理できるリソースは，表6-6を参照してください。

リソースおよびリソースの操作を一意に識別させるための値

必要に応じて，リソースを一意に識別する値およびアクションの種類を指定します。詳細については，各APIの説明を参照してください。

クエリ文字列

必要に応じて，クエリ文字列を指定します。クエリ文字列は，URIの末尾に続けて，「?」を付けて，次のように指定します。

パラメーター名=値

パラメーターが複数あるときは「&」で区切って，次のように指定します。

パラメーター名=値&パラメーター名=値

プロトコルバージョン

固定で「HTTP/1.1」を指定してください。

リクエストヘッダー

リクエストヘッダーは「リクエストヘッダー:指定値」の形式で指定します。リクエストヘッダーを複数指定する場合は，改行文字で区切ってください。指定できるリクエストヘッダーの一覧を次の表に示します。

表6‒7　リクエストヘッダー一覧

リクエストヘッダー

説明

必須・任意

Host

ホストの情報を次の形式で指定します。

host:port

hostにはWeb Consoleサーバのホスト名またはIPアドレスを指定します。

portにはポート番号を指定します。デフォルトのポート番号は，22252です。

必須

X-AJS-Authorization

認証情報を指定します。詳細については，「6.2 API利用時の認証」を参照してください。

必須

Content-Type

リクエストのメッセージボディのデータ形式を指定します。

固定で「application/json」を指定します。

任意

Accept-Language

レスポンスでJP1/AJS3 - Web Consoleが発行するメッセージ文の言語コードを指定します。

「Accept-Language」を指定しなかった場合は，システムのデフォルトの言語コードとなります。

指定できる言語コードを次に示します。

ja：日本語

en：英語

zh：中国語

なお，「Accept-Language」で制御できるのは，JP1/AJS3 - Web Consoleが発行するKNAKで始まるメッセージのメッセージ文だけです。メッセージ内に含まれるユニット名，コメント，実行結果詳細，引き継ぎ結果などの言語コードは，制御できません。

任意

メッセージボディ

入力情報をJSON形式で指定します。文字コードはUTF-8を使用してください。

6.4.2　リクエストの指定例

ユニット一覧の取得APIを使用して，次のような内容を指定するときのリクエストの例を示します。

表6‒8　リクエスト内容

項目

内容

API

ユニット一覧の取得API

ユニットの指定条件

マネージャーホスト名：ManagerHostA

スケジューラーサービス名：AJSROOT1

上位ユニットの完全名：/jobgroupA

Web Consoleサーバのホスト名

HostA

ポート番号

22252

JP1ユーザー名

user

パスワード

password

指定例

GET /ajs/api/v1/objects/statuses?mode=search&manager=ManagerHostA&serviceName=AJSROOT1&location=/jobgroupA HTTP/1.1
Host: HostA:22252
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

6.5　レスポンスの形式

レスポンスを正常に取得できた場合と，エラーが発生した場合のレスポンスの形式を説明します。

レスポンスは，ステータス行，レスポンスヘッダー，メッセージボディで構成されます。レスポンスは次の形式で返却されます。

httpVersion△statusCode△reasonPhrase
responseHeader

messageBody

（凡例）

△：半角スペース

表6‒9　レスポンス形式の表記と意味

区分

表記

内容

ステータス行

httpVersion

プロトコルバージョン

statusCode

ステータスコード

reasonPhrase

ステータスコードのテキスト記述

レスポンスヘッダー

responseHeader

レスポンスヘッダー

メッセージボディ

messageBody

メッセージボディ

6.5.1　レスポンスを正常に取得できた場合のレスポンス形式

レスポンスを正常に取得できた場合のレスポンス形式について説明します。

(1)　レスポンスの詳細

レスポンスとして返却される値について次に説明します。

プロトコルバージョン

固定で「HTTP/1.1」が返却されます。

ステータスコード

処理の結果を示すステータスコードが返却されます。詳細については，各APIの説明を参照してください。

ステータスコードのテキスト記述

処理の結果を示すステータスコードのテキスト記述が返却されます。なお，ステータスコードのテキスト記述は省略される場合があります。

レスポンスヘッダー

レスポンスヘッダーの一覧を次の表に示します。

表6‒10　レスポンスヘッダー一覧

レスポンスヘッダー

説明

Cache-Control

レスポンス情報のキャッシュを制御します。

Pragma

Expires

Content-Type

レスポンスデータのデータ形式です。

固定で「application/json」を返却します。

メッセージボディ

JSON形式で出力情報が返却されます。文字コードはUTF-8です。

(2)　レスポンス（メッセージボディ）の例

ユニット一覧の取得APIを発行し，正常にレスポンスを取得したときのレスポンス（メッセージボディ）の例を次に示します。

{
  "statuses": [
    {
      "definition": {
        "unitName": "/jobgroupA/jobnetA",
        "simpleUnitName": "jobnetA",
        "unitComment": "test",
        ...
      },
      "unitStatus": {
        "unitName": "/jobgroupA/jobnetA",
        "simpleUnitName": "jobnetA",
        "execID": "@A101",
        ...
      },
      "release": {
        "releaseID": "AJS_AUTO",
        ...
      }
    }
  ],
  "all": true
}

6.5.2　APIでエラーが発生した場合のレスポンス形式

APIでエラーが発生した場合のレスポンスの各要素の説明を次に示します。

(1)　レスポンスの詳細

レスポンスとして返却される値について次に説明します。

プロトコルバージョン

固定で「HTTP/1.1」が返却されます。

ステータスコード

処理の結果を示すステータスコードが返却されます。詳細については，各APIの説明を参照してください。

ステータスコードのテキスト記述

処理の結果を示すステータスコードのテキスト記述が返却されます。なお，ステータスコードのテキスト記述は省略される場合があります。

レスポンスヘッダー

レスポンスヘッダーの一覧を次の表に示します。

表6‒11　レスポンスヘッダー一覧

レスポンスヘッダー

説明

Cache-Control

レスポンス情報のキャッシュを制御します。

Pragma

Expires

Content-Type

レスポンスデータのデータ形式です。

固定で「application/json」を返却します。

メッセージボディ

JSON形式でエラー情報が返却されます。文字コードはUTF-8です。次にエラー情報の詳細を示します。

エラー情報の形式

{
  "errorSource":"エラーが発生したURI"
  "message":"メッセージ文",
  "messageID":"メッセージID",
  "application":"アプリケーション情報",
  "extensions": [
    エラー情報の付加情報,...
  ]
}

エラー情報のメンバー

メンバー名

データ型

説明

errorSource

string

エラーが発生したURIが返却されます。

message

string

メッセージ文が返却されます。

messageID

string

メッセージIDが返却されます。

application

string

アプリケーション情報が返却されます。固定で「ajs」が返却されます。

extensions

object

エラー情報の付加情報が配列で返却されます。

エラー情報の付加情報の形式

{
  "key":"付加情報のキー名",
  "value":付加情報のキーに対する値,
}

エラー情報の付加情報のメンバー

メンバー名

データ型

説明

key

string

付加情報のキー名が返却されます。

value

string

付加情報のキーに対応する値が返却されます。

(2)　レスポンス（メッセージボディ）の例

指定必須のクエリ文字列が指定されていなかったときのレスポンス（メッセージボディ）の例を示します。

{
  "errorSource": "/ajs/api/v1/objects/statuses",
  "message": "スケジューラーサービス名を指定してください",
  "messageID": "KNAK3201-E",
  "application": "ajs",
  "extensions": [
    {
      "key": "error_type",
      "value": "PARAMETER"
    },
    {
      "key": "error_code",
      "value": "ERROR_PARAM_EMPTY"
    },
    {
      "key": "error_parameter",
      "value": "serviceName"
    }
  ]
}

6.5.3　API以外の要因でエラーが発生した場合のレスポンス形式

リクエストの形式不正やWeb Consoleサーバの未起動など，API以外の要因でエラーが発生した場合の，レスポンスの各要素の説明を次に示します。

(1)　レスポンスの詳細

レスポンスとして返却される値について次に説明します。

プロトコルバージョン

固定で「HTTP/1.1」が返却されます。

ステータスコード

処理の結果を示すステータスコードが返却されます。詳細については，各APIの説明を参照してください。

ステータスコードのテキスト記述

処理の結果を示すステータスコードのテキスト記述が返却されます。なお，ステータスコードのテキスト記述は省略される場合があります。

メッセージボディ

HTML形式やプレーンテキスト形式で出力情報が返却されます。

6.6　API構成要素

API構成要素には，API，リソース，オブジェクト，および定数があります。ここでは，各構成要素の一覧を示します。

6.6.1　API構成要素の一覧

API，リソース，オブジェクト，および定数の一覧を示します。

(1)　API一覧

使用できるAPIの一覧を次の表に示します。

表6‒12　API一覧

項番

分類

API

説明

API種別

参照先

1

ユニット情報の取得

ユニット一覧の取得

指定したユニット，またはユニット配下のジョブグループ，ジョブネット，およびジョブの情報を取得します。

SC-004

7.1.1

2

ユニット情報の取得

指定したユニットの情報を取得します。

SC-007

7.1.2

3

実行結果詳細の取得

実行が終了したジョブの，実行結果詳細を取得します。

SC-010

7.1.3

4

待ち合わせ条件の状態一覧の取得

指定したユニットの待ち合わせ条件と，待ち合わせ条件に設定されている待ち合わせ対象ユニットの状態の一覧を取得します。

SC-046

7.1.4

5

ジョブネットの実行登録および実行登録解除

計画実行登録

指定したジョブネットを計画実行登録します。

SC-017

7.1.5

6

確定実行登録

指定したジョブネットを確定実行登録します。

SC-018

7.1.6

7

即時実行登録

指定したジョブネットを即時実行登録します。

SC-019

7.1.7

8

登録解除

指定した実行登録中のジョブネットの実行登録を解除します。

SC-020

7.1.8

9

ユニットの操作

保留属性変更

指定したジョブネットやジョブの保留属性を変更します。

SC-012

7.1.9

10

遅延監視変更

指定した実行登録済みのジョブネットの遅延監視の設定を，一時的に変更します。

SC-024

7.1.10

11

ジョブ状態変更

指定したジョブの状態を変更します。

SC-025

7.1.11

12

計画一時変更（日時変更）

指定した実行登録済みのジョブネットの実行開始予定日時を，一時的に変更します。

SC-026

7.1.12

13

計画一時変更（即時実行）

指定した実行登録済みのジョブネットの実行スケジュールを一時的に変更し，即時実行します。

SC-027

7.1.13

14

計画一時変更（実行中止）

指定した実行登録済みのジョブネットの実行スケジュールを一時的に変更し，実行を中止します。

SC-028

7.1.14

15

計画一時変更（変更解除）

ユニットの実行スケジュールの一時的な変更を解除し，変更前の情報に戻します。

SC-029

7.1.15

16

中断

指定した実行中のルートジョブネットを中断します。

SC-030

7.1.16

17

強制終了

指定した実行中のジョブおよびルートジョブネットを強制終了します。

SC-031

7.1.17

18

再実行

指定したジョブネットやジョブを再実行します。

SC-032

7.1.18

19

待ち合わせ状態の変更

指定したユニットの待ち合わせ状態を一時的に変更します。

SC-047

7.1.19

20

実行順序制御方式の変更

指定したルートジョブネットの実行順序制御方式を一時的に変更します。

SC-045

7.1.20

21

実行エージェントの操作

実行エージェントの状況一覧の取得

接続先のJP1/AJS3 - Managerに登録されている実行エージェントの状況一覧を取得します。

AG-001

7.1.21

22

実行エージェントの状況の取得

接続先のJP1/AJS3 - Managerに登録されている実行エージェントの状況を取得します。

AG-002

7.1.22

23

実行エージェントの定義の取得

接続先のJP1/AJS3 - Managerに登録されている実行エージェントの定義を取得します。

AG-003

7.1.23

24

実行エージェントの追加

接続先のJP1/AJS3 - Managerに実行エージェントを追加します。

AG-004

7.1.24

25

実行エージェントの削除

接続先のJP1/AJS3 - Managerから，指定した実行エージェントを削除します。

AG-005

7.1.25

26

実行エージェントの設定変更

接続先のJP1/AJS3 - Managerに登録されている実行エージェントの設定を変更します。

AG-006

7.1.26

27

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

接続先のJP1/AJS3 - Managerに登録されている実行エージェントの受付配信制限の状態を変更します。

AG-007

7.1.27

28

実行エージェントの状態の変更

接続先のJP1/AJS3 - Managerに登録されている実行エージェントの状態を変更します。

AG-008

7.1.28

29

ジョブ配信遅延の軽減機能の通信状態確認

接続先のJP1/AJS3 - Managerホストで，ジョブ配信遅延の軽減機能の通信状態の確認操作をします。

AG-016

7.1.29

30

実行エージェントの実行状況一覧の取得

接続先のJP1/AJS3 - Managerに登録されている実行エージェント上のジョブの実行状況を取得します。

AG-017

7.1.30

31

実行エージェントグループの状況一覧の取得

接続先のJP1/AJS3 - Managerに登録されている実行エージェントグループの状況一覧を取得します。

AG-009

7.1.31

32

実行エージェントグループの定義の取得

接続先のJP1/AJS3 - Managerに登録されている実行エージェントグループの定義を取得します。

AG-010

7.1.32

33

実行エージェントグループの追加

接続先のJP1/AJS3 - Managerに実行エージェントグループを追加します。

AG-011

7.1.33

34

実行エージェントグループの削除

接続先のJP1/AJS3 - Managerから，指定した実行エージェントグループを削除します。

AG-012

7.1.34

35

実行エージェントグループの設定変更

接続先のJP1/AJS3 - Managerに設定されている実行エージェントグループの設定を変更します。

AG-013

7.1.35

36

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

接続先のJP1/AJS3 - Managerに登録されている実行エージェントグループの受付配信制限の状態を変更します。

AG-014

7.1.36

37

実行エージェントの除外，追加，優先順位の変更

接続先のJP1/AJS3 - Managerに登録されている実行エージェントグループに対して，実行エージェントの除外，追加，または優先順位の変更をします。

AG-015

7.1.37

38

その他

バージョン情報の取得

製品のバージョン情報を取得します。

OT-003

7.1.38

39

JP1/AJS3 - Managerのプロトコルバージョンの取得

接続先JP1/AJS3 - Managerのプロトコルバージョンを取得します。

OT-005

7.1.39

(2)　リソース一覧

使用できるリソースの一覧を次の表に示します。

表6‒13　リソース一覧

項番

リソース

説明

参照先

1

ステータス監視のリソース

ステータス監視をするためのユニットや世代の情報を表します。ステータス監視のリソースは，次のオブジェクトを含みます。

ユニット定義情報

ステータス情報

リリース情報

7.2.1

2

ユニット定義のリソース

ユニット定義のリソースを表します。このリソースはジョブネットを実行登録するAPIなどで指定します。

なし

(3)　オブジェクト一覧

使用できるオブジェクトの一覧を次の表に示します。

表6‒14　オブジェクト一覧

項番

オブジェクト

説明

参照先

1

ユニット定義情報

ユニット名やユニット種別などのユニット定義情報を表します。

7.3.1

2

ステータス情報

開始日時や状態などの，ユニットのステータス情報を表します。

7.3.2

3

リリース情報

リリース日時やリリースIDなどの，ユニットのリリース情報を表します。

7.3.3

4

起動条件パラメーター

起動条件の回数や時間などの設定値を表します。

7.3.4

5

マクロ変数

マクロ変数名と引き継ぎ情報を表します。

7.3.5

6

実行エージェントの操作結果

実行エージェント，または実行エージェントグループを操作した結果を表します。

7.3.6

7

実行エージェント定義情報

実行エージェント，または実行エージェントグループの定義情報を表します。

7.3.7

8

実行エージェントの状況

実行エージェント，または実行エージェントグループの状況を表します。

7.3.8

(4)　定数一覧

使用できる定数の一覧を次の表に示します。

表6‒15　定数一覧

項番

分類

定数

説明

参照先

1

各種API共通で使用する定数

DateType

開始終了日時の指定種別を表します。

7.4.1

2

Status

ユニットの状態を表します。

3

DelayStart

開始遅延の有無を表します。

4

DelayEnd

終了遅延の有無を表します。

5

ユニット一覧の取得APIで使用する定数

LowerType

指定したユニット配下のユニットの取得方法を表します。

7.4.2

6

SearchTargetType

取得対象のユニットの範囲を表します。

7

MatchMethods

文字列の比較方法を表します。

8

UnitType

ユニット種別を表します。

9

GenerationType

世代の取得方法を表します。

10

UnitStatus

ユニット状態を表します。

11

DelayType

開始遅延または終了遅延の指定有無を表します。

12

HoldPlan

保留予定の有無を表します。

13

ReleaseInfoSearchMethods

リリース情報の取得方法を表します。

14

実行登録APIで使用する定数

PlannedTimePassedType

スケジューラーサービス起動時および実行登録時に予定時刻を超過していたユニットの実行のタイミングを表します。

7.4.3

15

ユニット定義情報のオブジェクトで使用する定数

Type

ユニットの種別を表します。

7.4.4

16

RegisterStatus

ユニットの登録状態を表します。

17

ステータス情報のオブジェクトで使用する定数

ChangeType

計画一時変更の有無を表します。

7.4.5

18

HoldAttr

保留属性を表します。

19

TimeType

起動条件の有効範囲の時間種別を表します。

20

Waiting

成立していない待ち合わせ条件の有無を示します。

21

DelayMonitor

ジョブネットの遅延監視方法を示します。

22

MonitoringJobnet

ジョブネットの実行所要時間による終了遅延の監視の方法を示します。

23

ExecOrderMethod

ジョブネットの実行順序制御方式を示します。

24

リリース情報のオジェクトで使用する定数

ReleaseStatus

リリース状態を表します。

7.4.6

25

起動条件パラメーターのオブジェクトで使用する定数

TimeType

起動条件の有効範囲の時間の種別を表します。

7.4.7

26

保留属性変更で使用する定数

ChangeHoldAttr

保留属性の変更を表します。

7.4.8(1)

27

計画一時変更で使用する定数

ChangeStartTimeType

計画一時変更するときの，実行開始日時の種類を表します。

7.4.9(1)

28

ChangePushedAheadType

計画一時変更するときの，前倒しの動作を表します。

7.4.9(2)

29

ChangeLowerType

計画一時変更するとき，配下のジョブネットの開始日時をずらすかどうかを表します。

7.4.9(3)

30

再実行で使用する定数

RootRerunType

ルートジョブネットを再実行する方法を表します。

7.4.10(1)

31

RerunType

ネストジョブネットまたはジョブを再実行する方法を表します。

7.4.10(2)

32

RerunOption

再実行のオプションを表します。

7.4.10(3)

33

遅延監視変更で使用する定数

DelayMonitorType

ジョブネットの遅延監視方法を表します。

7.4.11(1)

34

MonitoringJobnetType

ジョブネットの実行所要時間による終了遅延の監視方法を表します。

7.4.11(2)

35

ジョブ状態変更で使用する定数

ChangeStatus

ジョブの変更後の状態を表します。

7.4.12(1)

36

待ち合わせで使用する定数

WaitMethod

待ち合わせが成立する条件を示します。

7.4.13

37

WaitingAction

待ち合わせ条件付きユニットの動作を示します。

38

WaitingStatus

待ち合わせ条件付きユニットと待ち合わせ対象ユニットの待ち合わせの状態を示します。

39

WaitingStatusAction

待ち合わせを有効化するか無効化するかを示します。

40

実行エージェントのオブジェクトで使用する定数

ExecAgentStatus

実行エージェント，または実行エージェントグループの受付配信制限の状態を表します。

7.4.14

41

ComStatus

実行エージェントの状態を表します。

42

ExecAgentJobClass

実行エージェントで管理されているジョブの分類を示します。

43

実行順序制御方式の変更APIで使用する定数

ChangeExecOrderMethod

変更後の実行順序制御方式を示します。

7.4.15

44

ユニット情報の取得APIで使用する定数

ConnectInfoType

ステータス監視リソースの「ステータス情報オブジェクト（unitStatus）」を取得するときに，接続情報を取得するか，接続情報を取得しないかを表します。

7.4.16

6.7　API利用時の注意事項

API利用時の注意事項について説明します。

6.7.1　JP1/AJS3 - Managerへの負荷

APIの操作対象とするユニットの個数やシステム構成によって，JP1/AJS3 - Managerへの負荷が増える場合があります。JP1/AJS3 - Managerへの負荷が増える操作，およびその対策について説明します。

多数のユーザーによる多重実行をする場合

複数のユーザーが同じJP1/AJS3 - Managerのスケジューラーサービスに対してAPIを発行すると，JP1/AJS3 - Managerで処理が多重実行されます。多重実行するAPIの数が多い場合，処理に時間が掛かったり，JP1/AJS3 - Managerに負荷が掛かったりすることがあります。この場合，操作できるユーザーの数（最大同時セション数）を制限してください。最大同時セション数については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2(21) CDMAXSESSION」を参照してください。

APIの発行頻度が高い場合

APIの発行頻度が高い場合，APIの処理頻度も高くなるためJP1/AJS3 - Managerに継続的な負荷が掛かります。そのため，ユーザーアプリケーションでAPIを繰り返して発行する場合は，APIの発行が頻発しないように設計してください。

ユニットの総数および世代数が多い場合

APIの発行対象にするユニットの配下に多数のユニットがある場合，または世代数が多い場合，APIの処理でJP1/AJS3 - Managerに負荷が掛かることがあります。JP1/AJS3 - Managerに負荷が掛かるAPIと操作の条件を次に示します。それぞれ，JP1/AJS3 - Managerへの負荷を考慮して，対象とするユニット数や世代数を検討してください。

確定実行登録API

ルートジョブネットの配下にあるユニットの総数や実行登録する世代数が多い場合，負荷が高くなるおそれがあります。

実行登録の解除API

実行登録されている世代数や対象ジョブネットの総ユニット数が多い場合，負荷が高くなるおそれがあります。

ユニット一覧の取得API

取得対象のユニット数が多い場合，負荷が高くなるおそれがあります。

補足事項

Web ConsoleサーバとJP1/AJS3 - Manager間の接続やレスポンスの受信に一定の時間が掛かった場合，接続をタイムアウトする設定ができます。タイムアウト時間はWeb Consoleサーバの通信設定ファイルで設定する方法と，JP1/AJS3 - Managerの環境設定パラメーターCDSESSIONTIMEOUTで設定する方法があります。デフォルトでは次の値が設定されています。

Web Consoleサーバの通信設定ファイル

接続タイムアウト時間：しない

受信タイムアウト時間：180秒

JP1/AJS3 - Managerの環境設定パラメーターCDSESSIONTIMEOUT

接続タイムアウト時間：180秒

通信設定ファイルについては，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　3.4.4 通信設定ファイル（ajscd_ajs3web.properties）の設定項目の詳細」を参照してください。

環境設定パラメーターCDSESSIONTIMEOUTについては，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2(104) CDSESSIONTIMEOUT」を参照してください。

6.7.2　SSL通信の設定方法

ユーザーアプリケーションからAPIを呼び出す際にSSL通信を使用する場合，SSL通信の設定方法は使用するプログラミング言語に依存します。各プログラミング言語で提供される手順で設定してください。また，SSL通信を使用する場合はWeb Consoleサーバでも設定が必要です。詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.3.6 SSLによるJP1/AJS3の通信の暗号化」を参照してください。

6.7.3　操作対象のユニットに対するJP1ユーザーの権限

実行登録などの操作を実施するには，対象のユニットに対してJP1ユーザーの実行権限が必要です。また，ユニット情報を取得するには，JP1ユーザーの参照権限が必要です。実行権限のないユニットに対して実行登録などの操作をした場合は，操作を実行できません。また，ユニットの情報を取得する場合は，参照権限のあるユニットの情報だけが取得できます。各APIの実行に必要な実行権限は，各APIの説明を参照してください。

補足事項

使用するJP1ユーザーは，あらかじめユーザーマッピングを設定しておく必要があります。

JP1資源グループを設定していないユニットは，すべてのJP1ユーザーが操作および参照できます。

6.7.4　API引数に使用できる文字

ユニット名やスケジューラーサービス名など，APIの引数の名称に使用できる文字の種類は，JP1/AJS3 - Managerと同じです。また，リクエストおよびレスポンスに使用できる文字コードは，UTF-8です。リクエストには，BOMのないデータを利用してください。

ユニットの名称に使用できる文字については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　付録B.3 ユニットの制限値」を参照してください。また，使用できる文字の範囲については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.4.2 システムで使用する言語種別と文字コードについて検討する」を参照してください。

6.7.5　API引数のバイト数

APIの引数に使用できるバイト数は，接続先のJP1/AJS3 - Managerに依存します。

JP1/AJS3 - ManagerがUNIX環境で，文字コードがUTF-8の場合，シフトJISの場合よりも指定できる文字数が少なくなります。ただし，UTF-8環境でユニット名などに指定できる文字数を変更するための設定（環境設定パラメーターDEFLENTYPE）を「sjis」に指定しているときは，シフトJISと同じ文字数が使用できます。UNIXのUTF-8環境でユニット名などに指定できる文字数を変更するための設定については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　15.1.10 UTF-8環境でユニット名などに指定できる文字数を変更するための設定」を参照してください。

6.7.6　操作対象のユニットの実行IDの管理

実行登録したジョブネットを操作するAPIやユニット情報を参照するAPIには，引数として実行IDを指定します。そのため，ユーザーアプリケーションではAPIで取得した実行IDを適切に管理してください。

実行IDを取得できるAPIを次に示します。

ユニット一覧の取得

確定実行登録（日時を指定して実行予定を追加する場合）

即時実行登録

6.7.7　リクエスト形式が不正な場合のステータスコード

リクエスト形式が不正な場合，ステータスコード500を返却されることがあります。代表的な例を次に示します。

リクエスト行，リクエストヘッダーにマルチバイト文字を指定したとき

URLエンコードに誤りがあるとき

リクエストヘッダーの値に誤りがあるとき

指定必須のメッセージボディがあるが，メッセージボディのサイズが0バイトのとき

メッセージボディにBOMが含まれるとき

6.7.8　メッセージ文の保守情報やスタックトレース情報の言語種別

メッセージ文の保守情報やスタックトレース情報は，OSの言語種別に従って出力される場合があります。そのため，リクエストヘッダー「Accept-Language」に指定した言語種別や，環境設定ファイルのメッセージの言語種別の設定と異なる言語がメッセージに含まれる場合があります。

6.7.9　レスポンスのメッセージボディ

レスポンスに含まれるメッセージボディの情報は，JP1/AJS3 - Web Consoleのバージョンアップなどによって，項目数が増えることがあります。項目数が増える情報を次に示します。

メッセージボディのメンバー

リソースのメンバー

オブジェクトのメンバー

定数に規定されている値

そのため，ユーザーアプリケーションなどでAPIを使用する場合，メッセージボディの項目数が増えることを前提にプログラムを作成する必要があります。例えば，JSONデータをオブジェクトに変換する場合で，存在しないメンバーがあるとエラーが発生するように実装されているとき，JSONデータの項目数が増えると，ユーザーアプリケーションが正常に動作しなくなるおそれがあります。

6.7.10　リクエスト発行先のJP1/AJS3 - Managerに対する接続許可

Web Consoleサーバで接続先JP1/AJS3 - Managerの制限機能を使用している場合，リクエストを発行したいJP1/AJS3 - Managerへの接続を許可しておく必要があります。ユーザーアプリケーションから，接続が許可されていないJP1/AJS3 - Managerにリクエストを発行すると，JP1/AJS3 - Managerにログインできないため，エラーになります。

接続先JP1/AJS3 - Managerの制限機能は，Web Consoleサーバの環境設定ファイル（ajs3web.conf）で設定します。環境設定ファイル（ajs3web.conf）の詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　3.4.3 環境設定ファイル（ajs3web.conf）の設定項目の詳細」（Windowsの場合），またはマニュアル「JP1/Automatic Job Management System 3 構築ガイド　13.3.3 環境設定ファイル（ajs3web.conf）の設定項目の詳細」（Linuxの場合）を参照してください。

6.7.11　12-60以前のバージョンからのバージョンアップ時の注意事項

APIのレスポンスでステータスコードが返却されます。バージョン12-60以前で出力していたステータスコードのテキスト記述は，バージョン13-00以降省略される場合があります。

バージョン12-60以前のJP1/AJS3 - Web Consoleを使用しステータスコードのテキスト記述を含めた判定処理をしていたユーザーアプリケーションは，バージョン13-00以降にバージョンアップした場合に判定処理を見直す必要があります。

7　API構成要素の詳細

この章では，API，リソース，オブジェクト，および定数について説明します。

7.1　APIの詳細

JP1/AJS3で公開されている各APIの形式や詳細について説明します。

7.1.1　ユニット一覧の取得API

指定したユニットまたはユニット配下の，ジョブグループ，ジョブネット，およびジョブの情報を取得します。情報を取得するユニットは，条件を記述することで指定します。条件を複数記述した場合，すべての条件を満たすユニットの一覧が取得されます。

条件を満たすユニットが一つも存在しない場合，0件のユニット一覧を返却します。ログインしたJP1ユーザーに参照権限がないユニットの情報は取得結果に含まれません。取得できるユニットは最大1,000件です。取得件数が1,000件を超える場合は，条件を変更し，取得件数を絞り込んでください。

実行権限

ログインしたJP1ユーザーが，情報を取得するユニットに対して，次に示すどれかのJP1権限が与えられている必要があります。

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Editor権限

JP1_AJS_Operator権限

JP1_AJS_Guest権限

リクエストの形式

リクエスト行

GET /application/component/apiVersion/objects/statuses?query httpVersion

APIのバージョン

v1

リソースを一意に識別する情報

なし

パラメーター

「query」に指定するパラメーターを次の表に示します。

表7‒1　ユニット一覧の取得APIのパラメーター一覧

パラメーター

値の説明

必須・任意

mode

固定で「search」を指定します。

必須

manager

マネージャーホスト名またはIPアドレスを，1〜255バイトの文字列で指定します。

必須

serviceName

スケジューラーサービス名を，1〜30バイトの文字列で指定します。

必須

location

取得したいユニットの上位ユニット（ジョブグループまたはジョブネット）のユニット完全名を，1〜930バイトの文字列で指定します。

必須

searchLowerUnits

パラメーターlocationで指定したユニットの，直下1階層のユニット情報を取得対象とするか，配下のユニットすべての情報を取得対象とするかを，定数LowerTypeに規定されている文字列定数で指定します。定数LowerTypeの詳細については，「7.4.2(1) LowerType」を参照してください。

このパラメーターを指定しなかった場合，「NO（直下1階層のユニット）」が仮定されます。

任意

searchTarget

ユニットの定義だけを取得対象とするか，ユニットの定義および状態を取得対象とするかを，定数SearchTargetTypeに規定されている文字列定数で指定します。定数SearchTargetTypeの詳細については，「7.4.2(2) SearchTargetType」を参照してください。

「DEFINITION（定義）」を指定した場合は，次のパラメーターの指定は無視されます。

execID

generation

periodBegin

periodEnd

status

delayStatus

holdPlan

execHost

execHostMatchMethods

このパラメーターを指定しなかった場合，「DEFINITION_AND_STATUS（定義と状態）」が仮定されます。

任意

unitName

取得したいユニットの名称を指定します。

パラメーターunitNameMatchMethodsでユニット名の比較方法を指定した場合だけ，このパラメーターを指定できます。また，ユニット名の比較方法に「NO（検索条件にしない）」を指定した場合は，このパラメーターの指定は無視されます。

指定できるユニット名のバイト数は，パラメーターunitNameMatchMethodsの指定値によって異なります。

パラメーターunitNameMatchMethodsの指定値と，このパラメーターに指定できるバイト数を次に示します。

EQ，BW，EW，NE，CO，NC：1〜30バイト

RE：1〜64バイト

任意

unitNameMatchMethods

ユニット名の比較方法を定数MatchMethodsに規定されている文字列定数で指定します。定数MatchMethodsの詳細については，「7.4.2(3) MatchMethods」を参照してください。「NO（検索条件にしない）」を指定した場合は，すべてのユニット名が取得対象となります。

このパラメーターを指定しなかった場合，「NO」が仮定されます。

任意

execID

取得したいユニットの実行IDを「@[mmmm]{A〜Z}nnnn」の形式で指定します（例：@10A200）。

パラメーターgenerationで「EXECID（指定した実行IDの世代を取得）」を指定した場合だけ，このパラメーターを指定できます。その他の値を指定した場合，このパラメーターの指定は無視されます。

任意

unitType

取得したいユニットの種別を定数UnitTypeに規定されている文字列定数で指定します。定数UnitTypeの詳細については，「7.4.2(4) UnitType」を参照してください。

「NO（検索条件にしない）」を指定した場合，すべてのユニットの種別が取得対象となります。

「GROUP（ジョブグループなど）」を指定した場合，次のパラメーターの指定は無視されます。

execID

generation

periodBegin

periodEnd

status

delayStatus

holdPlan

execHost

execHostMatchMethods

releaseID

releaseInfoSearchMethods

「ROOT（ルートジョブネットなど）」および「NET（ジョブネットなど）」を指定した場合，次のパラメーターの指定は無視されます。

execHost

execHostMatchMethods

このパラメーターを指定しなかった場合，「NO」が仮定されます。

任意

generation

取得したいユニットの世代を定数GenerationTypeに規定されている文字列定数で指定します。定数GenerationTypeの詳細については，「7.4.2(5) GenerationType」を参照してください。

このパラメーターを指定しなかった場合，「STATUS（最新状態）」が仮定されます。

任意

periodBegin

取得したいユニットの世代の開始日時を，「YYYY-MM-DDThh:mm」の形式で指定します。指定した日時以降に存在する世代が取得対象となります。

指定できる値を次に示します。

YYYY：年を指定します。

年に指定できる値は，次のとおりです。

JP1/AJS3 - Web Consoleのバージョンが13-00以降，かつ接続先JP1/AJS3 - Managerのバージョンが13-00以降の場合：

1994〜環境設定パラメーターSCHEDULELIMITに設定した値（単位：年）※

上記以外の場合：

1994〜2036（単位：年）

MM：月を指定します。

月に指定できる値は，01〜12（単位：月）です。

DD：日にちを指定します。

日にちに指定できる値は，01〜指定した月の最終日（単位：日）です。

hh：時間を指定します。

時間に指定できる値は，00〜23（単位：時）です。

mm：分を指定します。

分に指定できる値は，00〜59（単位：分）です。

指定する日時は，要求先JP1/AJS3 - Managerのスケジューラーサービスローカル日時で指定してください。

パラメーターgenerationで「PERIOD（期間指定）」を指定した場合だけ，このパラメーターを指定できます。その他の値を指定した場合，このパラメーターの指定は無視されます。期間の終了日時はパラメーターperiodEndで指定します。

パラメーターperiodEndで指定した終了日時以前の日時を指定してください。

任意

periodEnd

取得したいユニットの世代の終了日時を，「YYYY-MM-DDThh:mm」の形式で指定します。指定した日時以前に存在する世代が取得対象になります。

指定できる値を次に示します。

YYYY：年を指定します。

年に指定できる値は，次のとおりです。

JP1/AJS3 - Web Consoleのバージョンが13-00以降，かつ接続先JP1/AJS3 - Managerのバージョンが13-00以降の場合：

1994〜環境設定パラメーターSCHEDULELIMITに設定した値（単位：年）※

上記以外の場合：

1994〜2036（単位：年）

MM：月を指定します。

月に指定できる値は，01〜12（単位：月）です。

DD：日にちを指定します。

日にちに指定できる値は，01〜指定した月の最終日（単位：日）です。

hh：時間を指定します。

時間に指定できる値は，00〜23（単位：時）です。

mm：分を指定します。

分に指定できる値は，00〜59（単位：分）です。

指定する日時は，要求先JP1/AJS3 - Managerのスケジューラーサービスローカル日時で指定してください。

パラメーターgenerationで「PERIOD（期間指定）」を指定した場合だけ，このパラメーターを指定します。その他の値を指定した場合，このパラメーターの指定は無視されます。

期間の開始日時はパラメーターperiodBeginで指定します。

パラメーターperiodBeginで指定した開始日時以降の日時を指定してください。

任意

status

取得したいユニットの状態を定数UnitStatusに規定されている文字列定数で指定します。定数UnitStatusの詳細については，「7.4.2(6) UnitStatus」を参照してください。

「NO（検索条件にしない）」を指定した場合，すべてのユニットの状態が取得対象となります。

「UNREGISTERED（未登録）」を指定した場合，次のパラメーターの指定は無視されます。

execID

generation

periodBegin

periodEnd

delayStatus

holdPlan

execHost

execHostMatchMethods

「UNREGISTERED（未登録）」を指定した場合で，ジョブネットリリース機能を使用しているときは，同一ユニット名のユニット情報が複数取得されることがあります。この場合，パラメーターreleaseInfoSearchMethodsとパラメーターreleaseIDを指定して，取得対象を特定してください。

このパラメーターを指定しなかった場合は，「NO」が仮定されます。

任意

delayStatus

取得したいユニットの遅延状態を定数DelayTypeに規定されている文字列定数で指定します。定数DelayTypeの詳細については，「7.4.2(7) DelayType」を参照してください。

このパラメーターを指定しなかった場合，「NO（遅延を検索条件にしない）」が仮定されます。

任意

holdPlan

取得したいユニットの保留予定の有無を定数HoldPlanに規定されている文字列定数で指定します。定数HoldPlanの詳細については，「7.4.2(8) HoldPlan」を参照してください。

「PLAN_YES（保留予定あり）」を指定した場合は，実行待ち，保留中，および実行が終了した世代が対象になります。実行が終了した世代も対象になるため，再実行時に保留される世代の情報も取得されます。実行待ちの世代だけ，実行が終了した世代だけ，または特定の世代だけを取得対象にしたい場合は，パラメーターgenerationやパラメーターstatusを同時に指定して，取得対象の世代を特定してください。

このパラメーターを指定しなかった場合，「NO（保留予定を検索条件にしない）」が仮定されます。

任意

unitComment

取得したいユニットのコメントを指定します。

パラメーターunitCommentMatchMethodsでコメントの比較方法を指定した場合だけ，このパラメーターを指定できます。コメントの比較方法に「NO（検索条件にしない）」を指定した場合は，このパラメーターの指定は無視されます。コメントの比較方法に「EQ（完全一致）」を指定して，このパラメーターに空文字列（0バイト）を指定した場合は，コメントの定義されていないユニットが取得対象となります。

指定できるコメントのバイト数は，パラメーターunitCommentMatchMethodsの指定値によって異なります。

パラメーターunitCommentMatchMethodsの指定値と，このパラメーターに指定できるバイト数を次に示します。

EQ，NE：0〜80バイト

BW，EW，CO，NC：1〜80バイト

RE：1〜164バイト

任意

unitCommentMatchMethods

ユニットのコメントの比較方法を定数MatchMethodsに規定されている文字列定数で指定します。定数MatchMethodsの詳細については，「7.4.2(3) MatchMethods」を参照してください。

このパラメーターを指定しなかった場合，「NO（検索条件にしない）」が仮定されます。

任意

execHost

取得したいユニットの実行ホストを指定します。ユニット定義の実行エージェントではなく，実際に実行されたエージェントホスト名を指定します。

パラメーターexecHostMatchMethodsで実行ホスト名の比較方法を指定した場合だけ，このパラメーターを指定できます。実行ホスト名の比較方法に「NO（検索条件にしない）」を指定した場合は，このパラメーターの指定は無視されます。実行ホスト名の比較方法に「EQ（完全一致）」を指定して，このパラメーターに空文字列（0バイト）を指定した場合は，実行ホストが確定していない待ち状態のジョブが取得対象になります。

指定できる実行ホストのバイト数は，パラメーターexecHostMatchMethodsの指定値によって異なります。

パラメーターexecHostMatchMethodsの指定値と，このパラメーターに指定できるバイト数を次に示します。

EQ，NE：0〜255バイト

BW，EW，CO，NC：1〜255バイト

RE：1〜514バイト

任意

execHostMatchMethods

ユニットの実行ホスト名の比較方法を定数MatchMethodsに規定されている文字列定数で指定します。定数MatchMethodsの詳細については，「7.4.2(3) MatchMethods」を参照してください。

このパラメーターを指定しなかった場合，「NO（検索条件にしない）」が仮定されます。

任意

releaseID

取得したいユニットのリリースIDを1〜30バイトの文字列で指定します。

パラメーターreleaseInfoSearchMethodsで「ID（リリースID）」を指定した場合に，このパラメーターを指定します。その他の指定では，このパラメーターの指定は無視されます。

任意

releaseInfoSearchMethods

リリース情報の取得方法を定数ReleaseInfoSearchMethodsに規定されている文字列定数で指定します。定数ReleaseInfoSearchMethodsの詳細については，「7.4.2(9) ReleaseInfoSearchMethods」を参照してください。

「NO（検索条件にしない）」を指定した場合，すべてのリリース情報が取得対象となります。

このパラメーターを指定しなかった場合，「NO」が仮定されます。

任意

注※

接続先JP1/AJS3 - Managerの環境設定パラメーターSCHEDULELIMITの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2(123) SCHEDULELIMIT」を参照してください。

また，JP1/AJS3 - Web Consoleのバージョンはバージョン情報の取得APIの戻り値（productVersionNumber）を，接続先JP1/AJS3 - Managerのバージョンは，JP1/AJS3 - Managerのプロトコルバージョンの取得APIの戻り値（protocolVersionNumber）を確認してください。

バージョン情報の取得APIの詳細については，「7.1.38 バージョン情報の取得API」を参照してください。

JP1/AJS3 - Managerのプロトコルバージョンの取得APIの詳細については，「7.1.39 JP1/AJS3 - Managerのプロトコルバージョンの取得API」を参照してください。

ステータスコード

レスポンスで返却するステータスコードを次の表に示します。

ステータスコード

テキスト記述

説明

200

OK

ユニット一覧の取得に成功しました。

400

Bad Request

クエリ文字列が不正です。

401

Unauthorized

認証が必要です。

403

Forbidden

実行権限がありません。

404

Not found

リソースにアクセスする権限がありません。または，リソースがありません。

409

Conflict

リクエストは現在のリソースの状態と矛盾しているため，処理を続行できません。

412

Precondition failed

Web Consoleサーバが利用できません。

500

Server-side error

Web Consoleサーバ処理エラーが発生しました。

レスポンスの形式

メッセージボディ

{
  "statuses":[ステータス監視のリソース,...],
  "all":すべての情報を取得できたかどうか
}

戻り値

ステータスコードが「200」の場合，次の情報を返却します。

メンバー

データ型

説明

statuses

object[]

ステータス監視のリソースの配列を返却します。条件を満たすユニットが一つも存在しない場合は，要素数0個の配列を返却します。ステータス監視のリソースの詳細については，「7.2.1 ステータス監視のリソース」を参照してください。

all

boolean

すべての情報を取得できたかどうかを返却します。

取得件数が1,000件を超えていない場合，「true」を返却します。取得件数が1,000件を超えている場合，「false」を返却します。

ただし，ログインしたJP1ユーザーに参照権限がないユニットの情報は，取得結果に含まれていません。このため，ログインしたJP1ユーザーに参照権限がないユニットの情報が取得できていない場合でも，取得件数が1,000件を超えていなければ，「true」を返却します。

使用例

ジョブグループ（/JobGroup）直下のユニット一覧（最新状態）を取得する場合のAPIの使用例を次に示します。

リクエストの例

GET /ajs/api/v1/objects/statuses?mode=search&manager=HOSTM&serviceName=AJSROOT1&location=%2FJobGroup HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

レスポンス（メッセージボディ）の例

{
  "statuses": [
    {
      "definition": {
        "owner": "jp1admin",
        "customJobType": "",
        "registerStatus": "YES",
        "rootJobnetName": "/JobGroup/Jobnet",
        "recoveryUnit": false,
        "unitType": "ROOTNET",
        "unitComment": "",
        "simpleUnitName": "Jobnet",
        "parameters": "",
        "execAgent": "",
        "execFileName": "",
        "wait": false,
        "jobnetReleaseUnit": false,
        "jp1ResourceGroup": "",
        "unitName": "/JobGroup/Jobnet",
        "unitID": 1560
      },
      "release": null,
      "unitStatus": {
        "status": "RUNNING",
        "execHost": "",
        "startDelayStatus": "NO",
        "nestStartDelayStatus": "NO",
        "endDelayStatus": "NO",
        "nestEndDelayStatus": "NO",
        "startDelayTime": "",
        "endDelayTime": "",
        "changeType": "NO",
        "registerTime": "",
        "jobNumber": -1,
        "retCode": "",
        "simpleUnitName": "Jobnet",
        "schStartTime": "2015-09-02T00:00:00+09:00",
        "reStartTime": "",
        "endTime": "",
        "holdAttr": "NO",
        "startTime": "2015-09-02T22:50:28+09:00",
        "unitName": "/JobGroup/Jobnet",
        "execID": "@A2959"
      }
    }
  ],
  "all": true
}

7.1.2　ユニット情報の取得API

指定したユニットの情報を取得します。ログインしたJP1ユーザーに該当のユニットの参照権限がない場合は，ユニットの情報は取得できません。

このAPIは，JP1/AJS3 - Web Consoleのバージョンが11-50以降のときに使用できます。バージョン情報の取得APIの戻り値（productVersionNumber）が115000以上であることを確認して使用してください。

実行権限

ログインしたJP1ユーザーが，情報を取得するユニットに対して，次に示すどれかのJP1権限が与えられている必要があります。

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Editor権限

JP1_AJS_Operator権限

JP1_AJS_Guest権限

リクエストの形式

リクエスト行

GET /application/component/apiVersion/objects/statuses/unitName:execID?query httpVersion

APIのバージョン

v1

リソースを一意に識別する情報

リソースを一意に識別する情報を次の表に示します。

なお，パラメーターの指定に誤りがある場合，またはパラメーターを指定しなかった場合は，リソースを一意に識別できないため，ステータスコード「404」のエラーになります。

リソースを一意に識別する情報

データ型

説明

必須・任意

unitName

string

要求対象のユニットのユニット完全名を，1〜930バイトの文字列で指定します。

必須

execID

string

実行IDを，文字列で指定します。

指定する形式は「@[mmmm]{A〜Z}nnnn」です（例：@10A200）。

必須

パラメーター

「query」に指定するパラメーターを次の表に示します。

表7‒2　ユニット情報の取得APIのパラメーター一覧

パラメーター

値の説明

必須・任意

manager

マネージャーホスト名またはIPアドレスを，1〜255バイトの文字列で指定します。

必須

serviceName

スケジューラーサービス名を，1〜30バイトの文字列で指定します。

必須

searchConnectInfo

ステータス監視リソースの「ステータス情報オブジェクト（unitStatus）」を取得するときに，接続情報を取得するか，接続情報を取得しないかを，定数ConnectInfoTypeに規定されている文字列定数で指定します。定数ConnectInfoTypeについては，「7.4.16(1) ConnectInfoType」を参照してください。

このパラメーターを指定しなかった場合，「NO（接続情報を取得しない）」が仮定されます。

このパラメーターは，JP1/AJS3 - Web Consoleのバージョンが12-50以降の場合だけ指定できます。バージョン情報の取得APIの戻り値（productVersionNumber）が125000以上であることを確認して，指定してください。バージョン情報の取得APIの詳細については，「7.1.38 バージョン情報の取得API」を参照してください。

任意

ステータスコード

レスポンスで返却するステータスコードを次の表に示します。

ステータスコード

テキスト記述

説明

200

OK

ユニット情報の取得に成功しました。

400

Bad Request

クエリ文字列が不正です。

401

Unauthorized

認証が必要です。

403

Forbidden

実行権限がありません。

404

Not found

リソースにアクセスする権限がありません。または，リソースがありません。

409

Conflict

リクエストは現在のリソースの状態と矛盾しているため，処理を続行できません。

412

Precondition failed

Web Consoleサーバが利用できません。

500

Server-side error

Web Consoleサーバ処理エラーが発生しました。

レスポンスの形式

メッセージボディ

ステータス監視のリソース

戻り値

ステータスコードが「200」の場合，ステータス監視のリソースを返却します。ステータス監視のリソースの詳細については，「7.2.1 ステータス監視のリソース」を参照してください。

使用例

指定したユニットの情報を取得するAPIの使用例を次に示します。

リクエストの例

GET /ajs/api/v1/objects/statuses/%2FJobGroup%2FJobnet:@A119?manager=HOSTM&serviceName=AJSROOT1 HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

レスポンス（メッセージボディ）の例

{
   "definition":
   {
      "owner":"user",
      "parameters":"",
      "unitID":29444,
      "simpleUnitName":"Jobnet",
      "unitType":"ROOTNET",
      "unitComment":"",
      "jp1ResourceGroup":"",
      "unitName":"/JobGroup/Jobnet",
      "customJobType":"",
      "execAgent":"",
      "execFileName":"",
      "registerStatus":"YES",
      "scenarioUnit":false,
      "recoveryUnit":false,
      "wait":false,
      "jobnetReleaseUnit":false,
      "horizontalPosition":-1,
      "verticalPosition":-1,
      "rootJobnetName":"/JobGroup/Jobnet"
   },
   "unitStatus":
   {
      "status":"NORMAL",
      "simpleUnitName":"Jobnet",
      "holdPlan":"NONE",
      "execHost":"",
      "delayedStart":"NOT",
      "holdAttr":"NO",
      "startTime":"2017-04-20T17:27:10+09:00",
      "endTime":"2017-04-20T17:27:10+09:00",
      "delayedStartTime":"",
      "delayedEnd":"NOT",
      "delayedEndTime":"",
      "timeRequiredForExecution":"-1",
      "unitName":"/JobGroup/Jobnet",
      "execID":"@A119",
      "schStartTime":"2017-04-20T00:00:00+09:00",
      "reStartTime":"",
      "startDelayStatus":"NO",
      "nestStartDelayStatus":"NO",
      "endDelayStatus":"NO",
      "nestEndDelayStatus":"NO",
      "startDelayTime":"",
      "endDelayTime":"",
      "changeType":"NO",
      "registerTime":"",
      "jobNumber":-1,
      "retCode":"",
      "executionType":"NONE",
      "startConditionTimes":-1,
      "startConditionPeriodType":"NONE",
      "startConditionPeriod":"",
      "retryStatus":"NONE",
      "retryTimes":-1,
      "execSchedule":"NONE",
      "statusInSummary": [
         "NONE"
      ],
      "execDateBaseTime":"",
      "waiting":"NONE",
      "monitoringJobnet":"TIME_REQUIRED_FOR_EXECUTION_NO"
   },
   "release":null
}

7.1.3　実行結果詳細の取得API

実行が終了したユニットの，実行結果の詳細を取得します。

実行結果の詳細については，マニュアル「JP1/Automatic Job Management System 3 操作ガイド　12.3.39 ［実行結果詳細］ダイアログボックス」を参照してください。

実行権限

ログインしたJP1ユーザーが，情報を取得するユニットに対して，次に示すどれかのJP1権限が与えられている必要があります。

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Editor権限

JP1_AJS_Operator権限

JP1_AJS_Guest権限

リクエストの形式

リクエスト行

GET /application/component/apiVersion/objects/statuses/unitName:execID/actions/execResultDetails/invoke?query httpVersion

APIのバージョン

v1

リソースを一意に識別する情報

リソースを一意に識別する情報を次の表に示します。

なお，パラメーターの指定に誤りがある場合，またはパラメーターを指定しなかった場合は，リソースを一意に識別できないため，ステータスコード「404」のエラーになります。

リソースを一意に識別する情報

データ型

説明

必須・任意

unitName

string

要求対象のユニットのユニット完全名を，1〜930バイトの文字列で指定します。

必須

execID

string

実行IDを，文字列で指定します。

指定する形式は「@[mmmm]{A〜Z}nnnn」です（例：@10A200）。

必須

パラメーター

「query」に指定するパラメーターを次の表に示します。

表7‒3　実行結果詳細の取得APIのパラメーター一覧

パラメーター

値の説明

必須・任意

manager

マネージャーホスト名またはIPアドレスを，1〜255バイトの文字列で指定します。

必須

serviceName

スケジューラーサービス名を，1〜30バイトの文字列で指定します。

必須

ステータスコード

レスポンスで返却するステータスコードを次の表に示します。

ステータスコード

テキスト記述

説明

200

OK

実行結果詳細の取得に成功しました。

400

Bad Request

クエリ文字列が不正です。

401

Unauthorized

認証が必要です。

403

Forbidden

実行権限がありません。

404

Not found

リソースにアクセスする権限がありません。または，リソースがありません。

409

Conflict

リクエストは現在のリソースの状態と矛盾しているため，処理を続行できません。

412

Precondition failed

Web Consoleサーバが利用できません。

500

Server-side error

Web Consoleサーバ処理エラーが発生しました。

レスポンスの形式

レスポンスのメッセージボディ

{
  "execResultDetails":"実行結果詳細",
  "all":すべての情報を取得できたかどうか
}

戻り値

ステータスコードが「200」の場合，次の情報を返却します。

メンバー

データ型

説明

execResultDetails

string

実行結果詳細を5メガバイト以内の文字列で返却します。実行結果詳細が5メガバイトを超える場合，5メガバイトを超える情報は切り捨てられるため，末尾の文字を文字として識別できないおそれがあります。

実行結果詳細には，ジョブを実行した環境の改行コード（¥nまたは¥r¥n）が含まれます。表示する環境に合わせて改行コードを置換してください。

実行結果詳細がない場合は，空文字列（0バイト）を返却します。

all

boolean

すべての実行結果詳細を取得できたかどうかを返却します。

すべての実行結果詳細を取得できた場合，「true」を返却します。すべての実行結果詳細を取得できなかった場合，「false」を返却します。

使用例

指定したジョブの実行結果詳細を取得するAPIの使用例を次に示します。

リクエストの例

GET /ajs/api/v1/objects/statuses/%2FJobGroup%2FJobnet%2FJob:%40A100/actions/execResultDetails/invoke?manager=HOSTM&serviceName=AJSROOT1 HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

レスポンス（メッセージボディ）の例

{
  "execResultDetails": "実行結果詳細",
  "all": true
}

7.1.4　待ち合わせ条件の状態一覧の取得API

指定されたユニットの待ち合わせ条件と，待ち合わせ条件に設定されている待ち合わせ対象ユニットの状態の一覧を取得します。

待ち合わせの詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　2.2.5 待ち合わせ条件を使用したユニットの実行順序制御」を参照してください。

このAPIは，JP1/AJS3 - Web Consoleのバージョンが12-50以降のときに使用できます。バージョン情報の取得APIの戻り値（productVersionNumber）が125000以上であることを確認して，使用してください。

実行権限

ログインしたJP1ユーザーが，待ち合わせ条件の状態一覧を取得するユニットに対して，次に示すどれかのJP1権限が与えられている必要があります。

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Editor権限

JP1_AJS_Operator権限

JP1_AJS_Guest権限

リクエストの形式

リクエスト行

GET /application/component/apiVersion/objects/waiting/unitName:execID?query httpVersion

APIのバージョン

v1

リソースを一意に識別する情報

リソースを一意に識別する情報を次の表に示します。

なお，パラメーターの指定に誤りがある場合，またはパラメーターを指定しなかった場合は，リソースを一意に識別できないため，ステータスコード「404」のエラーになります。

リソースを一意に識別する情報

データ型

説明

必須・任意

unitName

string

要求対象のユニットのユニット完全名を，1〜930バイトの文字列で指定します。

必須

execID

string

実行IDを，文字列で指定します。

指定する形式は「@[mmmm]{A〜Z}nnnn」です（例：@10A200）。

必須

パラメーター

「query」に指定するパラメーターを次の表に示します。

表7‒4　待ち合わせ条件の状態一覧の取得APIのパラメーター一覧

パラメーター

値の説明

必須・任意

manager

マネージャーホスト名またはIPアドレスを，1〜255バイトの文字列で指定します。

必須

serviceName

スケジューラーサービス名を，1〜30バイトの文字列で指定します。

必須

ステータスコード

レスポンスで返却するステータスコードを次の表に示します。

ステータスコード

テキスト記述

説明

200

OK

待ち合わせ条件の状態一覧の取得に成功しました。

400

Bad Request

クエリ文字列が不正です。

401

Unauthorized

認証が必要です。

403

Forbidden

実行権限がありません。

404

Not found

リソースにアクセスする権限がありません。または，リソースがありません。

409

Conflict

リクエストは現在のリソースの状態と矛盾しているため，処理を続行できません。

412

Precondition failed

Web Consoleサーバが利用できません。

500

Server-side error

Web Consoleサーバ処理エラーが発生しました。

レスポンスの形式

メッセージボディ

待ち合わせのリソース

戻り値

ステータスコードが「200」の場合，待ち合わせのリソースを返却します。待ち合わせのリソースの詳細については，「7.2.2 待ち合わせのリソース」を参照してください。

使用例

指定したユニットの待ち合わせ条件の状態一覧を取得するAPIの使用例を次に示します。

リクエストの例

GET /ajs/api/v1/objects/waiting/%2FJobGroup%2FJobnet01:%40A102?manager=HOSTM&serviceName=AJSROOT1 HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

レスポンス（メッセージボディ）の例

{
    "status":"NORMAL",
    "startDelayStatus":"NO",
    "nestStartDelayStatus":"NO",
    "endDelayStatus":"NO",
    "nestEndDelayStatus":"NO",
    "execSchedule":"NONE",
    "waitMethod":"AND",
    "noGenerationAction":"NOT_EXECUTE",
    "unmonitoredEndedAction":"NOT_EXECUTE",
    "abnomalEndedAction":"NOT_EXECUTE",
    "waitingTargetUnits":
    [
        {
            "status":"NORMAL",
            "startDelayStatus":"NO",
            "nestStartDelayStatus":"NO",
            "endDelayStatus":"NO",
            "nestEndDelayStatus":"NO",
            "execSchedule":"NONE",
            "unitName":"/JobGroup/Jobnet02",
            "execID":"@A103",
            "holdPlan":"NONE",
            "unitComment":"",
            "waitingStatus":"COMPLETE"
        }
    ],
    "unitName":"/JobGroup/Jobnet01",
    "execID":"@A102",
    "holdPlan":"NONE",
    "unitComment":""
}

7.1.5　計画実行登録API

指定したジョブネットを計画実行登録します。

計画実行登録の詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　4.1.1(2) 計画実行登録」を参照してください。

実行権限

ログインしたJP1ユーザーが，計画実行登録するユニットに対して，次に示すどれかのJP1権限が与えられている必要があります。

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Operator権限

リクエストの形式

リクエスト行

POST /application/component/apiVersion/objects/definitions/unitName/actions/registerPlannedExec/invoke httpVersion

メッセージボディ

{
  "parameters":{
    "manager":"マネージャーホスト名またはIPアドレス",
    "serviceName":"スケジューラーサービス名",
    "passedDaemonStarts":"スケジューラーサービス起動時に予定時刻を超過していた場合の動作",
    "passedRegForExe":"実行登録時に予定時刻を超過していた場合の動作",
    "holding":ジョブネットの実行を保留するかどうか,
    "macro":[マクロ変数のオブジェクト,...]
  }
}

APIのバージョン

v1

リソースを一意に識別する情報

リソースを一意に識別する情報を次の表に示します。

なお，パラメーターの指定に誤りがある場合，またはパラメーターを指定しなかった場合は，リソースを一意に識別できないため，ステータスコード「404」のエラーになります。

リソースを一意に識別する情報

データ型

説明

必須・任意

unitName

string

要求対象のユニットのユニット完全名を，1〜930バイトの文字列で指定します。

必須

パラメーター

リクエストのメッセージボディのparametersに指定するパラメーターを次の表に示します。

表7‒5　計画実行登録APIのパラメーター一覧

パラメーター

データ型

値の説明

必須・任意

manager

string

マネージャーホスト名またはIPアドレスを，1〜255バイトの文字列で指定します。

必須

serviceName

string

スケジューラーサービス名を，1〜30バイトの文字列で指定します。

必須

passedDaemonStarts

string

スケジューラーサービス起動時に予定時刻を超過していた場合の動作を，定数PlannedTimePassedTypeに規定されている文字列定数で指定します。定数PlannedTimePassedTypeの詳細については，「7.4.3(1) PlannedTimePassedType」を参照してください。

このパラメーターの指定は，スケジューラーサービスの起動モードがウォームスタートまたはディザスターリカバリースタートの場合だけ有効です。

必須

passedRegForExe

string

実行登録時に予定時刻を超過していた場合の動作を，定数PlannedTimePassedTypeに規定されている文字列定数で指定します。定数PlannedTimePassedTypeの詳細については，「7.4.3(1) PlannedTimePassedType」を参照してください。

必須

holding

boolean

計画実行登録時にジョブネットの実行を保留するかどうかを指定します。

保留する場合は「true」を指定します。保留しない場合は「false」を指定します。

「true」を指定した場合は，実行登録時に作成される実行世代に対して保留を設定します。

このパラメーターを指定しなかった場合は，「false」が仮定されます。

このパラメーターは，JP1/AJS3 - Web Consoleのバージョンが11-10以降，かつ接続先JP1/AJS3 - Managerのバージョンが11-10以降の場合だけ指定できます。バージョン情報の取得APIの戻り値（productVersionNumber）が111000以上，かつJP1/AJS3 - Managerのプロトコルバージョンの取得APIの戻り値（protocolVersionNumber）が1110以上であることを確認して，指定してください。

バージョン情報の取得APIの詳細については，「7.1.38 バージョン情報の取得API」を参照してください。

JP1/AJS3 - Managerのプロトコルバージョンの取得APIの詳細については，「7.1.39 JP1/AJS3 - Managerのプロトコルバージョンの取得API」を参照してください。

任意

macro

object[]

ルートジョブネット配下のジョブで使用しているマクロ変数に設定する情報を，マクロ変数のオブジェクトの配列で指定します。

マクロ変数のオブジェクトの詳細については，「7.3.5 マクロ変数オブジェクト」を参照してください。

マクロ変数は32個まで指定できます。複数指定する場合，「マクロ変数名のバイト数＋引き継ぎ情報のバイト数＋4」の値が4,085以内になるよう指定してください。同じマクロ変数を複数指定した場合，最初に指定したマクロ変数の引き継ぎ情報が引き継がれます。

マクロ変数を引き継ぐ場合だけ，このパラメーターを指定してください。マクロ変数を引き継がない場合は，このパラメーターを指定しないか，またはこのパラメーターに「null」を指定してください。

任意

ステータスコード

レスポンスで返却するステータスコードを次の表に示します。

ステータスコード

テキスト記述

説明

200

OK

計画実行登録が成功しました。

400

Bad Request

引数が不正です。

401

Unauthorized

認証が必要です。

403

Forbidden

実行権限がありません。

404

Not found

リソースにアクセスする権限がありません。または，リソースがありません。

409

Conflict

リクエストは現在のリソースの状態と矛盾しているため，処理を続行できません。

412

Precondition failed

Web Consoleサーバが利用できません。

500

Server-side error

Web Consoleサーバ処理エラーが発生しました。

戻り値

なし（レスポンスのメッセージボディのサイズは0バイトです）

使用例1

指定したジョブネットを計画実行登録するAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/definitions/%2FJobGroup%2FJobnet/actions/registerPlannedExec/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "serviceName":"AJSROOT1",
    "passedDaemonStarts":"IMMEDIATE",
    "passedRegForExe":"IMMEDIATE"
  }
}

使用例2

マクロ変数を指定して，ジョブネットを計画実行登録するAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/definitions/%2FJobGroup%2FJobnet/actions/registerPlannedExec/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "serviceName":"AJSROOT1",
    "passedDaemonStarts":"IMMEDIATE",
    "passedRegForExe":"IMMEDIATE",
    "macro":[{"name":"AJS2KEY1","value":"1"},{"name":"AJS2KEY2","value":"2"}]
  }
}

使用例3

計画実行登録時にジョブネットの初回の実行開始を保留にするAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/definitions/%2FJobGroup%2FJobnet/actions/registerPlannedExec/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "serviceName":"AJSROOT1",
    "passedDaemonStarts":"IMMEDIATE",
    "passedRegForExe":"IMMEDIATE",
    "holding":true
  }
}

7.1.6　確定実行登録API

指定したジョブネットを確定実行登録します。

確定実行登録の詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　4.1.1(3) 確定実行登録」を参照してください。

また，日時指定の確定実行登録の詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　4.5.2 ジョブネットに実行予定を追加する」もあわせて参照してください。

実行権限

ログインしたJP1ユーザーが，確定実行登録するユニットに対して，次に示すどれかのJP1権限が与えられている必要があります。

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Operator権限

リクエストの形式

リクエスト行

POST /application/component/apiVersion/objects/definitions/unitName/actions/registerFixedExec/invoke httpVersion

メッセージボディ

{
  "parameters":{
    "manager":"マネージャーホスト名またはIPアドレス",
    "serviceName":"スケジューラーサービス名",
    "fixedScheduleFrom":"確定期間の開始年月日",
    "fixedScheduleTo":"確定期間の終了年月日",
    "futureGeneration":未来世代数,
    "startTime":"ジョブネットの実行を開始する日時",
    "passedDaemonStarts":"スケジューラーサービス起動時に予定時刻を超過していた場合の動作",
    "holding":ジョブネットの実行を保留するかどうか,
    "macro":[マクロ変数のオブジェクト,...]
  }
}

APIのバージョン

v1

リソースを一意に識別する情報

リソースを一意に識別する情報を次の表に示します。

なお，パラメーターの指定に誤りがある場合，またはパラメーターを指定しなかった場合は，リソースを一意に識別できないため，ステータスコード「404」のエラーになります。

リソースを一意に識別する情報

データ型

説明

必須・任意

unitName

string

要求対象のユニットのユニット完全名を，1〜930バイトの文字列で指定します。

必須

パラメーター

リクエストのメッセージボディのparametersに指定するパラメーターを次の表に示します。

表7‒6　確定実行登録APIのパラメーター一覧

パラメーター

データ型

値の説明

必須・任意

manager

string

マネージャーホスト名またはIPアドレスを，1〜255バイトの文字列で指定します。

必須

serviceName

string

スケジューラーサービス名を，1〜30バイトの文字列で指定します。

必須

fixedScheduleFrom※1

string

確定期間を指定して確定実行登録する場合に指定します。

確定実行スケジュールで実行する確定期間の開始年月日を，「YYYY-MM-DD」の形式で指定します。指定できる値を次に示します。

YYYY：年を指定します。

年に指定できる値は，次のとおりです。

JP1/AJS3 - Web Consoleのバージョンが13-00以降，かつ接続先JP1/AJS3 - Managerのバージョンが13-00以降の場合：

1994〜環境設定パラメーターSCHEDULELIMITに設定した値（単位：年）※2

上記以外の場合：

1994〜2036（単位：年）

MM：月を指定します。

月に指定できる値は，01〜12（単位：月）です。

DD：日にちを指定します。

日にちに指定できる値は，01〜指定した月の最終日（単位：日）です。

指定する年月日は，要求先JP1/AJS3 - Managerのスケジューラーサービスローカル日時で指定してください。

確定期間の開始年月日を指定した場合，確定期間の終了年月日は必ず指定してください。指定しない場合，エラーになります。

確定期間を指定しない場合は，このパラメーターを指定しないか，またはこのパラメーターに「null」を指定してください。

任意

fixedScheduleTo※1

string

確定期間を指定して確定実行登録する場合に指定します。

確定実行スケジュールで実行する確定期間の終了年月日を，「YYYY-MM-DD」の形式で指定します。指定できる値を次に示します。

YYYY：年を指定します。

年に指定できる値は，次のとおりです。

JP1/AJS3 - Web Consoleのバージョンが13-00以降，かつ接続先JP1/AJS3 - Managerのバージョンが13-00以降の場合：

1994〜環境設定パラメーターSCHEDULELIMITに設定した値（単位：年）※2

上記以外の場合：

1994〜2036（単位：年）

MM：月を指定します。

月に指定できる値は，01〜12（単位：月）です。

DD：日にちを指定します。

日にちに指定できる値は，01〜指定した月の最終日（単位：日）です。

指定する年月日は，要求先JP1/AJS3 - Managerのスケジューラーサービスローカル日時で指定してください。

確定期間の終了年月日を指定した場合，確定期間の開始年月日は必ず指定してください。指定しない場合，エラーになります。

確定期間を指定しない場合は，このパラメーターを指定しないか，またはこのパラメーターに「null」を指定してください。

任意

futureGeneration※1

int

未来世代数を指定して確定実行登録する場合に指定します。

何回先まで実行予定を作成するかを数値で指定します。指定できる値は，1〜99（単位：世代）です。

未来世代数を指定しない場合は，このパラメーターを指定しないか，またはこのパラメーターに「0」を指定してください。

任意

startTime※1

string

ジョブネットのスケジュール定義に関係なく，日時を指定して実行予定を追加する場合に指定します。

ジョブネットの実行を開始する日時を，「YYYY-MM-DDThh:mm」の形式で指定します。

指定できる値を次に示します。

YYYY：年を指定します。年に指定できる値は，次のとおりです。

JP1/AJS3 - Web Consoleのバージョンが13-00以降，かつ接続先JP1/AJS3 - Managerのバージョンが13-00以降の場合：

1994〜環境設定パラメーターSCHEDULELIMITに設定した値（単位：年）※2

上記以外の場合：

1994〜2036（単位：年）

MM：月を指定します。月に指定できる値は，01〜12（単位：月）です。

DD：日にちを指定します。日にちに指定できる値は，01〜指定した月の最終日（単位：日）です。

hh：時間を指定します。時間に指定できる値は，00〜47（単位：時）です。

mm：分を指定します。分に指定できる値は，00〜59（単位：分）です。

指定する日時は，要求先JP1/AJS3 - Managerのスケジューラーサービスローカル日時で指定してください。

このパラメーターは，JP1/AJS3 - Web Consoleのバージョンが11-10以降の場合に指定できます。バージョン情報の取得APIの戻り値（productVersionNumber）が111000以上であることを確認して，指定してください。

バージョン情報の取得APIの詳細については，「7.1.38 バージョン情報の取得API」を参照してください。

任意

passedDaemonStarts

string

スケジューラーサービス起動時に予定時刻を超過していた場合の動作を，定数PlannedTimePassedTypeに規定されている文字列定数で指定します。定数PlannedTimePassedTypeの詳細については，「7.4.3(1) PlannedTimePassedType」を参照してください。

このパラメーターの指定は，スケジューラーサービスの起動モードがウォームスタートまたはディザスターリカバリースタートの場合だけ有効です。

このパラメーターは，確定期間，未来世代数を指定した場合と，日時を指定した場合で，動作が異なります。

動作を次に示します。

確定期間，未来世代数を指定した場合，このパラメーターを省略するとエラーになります。

日時を指定した場合，このパラメーターを指定しなかったとき，またはこのパラメーターに「null」を指定したときは，「IMMEDIATE（すぐに実行する）」が仮定されます。このパラメーターは，JP1/AJS3 - Web Consoleのバージョンが11-10以降，かつ接続先JP1/AJS3 - Managerのバージョンが11-10以降の場合だけ指定できます。バージョン情報の取得APIの戻り値（productVersionNumber）が111000以上，かつJP1/AJS3 - Managerのプロトコルバージョンの取得APIの戻り値（protocolVersionNumber）が1110以上であることを確認して，指定してください。

バージョン情報の取得APIの詳細については，「7.1.38 バージョン情報の取得API」を参照してください。

JP1/AJS3 - Managerのプロトコルバージョンの取得APIの詳細については，「7.1.39 JP1/AJS3 - Managerのプロトコルバージョンの取得API」を参照してください。

任意

holding

boolean

確定実行登録時にジョブネットの実行を保留するかどうかを指定します。

保留する場合は「true」を指定します。保留しない場合は「false」を指定します。

「true」を指定した場合は，実行登録時に作成される世代のうち，最初の実行世代に対して保留を設定します。

このパラメーターを指定しなかった場合は，「false」が仮定されます。

このパラメーターは，JP1/AJS3 - Web Consoleのバージョンが11-10以降，かつ接続先JP1/AJS3 - Managerのバージョンが11-10以降の場合だけ指定できます。バージョン情報の取得APIの戻り値（productVersionNumber）が111000以上，かつJP1/AJS3 - Managerのプロトコルバージョンの取得APIの戻り値（protocolVersionNumber）が1110以上であることを確認して，指定してください。

バージョン情報の取得APIの詳細については，「7.1.38 バージョン情報の取得API」を参照してください。

JP1/AJS3 - Managerのプロトコルバージョンの取得APIの詳細については，「7.1.39 JP1/AJS3 - Managerのプロトコルバージョンの取得API」を参照してください。

任意

macro

object[]

ルートジョブネット配下のジョブで使用しているマクロ変数に設定する情報を，マクロ変数のオブジェクトの配列で指定します。

マクロ変数のオブジェクトの詳細については，「7.3.5 マクロ変数オブジェクト」を参照してください。

マクロ変数は32個まで指定できます。複数指定する場合，「マクロ変数名のバイト数＋引き継ぎ情報のバイト数＋4」の値が4,085以内になるよう指定してください。同じマクロ変数を複数指定した場合，最初に指定したマクロ変数の引き継ぎ情報が引き継がれます。

マクロ変数を引き継がない場合は，このパラメーターを指定しないか，またはこのパラメーターに「null」を指定してください。

任意

注※1

確定期間（fixedScheduleFromとfixedScheduleTo），未来世代数（futureGeneration）または日時指定の予定追加（startTime）のどれかを必ず指定してください。どれも指定しなかった場合（nullを指定した場合を含む）は，エラーになります。

確定期間と未来世代数は同時に指定できます。しかし，日時指定の予定追加は，確定期間および未来世代数と同時に指定できません。指定するとエラーになります。

注※2

接続先JP1/AJS3 - Managerの環境設定パラメーターSCHEDULELIMITの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2(123) SCHEDULELIMIT」を参照してください。

また，JP1/AJS3 - Web Consoleのバージョンはバージョン情報の取得APIの戻り値（productVersionNumber）を，接続先JP1/AJS3 - Managerのバージョンは，JP1/AJS3 - Managerのプロトコルバージョンの取得APIの戻り値（protocolVersionNumber）を確認してください。

バージョン情報の取得APIの詳細については，「7.1.38 バージョン情報の取得API」を参照してください。

JP1/AJS3 - Managerのプロトコルバージョンの取得APIの詳細については，「7.1.39 JP1/AJS3 - Managerのプロトコルバージョンの取得API」を参照してください。

ステータスコード

レスポンスで返却するステータスコードを次の表に示します。

ステータスコード

テキスト記述

説明

200

OK

確定実行登録が成功しました。

400

Bad Request

引数が不正です。

401

Unauthorized

認証が必要です。

403

Forbidden

実行権限がありません。

404

Not found

リソースにアクセスする権限がありません。または，リソースがありません。

409

Conflict

リクエストは現在のリソースの状態と矛盾しているため，処理を続行できません。

412

Precondition failed

Web Consoleサーバが利用できません。

500

Server-side error

Web Consoleサーバ処理エラーが発生しました。

レスポンスの形式

確定期間，未来世代数を指定した場合のレスポンスのメッセージボディ

なし（レスポンスのメッセージボディのサイズは0バイトです）

日時を指定した場合のレスポンスのメッセージボディ

{
  "execID":"実行ID"
}

戻り値

確定期間，未来世代数を指定した場合

なし（レスポンスのメッセージボディのサイズは0バイトです）

日時を指定した場合

ステータスコードが「200」のとき，次の情報を返却します。

メンバー

データ型

説明

execID

string

実行IDを「@[mmmm]{A〜Z}nnnn」の形式で返却します（例：@10A200）。

使用例1

期間を指定して，確定実行登録するAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/definitions/%2FJobGroup%2FJobnet/actions/registerFixedExec/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "serviceName":"AJSROOT1",
    "fixedScheduleFrom":"2015-09-07",
    "fixedScheduleTo":"2015-09-11",
    "passedDaemonStarts":"IMMEDIATE"
  }
}

使用例2

未来世代数とマクロ変数を指定して，確定実行登録するAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/definitions/%2FJobGroup%2FJobnet/actions/registerFixedExec/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "serviceName":"AJSROOT1",
    "futureGeneration":5,
    "passedDaemonStarts":"IMMEDIATE",
    "macro":[{"name":"AJS2KEY1","value":"1"},{"name":"AJS2KEY2","value":"2"}]
  }
}

使用例3

ジョブネットのスケジュール定義に関係なく，日時を指定して実行予定を追加するAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/definitions/%2FJobGroup%2FJobnet/actions/registerFixedExec/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "serviceName":"AJSROOT1",
    "startTime":"2016-09-07T08:30",
    "passedDaemonStarts":"IMMEDIATE"
  }
}

レスポンス（メッセージボディ）の例

{
  "execID": "@A100"
}

使用例4

確定実行登録時にジョブネットの初回の実行開始を保留にするAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/definitions/%2FJobGroup%2FJobnet/actions/registerFixedExec/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "serviceName":"AJSROOT1",
    "fixedScheduleFrom":"2016-09-07",
    "fixedScheduleTo":"2016-09-11",
    "passedDaemonStarts":"IMMEDIATE",
    "holding":true
  }
}

7.1.7　即時実行登録API

指定したジョブネットを即時実行登録します。

即時実行登録の詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　4.1.1(1) 即時実行登録」を参照してください。

実行権限

ログインしたJP1ユーザーが，即時実行登録するユニットに対して，次に示すどれかのJP1権限が与えられている必要があります。

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Operator権限

リクエストの形式

リクエスト行

POST /application/component/apiVersion/objects/definitions/unitName/actions/registerImmediateExec/invoke httpVersion

メッセージボディ

{
  "parameters":{
    "manager":"マネージャーホスト名またはIPアドレス",
    "serviceName":"スケジューラーサービス名",
    "startCondition":起動条件パラメーターのオブジェクト,
    "holding":ジョブネットの実行を保留するかどうか,
    "macro":[マクロ変数のオブジェクト,...]
  }
}

APIのバージョン

v1

リソースを一意に識別する情報

リソースを一意に識別する情報を次の表に示します。

なお，パラメーターの指定に誤りがある場合，またはパラメーターを指定しなかった場合は，リソースを一意に識別できないため，ステータスコード「404」のエラーになります。

リソースを一意に識別する情報

データ型

説明

必須・任意

unitName

string

要求対象のユニットのユニット完全名を，1〜930バイトの文字列で指定します。

必須

パラメーター

リクエストのメッセージボディのparametersに指定するパラメーターを次の表に示します。

表7‒7　即時実行登録APIのパラメーター一覧

パラメーター

データ型

値の説明

必須・任意

manager

string

マネージャーホスト名またはIPアドレスを，1〜255バイトの文字列で指定します。

必須

serviceName

string

スケジューラーサービス名を，1〜30バイトの文字列で指定します。

必須

startCondition

object

起動条件を使ってジョブネットを実行する場合，起動条件パラメーターオブジェクトを指定します。起動条件パラメーターオブジェクトの詳細については，「7.3.4 起動条件パラメーターオブジェクト」を参照してください。

起動条件を指定しない場合は，このパラメーターを指定しないか，このパラメーターに「null」を指定してください。

任意

holding

boolean

即時実行登録時にジョブネットの実行を保留するかどうかを指定します。保留する場合は「true」を指定します。保留しない場合は「false」を指定します。

このパラメーターを指定しなかった場合は，「false」が仮定されます。

任意

macro

object[]

ルートジョブネット配下のジョブで使用しているマクロ変数に設定する情報を，マクロ変数オブジェクトの配列で指定します。

マクロ変数オブジェクトの詳細については，「7.3.5 マクロ変数オブジェクト」を参照してください。

マクロ変数は32個まで指定できます。複数指定する場合，「マクロ変数名のバイト数＋引き継ぎ情報のバイト数＋4」の値が4,085以内になるよう指定してください。同じマクロ変数を複数指定した場合，最初に指定したマクロ変数の引き継ぎ情報が引き継がれます。

マクロ変数を引き継がない場合は，このパラメーターを指定しないか，またはこのパラメーターに「null」を指定してください。

任意

ステータスコード

レスポンスで返却するステータスコードを次の表に示します。

ステータスコード

テキスト記述

説明

200

OK

即時実行登録が成功しました。

400

Bad Request

引数が不正です。

401

Unauthorized

認証が必要です。

403

Forbidden

実行権限がありません。

404

Not found

リソースにアクセスする権限がありません。または，リソースがありません。

409

Conflict

リクエストは現在のリソースの状態と矛盾しているため，処理を続行できません。

412

Precondition failed

Web Consoleサーバが利用できません。

500

Server-side error

Web Consoleサーバ処理エラーが発生しました。

レスポンスの形式

レスポンスのメッセージボディ

{
  "execID":"実行ID"
}

戻り値

ステータスコードが「200」の場合，次の情報を返却します。

メンバー

データ型

説明

execID

string

実行IDを「@[mmmm]{A〜Z}nnnn」の形式で返却します（例：@10A200）。起動条件を指定している場合は監視世代の実行IDを返却します。

使用例1

指定したジョブネットを即時実行登録するAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/definitions/%2FJobGroup%2FJobnet/actions/registerImmediateExec/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "serviceName":"AJSROOT1"
  }
}

レスポンス（メッセージボディ）の例

{
  "execID": "@A2895"
}

使用例2

起動条件パラメーター（回数）とマクロ変数を指定して，ジョブネットを即時実行登録するAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/definitions/%2FJobGroup%2FJobnet/actions/registerImmediateExec/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "serviceName":"AJSROOT1",
    "startCondition":{
      "times":5
    },
    "macro":[{"name":"AJS2KEY1","value":"1"},{"name":"AJS2KEY2","value":"2"}]
  }
}

レスポンス（メッセージボディ）の例

{
  "execID": "@A2897"
}

使用例3

即時実行登録時にジョブネットの実行を保留にするAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/definitions/%2FJobGroup%2FJobnet/actions/registerImmediateExec/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "serviceName":"AJSROOT1",
    "holding":true
  }
}

レスポンス（メッセージボディ）の例

{
  "execID": "@A100"
}

7.1.8　登録解除API

指定した実行登録中のジョブネットの登録を解除します。

登録解除の詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　4.5.1 ジョブネットの登録を解除する」を参照してください。

実行権限

ログインしたJP1ユーザーが，登録解除するユニットに対して，次に示すどれかのJP1権限が与えられている必要があります。

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Operator権限

リクエストの形式

リクエスト行

POST /application/component/apiVersion/objects/definitions/unitName/actions/cancelRegistration/invoke httpVersion

メッセージボディ

{
  "parameters":{
    "manager":"マネージャーホスト名またはIPアドレス",
    "serviceName":"スケジューラーサービス名",
    "dateType":"暦日または実行日"
    "begin":"登録解除する期間の開始日"
    "end":"登録解除する期間の終了日"
  }
}

APIのバージョン

v1

リソースを一意に識別する情報

リソースを一意に識別する情報を次の表に示します。

なお，パラメーターの指定に誤りがある場合，またはパラメーターを指定しなかった場合は，リソースを一意に識別できないため，ステータスコード「404」のエラーになります。

リソースを一意に識別する情報

データ型

説明

必須・任意

unitName

string

要求対象のユニットのユニット完全名を，1〜930バイトの文字列で指定します。

必須

パラメーター

リクエストのメッセージボディのparametersに指定するパラメーターを次の表に示します。

表7‒8　登録解除APIのパラメーター一覧

パラメーター

データ型

値の説明

必須・任意

manager

string

マネージャーホスト名またはIPアドレスを，1〜255バイトの文字列で指定します。

必須

serviceName

string

スケジューラーサービス名を，1〜30バイトの文字列で指定します。

必須

dateType※1

string

実行登録を解除する期間を，暦日で指定するか実行日で指定するか，定数DateTypeに規定されている文字列定数で指定します。定数DateTypeの詳細については，「7.4.1(1) DateType」を参照してください。

実行登録を解除する期間を指定しない場合は，このパラメーターを指定しないか，このパラメーターに「null」を指定してください。

任意

begin※1

string

実行登録を解除する期間の開始日を，「YYYY-MM-DD」の形式で指定します。指定できる値を次に示します。

YYYY：年を指定します。

年に指定できる値は，次のとおりです。

JP1/AJS3 - Web Consoleのバージョンが13-00以降，かつ接続先JP1/AJS3 - Managerのバージョンが13-00以降の場合：

1994〜環境設定パラメーターSCHEDULELIMITに設定した値（単位：年）※2

上記以外の場合：

1994〜2036（単位：年）

MM：月を指定します。

月に指定できる値は，01〜12（単位：月）です。

DD：日にちを指定します。

日にちに指定できる値は，01〜指定した月の最終日（単位：日）です。

指定する年月日は，要求先JP1/AJS3 - Managerのスケジューラーサービスローカル日時で指定してください。

実行登録を解除する期間を指定しない場合は，このパラメーターを指定しないか，このパラメーターに「null」を指定してください。

任意

end※1

string

実行登録を解除する期間の終了日を，「YYYY-MM-DD」の形式で指定します。指定できる値を次に示します。

YYYY：年を指定します。

年に指定できる値は，次のとおりです。

JP1/AJS3 - Web Consoleのバージョンが13-00以降，かつ接続先JP1/AJS3 - Managerのバージョンが13-00以降の場合：

1994〜環境設定パラメーターSCHEDULELIMITに設定した値（単位：年）※2

上記以外の場合：

1994〜2036（単位：年）

MM：月を指定します。

月に指定できる値は，01〜12（単位：月）です。

DD：日にちを指定します。

日にちに指定できる値は，01〜指定した月の最終日（単位：日）です。

指定する年月日は，要求先JP1/AJS3 - Managerのスケジューラーサービスローカル日時で指定してください。

なお，このパラメーターには，パラメーターbeginで指定した年月日以降の値を指定してください。それより前の値を指定した場合は，エラーになります。

実行登録を解除する期間を指定しない場合は，このパラメーターを指定しないか，このパラメーターに「null」を指定してください。

任意

注※1

パラメーターdateType，begin，およびendをすべて省略した場合，指定したすべてのジョブネットの実行登録が解除されます。

期間を指定して実行登録を解除する場合は，パラメーターdateType，begin，およびendをすべて指定してください。どれか一つでも省略した場合，エラーになります。

注※2

接続先JP1/AJS3 - Managerの環境設定パラメーターSCHEDULELIMITの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2(123) SCHEDULELIMIT」を参照してください。

また，JP1/AJS3 - Web Consoleのバージョンはバージョン情報の取得APIの戻り値（productVersionNumber）を，接続先JP1/AJS3 - Managerのバージョンは，JP1/AJS3 - Managerのプロトコルバージョンの取得APIの戻り値（protocolVersionNumber）を確認してください。

バージョン情報の取得APIの詳細については，「7.1.38 バージョン情報の取得API」を参照してください。

JP1/AJS3 - Managerのプロトコルバージョンの取得APIの詳細については，「7.1.39 JP1/AJS3 - Managerのプロトコルバージョンの取得API」を参照してください。

ステータスコード

レスポンスで返却するステータスコードを次の表に示します。

ステータスコード

テキスト記述

説明

200

OK

登録解除が成功しました。

400

Bad Request

引数が不正です。

401

Unauthorized

認証が必要です。

403

Forbidden

実行権限がありません。

404

Not found

リソースにアクセスする権限がありません。または，リソースがありません。

409

Conflict

リクエストは現在のリソースの状態と矛盾しているため，処理を続行できません。

412

Precondition failed

Web Consoleサーバが利用できません。

500

Server-side error

Web Consoleサーバ処理エラーが発生しました。

戻り値

なし（レスポンスのメッセージボディのサイズは0バイトです）

使用例1

指定した実行登録中のジョブネットの登録を解除するAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/definitions/%2FJobGroup%2FJobnet/actions/cancelRegistration/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "serviceName":"AJSROOT1"
  }
}

使用例2

期間を指定して，実行登録中のジョブネットの登録を解除するAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/definitions/%2FJobGroup%2FJobnet/actions/cancelRegistration/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "serviceName":"AJSROOT1",
    "dateType":"CALENDAR_DATE",
    "begin":"2015-09-09",
    "end":"2015-09-11"
  }
}

7.1.9　保留属性変更API

指定したユニットの保留属性を変更します。

保留属性の変更については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　4.5.6 ジョブネットやジョブの保留属性を一時変更する」を参照してください。

実行権限

ログインしたJP1ユーザーが，保留属性を変更するユニットに対して，次に示すどれかのJP1権限が与えられている必要があります。

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Operator権限

リクエストの形式

リクエスト行

POST /application/component/apiVersion/objects/statuses/unitName:execID/actions/changeHold/invoke httpVersion

メッセージボディ

{
  "parameters":{
    "manager":"マネージャーホスト名またはIPアドレス",
    "serviceName":"スケジューラーサービス名",
    "holdAttr":"保留属性設定または保留解除"
  }
}

APIのバージョン

v1

リソースを一意に識別する情報

リソースを一意に識別する情報を次の表に示します。

なお，パラメーターの指定に誤りがある場合，またはパラメーターを指定しなかった場合は，リソースを一意に識別できないため，ステータスコード「404」のエラーになります。

リソースを一意に識別する情報

データ型

値の説明

必須・任意

unitName

string

要求対象のユニットのユニット完全名を，1〜930バイトの文字列で指定します。

必須

execID

string

実行IDを，文字列で指定します。

指定する形式は「@[mmmm]{A〜Z}nnnn」です（例：@10A200）。

必須

パラメーター

リクエストのメッセージボディのparametersに指定するパラメーターを次の表に示します。

表7‒9　保留属性変更APIのパラメーター一覧

パラメーター

データ型

値の説明

必須・任意

manager

string

マネージャーホスト名またはIPアドレスを，1〜255バイトの文字列で指定します。

必須

serviceName

string

スケジューラーサービス名を，1〜30バイトの文字列で指定します。

必須

holdAttr

string

保留属性設定か保留解除かを，定数ChangeHoldAttrに規定されている文字列定数で指定します。

定数ChangeHoldAttrの詳細については，「7.4.8(1) ChangeHoldAttr」を参照してください。

必須

ステータスコード

レスポンスで返却するステータスコードを次の表に示します。

ステータスコード

テキスト記述

説明

200

OK

保留属性の変更が成功しました。

400

Bad Request

引数が不正です。

401

Unauthorized

認証が必要です。

403

Forbidden

実行権限がありません。

404

Not found

リソースにアクセスする権限がありません。または，リソースがありません。

409

Conflict

リクエストは現在のリソースの状態と矛盾しているため，処理を続行できません。

412

Precondition failed

Web Consoleサーバが利用できません。

500

Server-side error

Web Consoleサーバ処理エラーが発生しました。

戻り値

なし（レスポンスのメッセージボディのサイズは0バイトです）

使用例1

指定したジョブネットに保留属性を設定するAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/statuses/%2FJobGroup%2FJobnet:%40A100/actions/changeHold/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "serviceName":"AJSROOT1",
    "holdAttr":"SET"
  }
}

使用例2

指定したジョブネットの保留を解除するAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/statuses/%2FJobGroup%2FJobnet:%40A100/actions/changeHold/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "serviceName":"AJSROOT1",
    "holdAttr":"RELEASE"
  }
}

7.1.10　遅延監視変更API

指定した実行登録済みのジョブネットの遅延監視の設定を，一時的に変更します。

遅延監視設定の一時変更の詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　4.5.7 ジョブネットの遅延監視の設定を一時変更する」を参照してください。

このAPIは，JP1/AJS3 - Web Consoleのバージョンが11-10以降のときに使用できます。バージョン情報の取得APIの戻り値（productVersionNumber）が111000以上であることを確認して，使用してください。

実行権限

ログインしたJP1ユーザーが，遅延監視の設定を変更するユニットに対して，次に示すどれかのJP1権限が与えられている必要があります。

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Operator権限

リクエストの形式

リクエスト行

POST /application/component/apiVersion/objects/statuses/unitName:execID/actions/changeDelayMonitor/invoke httpVersion

メッセージボディ

{
  "parameters":{
    "manager":"マネージャーホスト名またはIPアドレス",
    "serviceName":"スケジューラーサービス名",
    "delayedStart":"開始遅延を監視する方法",
    "delayedStartTime":"開始遅延の監視を始める時刻",
    "delayedEnd":"終了遅延を監視する方法",
    "delayedEndTime":"終了遅延の監視を始める時刻",
    "monitoringJobnet":"ジョブネットの実行所要時間による終了遅延の監視方法",
    "timeRequiredForExecution":"ジョブネットの実行所要時間"
  }
}

APIのバージョン

v1

リソースを一意に識別する情報

リソースを一意に識別する情報を次の表に示します。

なお，パラメーターの指定に誤りがある場合，またはパラメーターを指定しなかった場合は，リソースを一意に識別できないため，ステータスコード「404」のエラーになります。

リソースを一意に識別する情報

データ型

値の説明

必須・任意

unitName

string

要求対象のユニットのユニット完全名を，1〜930バイトの文字列で指定します。

必須

execID

string

実行IDを，文字列で指定します。

指定する形式は「@[mmmm]{A〜Z}nnnn」です（例：@10A200）。

必須

パラメーター

リクエストのメッセージボディのparametersに指定するパラメーターを次の表に示します。

表7‒10　遅延監視変更APIのパラメーター一覧

パラメーター

データ型

値の説明

必須・任意

manager

string

マネージャーホスト名またはIPアドレスを，1〜255バイトの文字列で指定します。

必須

serviceName

string

スケジューラーサービス名を，1〜30バイトの文字列で指定します。

必須

delayedStart※

string

開始遅延を監視する方法を，定数DelayMonitorTypeに規定されている文字列定数で指定します。定数DelayMonitorTypeの詳細については，「7.4.11(1) DelayMonitorType」を参照してください。

開始遅延の監視設定を変更しない場合，このパラメーターを指定しないか，このパラメーターに「null」を指定してください。

ルートジョブネットに対して，指定できない定数を指定した場合，エラーになります。

ジョブネットが実行中の場合は，開始遅延の監視設定を変更できません。このパラメーターを指定するとエラーになります。

任意

delayedStartTime

string

開始遅延監視を始める時刻を，文字列で指定します。

パラメーターdelayedStartで開始遅延の監視設定を変更する場合は，このパラメーターを必ず指定してください。省略するとエラーになります。

パラメーターdelayedStartに「ABSOLUTE（絶対時刻）」を指定した場合は，開始遅延の監視を始める絶対時刻を，「hh:mm」の形式で指定します。

指定する時刻は，要求先JP1/AJS3 - Managerのスケジューラーサービスローカル日時で指定してください。

指定できる値を次に示します。

hh：時間を指定します。時間に指定できる値は00〜47（単位：時）です。

mm：分を指定します。分に指定できる値は00〜59（単位：分）です。

パラメーターdelayedStartに「ROOT（ルートジョブネットの開始予定時刻からの相対時刻）」，「TOP（上位ジョブネットの開始予定時刻からの相対時刻）」または「OWN（自ジョブネットの開始予定時刻からの相対時刻）」を指定した場合は，相対時刻を，「hh:mm」の形式で指定します。

指定する時刻は，要求先JP1/AJS3 - Managerのスケジューラーサービスローカル日時で指定してください。

指定できる値を次に示します。

hh：時間を指定します。時間に指定できる値は00〜47（単位：時）です。

mm：分を指定します。分に指定できる値は00〜59（単位：分）です。

ただし，00:00は指定できません。00:01〜47:59の範囲内で指定してください。

パラメーターdelayedStartを省略した場合，またはパラメーターdelayedStartに「NOT（監視しない）」を指定した場合は，このパラメーターの指定は無視されます。

任意

delayedEnd※

string

終了遅延を監視する方法を，定数DelayMonitorTypeに規定されている文字列定数で指定します。定数DelayMonitorTypeの詳細については，「7.4.11(1) DelayMonitorType」を参照してください。

終了遅延の監視設定を変更しない場合は，このパラメーターを指定しないか，このパラメーターに「null」を指定してください。

ルートジョブネットに対して，指定できない定数を指定した場合，エラーになります。

任意

delayedEndTime

string

終了遅延の監視を始める時刻を，文字列で指定します。

パラメーターdelayedEndで終了遅延の監視設定を変更する場合は，このパラメーターを必ず指定してください。省略するとエラーになります。

パラメーターdelayedEndに「ABSOLUTE（絶対時刻）」を指定した場合は，終了遅延の監視を始める絶対時刻を，「hh:mm」の形式で指定します。

指定する時刻は，要求先JP1/AJS3 - Managerのスケジューラーサービスローカル日時で指定してください。

指定できる値を次に示します。

hh：時間を指定します。時間に指定できる値は00〜47（単位：時）です。

mm：分を指定します。分に指定できる値は00〜59（単位：分）です。

パラメーターdelayedEndに「ROOT（ルートジョブネットの開始予定時刻からの相対時刻）」，「TOP（上位ジョブネットの開始予定時刻からの相対時刻）」または「OWN（自ジョブネットの開始予定時刻からの相対時刻）」を指定した場合は，相対時刻を，「hh:mm」の形式で指定します。

指定する時刻は，要求先JP1/AJS3 - Managerのスケジューラーサービスローカル日時で指定してください。

指定できる値を次に示します。

hh：時間を指定します。時間に指定できる値は00〜47（単位：時）です。

mm：分を指定します。分に指定できる値は00〜59（単位：分）です。

ただし，00:00は指定できません。00:01〜47:59の範囲内で指定してください。

パラメーターdelayedEndを省略した場合，またはパラメーターdelayedEndに「NOT（監視しない）」を指定した場合は，このパラメーターの指定は無視されます。

任意

monitoringJobnet※

string

ジョブネットの実行所要時間による終了遅延の監視方法を，定数MonitoringJobnetTypeに規定されている文字列定数で指定します。

定数MonitoringJobnetTypeの詳細については，「7.4.11(2) MonitoringJobnetType」を参照してください。

ジョブネットの実行所要時間による終了遅延の監視設定を変更しない場合は，このパラメーターを指定しないか，このパラメーターに「null」を指定してください。

任意

timeRequiredForExecution

string

ジョブネットの実行所要時間による終了遅延監視をする場合に，ジョブネットの実行所要時間を文字列で指定します。

パラメーターmonitoringJobnetでジョブネットの実行所要時間による終了監視遅延監視を変更する場合は，このパラメーターを必ず指定してください。省略するとエラーになります。

パラメーターmonitoringJobnetに「TIME_REQUIRED_FOR_EXECUTION（実行所要時間）」を指定した場合は，ジョブネットの実行所要時間を，「hh:mm」の形式で指定します。

指定できる値を次に示します。

hh：時間を指定します。時間に指定できる値は00〜47（単位：時）です。

mm：分を指定します。分に指定できる値は00〜59（単位：分）です。

ただし，00:00は指定できません。00:01〜47:59の範囲内で指定してください。

パラメーターmonitoringJobnetを省略した場合，またはパラメーターmonitoringJobnetに「NOT（監視しない）」を指定した場合は，このパラメーターの指定は無視されます。

任意

注※

開始遅延を監視する方法（delayedStart），終了遅延を監視する方法（delayedEnd），またはジョブネットの実行所要時間による終了遅延の監視方法（monitoringJobnet）のどれかを必ず指定してください。どれも指定しなかった場合（nullを指定した場合を含む）は，エラーになります。

ステータスコード

レスポンスで返却するステータスコードを次の表に示します。

ステータスコード

テキスト記述

説明

200

OK

遅延監視設定の変更が成功しました。

400

Bad Request

引数が不正です。

401

Unauthorized

認証が必要です。

403

Forbidden

実行権限がありません。

404

Not found

リソースにアクセスする権限がありません。または，リソースがありません。

409

Conflict

リクエストは現在のリソースの状態と矛盾しているため，処理を続行できません。

412

Precondition failed

Web Consoleサーバが利用できません。

500

Server-side error

Web Consoleサーバ処理エラーが発生しました。

戻り値

なし（レスポンスのメッセージボディのサイズは0バイトです）

使用例1

指定したジョブネットの遅延監視の設定を，一時的に変更するAPIの使用例を次に示します。

なお，この使用例では，遅延監視の設定を次のように変更します。

ジョブネットの開始遅延の遅延監視を，絶対時刻で08:30から開始する

ジョブネットの終了遅延の遅延監視を設定しない

ジョブネットの実行所要時間による終了遅延監視を10分とする

リクエストの例

POST /ajs/api/v1/objects/statuses/%2FJobGroup%2FJobnet:%40A100/actions/changeDelayMonitor/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "serviceName":"AJSROOT1",
    "delayedStart":"ABSOLUTE",
    "delayedStartTime":"08:30",
    "delayedEnd":"NOT",
    "monitoringJobnet":"TIME_REQUIRED_FOR_EXECUTION",
    "timeRequiredForExecution":"00:10"
  }
}

使用例2

指定したジョブネットの終了遅延の監視設定だけを一時的に変更するAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/statuses/%2FJobGroup%2FJobnet:%40A100/actions/changeDelayMonitor/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "serviceName":"AJSROOT1",
    "delayedEnd":"OWN",
    "delayedEndTime":"00:10"
  }
}

7.1.11　ジョブ状態変更API

指定したジョブの状態を変更します。

ジョブの状態変更の詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　4.5.12 ジョブの状態を変更する」を参照してください。

このAPIは，JP1/AJS3 - Web Consoleのバージョンが11-10以降のときに使用できます。バージョン情報の取得APIの戻り値（productVersionNumber）が111000以上であることを確認して，使用してください。

実行権限

ログインしたJP1ユーザーが，ジョブの状態を変更するユニットに対して，次に示すどれかのJP1権限が与えられている必要があります。

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Operator権限

リクエストの形式

リクエスト行

POST /application/component/apiVersion/objects/statuses/unitName:execID/actions/changeStatus/invoke httpVersion

メッセージボディ

{
  "parameters":{
    "manager":"マネージャーホスト名またはIPアドレス",
    "serviceName":"スケジューラーサービス名",
    "newStatus":"変更後の状態",
    "newReturnCode":"変更後の終了コード"
  }
}

APIのバージョン

v1

リソースを一意に識別する情報

リソースを一意に識別する情報を次の表に示します。

なお，パラメーターの指定に誤りがある場合，またはパラメーターを指定しなかった場合は，リソースを一意に識別できないため，ステータスコード「404」のエラーになります。

リソースを一意に識別する情報

データ型

値の説明

必須・任意

unitName

string

要求対象のユニットのユニット完全名を，1〜930バイトの文字列で指定します。

必須

execID

string

実行IDを，文字列で指定します。

指定する形式は「@[mmmm]{A〜Z}nnnn」です（例：@10A200）。

必須

パラメーター

リクエストのメッセージボディのparametersに指定するパラメーターを次の表に示します。

表7‒11　ジョブ状態変更APIのパラメーター一覧

パラメーター

データ型

値の説明

必須・任意

manager

string

マネージャーホスト名またはIPアドレスを，1〜255バイトの文字列で指定します。

必須

serviceName

string

スケジューラーサービス名を，1〜30バイトの文字列で指定します。

必須

newStatus※

string

変更後の状態を，定数ChangeStatusに規定されている文字列定数で指定します。定数ChangeStatusの詳細については，「7.4.12(1) ChangeStatus」を参照してください。

状態を変更しない場合は，このパラメーターを指定しないか，このパラメーターに「null」を指定してください。

なお，このパラメーターは，状態を変更するユニット種別によって動作が異なります。

動作を次に示します。

状態を変更するユニットのユニット種別がジョブネットコネクタの場合，「NORMAL（正常終了にする）」，「WARNING（警告検出終了にする）」または「ABNORMAL（異常検出終了にする）」のどれかを指定できます。それ以外を指定したとき，またはこのパラメーターを省略したときは，エラーになります。

状態を変更するユニットのユニット種別がイベントジョブ，カスタムイベントジョブ，アクションジョブまたはORジョブの場合，「RETURNCODE（終了コードで判定する）」は指定できません。指定するとエラーになります。

状態を変更するユニットのユニット種別が判定ジョブ，起動条件に定義したイベントジョブまたはカスタムイベントジョブの場合，このパラメーターを指定できません。指定するとエラーになります。

任意

newReturnCode※

string

変更後の終了コードを-2,147,483,648〜2,147,483,647の数字で指定します。終了コードを変更しない場合は，このパラメーターを指定しないか，このパラメーターに「null」を指定してください。

状態を変更するユニットのユニット種別がジョブネットコネクタ，起動条件に定義したイベントジョブまたはカスタムイベントジョブの場合，このパラメーターを指定できません。指定するとエラーになります。

任意

注※

変更後の状態（newStatus）と変更後の終了コード（newReturnCode）のどちらかを必ず指定してください。どちらも指定しなかった場合（nullを指定した場合を含む）は，エラーになります。

ステータスコード

レスポンスで返却するステータスコードを次の表に示します。

ステータスコード

テキスト記述

説明

200

OK

ジョブの状態変更が成功しました。

400

Bad Request

引数が不正です。

401

Unauthorized

認証が必要です。

403

Forbidden

実行権限がありません。

404

Not found

リソースにアクセスする権限がありません。または，リソースがありません。

409

Conflict

リクエストは現在のリソースの状態と矛盾しているため，処理を続行できません。

412

Precondition failed

Web Consoleサーバが利用できません。

500

Server-side error

Web Consoleサーバ処理エラーが発生しました。

戻り値

なし（レスポンスのメッセージボディのサイズは0バイトです）

使用例1

指定したジョブの状態を変更するAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/statuses/%2FJobGroup%2FJobnet%2FJob:%40A100/actions/changeStatus/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "serviceName":"AJSROOT1",
    "newStatus":"NORMAL"
  }
}

使用例2

指定したジョブの終了コードを変更するAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/statuses/%2FJobGroup%2FJobnet%2FJob:%40A100/actions/changeStatus/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "serviceName":"AJSROOT1",
    "newReturnCode":"4"
  }
}

使用例3

指定したジョブの状態と終了コードを変更するAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/statuses/%2FJobGroup%2FJobnet%2FJob:%40A100/actions/changeStatus/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "serviceName":"AJSROOT1",
    "newStatus":"ABNORMAL",
    "newReturnCode":"4"
  }
}

使用例4

指定したジョブの状態を終了コードで判定し，指定した終了コードに変更するAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/statuses/%2FJobGroup%2FJobnet%2FJob:%40A100/actions/changeStatus/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "serviceName":"AJSROOT1",
    "newStatus":"RETURNCODE",
    "newReturnCode":"99"
  }
}

7.1.12　計画一時変更（日時変更）API

指定した実行登録済みのジョブネットの実行開始予定日時を，一時的に変更します。変更した内容で実行したあとは，ジョブネットに定義されたスケジュールに従って実行します。

実行開始予定日時の一時変更の詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　4.5.3 ジョブネットの実行日時を一時変更する」を参照してください。

このAPIは，JP1/AJS3 - Web Consoleのバージョンが11-10以降のときに使用できます。バージョン情報の取得APIの戻り値（productVersionNumber）が111000以上であることを確認して，使用してください。

実行権限

ログインしたJP1ユーザーが，計画一時変更（日時変更）するユニットに対して，次に示すどれかのJP1権限が与えられている必要があります。

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Operator権限

リクエストの形式

リクエスト行

POST /application/component/apiVersion/objects/statuses/unitName:execID/actions/changeStartTime/invoke httpVersion

メッセージボディ

{
  "parameters":{
    "manager":"マネージャーホスト名またはIPアドレス",
    "serviceName":"スケジューラーサービス名",
    "kindTime":"実行開始日時の種類",
    "absoluteTime":"実行開始日時",
    "relativeSign":"実行開始日時を相対指定する場合の記号",
    "relativeDay":実行開始日時を相対指定する場合の相対日,
    "relativeTime":"実行開始日時を相対指定する場合の相対時刻",
    "pushedAhead":"開始時間を前倒しにするときの動作",
    "changeLower":"配下のジョブネットの開始日時の動作"
  }
}

APIのバージョン

v1

リソースを一意に識別する情報

リソースを一意に識別する情報を次の表に示します。

なお，パラメーターの指定に誤りがある場合，またはパラメーターを指定しなかった場合は，リソースを一意に識別できないため，ステータスコード「404」のエラーになります。

リソースを一意に識別する情報

データ型

値の説明

必須・任意

unitName

string

要求対象のユニットのユニット完全名を，1〜930バイトの文字列で指定します。

必須

execID

string

実行IDを，文字列で指定します。

指定する形式は「@[mmmm]{A〜Z}nnnn」です（例：@10A200）。

必須

パラメーター

リクエストのメッセージボディのparametersに指定するパラメーターを次の表に示します。

表7‒12　計画一時変更（日時変更）APIのパラメーター一覧

パラメーター

データ型

値の説明

必須・任意

manager

string

マネージャーホスト名またはIPアドレスを，1〜255バイトの文字列で指定します。

必須

serviceName

string

スケジューラーサービス名を，1〜30バイトの文字列で指定します。

必須

kindTime

string

実行開始日時を，絶対日時で指定するか相対日時で指定するか，定数ChangeStartTimeTypeに規定されている文字列定数で指定します。

定数ChangeStartTimeTypeの詳細については，「7.4.9(1) ChangeStartTimeType」を参照してください。

必須

absoluteTime※1

string

実行開始日時を絶対日時で指定する場合，実行開始日時を「YYYY-MM-DDThh:mm」の形式で指定します。

指定する日時は，要求先JP1/AJS3 - Managerのスケジューラーサービスローカル日時で指定してください。

指定できる値を次に示します。

YYYY：年を指定します。年に指定できる値は，次のとおりです。

JP1/AJS3 - Web Consoleのバージョンが13-00以降，かつ接続先JP1/AJS3 - Managerのバージョンが13-00以降の場合：

1994〜環境設定パラメーターSCHEDULELIMITに設定した値（単位：年）※4

上記以外の場合：

1994〜2036（単位：年）

MM：月を指定します。月に指定できる値は，01〜12（単位：月）です。

DD：日にちを指定します。日にちに指定できる値は，01〜指定した月の最終日（単位：日）です。

hh：時間を指定します。時間に指定できる値は，00〜47（単位：時）です。

mm：分を指定します。分に指定できる値は，00〜59（単位：分）です。

パラメーターkindTimeで「ABSOLUTETIME（絶対日時を指定する）」を指定した場合だけ，このパラメーターを指定できます。

パラメーターkindTimeで「RELATIVETIME（相対日時を指定する）」を指定した場合，このパラメーターの指定は無視されます。

任意

relativeSign※2

string

変更前の実行開始日時を基準に実行開始日時を相対指定する場合，変更前の実行開始日時より後ろに変更するか，前に変更するかを「+」または「-」で指定します。

+：実行開始日時を，変更前の実行開始日時より後ろに変更します。

-：実行開始日時を，変更前の実行開始日時より前に変更します。

パラメーターkindTimeで「RELATIVETIME（相対日時を指定する）」を指定した場合だけ，このパラメーターを指定できます。

パラメーターkindTimeで「ABSOLUTETIME（絶対日時を指定する）」を指定した場合，このパラメーターの指定は無視されます。

任意

relativeDay※2，※3

int

変更前の実行開始日時を基準に実行開始日時を相対指定する場合，相対日を指定します。相対日は0〜99の範囲の数値を指定します。

指定する日時は，要求先JP1/AJS3 - Managerのスケジューラーサービスローカル日時で指定してください。

パラメーターkindTimeで「RELATIVETIME（相対日時を指定する）」を指定した場合だけ，このパラメーターを指定できます。

パラメーターkindTimeで「ABSOLUTETIME（絶対日時を指定する）」を指定した場合，このパラメーターの指定は無視されます。

任意

relativeTime※2，※3

string

変更前の実行開始日時を基準に実行開始日時を相対指定する場合，相対時刻を指定します。相対時刻は「hh:mm」の形式で指定します。

指定する時刻は，要求先JP1/AJS3 - Managerのスケジューラーサービスローカル日時で指定してください。

指定できる値を次に示します。

hh：時間を指定します。時間に指定できる値は，00〜47（単位：時）です。

mm：分を指定します。分に指定できる値は，00〜59（単位：分）です。

パラメーターkindTimeで「RELATIVETIME（相対日時を指定する）」を指定した場合だけ，このパラメーターを指定できます。

パラメーターkindTimeで「ABSOLUTETIME（絶対日時を指定する）」を指定した場合，このパラメーターの指定は無視されます。

任意

pushedAhead

string

ルートジョブネットの場合で，開始時間を前倒しに変更するとき，変更前の開始時間に実行予定を追加するかどうかを，定数ChangePushedAheadTypeに規定されている文字列定数で指定します。

定数ChangePushedAheadTypeの詳細については，「7.4.9(2) ChangePushedAheadType」を参照してください。

このパラメーターを指定しなかった場合，またはこのパラメーターに「null」を指定した場合は，「ADD（次回予定追加）」が仮定されます。

このパラメーターは，計画一時変更（日時変更）するユニットが，ルートジョブネットの場合だけ有効です。ルートジョブネット以外の場合，このパラメーターの指定は無視されます。

任意

changeLower

string

指定したジョブネット配下のネストジョブネットの開始日時を連動して変更するかどうかを，定数ChangeLowerTypeに規定されている文字列定数で指定します。

定数ChangeLowerTypeの詳細については，「7.4.9(3) ChangeLowerType」を参照してください。

このパラメーターを指定しなかった場合，またはこのパラメーターに「null」を指定した場合は，「NOTSHIFT（配下のジョブネットの開始日時は変更しない）」が仮定されます。

任意

注※1

絶対日時を指定して日時変更する場合は ，パラメーターabsoluteTimeを指定してください。省略した場合（nullを指定した場合を含む），エラーになります。

注※2

相対日時を指定して日時変更する場合は，パラメーターrelativeSign，relativeDayおよびrelativeTimeをすべて指定してください。どれか一つでも省略した場合（nullを指定した場合を含む），エラーになります。

注※3

相対日時を指定して日時変更する場合は，相対日時が1分以上になるように値を指定してください。パラメーターrelativeDayに0，relativeTimeに"00:00"を指定するとエラーになります。

注※4

接続先JP1/AJS3 - Managerの環境設定パラメーターSCHEDULELIMITの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2(123) SCHEDULELIMIT」を参照してください。

また，JP1/AJS3 - Web Consoleのバージョンはバージョン情報の取得APIの戻り値（productVersionNumber）を，接続先JP1/AJS3 - Managerのバージョンは，JP1/AJS3 - Managerのプロトコルバージョンの取得APIの戻り値（protocolVersionNumber）を確認してください。

バージョン情報の取得APIの詳細については，「7.1.38 バージョン情報の取得API」を参照してください。

JP1/AJS3 - Managerのプロトコルバージョンの取得APIの詳細については，「7.1.39 JP1/AJS3 - Managerのプロトコルバージョンの取得API」を参照してください。

ステータスコード

レスポンスで返却するステータスコードを次の表に示します。

ステータスコード

テキスト記述

説明

200

OK

計画一時変更（日時変更）が成功しました。

400

Bad Request

引数が不正です。

401

Unauthorized

認証が必要です。

403

Forbidden

実行権限がありません。

404

Not found

リソースにアクセスする権限がありません。または，リソースがありません。

409

Conflict

リクエストは現在のリソースの状態と矛盾しているため，処理を続行できません。

412

Precondition failed

Web Consoleサーバが利用できません。

500

Server-side error

Web Consoleサーバ処理エラーが発生しました。

戻り値

なし（レスポンスのメッセージボディのサイズは0バイトです）

使用例1

指定したルートジョブネットの実行開始日時を，絶対日時で指定して変更するAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/statuses/%2FJobGroup%2FJobnet:%40A100/actions/changeStartTime/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "serviceName":"AJSROOT1",
    "kindTime":"ABSOLUTETIME",
    "absoluteTime":"2016-09-07T08:30",
    "pushedAhead":"ADD",
    "changeLower":"NOTSHIFT"
  }
}

使用例2

指定したネストジョブネットの実行開始日時を，相対日時で指定して変更するAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/statuses/%2FJobGroup%2FJobnet%2FNestJobnet:%40A100/actions/changeStartTime/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "serviceName":"AJSROOT1",
    "kindTime":"RELATIVETIME",
    "relativeSign":"-",
    "relativeDay":0,
    "relativeTime":"01:00",
    "changeLower":"NOTSHIFT"
  }
}

使用例3

実行予定のないネストジョブネットを指定して，実行予定を追加するAPIの使用例を次に示します。

なお，実行予定のあるネストジョブネットを指定した場合，実行開始日時が変更されることに注意してください。

リクエストの例

POST /ajs/api/v1/objects/statuses/%2FJobGroup%2FJobnet%2FNestJobnet:%40A100/actions/changeStartTime/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "serviceName":"AJSROOT1",
    "kindTime":"ABSOLUTETIME",
    "absoluteTime":"2016-09-07T08:30"
  }
}

7.1.13　計画一時変更（即時実行）API

指定した実行登録済みのジョブネットの実行スケジュールを一時的に変更し，即時実行します。変更した内容で実行したあとは，ジョブネットに定義されたスケジュールに従って実行します。

即時実行の詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　4.5.4 登録済みのジョブネットを即時実行する」を参照してください。

このAPIは，JP1/AJS3 - Web Consoleのバージョンが11-10以降のときに使用できます。バージョン情報の取得APIの戻り値（productVersionNumber）が111000以上であることを確認して，使用してください。

実行権限

ログインしたJP1ユーザーが，計画一時変更（即時実行）するユニットに対して，次に示すどれかのJP1権限が与えられている必要があります。

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Operator権限

リクエストの形式

リクエスト行

POST /application/component/apiVersion/objects/statuses/unitName:execID/actions/execImmediate/invoke httpVersion

メッセージボディ

{
  "parameters":{
    "manager":"マネージャーホスト名またはIPアドレス",
    "serviceName":"スケジューラーサービス名",
    "pushedAhead":"開始時間を前倒しにするときの動作",
    "changeLower":"配下のジョブネットの開始日時の動作"
  }
}

APIのバージョン

v1

リソースを一意に識別する情報

リソースを一意に識別する情報を次の表に示します。

なお，パラメーターの指定に誤りがある場合，またはパラメーターを指定しなかった場合は，リソースを一意に識別できないため，ステータスコード「404」のエラーになります。

リソースを一意に識別する情報

データ型

値の説明

必須・任意

unitName

string

要求対象のユニットのユニット完全名を，1〜930バイトの文字列で指定します。

必須

execID

string

実行IDを，文字列で指定します。

指定する形式は「@[mmmm]{A〜Z}nnnn」です（例：@10A200）。

必須

パラメーター

リクエストのメッセージボディのparametersに指定するパラメーターを次の表に示します。

表7‒13　計画一時変更（即時実行）APIのパラメーター一覧

パラメーター

データ型

値の説明

必須・任意

manager

string

マネージャーホスト名またはIPアドレスを，1〜255バイトの文字列で指定します。

必須

serviceName

string

スケジューラーサービス名を，1〜30バイトの文字列で指定します。

必須

pushedAhead

string

ルートジョブネットの開始時間を前倒しに変更するとき，変更前の開始時間に実行予定を追加するかどうかを，定数ChangePushedAheadTypeに規定されている文字列定数で指定します。

定数ChangePushedAheadTypeの詳細については，「7.4.9(2) ChangePushedAheadType」を参照してください。

このパラメーターを指定しなかった場合，またはこのパラメーターに「null」を指定した場合は，「ADD（次回予定追加）」が仮定されます。

このパラメーターは，計画一時変更（即時実行）するユニットがルートジョブネットの場合だけ有効です。ルートジョブネット以外の場合，このパラメーターの指定は無視されます。

任意

changeLower

string

指定したジョブネット配下のネストジョブネットの開始日時を連動して変更するかどうかを，定数ChangeLowerTypeに規定されている文字列定数で指定します。

定数ChangeLowerTypeの詳細については，「7.4.9(3) ChangeLowerType」を参照してください。

このパラメーターを指定しなかった場合，またはこのパラメーターに「null」を指定した場合は，「NOTSHIFT（配下のジョブネットの開始日時は変更しない）」が仮定されます。

任意

ステータスコード

レスポンスで返却するステータスコードを次の表に示します。

ステータスコード

テキスト記述

説明

200

OK

計画一時変更（即時実行）が成功しました。

400

Bad Request

引数が不正です。

401

Unauthorized

認証が必要です。

403

Forbidden

実行権限がありません。

404

Not found

リソースにアクセスする権限がありません。または，リソースがありません。

409

Conflict

リクエストは現在のリソースの状態と矛盾しているため，処理を続行できません。

412

Precondition failed

Web Consoleサーバが利用できません。

500

Server-side error

Web Consoleサーバ処理エラーが発生しました。

戻り値

なし（レスポンスのメッセージボディのサイズは0バイトです）

使用例

指定したジョブネットの実行スケジュールを一時的に変更し，即時実行するAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/statuses/%2FJobGroup%2FJobnet:%40A100/actions/execImmediate/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "serviceName":"AJSROOT1",
    "pushedAhead":"ADD",
    "changeLower":"NOTSHIFT"
  }
}

7.1.14　計画一時変更（実行中止）API

指定した実行登録済みのジョブネットの実行スケジュールを一時的に変更し，実行を中止します。変更した内容で実行したあとは，ジョブネットに定義されたスケジュールに従って実行します。

実行中止の詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　4.5.5 ジョブネットやジョブの実行を中止する」を参照してください。

このAPIは，JP1/AJS3 - Web Consoleのバージョンが11-10以降のときに使用できます。バージョン情報の取得APIの戻り値（productVersionNumber）が111000以上であることを確認して，使用してください。

実行権限

ログインしたJP1ユーザーが，計画一時変更（実行中止）するユニットに対して，次に示すどれかのJP1権限が与えられている必要があります。

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Operator権限

リクエストの形式

リクエスト行

POST /application/component/apiVersion/objects/statuses/unitName:execID/actions/cancelExecSchedule/invoke httpVersion

メッセージボディ

{
  "parameters":{
    "manager":"マネージャーホスト名またはIPアドレス",
    "serviceName":"スケジューラーサービス名"
  }
}

APIのバージョン

v1

リソースを一意に識別する情報

リソースを一意に識別する情報を次の表に示します。

なお，パラメーターの指定に誤りがある場合，またはパラメーターを指定しなかった場合は，リソースを一意に識別できないため，ステータスコード「404」のエラーになります。

リソースを一意に識別する情報

データ型

値の説明

必須・任意

unitName

string

要求対象のユニットのユニット完全名を，1〜930バイトの文字列で指定します。

必須

execID

string

実行IDを，文字列で指定します。

指定する形式は「@[mmmm]{A〜Z}nnnn」です（例：@10A200）。

必須

パラメーター

リクエストのメッセージボディのparametersに指定するパラメーターを次の表に示します。

表7‒14　計画一時変更（実行中止）APIのパラメーター一覧

パラメーター

データ型

値の説明

必須・任意

manager

string

マネージャーホスト名またはIPアドレスを，1〜255バイトの文字列で指定します。

必須

serviceName

string

スケジューラーサービス名を，1〜30バイトの文字列で指定します。

必須

ステータスコード

レスポンスで返却するステータスコードを次の表に示します。

ステータスコード

テキスト記述

説明

200

OK

計画一時変更（実行中止）が成功しました。

400

Bad Request

引数が不正です。

401

Unauthorized

認証が必要です。

403

Forbidden

実行権限がありません。

404

Not found

リソースにアクセスする権限がありません。または，リソースがありません。

409

Conflict

リクエストは現在のリソースの状態と矛盾しているため，処理を続行できません。

412

Precondition failed

Web Consoleサーバが利用できません。

500

Server-side error

Web Consoleサーバ処理エラーが発生しました。

戻り値

なし（レスポンスのメッセージボディのサイズは0バイトです）

使用例

指定したジョブネットの実行スケジュールを一時的に変更し，実行を中止するAPIの使用例を示します。

リクエストの例

POST /ajs/api/v1/objects/statuses/%2FJobGroup%2FJobnet:%40A100/actions/cancelExecSchedule/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "serviceName":"AJSROOT1"
  }
}

7.1.15　計画一時変更（変更解除）API

実行開始日時の一時変更，即時実行および実行中止を解除し，変更前の情報に戻します。一時変更を複数回実行した場合，最初の変更前の，一時変更していない状態に戻します。

変更解除の詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　4.5.2 ジョブネットに実行予定を追加する」，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　4.5.3 ジョブネットの実行日時を一時変更する」，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　4.5.4 登録済みのジョブネットを即時実行する」，およびマニュアル「JP1/Automatic Job Management System 3 導入ガイド　4.5.5 ジョブネットやジョブの実行を中止する」を参照してください。

このAPIは，JP1/AJS3 - Web Consoleのバージョンが11-10以降のときに使用できます。バージョン情報の取得APIの戻り値（productVersionNumber）が111000以上であることを確認して，使用してください。

実行権限

ログインしたJP1ユーザーが，計画一時変更（変更解除）するユニットに対して，次に示すどれかのJP1権限が与えられている必要があります。

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Operator権限

リクエストの形式

リクエスト行

POST /application/component/apiVersion/objects/statuses/unitName:execID/actions/restoreChangedSchedule/invoke httpVersion

メッセージボディ

{
  "parameters":{
    "manager":"マネージャーホスト名またはIPアドレス",
    "serviceName":"スケジューラーサービス名"
  }
}

APIのバージョン

v1

リソースを一意に識別する情報

リソースを一意に識別する情報を次の表に示します。

なお，パラメーターの指定に誤りがある場合，またはパラメーターを指定しなかった場合は，リソースを一意に識別できないため，ステータスコード「404」のエラーになります。

リソースを一意に識別する情報

データ型

値の説明

必須・任意

unitName

string

要求対象のユニットのユニット完全名を，1〜930バイトの文字列で指定します。

必須

execID

string

実行IDを，文字列で指定します。

指定する形式は「@[mmmm]{A〜Z}nnnn」です（例：@10A200）。

必須

パラメーター

リクエストのメッセージボディのparametersに指定するパラメーターを次の表に示します。

表7‒15　計画一時変更（変更解除）APIのパラメーター一覧

パラメーター

データ型

値の説明

必須・任意

manager

string

マネージャーホスト名またはIPアドレスを，1〜255バイトの文字列で指定します。

必須

serviceName

string

スケジューラーサービス名を，1〜30バイトの文字列で指定します。

必須

ステータスコード

レスポンスで返却するステータスコードを次の表に示します。

ステータスコード

テキスト記述

説明

200

OK

計画一時変更（変更解除）が成功しました。

400

Bad Request

引数が不正です。

401

Unauthorized

認証が必要です。

403

Forbidden

実行権限がありません。

404

Not found

リソースにアクセスする権限がありません。または，リソースがありません。

409

Conflict

リクエストは現在のリソースの状態と矛盾しているため，処理を続行できません。

412

Precondition failed

Web Consoleサーバが利用できません。

500

Server-side error

Web Consoleサーバ処理エラーが発生しました。

戻り値

なし（レスポンスのメッセージボディのサイズは0バイトです）

使用例1

ジョブネットの一時的な日時変更，即時実行および実行中止を解除し，変更前の情報に戻すAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/statuses/%2FJobGroup%2FJobnet:%40A100/actions/restoreChangedSchedule/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "serviceName":"AJSROOT1"
  }
}

使用例2

ジョブの一時的な実行中止を解除し，変更前の情報に戻すAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/statuses/%2FJobGroup%2FJobnet%2FJob:%40A100/actions/restoreChangedSchedule/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "serviceName":"AJSROOT1"
  }
}

7.1.16　中断API

指定した実行中のルートジョブネットを中断します。

中断の詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　4.5.9 実行中のジョブネットを中断する」を参照してください。

このAPIは，JP1/AJS3 - Web Consoleのバージョンが11-10以降のときに使用できます。バージョン情報の取得APIの戻り値（productVersionNumber）が111000以上であることを確認して，使用してください。

実行権限

ログインしたJP1ユーザーが，中断するユニットに対して，次に示すどれかのJP1権限が与えられている必要があります。

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Operator権限

リクエストの形式

リクエスト行

POST /application/component/apiVersion/objects/statuses/unitName:execID/actions/interrupt/invoke httpVersion

メッセージボディ

{
  "parameters":{
    "manager":"マネージャーホスト名またはIPアドレス",
    "serviceName":"スケジューラーサービス名"
  }
}

APIのバージョン

v1

リソースを一意に識別する情報

リソースを一意に識別する情報を次の表に示します。

なお，パラメーターの指定に誤りがある場合，またはパラメーターを指定しなかった場合は，リソースを一意に識別できないため，ステータスコード「404」のエラーになります。

リソースを一意に識別する情報

データ型

値の説明

必須・任意

unitName

string

要求対象のユニットのユニット完全名を，1〜930バイトの文字列で指定します。

必須

execID

string

実行IDを，文字列で指定します。

指定する形式は「@[mmmm]{A〜Z}nnnn」です（例：@10A200）。

必須

パラメーター

リクエストのメッセージボディのparametersに指定するパラメーターを次の表に示します。

表7‒16　中断APIのパラメーター一覧

パラメーター

データ型

値の説明

必須・任意

manager

string

マネージャーホスト名またはIPアドレスを，1〜255バイトの文字列で指定します。

必須

serviceName

string

スケジューラーサービス名を，1〜30バイトの文字列で指定します。

必須

ステータスコード

レスポンスで返却するステータスコードを次の表に示します。

ステータスコード

テキスト記述

説明

200

OK

中断が成功しました。

400

Bad Request

引数が不正です。

401

Unauthorized

認証が必要です。

403

Forbidden

実行権限がありません。

404

Not found

リソースにアクセスする権限がありません。または，リソースがありません。

409

Conflict

リクエストは現在のリソースの状態と矛盾しているため，処理を続行できません。

412

Precondition failed

Web Consoleサーバが利用できません。

500

Server-side error

Web Consoleサーバ処理エラーが発生しました。

戻り値

なし（レスポンスのメッセージボディのサイズは0バイトです）

使用例

指定した実行中のルートジョブネットを中断するAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/statuses/%2FJobGroup%2FJobnet:%40A100/actions/interrupt/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "serviceName":"AJSROOT1"
  }
}

7.1.17　強制終了API

指定した実行中のジョブおよびルートジョブネットを強制終了します。

強制終了の詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　4.5.10 実行中のジョブネットやジョブを強制終了する」を参照してください。

このAPIは，JP1/AJS3 - Web Consoleのバージョンが11-10以降のときに使用できます。バージョン情報の取得APIの戻り値（productVersionNumber）が111000以上であることを確認して，使用してください。

実行権限

ログインしたJP1ユーザーが，強制終了するユニットに対して，次に示すどれかのJP1権限レベルが与えられている必要があります。

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Operator権限

リクエストの形式

リクエスト行

POST /application/component/apiVersion/objects/statuses/unitName:execID/actions/kill/invoke httpVersion

メッセージボディ

{
  "parameters":{
    "manager":"マネージャーホスト名またはIPアドレス",
    "serviceName":"スケジューラーサービス名"
  }
}

APIのバージョン

v1

リソースを一意に識別する情報

リソースを一意に識別する情報を次の表に示します。

なお，パラメーターの指定に誤りがある場合，またはパラメーターを指定しなかった場合は，リソースを一意に識別できないため，ステータスコード「404」のエラーになります。

リソースを一意に識別する情報

データ型

値の説明

必須・任意

unitName

string

要求対象のユニットのユニット完全名を，1〜930バイトの文字列で指定します。

必須

execID

string

実行IDを，文字列で指定します。

指定する形式は「@[mmmm]{A〜Z}nnnn」です（例：@10A200）。

必須

パラメーター

リクエストのメッセージボディのparametersに指定するパラメーターを次の表に示します。

表7‒17　強制終了APIのパラメーター一覧

パラメーター

データ型

値の説明

必須・任意

manager

string

マネージャーホスト名またはIPアドレスを，1〜255バイトの文字列で指定します。

必須

serviceName

string

スケジューラーサービス名を，1〜30バイトの文字列で指定します。

必須

ステータスコード

レスポンスで返却するステータスコードを次の表に示します。

ステータスコード

テキスト記述

説明

200

OK

強制終了が成功しました。

400

Bad Request

引数が不正です。

401

Unauthorized

認証が必要です。

403

Forbidden

実行権限がありません。

404

Not found

リソースにアクセスする権限がありません。または，リソースがありません。

409

Conflict

リクエストは現在のリソースの状態と矛盾しているため，処理を続行できません。

412

Precondition failed

Web Consoleサーバが利用できません。

500

Server-side error

Web Consoleサーバ処理エラーが発生しました。

戻り値

なし（レスポンスのメッセージボディのサイズは0バイトです）

使用例

指定した実行中のルートジョブネットを強制終了するAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/statuses/%2FJobGroup%2FJobnet:%40A100/actions/kill/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "serviceName":"AJSROOT1"
  }
}

7.1.18　再実行API

指定したユニットを再実行します。

再実行の詳細については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　4.5.11 実行が終了したジョブネットやジョブを再実行する」を参照してください。

このAPIは，JP1/AJS3 - Web Consoleのバージョンが11-10以降のときに使用できます。バージョン情報の取得APIの戻り値（productVersionNumber）が111000以上であることを確認して，使用してください。

実行権限

ログインしたJP1ユーザーが，再実行するユニットに対して，次に示すどれかのJP1権限が与えられている必要があります。

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Operator権限

リクエストの形式

リクエスト行

POST /application/component/apiVersion/objects/statuses/unitName:execID/actions/rerun/invoke httpVersion

メッセージボディ

{
  "parameters":{
    "manager":"マネージャーホスト名またはIPアドレス",
    "serviceName":"スケジューラーサービス名",
    "rerunMethod":"再実行方法",
    "rerunOptions":["再実行オプション",...]
  }
}

APIのバージョン

v1

リソースを一意に識別する情報

リソースを一意に識別する情報を次の表に示します。

なお，パラメーターの指定に誤りがある場合，またはパラメーターを指定しなかった場合は，リソースを一意に識別できないため，ステータスコード「404」のエラーになります。

リソースを一意に識別する情報

データ型

値の説明

必須・任意

unitName

string

要求対象のユニットのユニット完全名を，1〜930バイトの文字列で指定します。

必須

execID

string

実行IDを，文字列で指定します。

指定する形式は「@[mmmm]{A〜Z}nnnn」です（例：@10A200）。

必須

パラメーター

リクエストのメッセージボディのparametersに指定するパラメーターを次の表に示します。

表7‒18　再実行APIのパラメーター一覧

パラメーター

データ型

値の説明

必須・任意

manager

string

マネージャーホスト名またはIPアドレスを，1〜255バイトの文字列で指定します。

必須

serviceName

string

スケジューラーサービス名を，1〜30バイトの文字列で指定します。

必須

rerunMethod

string

再実行方法を文字列定数で指定します。

再実行するユニットがルートジョブネットの場合は，定数RootRerunTypeに規定されている文字列定数で指定します。

定数RootRerunTypeの詳細については，「7.4.10(1) RootRerunType」を参照してください。

再実行するユニットがネストジョブネットまたはジョブの場合は，定数RerunTypeに規定されている文字列定数で指定します。

定数RerunTypeの詳細については，「7.4.10(2) RerunType」を参照してください。

ユニット種別に合った指定がされなかった場合，エラーになります。

必須

rerunOptions

string[]

再実行するユニットを保留状態にするか，異常状態の先行ユニットを警告終了にするかを，定数RerunOptionに規定されている文字列定数の配列で指定します。再実行オプションを指定しない場合は，空の文字列配列を指定します。

定数RerunOptionの詳細については，「7.4.10(3) RerunOption」を参照してください。

このパラメーターを指定しなかった場合，またはこのパラメーターに「null」を指定した場合は，再実行オプションをどれも指定していないと仮定されます。

再実行方法（rerunMethod）と同時に指定できない組み合わせの場合，またはユニット種別に合った指定がされなかった場合は，エラーになります。

任意

ステータスコード

レスポンスで返却するステータスコードを次の表に示します。

ステータスコード

テキスト記述

説明

200

OK

再実行が成功しました。

400

Bad Request

引数が不正です。

401

Unauthorized

認証が必要です。

403

Forbidden

実行権限がありません。

404

Not found

リソースにアクセスする権限がありません。または，リソースがありません。

409

Conflict

リクエストは現在のリソースの状態と矛盾しているため，処理を続行できません。

412

Precondition failed

Web Consoleサーバが利用できません。

500

Server-side error

Web Consoleサーバ処理エラーが発生しました。

戻り値

なし（レスポンスのメッセージボディのサイズは0バイトです）

使用例1

指定したルートジョブネットの先頭のジョブから再実行するAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/statuses/%2FJobGroup%2FJobnet:%40A100/actions/rerun/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "serviceName":"AJSROOT1",
    "rerunMethod":"TOP",
    "rerunOptions":[]
  }
}

使用例2

再実行オプションを指定して再実行するAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/statuses/%2FJobGroup%2FJobnet%2FJob:%40A100/actions/rerun/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "serviceName":"AJSROOT1",
    "rerunMethod":"FROM",
    "rerunOptions":["HOLD","WARNING"]
  }
}

7.1.19　待ち合わせ状態の変更API

待ち合わせ条件付きユニットと，待ち合わせ対象ユニットとの待ち合わせ状態を一時的に変更します。

待ち合わせ状態の変更の詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　2.2.5 待ち合わせ条件を使用したユニットの実行順序制御」を参照してください。

このAPIは，JP1/AJS3 - Web Consoleのバージョンが12-50以降のときに使用できます。バージョン情報の取得APIの戻り値（productVersionNumber）が125000以上であることを確認して，使用してください。

実行権限

ログインしたJP1ユーザーが，待ち合わせ状態を変更するユニットに対して，次に示すどれかのJP1権限レベルが与えられている必要があります。

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Operator権限

リクエストの形式

リクエスト行

POST /application/component/apiVersion/objects/waiting/unitName:execID/actions/changeWaiting/invoke httpVersion

メッセージボディ

{
  "parameters":{
    "manager":"マネージャーホスト名またはIPアドレス",
    "serviceName":"スケジューラーサービス名",
    "waitingTargetUnitName":"待ち合わせ対象ユニットのユニット完全名",
    "waitingStatusAction":"待ち合わせの有効化または無効化"
  }
}

APIのバージョン

v1

リソースを一意に識別する情報

リソースを一意に識別する情報を次の表に示します。

なお，パラメーターの指定に誤りがある場合，またはパラメーターを指定しなかった場合は，リソースを一意に識別できないため，ステータスコード「404」のエラーになります。

リソースを一意に識別する情報

データ型

値の説明

必須・任意

unitName

string

要求対象のユニットのユニット完全名を，1〜930バイトの文字列で指定します。

必須

execID

string

実行IDを，文字列で指定します。

指定する形式は「@[mmmm]{A〜Z}nnnn」です（例：@10A200）。

必須

パラメーター

リクエストのメッセージボディのparametersに指定するパラメーターを次の表に示します。

表7‒19　待ち合わせ状態の変更APIのパラメーター一覧

パラメーター

データ型

値の説明

必須・任意

manager

string

マネージャーホスト名またはIPアドレスを，1〜255バイトの文字列で指定します。

必須

serviceName

string

スケジューラーサービス名を，1〜30バイトの文字列で指定します。

必須

waitingTargetUnitName

string

待ち合わせ対象のユニットのユニット完全名を，1〜930バイトの文字列で指定します。

必須

waitingStatusAction

string

待ち合わせを有効にするか無効にするかを，定数WaitingStatusActionに規定されている文字列定数で指定します。定数WaitingStatusActionの詳細については「7.4.13(4) WaitingStatusAction」を参照してください。

必須

ステータスコード

レスポンスで返却するステータスコードを次の表に示します。

ステータスコード

テキスト記述

説明

200

OK

待ち合わせ状態の変更が成功しました。

400

Bad Request

引数が不正です。

401

Unauthorized

認証が必要です。

403

Forbidden

実行権限がありません。

404

Not found

リソースにアクセスする権限がありません。または，リソースがありません。

409

Conflict

リクエストは現在のリソースの状態と矛盾しているため，処理を続行できません。

412

Precondition failed

Web Consoleサーバが利用できません。

500

Server-side error

Web Consoleサーバ処理エラーが発生しました。

戻り値

なし（レスポンスのメッセージボディのサイズは0バイトです）

使用例

待ち合わせ状態を変更するAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/waiting/%2FJobGroup%2FJobnet01:%40A104/actions/changeWaiting/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-Type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "serviceName":"AJSROOT1",
    "waitingTargetUnitName":"/JobGroup/Jobnet02",
    "waitingStatusAction":"DISABLE"
  }
}

7.1.20　実行順序制御方式の変更API

ルートジョブネットの実行順序制御方式を一時的に変更します。

実行順序制御方式の詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）　2.2.4 ジョブネットコネクタを使用したルートジョブネットの実行順序制御」を参照してください。

このAPIは，JP1/AJS3 - Web Consoleのバージョンが12-50以降のときに使用できます。バージョン情報の取得APIの戻り値（productVersionNumber）が125000以上であることを確認して，使用してください。

実行権限

ログインしたJP1ユーザーが，実行順序制御方式を変更するルートジョブネットに対して，次に示すどれかのJP1権限レベルが与えられている必要があります。

JP1_AJS_Admin権限

JP1_AJS_Manager権限

JP1_AJS_Operator権限

リクエストの形式

リクエスト行

POST /application/component/apiVersion/objects/statuses/unitName:execID/actions/changeExecOrderMethod/invoke httpVersion

メッセージボディ

{
  "parameters":{
    "manager":"マネージャーホスト名またはIPアドレス",
    "serviceName":"スケジューラーサービス名",
    "execOrderMethod":"変更後の実行順序制御方式"
  }
}

APIのバージョン

v1

リソースを一意に識別する情報

リソースを一意に識別する情報を次の表に示します。

なお，パラメーターの指定に誤りがある場合，またはパラメーターを指定しなかった場合は，リソースを一意に識別できないため，ステータスコード「404」のエラーになります。

リソースを一意に識別する情報

データ型

値の説明

必須・任意

unitName

string

要求対象のユニットのユニット完全名を，1〜930バイトの文字列で指定します。

必須

execID

string

実行IDを，文字列で指定します。

指定する形式は「@[mmmm]{A〜Z}nnnn」です（例：@10A200）。

必須

パラメーター

リクエストのメッセージボディのparametersに指定するパラメーターを次の表に示します。

表7‒20　実行順序制御方式の変更APIのパラメーター一覧

パラメーター

データ型

値の説明

必須・任意

manager

string

マネージャーホスト名またはIPアドレスを，1〜255バイトの文字列で指定します。

必須

serviceName

string

スケジューラーサービス名を，1〜30バイトの文字列で指定します。

必須

execOrderMethod

string

実行順序制御方式を同期に変更するか非同期に変更するかを，定数ChangeExecOrderMethodに規定されている文字列定数で指定します。定数ChangeExecOrderMethodの詳細については「7.4.15(1) ChangeExecOrderMethod」を参照してください。

必須

ステータスコード

レスポンスで返却するステータスコードを次の表に示します。

ステータスコード

テキスト記述

説明

200

OK

実行順序制御方式の変更が成功しました。

400

Bad Request

引数が不正です。

401

Unauthorized

認証が必要です。

403

Forbidden

実行権限がありません。

404

Not found

リソースにアクセスする権限がありません。または，リソースがありません。

409

Conflict

リクエストは現在のリソースの状態と矛盾しているため，処理を続行できません。

412

Precondition failed

Web Consoleサーバが利用できません。

500

Server-side error

Web Consoleサーバ処理エラーが発生しました。

戻り値

なし（レスポンスのメッセージボディのサイズは0バイトです）

使用例

指定したルートジョブネットの実行順序制御方式を同期に変更するAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/statuses/%2FJobGroup%2FJobnet:%40A111/actions/changeExecOrderMethod/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-Type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "serviceName":"AJSROOT1",
    "execOrderMethod":"SYNC"
  }
}

7.1.21　実行エージェントの状況一覧の取得API

マネージャーホストに登録されている実行エージェントの状況一覧を取得します。

このAPIは，JP1/AJS3 - Web Consoleのバージョンが12-50以降，かつ接続先JP1/AJS3 - Managerのバージョンが12-50以降の場合だけ指定できます。バージョン情報の取得APIの戻り値（productVersionNumber）が125000以上，かつJP1/AJS3 - Managerのプロトコルバージョンの取得APIの戻り値（protocolVersionNumber）が1250以上であることを確認して，指定してください。

実行権限

ログインしたJP1ユーザーが，次に示すどれかのJP1権限レベルが与えられている必要があります。

JP1_JPQ_Admin権限

JP1_JPQ_Operator権限

JP1_JPQ_User権限

リクエストの形式

リクエスト行

GET /application/component/apiVersion/objects/execAgents/statuses?query httpVersion

APIのバージョン

v1

リソースを一意に識別する情報

なし

パラメーター

「query」に指定するパラメーターを次の表に示します。

表7‒21　実行エージェントの状況一覧の取得APIのパラメーター一覧

パラメーター

値の説明

必須・任意

manager

マネージャーホスト名またはIPアドレスを，1〜255バイトの文字列で指定します。

必須

mode

取得するモードを文字列で指定します。ここでは「agent」を指定します。

必須

ステータスコード

レスポンスで返却するステータスコードを次の表に示します。

ステータスコード

テキスト記述

説明

200

OK

実行エージェントの状況一覧の取得に成功しました。

400

Bad Request

クエリ文字列が不正です。

401

Unauthorized

認証が必要です。

403

Forbidden

実行権限がありません。

404

Not found

リソースにアクセスする権限がありません。または，リソースがありません。

412

Precondition failed

Web Consoleサーバが利用できません。

500

Server-side error

Web Consoleサーバ処理エラーが発生しました。

レスポンスの形式

レスポンスのメッセージボディ

{
  "results":[実行エージェントの操作結果オブジェクト]
}

戻り値

ステータスコードが「200」の場合，次の情報を返却します。

メンバー

データ型

説明

results

object[]

実行エージェントの操作結果オブジェクトの配列を返却します。配列の要素の0番目に，実行エージェントの状況の取得結果を格納して返却します。

また，マネージャーホスト上でコマンドが異常終了した場合は，対象処理の結果コードに「0」以外を格納し，メッセージに「KNAK3696-E」を格納して返却します。

実行エージェントの操作結果オブジェクトの詳細については，「7.3.6 実行エージェントの操作結果オブジェクト」を参照してください。

使用例

実行エージェントの状況一覧を取得するAPIの使用例を次に示します。

リクエストの例

GET /ajs/api/v1/objects/execAgents/statuses?manager=HOSTM&mode=agent HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

レスポンス（メッセージボディ）の例

{
    "results":
    [
        {
            "execAgent":"",
            "rtnCode":"0",
            "output":
            {
                "text":"",
                "serverTime":"2020-08-26T09:09:14+09:00",
                "statuses":
                [
                    {
                        "comStatus":"NOTCHECKED",
                        "conExe":5,
                        "status":"EFFECTIVE",
                        "description":"",
                        "execAgent":"@SYSTEM",
                        "execHost":"HISOL8139682",
                        "que":0,
                        "job":0,
                        "event":0
                    },
                    {
                        "comStatus":"NOTCHECKED",
                        "conExe":20,
                        "status":"BLOCKADE",
                        "description":"test",
                        "execAgent":"AGT01",
                        "execHost":"AGT01",
                        "que":0,
                        "job":0,
                        "event":0
                    }
                ],
                "definitions":null
            }
        }
    ]
}

7.1.22　実行エージェントの状況の取得API

マネージャーホストに登録されている実行エージェントの状況を取得します。

対象の実行エージェントが存在しない場合は，実行エージェントの状況の取得結果を空オブジェクト（要素数0のオブジェクト）で返却します。

このAPIは，JP1/AJS3 - Web Consoleのバージョンが12-50以降，かつ接続先JP1/AJS3 - Managerのバージョンが12-50以降の場合だけ指定できます。バージョン情報の取得APIの戻り値（productVersionNumber）が125000以上，かつJP1/AJS3 - Managerのプロトコルバージョンの取得APIの戻り値（protocolVersionNumber）が1250以上であることを確認して，指定してください。

実行権限

ログインしたJP1ユーザーが，次に示すどれかのJP1権限レベルが与えられている必要があります。

JP1_JPQ_Admin権限

JP1_JPQ_Operator権限

JP1_JPQ_User権限

リクエストの形式

リクエスト行

GET /application/component/apiVersion/objects/execAgents/statuses?query httpVersion

APIのバージョン

v1

リソースを一意に識別する情報

なし

パラメーター

「query」に指定するパラメーターを次の表に示します。

表7‒22　実行エージェントの状況の取得APIのパラメーター一覧

パラメーター

値の説明

必須・任意

manager

マネージャーホスト名またはIPアドレスを，1〜255バイトの文字列で指定します。

必須

mode

取得するモードを文字列で指定します。ここでは「agent」を指定します。

必須

execAgent

実行エージェント名を1〜255バイトの文字列で指定します。

必須

ステータスコード

レスポンスで返却するステータスコードを次の表に示します。

ステータスコード

テキスト記述

説明

200

OK

実行エージェントの状況の取得に成功しました。

400

Bad Request

クエリ文字列が不正です。

401

Unauthorized

認証が必要です。

403

Forbidden

実行権限がありません。

404

Not found

リソースにアクセスする権限がありません。または，リソースがありません。

412

Precondition failed

Web Consoleサーバが利用できません。

500

Server-side error

Web Consoleサーバ処理エラーが発生しました。

レスポンスの形式

レスポンスのメッセージボディ

{
  "results":[実行エージェントの操作結果オブジェクト]
}

戻り値

ステータスコードが「200」の場合，次の情報を返却します。

メンバー

データ型

説明

results

object[]

実行エージェントの操作結果オブジェクトの配列を返却します。配列の要素の0番目に，実行エージェントの状況の取得結果を格納して返却します。

また，マネージャーホスト上でコマンドが異常終了した場合は，対象処理の結果コードに「0」以外を格納し，メッセージに「KNAK3696-E」を格納して返却します。

実行エージェントの操作結果オブジェクトの詳細については，「7.3.6 実行エージェントの操作結果オブジェクト」を参照してください。

使用例

実行エージェントの状況を取得するAPIの使用例を次に示します。

リクエストの例

GET /ajs/api/v1/objects/execAgents/statuses?manager=HOSTM&mode=agent&execAgent=AGT01 HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

レスポンス（メッセージボディ）の例

{
    "results":
    [
        {
            "execAgent":"",
            "rtnCode":"0",
            "output":
            {
                "text":"",
                "serverTime":"2020-08-26T09:19:07+09:00",
                "statuses":
                [
                    {
                        "comStatus":"NOTCHECKED",
                        "conExe":20,
                        "status":"BLOCKADE",
                        "description":"test",
                        "execAgent":"AGT01",
                        "execHost":"AGT01",
                        "que":0,
                        "job":0,
                        "event":0
                    }
                ],
                "definitions":null
            }
        }
    ]
}

7.1.23　実行エージェントの定義の取得API

マネージャーホストに登録されている実行エージェントの定義を取得します。

このAPIは，JP1/AJS3 - Web Consoleのバージョンが12-50以降，かつ接続先JP1/AJS3 - Managerのバージョンが12-50以降の場合だけ指定できます。バージョン情報の取得APIの戻り値（productVersionNumber）が125000以上，かつJP1/AJS3 - Managerのプロトコルバージョンの取得APIの戻り値（protocolVersionNumber）が1250以上であることを確認して，指定してください。

実行権限

ログインしたJP1ユーザーが，次に示すどれかのJP1権限レベルが与えられている必要があります。

JP1_JPQ_Admin権限

JP1_JPQ_Operator権限

JP1_JPQ_User権限

リクエストの形式

リクエスト行

GET /application/component/apiVersion/objects/execAgents/definitions?query httpVersion

APIのバージョン

v1

リソースを一意に識別する情報

なし

パラメーター

「query」に指定するパラメーターを次の表に示します。

表7‒23　実行エージェントの定義の取得APIのパラメーター一覧

パラメーター

値の説明

必須・任意

manager

マネージャーホスト名またはIPアドレスを，1〜255バイトの文字列で指定します。

必須

mode

取得するモードを文字列で指定します。ここでは「agent」を指定します。

必須

execAgent

実行エージェント名を1〜255バイトの文字列で指定します。

必須

ステータスコード

レスポンスで返却するステータスコードを次の表に示します。

ステータスコード

テキスト記述

説明

200

OK

実行エージェントの定義の取得に成功しました。

400

Bad Request

クエリ文字列が不正です。

401

Unauthorized

認証が必要です。

403

Forbidden

実行権限がありません。

404

Not found

リソースにアクセスする権限がありません。または，リソースがありません。

412

Precondition failed

Web Consoleサーバが利用できません。

500

Server-side error

Web Consoleサーバ処理エラーが発生しました。

レスポンスの形式

レスポンスのメッセージボディ

{
  "results":[実行エージェントの操作結果オブジェクト]
}

戻り値

ステータスコードが「200」の場合，次の情報を返却します。

メンバー

データ型

説明

results

object[]

実行エージェントの操作結果オブジェクトの配列を返却します。配列の要素の0番目に，実行エージェントの定義情報取得結果を格納して返却します。

また，マネージャーホスト上でコマンドが異常終了した場合は，対象処理の結果コードに「0」以外を格納し，メッセージに「KNAK3696-E」を格納して返却します。

実行エージェントの操作結果オブジェクトの詳細については，「7.3.6 実行エージェントの操作結果オブジェクト」を参照してください。

使用例

実行エージェントの定義を取得するAPIの使用例を次に示します。

リクエストの例

GET /ajs/api/v1/objects/execAgents/definitions?manager=HOSTM&mode=agent&execAgent=AGT01 HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

レスポンス（メッセージボディ）の例

{
    "results":
    [
        {
            "rtnCode":"0",
            "output":
            {
                "definitions":
                [
                    {
                        "conExe":
                        [
                            "00:00-00:00=20"
                        ],
                        "status":"BLOCKADE",
                        "description":"test",
                        "execAgent":"AGT01",
                        "execHost":"AGT01"
                    }
                ],
                "statuses":null,
                "text":"",
                "serverTime":""
            },
            "execAgent":""
        }
    ]
}

7.1.24　実行エージェントの追加API

マネージャーホストに実行エージェントを追加します。

このAPIは，JP1/AJS3 - Web Consoleのバージョンが12-50以降，かつ接続先JP1/AJS3 - Managerのバージョンが12-50以降の場合だけ指定できます。バージョン情報の取得APIの戻り値（productVersionNumber）が125000以上，かつJP1/AJS3 - Managerのプロトコルバージョンの取得APIの戻り値（protocolVersionNumber）が1250以上であることを確認して，指定してください。

実行権限

ログインしたJP1ユーザーが，次に示すJP1権限レベルが与えられている必要があります。

JP1_JPQ_Admin権限

リクエストの形式

リクエスト行

POST /application/component/apiVersion/objects/execAgents httpVersion

メッセージボディ

{
  "parameters":{
    "manager":"マネージャーホスト名またはIPアドレス",
    "mode":"対象モード",
    "execAgent":"実行エージェント名",
    "execHost":"実行ホスト名",
    "timePeriods":[{
    "timePeriod":"時間帯",
    "conExe":ジョブ実行多重度
    },...],
    "status":"実行エージェントの受付配信制限の状態",
    "description":"説明文"
  }
}

APIのバージョン

v1

リソースを一意に識別する情報

なし

パラメーター

リクエストのメッセージボディのparametersに指定するパラメーターを次の表に示します。

表7‒24　実行エージェントの追加APIのパラメーター一覧

パラメーター

データ型

値の説明

必須・任意

manager

string

マネージャーホスト名またはIPアドレスを，1〜255バイトの文字列で指定します。

必須

mode

string

対象のモードを文字列で指定します。ここでは「agent」を指定します。

必須

execAgent

string

実行エージェント名を，1〜255バイトの文字列で指定します。

必須

execHost

string

ジョブの実行先ホスト名を，0〜255バイトの文字列で指定します。

ジョブの実行先ホスト名を指定しない場合は，このパラメーターを指定しないか，空文字列（0バイト）を指定してください。

任意

timePeriods

object[]

ジョブ実行多重度を，オブジェクトの配列で指定します。

ジョブ実行多重度を指定しない場合は，このパラメーターを指定しないか，空オブジェクト（要素数0のオブジェクト）または「null」を指定してください。

任意

timePeriod

string

ジョブ実行多重度を指定する時間帯を，「hh:mm-hh:mm」の形式で指定します。

指定できる値を次に示します。

hh：時間を指定します。時間に指定できる値は00〜23（単位：時）です。

mm：分を指定します。分に指定できる値は00または30（単位：分）です。

必須

conExe

long

指定した時間帯のジョブ実行多重度を，0〜4294967295の範囲の数値で指定します。

必須

status

string

実行エージェントの受付配信制限の状態を，定数ExecAgentStatusに規定した文字列定数で指定します。

定数ExecAgentStatusの詳細については，「7.4.14(1) ExecAgentStatus」を参照してください。

実行エージェントの受付配信制限の状態を指定しない場合は，このパラメーターを指定しないか，空文字列（0バイト）を指定してください。

任意

description

string

説明文を0〜80バイトの文字列で指定します。

説明文を指定しない場合，このパラメーターを指定しないか，空文字列（0バイト）を指定してください。

任意

ステータスコード

レスポンスで返却するステータスコードを次の表に示します。

ステータスコード

テキスト記述

説明

200

OK

実行エージェントの追加に成功しました。

400

Bad Request

引数が不正です。

401

Unauthorized

認証が必要です。

403

Forbidden

実行権限がありません。

404

Not found

リソースにアクセスする権限がありません。または，リソースがありません。

412

Precondition failed

Web Consoleサーバが利用できません。

500

Server-side error

Web Consoleサーバ処理エラーが発生しました。

レスポンスの形式

レスポンスのメッセージボディ

{
  "results":[実行エージェントの操作結果オブジェクト]
}

戻り値

ステータスコードが「200」の場合，次の情報を返却します。

メンバー

データ型

説明

results

object[]

実行エージェントの操作結果オブジェクトの配列を返却します。配列の要素の0番目に，実行エージェントの追加結果を格納して返却します。

また，マネージャーホスト上でコマンドが異常終了した場合は，対象処理の結果コードに「0」以外を格納し，メッセージに「KNAK3696-E」を格納して返却します。

実行エージェントの操作結果オブジェクトの詳細については，「7.3.6 実行エージェントの操作結果オブジェクト」を参照してください。

注意事項

JP1/AJS3 - Web Consoleでエラーが発生した場合でも，マネージャーホストで実行エージェントの操作に成功していることがあります。

使用例

実行エージェントを追加するAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/execAgents HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-Type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "mode":"agent",
    "execAgent":"AGT01",
    "execHost":"AGT01",
    "timePeriods":[{
      "timePeriod":"00:00-00:00",
      "conExe":20
    }],
    "status":"BLOCKADE",
    "description":"test"
  }
}

レスポンス（メッセージボディ）の例

{
    "results":
    [
        {
            "rtnCode":"0",
            "output":null,
            "execAgent":"AGT01"
        }
    ]
}

7.1.25　実行エージェントの削除API

指定した実行エージェントをマネージャーホストから削除します。同時に複数の実行エージェントを削除することもできます。

このAPIは，JP1/AJS3 - Web Consoleのバージョンが12-50以降，かつ接続先JP1/AJS3 - Managerのバージョンが12-50以降の場合だけ指定できます。バージョン情報の取得APIの戻り値（productVersionNumber）が125000以上，かつJP1/AJS3 - Managerのプロトコルバージョンの取得APIの戻り値（protocolVersionNumber）が1250以上であることを確認して，指定してください。

実行権限

ログインしたJP1ユーザーが，次に示すJP1権限レベルが与えられている必要があります。

JP1_JPQ_Admin権限

リクエストの形式

リクエスト行

POST /application/component/apiVersion/objects/execAgents/actions/delete/invoke httpVersion

メッセージボディ

{
  "parameters":{
    "manager":"マネージャーホスト名またはIPアドレス",
    "mode":"対象モード",
    "execAgents":["実行エージェント名",...]
  }
}

APIのバージョン

v1

リソースを一意に識別する情報

なし

パラメーター

リクエストのメッセージボディのparametersに指定するパラメーターを次の表に示します。

表7‒25　実行エージェントの削除APIのパラメーター一覧

パラメーター

データ型

値の説明

必須・任意

manager

string

マネージャーホスト名またはIPアドレスを，1〜255バイトの文字列で指定します。

必須

mode

string

対象のモードを文字列で指定します。ここでは「agent」を指定します。

必須

execAgents

string[]

削除する実行エージェント名を，文字列の配列で指定します。

実行エージェントは最大100個まで指定できます。

一つの実行エージェント名は，1〜255バイトの文字列で指定します。

必須

ステータスコード

レスポンスで返却するステータスコードを次の表に示します。

ステータスコード

テキスト記述

説明

200

OK

実行エージェントの削除に成功しました。

400

Bad Request

引数が不正です。

401

Unauthorized

認証が必要です。

403

Forbidden

実行権限がありません。

404

Not found

リソースにアクセスする権限がありません。または，リソースがありません。

412

Precondition failed

Web Consoleサーバが利用できません。

500

Server-side error

Web Consoleサーバ処理エラーが発生しました。

レスポンスの形式

レスポンスのメッセージボディ

{
  "results":[実行エージェントの操作結果オブジェクト,...]
}

戻り値

ステータスコードが「200」の場合，次の情報を返却します。

メンバー

データ型

説明

results

object[]

実行エージェントの操作結果オブジェクトの配列を返却します。

配列の要素数は，パラメーターexecAgentsに指定された配列の要素数と同じです。

またマネージャーホスト上でコマンドが異常終了した場合は，対象処理の結果コードに「0」以外を格納し，メッセージに「KNAK3696-E」を格納して返却します。

実行エージェントの操作結果オブジェクトの詳細については，「7.3.6 実行エージェントの操作結果オブジェクト」を参照してください。

注意事項

JP1/AJS3 - Web Consoleでエラーが発生した場合でも，マネージャーホストで実行エージェントの操作に成功していることがあります。

使用例

実行エージェントを削除するAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/execAgents/actions/delete/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-Type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "mode":"agent",
    "execAgents":["AGT01"]
  }
}

レスポンス（メッセージボディ）の例

{
    "results":
    [
        {
            "rtnCode":"0",
            "output":null,
            "execAgent":"AGT01"
        }
    ]
}

7.1.26　実行エージェントの設定変更API

マネージャーホストに設定されている実行エージェントの設定を変更します。

このAPIは，JP1/AJS3 - Web Consoleのバージョンが12-50以降，かつ接続先JP1/AJS3 - Managerのバージョンが12-50以降の場合だけ指定できます。バージョン情報の取得APIの戻り値（productVersionNumber）が125000以上，かつJP1/AJS3 - Managerのプロトコルバージョンの取得APIの戻り値（protocolVersionNumber）が1250以上であることを確認して，指定してください。

実行権限

ログインしたJP1ユーザーが，次に示すJP1権限レベルが与えられている必要があります。

JP1_JPQ_Admin権限

リクエストの形式

リクエスト行

POST /application/component/apiVersion/objects/execAgents/actions/update/invoke httpVersion

メッセージボディ

{
  "parameters":{
    "manager":"マネージャーホスト名またはIPアドレス",
    "mode":"対象モード",
    "execAgent":"実行エージェント名",
    "execHost":"実行ホスト名",
    "timePeriods":[{
    "timePeriod":"時間帯",
    "conExe":ジョブ実行多重度
    },...],
    "description":"説明文"
  }
}

APIのバージョン

v1

リソースを一意に識別する情報

なし

パラメーター

リクエストのメッセージボディのparametersに指定するパラメーターを次の表に示します。

表7‒26　実行エージェントの設定変更APIのパラメーター一覧

パラメーター

データ型

値の説明

必須・任意

manager

string

マネージャーホスト名またはIPアドレスを，1〜255バイトの文字列で指定します。

必須

mode

string

対象のモードを文字列で指定します。ここでは「agent」を指定します。

必須

execAgent

string

設定変更する実行エージェント名を，1〜255バイトの文字列で指定します。

必須

execHost※

string

ジョブの実行先ホスト名を，1〜255バイトの文字列で指定します。

ジョブの実行先ホスト名を変更しない場合は，このパラメーターを指定しないでください。

任意

timePeriods※

object[]

ジョブ実行多重度を，オブジェクトの配列で指定します。

このパラメーターを指定する場合は，一つ以上のジョブ実行多重度を指定してください。

ジョブ実行多重度を変更しない場合は，このパラメーターを指定しないでください。

任意

timePeriod

string

ジョブ実行多重度を指定する時間帯を，「hh:mm-hh:mm」形式で指定します。

指定できる値を次に示します。

hh：時間を指定します。時間に指定できる値は00〜23（単位：時）です。

mm：分を指定します。分に指定できる値は00または30（単位：分）です。

必須

conExe

long

指定した時間帯のジョブ実行多重度を，0〜4294967295の範囲の数値で指定します。

必須

description※

string

説明文を0〜80バイトの文字列で指定します。説明文を変更しない場合は，このパラメーターを指定しないでください。

任意

注※

ジョブの実行先ホスト名，ジョブ実行多重度，または説明文のどれかを必ず指定してください。

ステータスコード

レスポンスで返却するステータスコードを次の表に示します。

ステータスコード

テキスト記述

説明

200

OK

実行エージェントの設定変更に成功しました。

400

Bad Request

引数が不正です。

401

Unauthorized

認証が必要です。

403

Forbidden

実行権限がありません。

404

Not found

リソースにアクセスする権限がありません。または，リソースがありません。

412

Precondition failed

Web Consoleサーバが利用できません。

500

Server-side error

Web Consoleサーバ処理エラーが発生しました。

レスポンスの形式

レスポンスのメッセージボディ

{
  "results":[実行エージェントの操作結果オブジェクト]
}

戻り値

ステータスコードが「200」の場合，次の情報を返却します。

メンバー

データ型

説明

results

object[]

実行エージェントの操作結果オブジェクトの配列を返却します。配列の要素の0番目に，実行エージェントの設定変更結果を格納して返却します。

また，マネージャーホスト上でコマンドが異常終了した場合は，対象処理の結果コードに「0」以外を格納し，メッセージに「KNAK3696-E」を格納して返却します。

実行エージェントの操作結果オブジェクトの詳細については，「7.3.6 実行エージェントの操作結果オブジェクト」を参照してください。

注意事項

JP1/AJS3 - Web Consoleでエラーが発生した場合でも，マネージャーホストで実行エージェントの操作に成功していることがあります。

使用例

実行エージェントの設定を変更するAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/execAgents/actions/update/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-Type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "mode":"agent",
    "execAgent":"AGT01",
    "execHost":"AGT01",
    "timePeriods":[{
      "timePeriod":"00:00-00:00",
      "conExe":30
    }],
    "description":"TEST"
  }
}

レスポンス（メッセージボディ）の例

{
    "results":
    [
        {
            "rtnCode":"0",
            "output":null,
            "execAgent":"AGT01"
        }
    ]
}

7.1.27　実行エージェントの受付配信制限の状態の変更API

マネージャーホストに登録されている実行エージェントに対して，受付配信制限の状態を変更します。複数の実行エージェントを指定して変更することもできます。

このAPIは，JP1/AJS3 - Web Consoleのバージョンが12-50以降，かつ接続先JP1/AJS3 - Managerのバージョンが12-50以降の場合だけ指定できます。バージョン情報の取得APIの戻り値（productVersionNumber）が125000以上，かつJP1/AJS3 - Managerのプロトコルバージョンの取得APIの戻り値（protocolVersionNumber）が1250以上であることを確認して，指定してください。

実行権限

ログインしたJP1ユーザーが，次に示すどれかのJP1権限レベルが与えられている必要があります。

JP1_JPQ_Admin権限

JP1_JPQ_Operator権限

リクエストの形式

リクエスト行

POST /application/component/apiVersion/objects/execAgents/actions/changeStatus/invoke httpVersion

メッセージボディ

{
  "parameters":{
    "manager":"マネージャーホスト名またはIPアドレス",
    "mode":"agent",
    "status":"実行エージェントの受付配信制限の状態",
    "execAgents":["実行エージェント",...]
  }
}

APIのバージョン

v1

リソースを一意に識別する情報

なし

パラメーター

リクエストのメッセージボディのparametersに指定するパラメーターを次の表に示します。

表7‒27　実行エージェントの受付配信制限の状態の変更APIのパラメーター一覧

パラメーター

データ型

値の説明

必須・任意

manager

string

マネージャーホスト名またはIPアドレスを，1〜255バイトの文字列で指定します。

必須

mode

string

対象のモードを文字列で指定します。ここでは「agent」を指定します。

必須

status

string

実行エージェントの受付配信制限の状態を，定数ExecAgentStatusに規定した文字列定数で指定します。

定数ExecAgentStatusの詳細については，「7.4.14(1) ExecAgentStatus」を参照してください。

必須

execAgents

string[]

実行エージェント名を，文字列の配列で指定します。実行エージェントは最大100個まで指定できます。

一つの実行エージェント名は，1〜255バイトの文字列で指定します。

必須

ステータスコード

レスポンスで返却するステータスコードを次の表に示します。

ステータスコード

テキスト記述

説明

200

OK

実行エージェントの受付配信制限の状態の変更に成功しました。

400

Bad Request

引数が不正です。

401

Unauthorized

認証が必要です。

403

Forbidden

実行権限がありません。

404

Not found

リソースにアクセスする権限がありません。または，リソースがありません。

412

Precondition failed

Web Consoleサーバが利用できません。

500

Server-side error

Web Consoleサーバ処理エラーが発生しました。

レスポンスの形式

レスポンスのメッセージボディ

{
  "results":[実行エージェントの操作結果オブジェクト]
}

戻り値

ステータスコードが「200」の場合，次の情報を返却します。

メンバー

データ型

説明

results

object[]

実行エージェントの操作結果オブジェクトの配列を返却します。配列の要素数は，パラメーターexecAgentsに指定された配列の要素数と同じです。

また，マネージャーホスト上でコマンドが異常終了した場合，対象処理の結果コードに「0」以外を格納し，メッセージに「KNAK3696-E」を格納して返却します。

実行エージェントの操作結果オブジェクトの詳細については，「7.3.6 実行エージェントの操作結果オブジェクト」を参照してください。

注意事項

JP1/AJS3 - Web Consoleでエラーが発生した場合でも，マネージャーホストで実行エージェントの操作に成功していることがあります。

使用例

実行エージェントの受付配信制限の状態を変更するAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/execAgents/actions/changeStatus/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-Type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "mode":"agent",
    "status":"HOLD",
    "execAgents":["AGT01"]
  }
}

レスポンス（メッセージボディ）の例

{
    "results":
    [
        {
            "rtnCode":"0",
            "output":null,
            "execAgent":"AGT01"
        }
    ]
}

7.1.28　実行エージェントの状態の変更API

マネージャーホストに登録されている実行エージェントに対して，状態を変更します。複数の実行エージェントを指定して変更することもできます。

ジョブ配信遅延の軽減機能が有効な場合，実行エージェントの状態を変更できます。ジョブ配信遅延の軽減機能が無効な場合，返却される実行エージェントの操作結果はすべてエラーになります。

ジョブ配信遅延の軽減機能については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.5.5 ジョブ配信遅延の軽減の検討」を参照してください。

このAPIは，JP1/AJS3 - Web Consoleのバージョンが12-50以降，かつ接続先JP1/AJS3 - Managerのバージョンが12-50以降の場合だけ指定できます。バージョン情報の取得APIの戻り値（productVersionNumber）が125000以上，かつJP1/AJS3 - Managerのプロトコルバージョンの取得APIの戻り値（protocolVersionNumber）が1250以上であることを確認して，指定してください。

実行権限

ログインしたJP1ユーザーが，次に示すどれかのJP1権限レベルが与えられている必要があります。

JP1_JPQ_Admin権限

JP1_JPQ_Operator権限

リクエストの形式

リクエスト行

POST /application/component/apiVersion/objects/execAgents/actions/changeComStatus/invoke httpVersion

メッセージボディ

{
  "parameters":{
    "manager":"マネージャーホスト名またはIPアドレス",
    "comStatus":"実行エージェントの状態",
    "execAgents":["実行エージェント",...]
  }
}

APIのバージョン

v1

リソースを一意に識別する情報

なし

パラメーター

リクエストのメッセージボディのparametersに指定するパラメーターを次の表に示します。

表7‒28　実行エージェントの状態の変更APIのパラメーター一覧

パラメーター

データ型

値の説明

必須・任意

manager

string

マネージャーホスト名またはIPアドレスを，1〜255バイトの文字列で指定します。

必須

comStatus

string

実行エージェントの状態を，定数ComStatusに規定した文字列定数で指定します。

定数ComStatusの詳細については，「7.4.14(2) ComStatus」を参照してください。

必須

execAgent

string[]

実行エージェント名を，文字列の配列で指定します。実行エージェントは最大100個まで指定できます。

一つの実行エージェント名は，1〜255バイトの文字列で指定します。

必須

ステータスコード

レスポンスで返却するステータスコードを次の表に示します。

ステータスコード

テキスト記述

説明

200

OK

実行エージェントの状態の変更に成功しました。

400

Bad Request

引数が不正です。

401

Unauthorized

認証が必要です。

403

Forbidden

実行権限がありません。

404

Not found

リソースにアクセスする権限がありません。または，リソースがありません。

412

Precondition failed

Web Consoleサーバが利用できません。

500

Server-side error

Web Consoleサーバ処理エラーが発生しました。

レスポンスの形式

レスポンスのメッセージボディ

{
  "results":[実行エージェントの操作結果オブジェクト]
}

戻り値

ステータスコードが「200」の場合，次の情報を返却します。

メンバー

データ型

説明

results

object[]

実行エージェントの操作結果オブジェクトの配列を返却します。

配列の要素数は，パラメーターexecAgentsに指定された配列の要素数と同じです。

また，マネージャーホスト上でコマンドが異常終了した場合は，対象処理の結果コードに「0」以外を格納し，メッセージに「KNAK3696-E」を格納して返却します。

実行エージェントの操作結果オブジェクトの詳細については，「7.3.6 実行エージェントの操作結果オブジェクト」を参照してください。

注意事項

JP1/AJS3 - Web Consoleでエラーが発生した場合でも，マネージャーホストで実行エージェントの操作に成功していることがあります。

使用例

実行エージェントの状態を変更するAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/execAgents/actions/changeComStatus/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-Type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "comStatus":"UNAVAILABLE",
    "execAgents":["AGT01"]
  }
}

レスポンス（メッセージボディ）の例

{
    "results":
    [
        {
            "rtnCode":"0",
            "output":null,
            "execAgent":"AGT01"
        }
    ]
}

7.1.29　ジョブ配信遅延の軽減機能の通信状態確認API

マネージャーホストで，ジョブ配信遅延の軽減機能の通信状態の確認操作をします。次のうち，指定された操作をします。

通信状態の確認開始

通信状態の確認終了

通信状態の確認

ジョブ配信遅延の軽減機能が有効な場合だけ，このAPIで実行エージェントを操作できます。ジョブ配信遅延の軽減機能が無効な場合は，このAPIでの実行エージェントの操作はすべてエラーになります。

ジョブ配信遅延の軽減機能については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）　2.5.5 ジョブ配信遅延の軽減の検討」を参照してください。

このAPIは，JP1/AJS3 - Web Consoleのバージョンが12-50以降，かつ接続先JP1/AJS3 - Managerのバージョンが12-50以降の場合だけ指定できます。バージョン情報の取得APIの戻り値（productVersionNumber）が125000以上，かつJP1/AJS3 - Managerのプロトコルバージョンの取得APIの戻り値（protocolVersionNumber）が1250以上であることを確認して，指定してください。

実行権限

ログインしたJP1ユーザーが，次の管理者権限を持つOSユーザーにマッピングされている必要があります。

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

リクエストの形式

リクエスト行

POST /application/component/apiVersion/objects/execAgents/actions/check/invoke httpVersion

メッセージボディ

{
  "parameters":{
    "manager":"マネージャーホスト名またはIPアドレス",
    "action":"対象操作"
  }
}

APIのバージョン

v1

リソースを一意に識別する情報

なし

パラメーター

リクエストのメッセージボディのparametersに指定するパラメーターを次の表に示します。

表7‒29　ジョブ配信遅延の軽減機能の通信状態確認APIのパラメーター一覧

パラメーター

データ型

値の説明

任意・必須

manager

string

マネージャーホスト名またはIPアドレスを，1〜255バイトの文字列で指定します。

必須

action

string

対象の操作を文字列で指定します。

通信状態の確認開始の場合は「start」，通信状態の確認終了の場合は「stop」，通信状態の確認の場合は「status」を指定します。

必須

ステータスコード

レスポンスで返却するステータスコードを次の表に示します。

ステータスコード

テキスト記述

説明

200

OK

ジョブ配信遅延の軽減機能の通信状態確認に成功しました。

400

Bad Request

引数が不正です。

401

Unauthorized

認証が必要です。

403

Forbidden

実行権限がありません。

404

Not found

リソースにアクセスする権限がありません。または，リソースがありません。

412

Precondition failed

Web Consoleサーバが利用できません。

500

Server-side error

Web Consoleサーバ処理エラーが発生しました。

レスポンスの形式

レスポンスのメッセージボディ

{
  "results":[実行エージェントの操作結果オブジェクト]
}

戻り値

ステータスコードが「200」の場合，次の情報を返却します。

メンバー

データ型

説明

results

object[]

実行エージェントの操作結果オブジェクトの配列を返却します。配列の要素の0番目に実行結果を格納して返却します。

実行エージェントの操作結果オブジェクトの詳細については，「7.3.6 実行エージェントの操作結果オブジェクト」を参照してください。

注意事項

JP1/AJS3 - Web Consoleでエラーが発生した場合でも，マネージャーホストで実行エージェントの操作に成功していることがあります。

使用例

ジョブ配信遅延の軽減機能の通信状態を確認するAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/execAgents/actions/check/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-Type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "action":"start"
  }
}

レスポンス（メッセージボディ）の例

{
    "results":
    [
        {
            "execAgent":"",
            "rtnCode":"0",
            "output":
            {
                "text":"KNAC1200-I エージェント監視プロセスに通信状態確認開始要求を行いました",
                "serverTime":"",
                "statuses":null,
                "definitions":null
            }
        }
    ]
}

7.1.30　実行エージェントの実行状況一覧の取得API

JP1/AJS3 - Managerに登録されている実行エージェント上のジョブの実行状況を取得します。

このAPIは，JP1/AJS3 - Web Consoleのバージョンが13-50以降，かつ接続先JP1/AJS3 - Managerのバージョンが13-50 以降の場合だけ指定できます。バージョン情報の取得APIの戻り値（productVersionNumber）が135000以上，かつJP1/AJS3 - Managerのプロトコルバージョンの取得APIの戻り値（protocolVersionNumber）が1350以上であることを確認して，指定してください。

実行権限

ログインしたJP1ユーザーが，次に示すどれかのJP1権限レベルが与えられている必要があります。

JP1_JPQ_Admin権限

JP1_JPQ_Operator権限

JP1_JPQ_User権限

リクエストの形式

リクエスト行

GET /application/component/apiVersion/objects/execAgents/statuses/jobExecutionStatuses?query httpVersion

APIのバージョン

v1

リソースを一意に識別する情報

なし

パラメーター

「query」に指定するパラメーターを次の表に示します。

表7‒30　実行エージェントの実行状況一覧の取得APIのパラメーター一覧

パラメーター

値の説明

必須・任意

manager

マネージャーホスト名またはIPアドレスを，1〜255バイトの文字列で指定します。

必須

mode

取得するモードを文字列で指定します。ここでは「agent」を指定します。

必須

execAgent

実行エージェント名を1〜255バイトの文字列で指定します。

必須

ステータスコード

レスポンスで返却するステータスコードを次の表に示します。

ステータスコード

テキスト記述

説明

200

OK

実行エージェントの実行状況一覧の取得に成功しました。

400

Bad Request

クエリ文字列が不正です。

401

Unauthorized

認証が必要です。

403

Forbidden

実行権限がありません。

404

Not found

リソースにアクセスする権限がありません。または，リソースがありません。

412

Precondition failed

Web Consoleサーバが利用できません。

500

Server-side error

Web Consoleサーバ処理エラーが発生しました。

レスポンスの形式

レスポンスのメッセージボディ

{
  "results":[実行エージェントの操作結果オブジェクト]
}

戻り値

ステータスコードが「200」の場合，次の情報を返却します。

メンバー

データ型

説明

results

object[]

実行エージェントの操作結果オブジェクトの配列を返却します。配列の要素0番目に，実行エージェントの実行状況一覧の取得結果を格納して返却します。

また，マネージャーホスト上でコマンドが異常終了した場合は，対象処理の結果コードに「0」以外を格納し，メッセージに「KNAK3696-E」を格納して返却します。

実行エージェントの操作結果オブジェクトの詳細については，「7.3.6 実行エージェントの操作結果オブジェクト」を参照してください。

使用例

実行エージェントの実行状況一覧の取得APIの使用例を次に示します。

リクエストの例

GET /ajs/api/v1/objects/execAgents/statuses/jobExecutionStatuses?mode=agent&execAgent=AGTG01 HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

レスポンス（メッセージボディ）の例

{
    "results": [
        {
            "execAgent": "",
            "rtnCode": "0",
            "output": {
                "definitions": null,
                "statuses": [
                    {
                        "execAgent": "AGTG01",
                        "jobExecutionStatuses": [
                            {
                                "jobClass": "NONE",
                                "serviceName": "",
                                "unitName": "",
                                "execID": "",
                                "errorMessage": "KNAC1133-E ユニットに対する権限がありません:AJSROOT1:100:QUE"
                            },
                            {
                                "jobClass": "NONE",
                                "serviceName": "",
                                "unitName": "",
                                "execID": "",
                                "errorMessage": "KNAC1133-E ユニットに対する権限がありません:AJSROOT1:102:QUE"
                            },
                            {
                                "jobClass": "NONE",
                                "serviceName": "",
                                "unitName": "",
                                "execID": "",
                                "errorMessage": "KNAC1133-E ユニットに対する権限がありません:AJSROOT1:200:JOB"
                            },
                            {
                                "jobClass": "NONE",
                                "serviceName": "",
                                "unitName": "",
                                "execID": "",
                                "errorMessage": "KNAC1133-E ユニットに対する権限がありません:AJSROOT2:300:EVENT"
                            },
                            {
                                "jobClass": "JOB",
                                "serviceName": "AJSROOT1",
                                "unitName": "/JobgroupA/JobnetA/job1",
                                "execID": "@A102",
                                "errorMessage": ""
                            },
                            {
                                "jobClass": "JOB",
                                "serviceName": "AJSROOT1",
                                "unitName": "/Jobnet-A1/jobA",
                                "execID": "@A144",
                                "errorMessage": ""
                            },
                            {
                                "jobClass": "QUE",
                                "serviceName": "AJSROOT1",
                                "unitName": "/Jobnet1/job1",
                                "execID": "@A242",
                                "errorMessage": ""
                            },
                            {
                                "jobClass": "JOB",
                                "serviceName": "AJSROOT2",
                                "unitName": "/Jobnet-B1/job1",
                                "execID": "@A402",
                                "errorMessage": ""
                            },
                            {
                                "jobClass": "EVENT",
                                "serviceName": "AJSROOT2",
                                "unitName": "/Jobnet-B1/evjob1",
                                "execID": "@A422",
                                "errorMessage": ""
                            }
                        ]
                    }
                ],
                "text": "",
                "serverTime": "2025-04-02T17:54:33+09:00"
            }
        }
    ]
}

7.1.31　実行エージェントグループの状況一覧の取得API

マネージャーホストに登録されている実行エージェントグループの状況一覧を取得します。

このAPIは，JP1/AJS3 - Web Consoleのバージョンが12-50以降，かつ接続先JP1/AJS3 - Managerのバージョンが12-50以降の場合だけ指定できます。バージョン情報の取得APIの戻り値（productVersionNumber）が125000以上，かつJP1/AJS3 - Managerのプロトコルバージョンの取得APIの戻り値（protocolVersionNumber）が1250以上であることを確認して，指定してください。

実行権限

ログインしたJP1ユーザーが，次に示すどれかのJP1権限レベルが与えられている必要があります。

JP1_JPQ_Admin権限

JP1_JPQ_Operator権限

JP1_JPQ_User権限

リクエストの形式

リクエスト行

GET /application/component/apiVersion/objects/execAgents/statuses?query httpVersion

APIのバージョン

v1

リソースを一意に識別する情報

なし

パラメーター

「query」に指定するパラメーターを次の表に示します。

表7‒31　実行エージェントグループの状況一覧の取得APIのパラメーター一覧

パラメーター

値の説明

必須・任意

manager

マネージャーホスト名またはIPアドレスを，1〜255バイトの文字列で指定します。

必須

mode

対象のモードを文字列で指定します。ここでは「agentGroup」を指定します。

必須

ステータスコード

レスポンスで返却するステータスコードを次の表に示します。

ステータスコード

テキスト記述

説明

200

OK

実行エージェントグループの状況一覧の取得に成功しました。

400

Bad Request

クエリ文字列が不正です。

401

Unauthorized

認証が必要です。

403

Forbidden

実行権限がありません。

404

Not found

リソースにアクセスする権限がありません。または，リソースがありません。

412

Precondition failed

Web Consoleサーバが利用できません。

500

Server-side error

Web Consoleサーバ処理エラーが発生しました。

レスポンスの形式

レスポンスのメッセージボディ

{
  "results":[実行エージェントの操作結果オブジェクト]
}

戻り値

ステータスコードが「200」の場合，次の情報を返却します。

メンバー

データ型

説明

results

object[]

実行エージェントの操作結果オブジェクトの配列を返却します。配列の要素の0番目に，実行エージェントグループの状況の取得結果を格納して返却します。

また，マネージャーホスト上でコマンドが異常終了した場合は，対象処理の結果コードに「0」以外を格納し，メッセージに「KNAK3696-E」を格納して返却します。

実行エージェントの操作結果オブジェクトの詳細については，「7.3.6 実行エージェントの操作結果オブジェクト」を参照してください。

使用例

実行エージェントグループの状況一覧を取得するAPIの使用例を次に示します。

リクエストの例

GET /ajs/api/v1/objects/execAgents/statuses?manager=HOSTM&mode=agentGroup HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

レスポンス（メッセージボディ）の例

{
    "results":
    [
        {
            "execAgent":"",
            "rtnCode":"0",
            "output":
            {
                "text":"",
                "serverTime":"2020-08-25T18:53:21+09:00",
                "statuses":
                [
                    {
                        "status":"EFFECTIVE",
                        "description":"",
                        "execAgent":"AGTG01",
                        "linkAgents":
                        [
                            "AGT01:16",
                            "AGT02:10"
                        ],
                        "que":0
                    }
                ],
                "definitions":null
            }
        }
    ]
}

7.1.32　実行エージェントグループの定義の取得API

マネージャーホストに登録されている実行エージェントグループの定義を取得します。

このAPIは，JP1/AJS3 - Web Consoleのバージョンが12-50以降，かつ接続先JP1/AJS3 - Managerのバージョンが12-50以降の場合だけ指定できます。バージョン情報の取得APIの戻り値（productVersionNumber）が125000以上，かつJP1/AJS3 - Managerのプロトコルバージョンの取得APIの戻り値（protocolVersionNumber）が1250以上であることを確認して，指定してください。

実行権限

ログインしたJP1ユーザーが，次に示すどれかのJP1権限レベルが与えられている必要があります。

JP1_JPQ_Admin権限

JP1_JPQ_Operator権限

JP1_JPQ_User権限

リクエストの形式

リクエスト行

GET /application/component/apiVersion/objects/execAgents/definitions?query httpVersion

APIのバージョン

v1

リソースを一意に識別する情報

なし

パラメーター

「query」に指定するパラメーターを次の表に示します。

表7‒32　実行エージェントグループの定義の取得APIのパラメーター一覧

パラメーター

値の説明

必須・任意

manager

マネージャーホスト名またはIPアドレスを，1〜255バイトの文字列で指定します。

必須

mode

取得するモードを文字列で指定します。ここでは「agentGroup」を指定します。

必須

execAgent

実行エージェントグループ名を1〜255バイトの文字列で指定します。

必須

ステータスコード

レスポンスで返却するステータスコードを次の表に示します。

ステータスコード

テキスト記述

説明

200

OK

実行エージェントグループの定義の取得に成功しました。

400

Bad Request

クエリ文字列が不正です。

401

Unauthorized

認証が必要です。

403

Forbidden

実行権限がありません。

404

Not foun

リソースにアクセスする権限がありません。または，リソースがありません。

412

Precondition failed

Web Consoleサーバが利用できません。

500

Server-side error

Web Consoleサーバ処理エラーが発生しました。

レスポンスの形式

レスポンスのメッセージボディ

{
  "results":[実行エージェントの操作結果オブジェクト]
}

戻り値

ステータスコードが「200」の場合，次の情報を返却します。

メンバー

データ型

説明

results

object[]

実行エージェントの操作結果オブジェクトの配列を返却します。配列の要素の0番目に，実行エージェントグループの定義情報取得結果を格納して返却します。

また，マネージャーホスト上でコマンドが異常終了した場合は，対象処理の結果コードに「0」以外を格納し，メッセージに「KNAK3696-E」を格納して返却します。

実行エージェントの操作結果オブジェクトの詳細については，「7.3.6 実行エージェントの操作結果オブジェクト」を参照してください。

使用例

実行エージェントグループの定義を取得するAPIの使用例を次に示します。

リクエストの例

GET /ajs/api/v1/objects/execAgents/definitions?manager=HOSTM&mode=agentGroup&execAgent=AGTG01 HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

レスポンス（メッセージボディ）の例

{
    "results":
    [
        {
            "execAgent":"",
            "rtnCode":"0",
            "output":
            {
                "text":"",
                "serverTime":"",
                "statuses":null,
                "definitions":
                [
                    {
                        "status":"EFFECTIVE",
                        "description":"",
                        "execAgent":"AGTG01",
                        "linkAgents":
                        [
                            "AGT01:16",
                            "AGT02:10"
                        ]
                    }
                ]
            }
        }
    ]
}

7.1.33　実行エージェントグループの追加API

マネージャーホストに実行エージェントグループを追加します。

このAPIは，JP1/AJS3 - Web Consoleのバージョンが12-50以降，かつ接続先JP1/AJS3 - Managerのバージョンが12-50以降の場合だけ指定できます。バージョン情報の取得APIの戻り値（productVersionNumber）が125000以上，かつJP1/AJS3 - Managerのプロトコルバージョンの取得APIの戻り値（protocolVersionNumber）が1250以上であることを確認して，指定してください。

実行権限

ログインしたJP1ユーザーが，次に示すJP1権限レベルが与えられている必要があります。

JP1_JPQ_Admin権限

リクエストの形式

リクエスト行

POST /application/component/apiVersion/objects/execAgents httpVersion

メッセージボディ

{
  "parameters":{
    "manager":"マネージャーホスト名またはIPアドレス",
    "mode":"対象モード",
    "execAgent":"実行エージェントグループ名",
    "status":"実行エージェントグループの受付配信制限の状態",
    "description":"説明文"
  }
}

APIのバージョン

v1

リソースを一意に識別する情報

なし

パラメーター

リクエストのメッセージボディのparametersに指定するパラメーターを次の表に示します。

表7‒33　実行エージェントグループの追加APIのパラメーター一覧

パラメーター

データ型

値の説明

必須・任意

manager

string

マネージャーホスト名またはIPアドレスを，1〜255バイトの文字列で指定します。

必須

mode

string

対象のモードを文字列で指定します。ここでは「agentGroup」を指定します。

必須

execAgent

string

実行エージェントグループ名を，1〜255バイトの文字列で指定します。

必須

status

string

実行エージェントグループの受付配信制限の状態を，定数ExecAgentStatusに規定した文字列定数で指定します。

定数ExecAgentStatusの詳細については，「7.4.14(1) ExecAgentStatus」を参照してください。

実行エージェントグループの受付配信制限の状態を指定しない場合は，このパラメーターを指定しないか，空文字列（0バイト）を指定してください。

任意

description

string

説明文を0〜80バイトの文字列で指定します。

説明文を指定しない場合は，このパラメーターを指定しないか，空文字列（0バイト）を指定してください。

任意

ステータスコード

レスポンスで返却するステータスコードを次の表に示します。

ステータスコード

テキスト記述

説明

200

OK

実行エージェントグループの追加に成功しました。

400

Bad Request

引数が不正です。

401

Unauthorized

認証が必要です。

403

Forbidden

実行権限がありません。

404

Not found

リソースにアクセスする権限がありません。または，リソースがありません。

412

Precondition failed

Web Consoleサーバが利用できません。

500

Server-side error

Web Consoleサーバ処理エラーが発生しました。

レスポンスの形式

レスポンスのメッセージボディ

{
  "results":[実行エージェントの操作結果オブジェクト]
}

戻り値

ステータスコードが「200」の場合，次の情報を返却します。

メンバー

データ型

説明

results

object[]

実行エージェントの操作結果オブジェクトの配列を返却します。配列の要素の0番目に，実行エージェントグループの追加結果を格納して返却します。

また，マネージャーホスト上でコマンドが異常終了した場合は，対象処理の結果コードに「0」以外を格納し，メッセージに「KNAK3696-E」を格納して返却します。

実行エージェントの操作結果オブジェクトの詳細については，「7.3.6 実行エージェントの操作結果オブジェクト」を参照してください。

注意事項

JP1/AJS3 - Web Consoleでエラーが発生した場合でも，マネージャーホストで実行エージェントの操作に成功していることがあります。

使用例

実行エージェントグループを追加するAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/execAgents HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-Type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "mode":"agentGroup",
    "execAgent":"AGTG01",
    "status":"BLOCKADE",
    "description":"test"
  }
}

レスポンス（メッセージボディ）の例

{
    "results":
    [
        {
            "execAgent":"AGTG01",
            "rtnCode":"0",
            "output":null
        }
    ]
}

7.1.34　実行エージェントグループの削除API

指定した実行エージェントグループを，マネージャーホストから削除します。同時に複数の実行エージェントグループを削除することもできます。

このAPIは，JP1/AJS3 - Web Consoleのバージョンが12-50以降，かつ接続先JP1/AJS3 - Managerのバージョンが12-50以降の場合だけ指定できます。バージョン情報の取得APIの戻り値（productVersionNumber）が125000以上，かつJP1/AJS3 - Managerのプロトコルバージョンの取得APIの戻り値（protocolVersionNumber）が1250以上であることを確認して，指定してください。

実行権限

ログインしたJP1ユーザーが，次に示すJP1権限レベルが与えられている必要があります。

JP1_JPQ_Admin権限

リクエストの形式

リクエスト行

POST /application/component/apiVersion/objects/execAgents/actions/delete/invoke httpVersion

メッセージボディ

{
  "parameters":{
    "manager":"マネージャーホスト名またはIPアドレス",
    "mode":"対象モード",
    "execAgents":["実行エージェントグループ名",...]
  }
}

APIのバージョン

v1

リソースを一意に識別する情報

なし

パラメーター

リクエストのメッセージボディのparametersに指定するパラメーターを次の表に示します。

表7‒34　実行エージェントグループの削除APIのパラメーター一覧

パラメーター

データ型

値の説明

必須・任意

manager

string

マネージャーホスト名またはIPアドレスを，1〜255バイトの文字列で指定します。

必須

mode

string

対象のモードを文字列で指定します。ここでは「agentGroup」を指定します。

必須

execAgents

string[]

削除する実行エージェントグループ名を，文字列の配列で指定します。実行エージェントグループは最大100個まで指定できます。

一つの実行エージェントグループ名は，1〜255バイトの文字列で指定します。

必須

ステータスコード

レスポンスで返却するステータスコードを次の表に示します。

ステータスコード

テキスト記述

説明

200

OK

実行エージェントグループの削除に成功しました。

400

Bad Request

引数が不正です。

401

Unauthorized

認証が必要です。

403

Forbidden

実行権限がありません。

404

Not found

リソースにアクセスする権限がありません。または，リソースがありません。

412

Precondition failed

Web Consoleサーバが利用できません。

500

Server-side error

Web Consoleサーバ処理エラーが発生しました。

レスポンスの形式

レスポンスのメッセージボディ

{
  "results":[実行エージェントの操作結果オブジェクト,...]
}

戻り値

ステータスコードが「200」の場合，次の情報を返却します。

メンバー

データ型

説明

results

object[]

実行エージェントの操作結果オブジェクトの配列を返却します。

配列の要素数は，パラメーターexecAgentsに指定された配列の要素数と同じです。

またマネージャーホスト上でコマンドが異常終了した場合は，対象処理の結果コードに「0」以外を格納し，メッセージに「KNAK3696-E」を格納して返却します。

実行エージェントの操作結果オブジェクトの詳細については，「7.3.6 実行エージェントの操作結果オブジェクト」を参照してください。

注意事項

JP1/AJS3 - Web Consoleでエラーが発生した場合でも，マネージャーホストで実行エージェントの操作に成功していることがあります。

使用例

実行エージェントグループを削除するAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/execAgents/actions/delete/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-Type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "mode":"agentGroup",
    "execAgents":["AGTG01"]
  }
}

レスポンス（メッセージボディ）の例

{
    "results":
    [
        {
            "execAgent":"AGTG01",
            "rtnCode":"0",
            "output":null
        }
    ]
}

7.1.35　実行エージェントグループの設定変更API

マネージャーホストに設定されている実行エージェントグループの設定を変更します。

このAPIは，JP1/AJS3 - Web Consoleのバージョンが12-50以降，かつ接続先JP1/AJS3 - Managerのバージョンが12-50以降の場合だけ指定できます。バージョン情報の取得APIの戻り値（productVersionNumber）が125000以上，かつJP1/AJS3 - Managerのプロトコルバージョンの取得APIの戻り値（protocolVersionNumber）が1250以上であることを確認して，指定してください。

実行権限

ログインしたJP1ユーザーが，次に示すJP1権限レベルが与えられている必要があります。

JP1_JPQ_Admin権限

リクエストの形式

リクエスト行

POST /application/component/apiVersion/objects/execAgents/actions/update/invoke httpVersion

メッセージボディ

{
  "parameters":{
    "manager":"マネージャーホスト名またはIPアドレス",
    "mode":"対象モード",
    "execAgent":"実行エージェントグループ名",
    "description":"説明文"
  }
}

APIのバージョン

v1

リソースを一意に識別する情報

なし

パラメーター

リクエストのメッセージボディのparametersに指定するパラメーターを次の表に示します。

表7‒35　実行エージェントグループの設定変更APIのパラメーター一覧

パラメーター

データ型

値の説明

必須・任意

manager

string

マネージャーホスト名またはIPアドレスを，1〜255バイトの文字列で指定します。

必須

mode

string

対象のモードを文字列で指定します。ここでは「agentGroup」を指定します。

必須

execAgent

string

設定変更する実行エージェント名を，1〜255バイトの文字列で指定します。

必須

description

string

説明文を0〜80バイトの文字列で指定します。

必須

ステータスコード

レスポンスで返却するステータスコードを次の表に示します。

ステータスコード

テキスト記述

説明

200

OK

実行エージェントグループの設定変更に成功しました。

400

Bad Request

引数が不正です。

401

Unauthorized

認証が必要です。

403

Forbidden

実行権限がありません。

404

Not found

リソースにアクセスする権限がありません。または，リソースがありません。

412

Precondition failed

Web Consoleサーバが利用できません。

500

Server-side error

Web Consoleサーバ処理エラーが発生しました。

レスポンスの形式

レスポンスのメッセージボディ

{
  "results":[実行エージェントの操作結果オブジェクト]
}

戻り値

ステータスコードが「200」の場合，次の情報を返却します。

メンバー

データ型

説明

results

object[]

実行エージェントの操作結果オブジェクトの配列を返却します。配列の要素の0番目に，実行エージェントグループの設定変更結果を格納して返却します。

また，マネージャーホスト上でコマンドが異常終了した場合は，対象処理の結果コードに「0」以外を格納し，メッセージに「KNAK3696-E」を格納して返却します。

実行エージェントの操作結果オブジェクトの詳細については，「7.3.6 実行エージェントの操作結果オブジェクト」を参照してください。

注意事項

JP1/AJS3 - Web Consoleでエラーが発生した場合でも，マネージャーホストで実行エージェントの操作に成功していることがあります。

使用例

実行エージェントグループの設定を変更するAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/execAgents/actions/update/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-Type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "mode":"agentGroup",
    "execAgent":"AGTG01",
    "description":"TEST"
  }
}

レスポンス（メッセージボディ）の例

{
    "results":
    [
        {
            "execAgent":"AGTG01",
            "rtnCode":"0",
            "output":null
        }
    ]
}

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

マネージャーホストに登録されている実行エージェントグループに対して，受付配信制限の状態を変更します。複数の実行エージェントグループを指定して変更することもできます。

このAPIは，JP1/AJS3 - Web Consoleのバージョンが12-50以降，かつ接続先JP1/AJS3 - Managerのバージョンが12-50以降の場合だけ指定できます。バージョン情報の取得APIの戻り値（productVersionNumber）が125000以上，かつJP1/AJS3 - Managerのプロトコルバージョンの取得APIの戻り値（protocolVersionNumber）が1250以上であることを確認して，指定してください。

実行権限

ログインしたJP1ユーザーが，次に示すどれかのJP1権限レベルが与えられている必要があります。

JP1_JPQ_Admin権限

JP1_JPQ_Operator権限

リクエストの形式

リクエスト行

POST /application/component/apiVersion/objects/execAgents/actions/changeStatus/invoke httpVersion

メッセージボディ

{
  "parameters":{
    "manager":"マネージャーホスト名またはIPアドレス",
    "mode":"agentGroup",
    "status":"実行エージェントグループの受付配信制限の状態",
    "execAgents":["実行エージェントグループ名",...]
  }
}

APIのバージョン

v1

リソースを一意に識別する情報

なし

パラメーター

リクエストのメッセージボディのparametersに指定するパラメーターを次の表に示します。

表7‒36　実行エージェントグループの受付配信制限の状態の変更APIのパラメーター一覧

パラメーター

データ型

値の説明

必須・任意

manager

string

マネージャーホスト名またはIPアドレスを，1〜255バイトの文字列で指定します。

必須

mode

string

対象のモードを文字列で指定します。ここでは「agentGroup」を指定します。

必須

status

string

実行エージェントグループの受付配信制限の状態を，定数ExecAgentStatusに規定した文字列定数で指定します。

定数ExecAgentStatusの詳細については，「7.4.14(1) ExecAgentStatus」を参照してください。

必須

execAgents

string[]

実行エージェントグループ名を，文字列の配列で指定します。実行エージェントグループは最大100個まで指定できます。

一つの実行エージェントグループ名は，1〜255バイトの文字列で指定します。

必須

ステータスコード

レスポンスで返却するステータスコードを次の表に示します。

ステータスコード

テキスト記述

説明

200

OK

実行エージェントグループの受付配信制限の状態の変更に成功しました。

400

Bad Request

引数が不正です。

401

Unauthorized

認証が必要です。

403

Forbidden

実行権限がありません。

404

Not found

リソースにアクセスする権限がありません。または，リソースがありません。

412

Precondition failed

Web Consoleサーバが利用できません。

500

Server-side error

Web Consoleサーバ処理エラーが発生しました。

レスポンスの形式

レスポンスのメッセージボディ

{
  "results":[実行エージェントの操作結果オブジェクト]
}

戻り値

ステータスコードが「200」の場合，次の情報を返却します。

メンバー

データ型

説明

results

object[]

実行エージェントの操作結果オブジェクトの配列を返却します。配列の要素数は，パラメーターexecAgentsに指定された配列の要素数と同じです。

また，マネージャーホスト上でコマンドが異常終了した場合は，対象処理の結果コードに「0」以外を格納し，メッセージに「KNAK3696-E」を格納して返却します。

実行エージェントの操作結果オブジェクトの詳細については，「7.3.6 実行エージェントの操作結果オブジェクト」を参照してください。

注意事項

JP1/AJS3 - Web Consoleでエラーが発生した場合でも，マネージャーホストで実行エージェントの操作に成功していることがあります。

使用例

実行エージェントグループの受付配信制限の状態を変更するAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/execAgents/actions/changeStatus/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-Type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "mode":"agentGroup",
    "status":"HOLD",
    "execAgents":["AGTG01"]
  }
}

レスポンス（メッセージボディ）の例

{
    "results":
    [
        {
            "execAgent":"AGTG01",
            "rtnCode":"0",
            "output":null
        }
    ]
}

7.1.37　実行エージェントの除外，追加，優先順位の変更API

マネージャーホストに登録されている実行エージェントグループに対して，実行エージェントの除外，追加，または優先順位の変更をします。

このAPIは，JP1/AJS3 - Web Consoleのバージョンが12-50以降，かつ接続先JP1/AJS3 - Managerのバージョンが12-50以降の場合だけ指定できます。バージョン情報の取得APIの戻り値（productVersionNumber）が125000以上，かつJP1/AJS3 - Managerのプロトコルバージョンの取得APIの戻り値（protocolVersionNumber）が1250以上であることを確認して，指定してください。

実行権限

ログインしたJP1ユーザーが，次に示すJP1権限レベルが与えられている必要があります。

JP1_JPQ_Admin権限

リクエストの形式

リクエスト行

POST /application/component/apiVersion/objects/execAgents/actions/chengeLinkAgent/invoke httpVersion

リクエストのメッセージボディ

{
  "parameters":{
    "manager":"マネージャーホスト名またはIPアドレス",
    "execAgentGroup":"実行エージェントグループ名",
    "action":"対象の操作",
    "execAgent":"実行エージェント名",
    "priority":優先順位
  }
}

APIのバージョン

v1

リソースを一意に識別する情報

なし

パラメーター

リクエストのメッセージボディのparametersに指定するパラメーターを次の表に示します。

表7‒37　実行エージェントの除外，追加，優先順位の変更APIのパラメーター一覧

パラメーター

データ型

値の説明

必須・任意

manager

string

マネージャーホスト名またはIPアドレスを，1〜255バイトの文字列で指定します。

必須

execAgentGroup

string

実行エージェントグループ名を指定します。実行エージェントグループ名は，1〜255バイトの文字列で指定します。

必須

action

string

対象の操作を文字列で指定します。

実行エージェントの除外の場合は「remove」，実行エージェントの追加の場合は「add」，実行エージェントの優先順位の変更の場合は「changePriority」を指定します。

必須

execAgent

string

除外，追加，優先順位の変更をする実行エージェント名を，1〜255バイトの文字列で指定します。

一つの実行エージェントグループ名は，1〜255バイトの文字列で指定します。

必須

priority

int

優先順位を，1〜16の範囲の数値で指定します。

パラメーターactionに「remove」を指定した場合，または優先順位を指定しない場合はこのパラメーターを指定しないでください。

任意

ステータスコード

レスポンスで返却するステータスコードを次の表に示します。

ステータスコード

テキスト記述

説明

200

OK

実行エージェントの除外，追加，優先順位の変更に成功しました。

400

Bad Request

引数が不正です。

401

Unauthorized

認証が必要です。

403

Forbidden

実行権限がありません。

404

Not found

リソースにアクセスする権限がありません。または，リソースがありません。

412

Precondition failed

Web Consoleサーバが利用できません。

500

Server-side error

Web Consoleサーバ処理エラーが発生しました。

レスポンスの形式

レスポンスのメッセージボディ

{
  "results":[実行エージェントの操作結果オブジェクト]
}

戻り値

ステータスコードが「200」の場合，次の情報を返却します。

メンバー

データ型

説明

results

object[]

実行エージェントの操作結果オブジェクトの配列を返却します。配列の要素の0番目に操作結果を格納して返却します。

また，マネージャーホスト上でコマンドが異常終了した場合は，対象処理の結果コードに「0」以外を格納し，メッセージに「KNAK3696-E」を格納して返却します。

実行エージェントの操作結果オブジェクトの詳細については，「7.3.6 実行エージェントの操作結果オブジェクト」を参照してください。

注意事項

JP1/AJS3 - Web Consoleでエラーが発生した場合でも，マネージャーホストで実行エージェントの操作に成功していることがあります。

使用例

指定した実行エージェントグループに対して，実行エージェントを追加する場合のAPIの使用例を次に示します。

リクエストの例

POST /ajs/api/v1/objects/execAgents/actions/chengeLinkAgent/invoke HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
Content-Type: application/json
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

{
  "parameters":{
    "manager":"HOSTM",
    "execAgentGroup":"AGTG01",
    "action":"add",
    "execAgent":"AGT03",
    "priority":1
  }
}

レスポンス（メッセージボディ）の例

{
    "results":
    [
        {
            "execAgent":"AGTG01",
            "rtnCode":"0",
            "output":null
        }
    ]
}

7.1.38　バージョン情報の取得API

製品のバージョン情報を取得します。

このAPIは，次の表に示すAPIまたはパラメーターを指定するときの，JP1/AJS3 - Web Consoleの製品バージョンの判定に使用します。詳細については，各APIまたはパラメーターの説明を参照してください。

APIまたはパラメーター

参照先

ユニット一覧の取得APIの次のパラメーター

periodBegin

periodEnd

7.1.1 ユニット一覧の取得API

ユニット情報の取得API

7.1.2 ユニット情報の取得API

ユニット情報の取得APIの次のパラメーター

searchConnectInfo

待ち合わせ条件の状態一覧の取得API

7.1.4 待ち合わせ条件の状態一覧の取得API

計画実行登録APIの次のパラメーター

holding

7.1.5 計画実行登録API

確定実行登録APIの次のパラメーター

holding

startTime

passedDaemonStarts

fixedScheduleFrom

fixedScheduleTo

7.1.6 確定実行登録API

登録解除APIの次のパラメーター

begin

end

7.1.8 登録解除API

遅延監視変更API

7.1.10 遅延監視変更API

ジョブ状態変更API

7.1.11 ジョブ状態変更API

計画一時変更（日時変更）API

7.1.12 計画一時変更（日時変更）API

計画一時変更（日時変更）APIの次のパラメーター

absoluteTime

計画一時変更（即時実行）API

7.1.13 計画一時変更（即時実行）API

計画一時変更（実行中止）API

7.1.14 計画一時変更（実行中止）API

計画一時変更（変更解除）API

7.1.15 計画一時変更（変更解除）API

中断API

7.1.16 中断API

強制終了API

7.1.17 強制終了API

再実行API

7.1.18 再実行API

待ち合わせ状態の変更API

7.1.19 待ち合わせ状態の変更API

実行順序制御方式の変更API

7.1.20 実行順序制御方式の変更API

実行エージェントの状況一覧の取得API

7.1.21 実行エージェントの状況一覧の取得API

実行エージェントの状況の取得API

7.1.22 実行エージェントの状況の取得API

実行エージェントの定義の取得API

7.1.23 実行エージェントの定義の取得API

実行エージェントの追加API

7.1.24 実行エージェントの追加API

実行エージェントの削除API

7.1.25 実行エージェントの削除API

実行エージェントの設定変更API

7.1.26 実行エージェントの設定変更API

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

7.1.27 実行エージェントの受付配信制限の状態の変更API

実行エージェントの状態の変更API

7.1.28 実行エージェントの状態の変更API

ジョブ配信遅延の軽減機能の通信状態確認API

7.1.29 ジョブ配信遅延の軽減機能の通信状態確認API

実行エージェントの実行状況一覧の取得API

7.1.30 実行エージェントの実行状況一覧の取得API

実行エージェントグループの状況一覧の取得API

7.1.31 実行エージェントグループの状況一覧の取得API

実行エージェントグループの定義の取得API

7.1.32 実行エージェントグループの定義の取得API

実行エージェントグループの追加API

7.1.33 実行エージェントグループの追加API

実行エージェントグループの削除API

7.1.34 実行エージェントグループの削除API

実行エージェントグループの設定変更API

7.1.35 実行エージェントグループの設定変更API

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

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

実行エージェントの除外，追加，優先順位の変更API

7.1.37 実行エージェントの除外，追加，優先順位の変更API

JP1/AJS3 - Managerのプロトコルバージョンの取得API

7.1.39 JP1/AJS3 - Managerのプロトコルバージョンの取得API

実行権限

なし

リクエストの形式

リクエスト行

GET /application/component/apiVersion/version?query httpVersion

APIのバージョン

v1

リソースを一意に識別する情報

なし

パラメーター

「query」に指定するパラメーターを次の表に示します。

表7‒38　バージョン情報の取得APIのパラメーター一覧

パラメーター

値の説明

必須・任意

manager

マネージャーホスト名またはIPアドレスを，1〜255バイトの文字列で指定します。

必須

ステータスコード

レスポンスで返却するステータスコードを次の表に示します。

ステータスコード

テキスト記述

説明

200

OK

バージョン情報の取得に成功しました。

400

Bad Request

クエリ文字列が不正です。

401

Unauthorized

認証が必要です。

404

Not found

リソースにアクセスする権限がありません。または，リソースがありません。

412

Precondition failed

Web Consoleサーバが利用できません。

500

Server-side error

Web Consoleサーバ処理エラーが発生しました。

レスポンスの形式

レスポンスのメッセージボディ

{
  "productName":"製品名",
  "productVersion":"製品のバージョン",
  "displayProductVersion":"製品のバージョン（表示向け）",
  "productVersionNumber":製品のバージョン（数値）
}

戻り値

ステータスコードが「200」の場合，次の情報を返却します。

メンバー

データ型

説明

productName

string

製品名を返却します。

productVersion

string

製品のバージョンを「VV-RR-SS」の形式で返却します。

VV，RR，SSはそれぞれ2桁の数字を表します。

displayProductVersion

string

製品のバージョン（表示向け）を「VV-RR」，または「VV-RR-SS」の形式で返却します。

VV，RR，SSはそれぞれ2桁の数字を表します。

例えば，productVersionが「11-00-00」の場合にSSを省略して「11-00」と返却します。

productVersionNumber

int

製品のバージョンを数値で返却します。返却される数値は，製品バージョン「VV-RR-SS」に対して，「VVRRSS」の形式になります。

例えば，製品のバージョンが「11-00-06」の場合は「110006」と返却します。「11-10-00」の場合は「111000」と返却します。

このメンバーは，JP1/AJS3 - Web Consoleのバージョンが11-10以降のときに返却されます。このメンバーが返却されないとき， JP1/AJS3 - Web Consoleのバージョンは，11-10より前であると仮定してください。

使用例

製品のバージョン情報を取得するAPIの使用例を次に示します。

リクエストの例

GET /ajs/api/v1/version?manager=HOSTM HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

レスポンス（メッセージボディ）の例

{
  "productName": "Automatic Job Management System 3 - Web Console",
  "productVersion": "11-10-00",
  "displayProductVersion": "11-10",
  "productVersionNumber": 111000
}

7.1.39　JP1/AJS3 - Managerのプロトコルバージョンの取得API

接続先JP1/AJS3 - Managerのプロトコルのバージョンを取得します。

プロトコルのバージョンとは，接続先JP1/AJS3 - Managerの通信インターフェースのバージョンを表す値です。

このAPIは，次の表に示すAPIまたはパラメーターを指定するときの，接続先JP1/AJS3 - Managerのプロトコルバージョンの判定に使用します。詳細については，各APIまたはパラメーターの説明を参照してください。

APIまたはパラメーター

参照先

ユニット一覧の取得APIの次のパラメーター

periodBegin

periodEnd

7.1.1 ユニット一覧の取得API

計画実行登録APIの次のパラメーター

holding

7.1.5 計画実行登録API

確定実行登録APIの次のパラメーター

holding

passedDaemonStarts

fixedScheduleFrom

fixedScheduleTo

startTime

7.1.6 確定実行登録API

登録解除APIの次のパラメーター

begin

end

7.1.8 登録解除API

計画一時変更（日時変更）APIの次のパラメーター

absoluteTime

7.1.12 計画一時変更（日時変更）API

実行エージェントの状況一覧の取得API

7.1.21 実行エージェントの状況一覧の取得API

実行エージェントの状況の取得API

7.1.22 実行エージェントの状況の取得API

実行エージェントの定義の取得API

7.1.23 実行エージェントの定義の取得API

実行エージェントの追加API

7.1.24 実行エージェントの追加API

実行エージェントの削除API

7.1.25 実行エージェントの削除API

実行エージェントの設定変更API

7.1.26 実行エージェントの設定変更API

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

7.1.27 実行エージェントの受付配信制限の状態の変更API

実行エージェントの状態の変更API

7.1.28 実行エージェントの状態の変更API

ジョブ配信遅延の軽減機能の通信状態確認API

7.1.29 ジョブ配信遅延の軽減機能の通信状態確認API

実行エージェントの実行状況一覧の取得API

7.1.30 実行エージェントの実行状況一覧の取得API

実行エージェントグループの状況一覧の取得API

7.1.31 実行エージェントグループの状況一覧の取得API

実行エージェントグループの定義の取得API

7.1.32 実行エージェントグループの定義の取得API

実行エージェントグループの追加API

7.1.33 実行エージェントグループの追加API

実行エージェントグループの削除API

7.1.34 実行エージェントグループの削除API

実行エージェントグループの設定変更API

7.1.35 実行エージェントグループの設定変更API

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

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

実行エージェントの除外，追加，優先順位の変更API

7.1.37 実行エージェントの除外，追加，優先順位の変更API

このAPIは，JP1/AJS3 - Web Consoleのバージョンが11-10以降のときに使用できます。バージョン情報の取得APIの戻り値（productVersionNumber）が111000以上であることを確認して，使用してください。

実行権限

なし

リクエストの形式

リクエスト行

GET /application/component/apiVersion/protocolVersion?query httpVersion

APIのバージョン

v1

リソースを一意に識別する情報

なし

パラメーター

「query」に指定するパラメーターを次の表に示します。

表7‒39　JP1/AJS3 - Managerのプロトコルバージョンの取得APIのパラメーター一覧

パラメーター

データ型

値の説明

必須・任意

manager

string

マネージャーホスト名またはIPアドレスを，1〜255バイトの文字列で指定します。

必須

ステータスコード

レスポンスで返却するステータスコードを次の表に示します。

ステータスコード

テキスト記述

説明

200

OK

接続先JP1/AJS3 - Managerのプロトコルバージョンの取得が成功しました。

400

Bad Request

クエリ文字列が不正です。

401

Unauthorized

認証が必要です。

404

Not found

リソースにアクセスする権限がありません。または，リソースがありません。

412

Precondition failed

Web Consoleサーバが利用できません。

500

Server-side error

Web Consoleサーバ処理エラーが発生しました。

レスポンスの形式

レスポンスのメッセージボディ

{
  "protocolVersionNumber":接続先JP1/AJS3 - Managerのプロトコルバージョン
}

戻り値

ステータスコードが「200」の場合，次の情報を返却します。

メンバー

データ型

説明

protocolVersionNumber

int

接続先JP1/AJS3 - Managerのプロトコルのバージョンを，数値で返却します。

使用例

接続先JP1/AJS3 - Managerのプロトコルバージョンを取得するAPIの使用例を次に示します。

リクエストの例

GET /ajs/api/v1/protocolVersion?manager=HOSTM HTTP/1.1
Host: HOSTW:22252
Accept-Language: ja
X-AJS-Authorization: dXNlcjpwYXNzd29yZA==

レスポンス（メッセージボディ）の例

{
  "protocolVersionNumber":1110
}

7.2　リソースの詳細

JP1/AJS3で公開されている各リソースの形式や詳細について説明します。

7.2.1　ステータス監視のリソース

ステータス監視のリソースの詳細を次に示します。

ステータス監視リソースのAPIでの取得可否については，「付録D.1 APIで取得できるステータス監視リソースのメンバーの一覧」を参照してください。

形式

{
  "definition":ユニット定義情報オブジェクト,
  "unitStatus":ステータス情報オブジェクト,
  "release":リリース情報オブジェクト
}

メンバー

返却されるメンバーを次の表に示します。

表7‒40　ステータス監視のリソースのメンバー一覧

メンバー

データ型

説明

definition

object

ユニット定義情報オブジェクトを返却します。ユニット定義情報オブジェクトについては，「7.3.1 ユニット定義情報オブジェクト」を参照してください。

unitStatus

object

ステータス情報オブジェクトを返却します。ステータス情報オブジェクトについては，「7.3.2 ステータス情報オブジェクト」を参照してください。

情報を取得できない場合，または取得する世代がない場合は，「null」を返却します。

release

object

リリース情報オブジェクトを返却します。リリース情報オブジェクトについては，「7.3.3 リリース情報オブジェクト」を参照してください。

次の場合は「null」を返却します。

情報が取得できない場合

情報がないユニットの場合

ユニットがリリース先ジョブネットまたはその配下のユニットではない場合

7.2.2　待ち合わせのリソース

待ち合わせのリソースの詳細を次に示します。

形式

{
  "unitName":"待ち合わせ条件付きユニットのユニット完全名",
  "unitComment":"待ち合わせ条件付きユニットのコメント",
  "status":"待ち合わせ条件付きユニットの状態",
  "execId":"待ち合わせ条件付きユニットの実行ID",
  "startDelayStatus":"待ち合わせ条件付きユニットの開始遅延有無",
  "nestStartDelayStatus":"待ち合わせ条件付きユニットの配下の開始遅延有無",
  "endDelayStatus":"待ち合わせ条件付きユニットの終了遅延有無",
  "nestEndDelayStatus":"待ち合わせ条件付きユニットの配下の終了遅延有無",
  "waitMethod":"待ち合わせ方法",
  "noGenerationAction":"待ち合わせる世代がない場合",
  "unmonitoredEndedAction":"監視未起動終了の場合",
  "abnomalEndedAction":"実行世代に異常終了がある場合",
  "waitingTargetUnits":[
    {
      "unitName":"待ち合わせ対象ユニットのユニット完全名",
      "unitComment":"待ち合わせ対象ユニットのコメント",
      "status":"待ち合わせ対象ユニットの状態",
      "execId":"待ち合わせ対象ユニットの実行ID",
      "startDelayStatus":"待ち合わせ対象ユニットの開始遅延有無",
      "nestStartDelayStatus":"待ち合わせ対象ユニットの配下の開始遅延有無",
      "endDelayStatus":"待ち合わせ対象ユニットの終了遅延有無",
      "nestEndDelayStatus":"待ち合わせ対象ユニットの配下の終了遅延有無",
      "waitStatus":"待ち合わせ対象ユニットの待ち合わせ状態",
    }, ...
  ]
}

メンバー

返却されるメンバーを次の表に示します。

表7‒41　待ち合わせのリソースのメンバー一覧

メンバー

データ型

説明

unitName

string

待ち合わせ条件付きユニットのユニット完全名を1〜930バイトの文字列で返却します。

情報を取得できない場合は，長さ0バイトの文字列を返却します。

unitComment

string

待ち合わせ条件付きユニットのコメントを0〜80バイトの文字列で返却します。

情報を取得できない場合，またはユニットにコメントが定義されていない場合は，長さ0バイトの文字列を返却します。

status

string

待ち合わせ条件付きユニットの状態を，定数Statusに規定した文字列定数で返却します。

情報を取得できない場合は，「NONE（該当なし）」を返却します。定数Statusの詳細については，「7.4.1(2) Status」を参照してください。

execId

string

待ち合わせ条件付きユニットの実行IDを「@[mmmm]{A〜Z}nnnn」の形式で返却します（例：@10A200）。

情報を取得できない場合は，長さ0バイトの文字列を返却します。

startDelayStatus

string

待ち合わせ条件付きユニットの開始遅延有無を，定数DelayStartに規定した文字列定数で返却します。

情報を取得できない場合は，「NONE（該当なし）」を返却します。定数DelayStartの詳細については，「7.4.1(3) DelayStart」を参照してください。

nestStartDelayStatus

string

待ち合わせ条件付きユニットの配下の開始遅延有無を，定数DelayStartに規定した文字列定数で返却します。

情報を取得できない場合は，「NONE（該当なし）」を返却します。定数DelayStartの詳細については，「7.4.1(3) DelayStart」を参照してください。

endDelayStatus

string

待ち合わせ条件付きユニットの終了遅延有無を，定数DelayEndに規定した文字列定数で返却します。

情報を取得できない場合は，「NONE（該当せず）」を返却します。定数DelayEndの詳細については，「7.4.1(4) DelayEnd」を参照してください。

nestEndDelayStatus

string

待ち合わせ条件付きユニットの配下の終了遅延有無を，定数DelayEndに規定した文字列定数で返却します。

情報を取得できない場合は，「NONE（該当せず）」を返却します。定数DelayEndの詳細については，「7.4.1(4) DelayEnd」を参照してください。

waitMethod

string

待ち合わせ条件付きユニットに設定されている待ち合わせ条件の待ち合わせ方法を，定数WaitMethodに規定した文字列定数で返却します。

定数WaitMethodの詳細については，「7.4.13(1) WaitMethod」を参照してください。

noGenerationAction

string

待ち合わせ条件付きユニットに設定されている待ち合わせ条件の，待ち合わせる世代がない場合の動作を，定数WaitingActionに規定した文字列定数で返却します。

定数WaitingActionの詳細については，「7.4.13(2) WaitingAction」を参照してください。

unmonitoredEndedAction

string

待ち合わせ条件付きユニットに設定されている待ち合わせ条件の，監視未起動終了の場合の動作を，定数WaitingActionに規定した文字列定数で返却します。

定数WaitingActionの詳細については，「7.4.13(2) WaitingAction」を参照してください。

abnomalEndedAction

string

待ち合わせ条件付きユニットに設定されている待ち合わせ条件の，実行世代に異常終了がある場合の動作を，定数WaitingActionに規定した文字列定数で返却します。

定数WaitingActionの詳細については，「7.4.13(2) WaitingAction」を参照してください。

waitingTargetUnits

object[]

待ち合わせ条件付きユニットの待ち合わせ条件に設定されている待ち合わせ対象ユニットの情報を，オブジェクトの配列で返却します。

unitName

string

待ち合わせ条件付きユニットの待ち合わせ条件に設定されている待ち合わせ対象ユニットのユニット完全名を，1〜930バイトの文字列で返却します。

情報を取得できない場合は，長さ0バイトの文字列を返却します。

unitComment

string

待ち合わせ条件付きユニットの待ち合わせ条件に設定されている待ち合わせ対象ユニットのコメントを，0〜80バイトの文字列で返却します。

情報を取得できない場合，またはユニットにコメントが定義されていない場合は，長さ0バイトの文字列を返却します。

status

string

待ち合わせ条件付きユニットの待ち合わせ条件に設定されている待ち合わせ対象ユニットの状態を，定数Statusに規定した文字列定数で返却します。

次の場合に，「NONE（該当なし）」を返却します。

情報を取得できない場合

待ち合わせ対象ユニットが，プランニンググループの場合

定数Statusの詳細については，「7.4.1(2) Status」を参照してください。

execId

string

待ち合わせ条件付きユニットの待ち合わせ条件に設定されている待ち合わせ対象ユニットの実行IDを「@[mmmm]{A〜Z}nnnn」の形式で返却します（例：@10A200）。

次の場合に，長さ0バイトの文字列を返却します。

情報を取得できない場合

待ち合わせ対象ユニットが，プランニンググループの場合

startDelayStatus

string

待ち合わせ条件付きユニットの待ち合わせ条件に設定されている待ち合わせ対象ユニットの開始遅延有無を，定数DelayStartに規定した文字列定数で返却します。

次の場合に，「NONE（該当なし）」を返却します。

情報を取得できない場合

待ち合わせ対象ユニットが，プランニンググループの場合

定数DelayStartの詳細については，「7.4.1(3) DelayStart」を参照してください。

nestStartDelayStatus

string

待ち合わせ条件付きユニットの待ち合わせ条件に設定されている待ち合わせ対象ユニットの配下の開始遅延有無を，定数DelayStartに規定した文字列定数で返却します。

次の場合に，「NONE（該当なし）」を返却します。

情報を取得できない場合

待ち合わせ対象ユニットが，プランニンググループの場合

定数DelayStartの詳細については，「7.4.1(3) DelayStart」を参照してください。

endDelayStatus

string

待ち合わせ条件付きユニットの待ち合わせ条件に設定されている待ち合わせ対象ユニットの終了遅延有無を，定数DelayEndに規定した文字列定数で返却します。

次の場合に，「NONE（該当なし）」を返却します。

情報を取得できない場合

待ち合わせ対象ユニットが，プランニンググループの場合

定数DelayEndの詳細については，「7.4.1(4) DelayEnd」を参照してください。

nestEndDelayStatus

string

待ち合わせ条件付きユニットの待ち合わせ条件に設定されている待ち合わせ対象ユニットの配下の終了遅延有無を，定数DelayEndに規定した文字列定数で返却します。

次の場合に，「NONE（該当なし）」を返却します。

情報を取得できない場合

待ち合わせ対象ユニットが，プランニンググループの場合

定数DelayEndの詳細については，「7.4.1(4) DelayEnd」を参照してください。

waitingStatus

string

待ち合わせ条件付きユニットの待ち合わせ条件に設定されている待ち合わせ対象ユニットとの待ち合わせ状態を，定数WaitingStatusに規定した文字列定数で返却します。

定数WaitingStatusの詳細については，「7.4.13(2) WaitingAction」を参照してください。

7.3　オブジェクトの詳細

APIで公開されている各オブジェクトの形式や詳細について説明します。

7.3.1　ユニット定義情報オブジェクト

ユニット定義情報を示すオブジェクトです。

ユニット定義情報オブジェクトのAPIでの取得可否については，「付録D.2 APIで取得できるユニット定義情報オブジェクトのメンバーの一覧」を参照してください。

形式

{
  "unitName":"ユニット完全名",
  "unitComment":"ユニットのコメント",
  "unitType":"ユニット種別",
  "owner":"所有者",
  "execAgent":"実行エージェント名",
  "execFileName":"実行ファイル名またはスクリプトファイル名",
  "parameters":"パラメーター",
  "customJobType":"カスタムジョブの種別",
  "customEventJobType":"カスタムイベントジョブの種別",
  "registerStatus":"ユニットの登録状態",
  "recoveryUnit":リカバリーユニットかどうか,
  "unitID":ユニットID,
  "wait":待ち合わせ条件付きユニットかどうか,
  "jobnetReleaseUnit":ユニットがリリース登録されているかどうか,
  "jp1ResourceGroup":"JP1資源グループ名",
  "simpleUnitName":"ユニット名",
  "rootJobnetName":"ルートジョブネットのユニット完全名"
}

メンバー

返却されるメンバーを次の表に示します。

表7‒42　ユニット定義情報オブジェクトのメンバー一覧

メンバー

データ型

説明

unitName

string

ユニット完全名を1〜930バイトの文字列で返却します。情報を取得できない場合は，長さ0バイトの文字列を返却します。

unitComment

string

ユニットのコメントを0〜80バイトの文字列で返却します。情報を取得できない場合，またはユニットにコメントが定義されていない場合は，長さ0バイトの文字列を返却します。

unitType

string

ユニットの種別を，定数Typeに規定されている文字列定数で返却します。定数Typeの詳細については，「7.4.4(1) Type」を参照してください。

情報を取得できない場合は，「NONE（該当なし）」を返却します。

owner

string

ユニットに定義されている所有者名を0〜31バイトの文字列で返却します。情報を取得できない場合，またはユニットに所有者が定義されていない場合は，長さ0バイトの文字列を返却します。

execAgent

string

ユニットに定義されている実行エージェント（実行エージェント名または実行エージェントグループ名）を0〜255バイトの文字列で返却します。

情報を取得できない場合，またはユニットに実行エージェントが定義されていない場合は，長さ0バイトの文字列を返却します。

execFileName

string

ユニットに定義されている実行ファイル名またはスクリプトファイル名を0〜511バイトの文字列で返却します。

次の場合は，長さ0の文字列を返却します。

情報を取得できない場合

実行ファイル名，スクリプトファイル名が定義されていない場合

ユニットがUNIXジョブ，PCジョブ，フレキシブルジョブ，およびQUEUEジョブ以外の場合

parameters

string

PCジョブ，UNIXジョブ，フレキシブルジョブ，またはQUEUEジョブに定義されているパラメーターを0〜1,023バイトの文字列で返却します。

次の場合は，長さ0の文字列を返却します。

情報を取得できない場合

パラメーターが定義されていない場合

ユニットがUNIXジョブ，PCジョブ，フレキシブルジョブ，およびQUEUEジョブ以外の場合

customJobType

string

メンバーunitTypeの値が「CUSTOM（カスタムジョブ）」の場合，カスタムジョブの種別を文字列で返却します。カスタムジョブ種別の一覧については，表7-43を参照してください。

情報を取得できない場合，またはメンバーunitTypeの値が「CUSTOM」でない場合は，長さ0バイトの文字列を返却します。

customEventJobType

string

メンバーunitTypeの値が「EVCUSTOM（カスタムイベントジョブ）」の場合，カスタムイベントジョブの種別を文字列で返却します。カスタムイベントジョブ種別の一覧については，表7-44を参照してください。

情報を取得できない場合，またはメンバーunitTypeの値が「EVCUSTOM」でない場合は，長さ0バイトの文字列を返却します。

registerStatus

string

ユニットの実行登録状態を，定数RegisterStatusに規定されている文字列定数で返却します。定数RegisterStatusの詳細については，「7.4.4(2) RegisterStatus」を参照してください。

情報を取得できない場合は，「NONE（該当なし）」を返却します。

recoveryUnit

boolean

ユニットにリカバリー属性が設定されているかどうかを返却します。

ユニットにリカバリー属性が設定されている場合，「true」を返却します。

情報を取得できない場合，またはユニットにリカバリー属性が設定されていない場合は，「false」を返却します。

unitID

int

ユニットIDを数値で返却します。

情報を取得できない場合は，「-1」を返却します。

wait

boolean

待ち合わせ条件付きユニットかどうかを返却します。

待ち合わせ条件付きユニットの場合は，「true」を返却します。

情報を取得できない場合，または待ち合わせ条件付きユニットではない場合は，「false」を返却します。

jobnetReleaseUnit

boolean

ユニットがリリース登録されているかどうかを返却します。

リリース登録されている場合は，「true」を返却します。情報を取得できない場合，またはリリース登録されていない場合は，「false」を返却します。

jp1ResourceGroup

string

ユニットに定義されているJP1資源グループ名を0〜63バイトの文字列で返却します。

情報を取得できない場合，またはユニットにJP1資源グループが定義されていない場合は，長さ0バイトの文字列を返却します。

simpleUnitName

string

ユニット名を1〜30バイトの文字列で返却します。情報を取得できない場合は，長さ0バイトの文字列を返却します。

rootJobnetName

string

ルートジョブネットのユニット完全名を1〜930バイトの文字列で返却します。

情報を取得できない場合は，長さ0バイトの文字列を返却します。

表7‒43　 カスタムジョブの種別の一覧

カテゴリ

説明

標準カスタムジョブ

CUSTOM_PC_ADSHPC

CUSTOM_PC_ADSHAPPEXEC

CUSTOM_PC_ADSHUX

CUSTOM_PC_COSMNGAP

CUSTOM_PC_COSMNGSV

CUSTOM_PC_CPALINK

CUSTOM_PC_DHAJEL

CUSTOM_PC_DHAJEW

CUSTOM_PC_JP1AMOAP

CUSTOM_PC_JP1AMR3

CUSTOM_PC_JP1AMR3BW

CUSTOM_PC_JP1AMR3CP

CUSTOM_PC_JP1AMR3UX

CUSTOM_PC_JP1AMR3BWUX

CUSTOM_PC_JP1AMR3CPUX

CUSTOM_PC_JP1FTP

CUSTOM_PC_JP1SOVAR

CUSTOM_PC_OAP_JOB

CUSTOM_PC_R3_JOB

CUSTOM_UX_JP1AMOAP

CUSTOM_UX_JP1AMR3

CUSTOM_UX_JP1AMR3BW

CUSTOM_UX_JP1AMR3CP

CUSTOM_UX_JP1FTP

ユーザーカスタムジョブ

カスタムPCジョブ

CUSTOM_PC_USER_クラス名

カスタムUNIXジョブ

CUSTOM_UX_USER_クラス名

注

クラス名はJP1/AJS3が連携するプログラムごとに異なります。詳細については，マニュアル「JP1/Automatic Job Management System 3 操作ガイド　12.13.2 ［カスタムジョブ登録情報］ダイアログボックス」を参照してください。

表7‒44　カスタムイベントジョブの種別の一覧

カテゴリ

説明

カスタムイベントジョブ

CE_任意の名称※

注※

連携プログラムが定義する名称です。詳細は各連携プログラムのマニュアルを参照してください。

7.3.2　ステータス情報オブジェクト

ユニットのステータス情報を示すオブジェクトです。

ステータス情報オブジェクトのAPIでの取得可否については，「付録D.3 APIで取得できるステータス情報オブジェクトのメンバーの一覧」を参照してください。

形式

{
  "unitName":"ユニット完全名",
  "execID":"実行ID",
  "status":"状態",
  "schStartTime":"開始予定日時",
  "startTime":"開始日時",
  "reStartTime":"再実行開始日時",
  "endTime":"終了日時",
  "startDelayStatus":"開始遅延有無",
  "nestStartDelayStatus":"ユニット配下の開始遅延有無",
  "endDelayStatus":"終了遅延有無",
  "nestEndDelayStatus":"ユニット配下の終了遅延有無",
  "startDelayTime":"開始遅延日時",
  "endDelayTime":"終了遅延日時",
  "changeType":"計画一時変更の有無",
  "holdAttr":"保留属性",
  "registerTime":"ジョブ登録日時",
  "jobNumber":ジョブ番号,
  "retCode":"終了コード",
  "execHost":"実行ホスト名",
  "simpleUnitName":"ユニット名",
  "waiting":"成立していない待ち合わせ条件の有無",
  "delayedStart":"開始遅延を監視する方法",
  "delayedStartTime":"開始遅延の監視を始める時刻",
  "delayedEnd":"終了遅延を監視する方法",
  "delayedEndTime":"終了遅延の監視を始める時刻",
  "monitoringJobnet":"ジョブネットの実行所要時間による終了遅延の監視方法",
  "timeRequiredForExecution":"ジョブネットの実行所要時間"
  "destHostName":"接続先ホスト名",
  "destServiceName":"接続先スケジューラーサービス名",
  "destUnitName":"接続先ユニット名",
  "destExecID":"接続先実行ID",
  "srcHostName":"接続元ホスト名",
  "srcServiceName":"接続元スケジューラーサービス名",
  "srcUnitName":"接続元ユニット名",
  "srcExecID":"接続元実行ID",
  "execOrderMethod":"実行順序制御方式"
}

メンバー

返却されるメンバーを次の表に示します。

表7‒45　ステータス情報オブジェクトのメンバー一覧

メンバー

データ型

説明

unitName

string

ユニット完全名を1〜930バイトの文字列で返却します。

情報を取得できない場合は，長さ0バイトの文字列を返却します。

execID

string

実行IDを「@[mmmm]{A〜Z}nnnn」の形式で返却します（例：@10A200）。

情報を取得できない場合は，長さ0バイトの文字列を返却します。

status

string

ユニットの状態を，定数Statusに規定されている文字列定数で返却します。定数Statusの詳細については，「7.4.1(2) Status」を参照してください。

情報を取得できない場合は，「NONE（該当なし）」を返却します。

schStartTime

string

開始予定日時を返却します。開始予定日時は，1970年1月1日0時0分0秒からの経過時間（秒単位）が，次のISO 8601形式に変換されます。

「YYYY-MM-DDThh:mm:ssTZD」

ISO 8601形式の詳細については，「6.3 APIで利用できるデータ型」を参照してください。

情報を取得できない場合は，長さ0バイトの文字列を返却します。

startTime

string

開始日時を返却します。開始日時は，1970年1月1日0時0分0秒からの経過時間（秒単位）が，次のISO 8601形式に変換されます。

「YYYY-MM-DDThh:mm:ssTZD」

ISO 8601形式の詳細については，「6.3 APIで利用できるデータ型」を参照してください。

情報を取得できない場合は，長さ0バイトの文字列を返却します。

reStartTime

string

再実行開始日時を返却します。再実行開始日時は，1970年1月1日0時0分0秒からの経過時間（秒単位）が，次のISO 8601形式に変換されます。

「YYYY-MM-DDThh:mm:ssTZD」

ISO 8601形式の詳細については，「6.3 APIで利用できるデータ型」を参照してください。

情報を取得できない場合は，長さ0バイトの文字列を返却します。

endTime

string

終了日時を返却します。終了日時は，1970年1月1日0時0分0秒からの経過時間（秒単位）が，次のISO 8601形式に変換されます。

「YYYY-MM-DDThh:mm:ssTZD」

ISO 8601形式の詳細については，「6.3 APIで利用できるデータ型」を参照してください。

情報を取得できない場合は，長さ0バイトの文字列を返却します。

startDelayStatus

string

このユニットの開始遅延の有無を，定数DelayStartに規定されている文字列定数で返却します。定数DelayStartの詳細については，「7.4.1(3) DelayStart」を参照してください。

情報を取得できない場合は，「NONE（該当なし）」を返却します。

nestStartDelayStatus

string

このユニットの配下の開始遅延の有無を，定数DelayStartに規定されている文字列定数で返却します。定数DelayStartの詳細については，「7.4.1(3) DelayStart」を参照してください。

情報を取得できない場合は，「NONE（該当なし）」を返却します。

endDelayStatus

string

このユニットの終了遅延の有無を，定数Delayendに規定されている文字列定数で返却します。定数DelayEndの詳細については，「7.4.1(4) DelayEnd」を参照してください。

情報を取得できない場合は，「NONE（該当なし）」を返却します。

nestEndDelayStatus

string

このユニットの配下の終了遅延の有無を，定数Delayendに規定されている文字列定数で返却します。定数DelayEndの詳細については，「7.4.1(4) DelayEnd」を参照してください。

情報を取得できない場合は，「NONE（該当なし）」を返却します。

startDelayTime

string

開始遅延日時を返却します。開始遅延日時は，1970年1月1日0時0分0秒からの経過時間（秒単位）が，次のISO 8601形式に変換されます。

「YYYY-MM-DDThh:mm:ssTZD」

ISO 8601形式の詳細については，「6.3 APIで利用できるデータ型」を参照してください。

情報を取得できない場合は，長さ0バイトの文字列を返却します。

endDelayTime

string

終了遅延日時を返却します。終了遅延日時は，1970年1月1日0時0分0秒からの経過時間（秒単位）が，次のISO 8601形式に変換されます。

「YYYY-MM-DDThh:mm:ssTZD」

ISO 8601形式の詳細については，「6.3 APIで利用できるデータ型」を参照してください。

情報を取得できない場合は，長さ0バイトの文字列を返却します。

changeType

string

計画一時変更の有無を，定数ChangeTypeに規定されている文字列定数で返却します。定数ChangeTypeの詳細については，「7.4.5(1) ChangeType」を参照してください。

情報を取得できない場合は，「NONE（該当なし）」を返却します。

holdAttr

string

保留属性を，定数HoldAttrに規定されている文字列定数で返却します。定数HoldAttrの詳細については，「7.4.5(2) HoldAttr」を参照してください。

情報を取得できない場合は，「NONE（該当なし）」を返却します。

registerTime

string

ジョブ登録日時を返却します。ジョブ登録日時は，1970年1月1日0時0分0秒からの経過時間（秒単位）が，次のISO 8601形式に変換されます。

「YYYY-MM-DDThh:mm:ssTZD」

ISO 8601形式の詳細については，「6.3 APIで利用できるデータ型」を参照してください。

情報を取得できない場合は，長さ0バイトの文字列を返却します。

jobNumber

int

ジョブ番号を数値で返却します。

情報を取得できない場合，または情報がないユニットの場合は，「-1」を返却します。

retCode

string

終了コードを文字列で返却します。

情報を取得できない場合，または情報がないユニットの場合は，長さ0バイトの文字列を返却します。

execHost

string

実行ホスト名を0〜255バイトの文字列で返却します。

情報を取得できない場合，またはユニットが開始していない場合は，長さ0バイトの文字列を返却します。

simpleUnitName

string

ユニット名を0〜30バイトの文字列で返却します。

情報を取得できない場合は，長さ0バイトの文字列を返却します。

waiting

string

成立していない待ち合わせ条件の有無を，定数Waitingに規定した文字列定数で返却します。

情報を取得できない場合は，「NONE（該当なし）」を返却します。定数Waitingの詳細については，「7.4.5(4) Waiting」を参照してください。

delayedStart

string

開始遅延を監視する方法を，定数DelayMonitorに規定されている文字列で返却します。

情報を取得できない場合は，「NONE（該当せず）」を返却します。定数DelayMonitorの詳細については，「7.4.5(5) DelayMonitor」を参照してください。

delayedStartTime

string

開始遅延の監視を始める時刻を返却します。

メンバーdelayedStartで取得した定数DelayMonitorによって，次に示すとおりに返却します。

定数DelayMonitorが「ABSOLUTE」の場合

開始遅延の監視を始める時刻を「hh:mm」の形式で返却します。

hh：時間を00〜47（単位：時）で返却します。

mm：分を00〜59（単位：分）で返却します。

定数DelayMonitorが「ROOT」，「TOP」，または「OWN」の場合

開始遅延の監視を始める相対時刻（単位：分）を1〜2879の数字で返却します。

定数DelayMonitorが「ABSOLUTE」，「ROOT」，「TOP」，または「OWN」以外の場合

長さ0バイトの文字列を返却します。

delayedEnd

string

終了遅延を監視する方法を，定数DelayMonitorに規定されている文字列で返却します。

情報を取得できない場合は，「NONE（該当せず）」を返却します。定数DelayMonitorの詳細については，「7.4.5(5) DelayMonitor」を参照してください。

delayedEndTime

string

終了遅延の監視を始める時刻を返却します。

メンバーdelayedEndで取得した定数DelayMonitorによって，次に示すとおりに返却します。

定数DelayMonitorが「ABSOLUTE」の場合

開始遅延の監視を始める時刻を「hh:mm」の形式で返却します。

hh：時間を00〜47（単位：時）で返却します。

mm：分を00〜59（単位：分）で返却します。

定数DelayMonitorが「ROOT」，「TOP」，または「OWN」の場合

開始遅延の監視を始める相対時刻（単位：分）を1〜2879の数字で返却します。

定数DelayMonitorが「ABSOLUTE」，「ROOT」，「TOP」，または「OWN」以外の場合

長さ0バイトの文字列を返却します。

monitoringJobnet

string

ジョブネットの実行所要時間による終了遅延の監視方法を，定数MonitoringJobnetに規定されている文字列で返却します。

情報を取得できない場合は，「NONE（該当せず）」を返却します。定数MonitoringJobnetの詳細については，「7.4.5(6) MonitoringJobnet」を参照してください。

timeRequiredForExecution

string

ジョブネットの実行所要時間を返却します。

メンバーmonitoringJobnetで取得した定数MonitoringJobnetによって，次に示すとおりに返却します。

定数MonitoringJobnetが「TIME_REQUIRED_FOR_EXECUTION_YES」の場合

ジョブネットの実行所要時間（単位：分）を1〜2879の数字で返却します。

定数MonitoringJobnetが「TIME_REQUIRED_FOR_EXECUTION_YES」以外の場合

長さ0バイトの文字列を返却します。

情報を取得できない場合

長さ0バイトの文字列を返却します。

destHostName

string

パラメーターsearchConnectInfoで「YES（接続情報を取得する）」の指定がある場合，接続先ホスト名を1〜255バイトの文字列で返却します。

次の場合に，長さ0バイトの文字列を返却します。

指定したユニットのユニット種別が，ジョブネットコネクタではない場合

パラメーターsearchConnectInfoで「NO（接続情報を取得しない）」の指定がある場合

destServiceName

string

パラメーターsearchConnectInfoで「YES（接続情報を取得する）」の指定がある場合，接続先スケジューラーサービス名を1〜30バイトの文字列で返却します。

次の場合に，長さ0バイトの文字列を返却します。

指定したユニットのユニット種別が，ジョブネットコネクタではない場合

パラメーターsearchConnectInfoで「NO（接続情報を取得しない）」の指定がある場合

destUnitName

string

パラメーターsearchConnectInfoで「YES（接続情報を取得する）」の指定がある場合，接続先ユニット完全名を0〜930バイトの文字列で返却します。

次の場合に，長さ0バイトの文字列を返却します。

指定したユニットのユニット種別が，ジョブネットコネクタではない場合

パラメーターsearchConnectInfoで「NO（接続情報を取得しない）」の指定がある場合

destExecID

string

パラメーターsearchConnectInfoで「YES（接続情報を取得する）」の指定がある場合，接続先の実行IDを「@[mmmm]{A〜Z}nnnn」の形式で返却します（例：@10A200）。

次の場合に，長さ0バイトの文字列を返却します。

接続先実行IDがない場合

指定したユニットのユニット種別が，ジョブネットコネクタではない場合

接続相手のユニットが次のとき

・接続相手のユニットが存在しないとき

・接続相手のユニット種別が不正のとき

・接続ユニット名が空のとき

パラメーターsearchConnectInfoで「NO（接続情報を取得しない）」の指定がある場合

別のスケジューラーサービス認証時にエラーになり，実行IDが取得できない場合，「-2」の文字列を返却します。

「-2」以外の理由で，接続情報取得でエラーになった場合，「-1」の文字列を返却します。

srcHostName

string

パラメーターsearchConnectInfoで「YES（接続情報を取得する）」の指定がある場合，接続元ホスト名を1〜255バイトの文字列で返却します。

次の場合に，長さ0バイトの文字列を返却します。

指定したユニットのユニット種別が，ルートジョブネットではない場合

実行順序制御を「しない」に設定している場合

パラメーターsearchConnectInfoで「NO（接続情報を取得しない）」の指定があるとき

srcServiceName

string

パラメーターsearchConnectInfoで「YES（接続情報を取得する）」の指定がある場合，接続元スケジューラーサービス名を1〜30バイトの文字列で返却します。

次の場合に，長さ0バイトの文字列を返却します。

指定したユニットのユニット種別が，ルートジョブネットではない場合

実行順序制御を「しない」に設定している場合

パラメーターsearchConnectInfoで「NO（接続情報を取得しない）」の指定があるとき

srcUnitName

string

パラメーターsearchConnectInfoで「YES（接続情報を取得する）」の指定がある場合，接続元ユニット完全名を0〜930バイトの文字列で返却します。

次の場合に，長さ0バイトの文字列を返却します。

指定したユニットのユニット種別が，ルートジョブネットではない場合

実行順序制御を「しない」に設定している場合

パラメーターsearchConnectInfoで「NO（接続情報を取得しない）」の指定があるとき

srcExecID

string

パラメーターsearchConnectInfoで「YES（接続情報を取得する）」の指定がある場合，接続元の実行IDを「@[mmmm]{A〜Z}nnnn」の形式で返却します（例：@10A200）。

次の場合に，長さ0バイトの文字列を返却します。

接続元実行IDがない場合

指定したユニットのユニット種別が，ルートジョブネットではない場合

接続相手のユニットが次の場合

・接続相手のユニットが存在しないとき

・接続相手のユニット種別が不正のとき

・接続ユニット名が空のとき

実行順序制御を「しない」に設定している場合

パラメーターsearchConnectInfoで「NO（接続情報を取得しない）」の指定がある場合

別のスケジューラーサービス認証時にエラーになり，実行IDが取得できない場合，「-2」の文字列を返却します。

「-2」以外の理由で接続情報取得でエラーになった場合，「-1」の文字列を返却します。

execOrderMethod

string

パラメーターsearchConnectInfoで「YES（接続情報を取得する）」の指定がある場合，実行順序制御方式を，定数ExecOrderMethodに規定した文字列定数で返却します。

次の場合に，「NONE（該当なし）」を返却します。

指定したユニットのユニット種別が，ルートジョブネットではない場合

実行順序制御を「しない」に設定している場合

パラメーターsearchConnectInfoで「NO（接続情報を取得しない）」の指定があるとき

定数ExecOrderMethodの詳細については，「7.4.5(7) ExecOrderMethod」を参照してください。

7.3.3　リリース情報オブジェクト

ユニットのリリース情報を示すオブジェクトです。

リリース情報オブジェクトのAPIでの取得可否については，「付録D.4 APIで取得できるリリース情報オブジェクトのメンバーの一覧」を参照してください。

形式

{
  "releaseTime":"リリース日時",
  "releaseID":"リリースID",
  "releaseStatus":"リリース状態"
}

メンバー

返却されるメンバーを次の表に示します。

表7‒46　リリース情報オブジェクトのメンバー一覧

メンバー

データ型

説明

releaseTime

string

リリース日時を返却します。リリース日時は，1970年1月1日0時0分0秒からの経過時間（秒単位）が，次のISO 8601形式に変換されます。

「YYYY-MM-DDThh:mm:ssTZD」

ISO 8601形式の詳細については，「6.3 APIで利用できるデータ型」を参照してください。

情報を取得できない場合，または情報がないユニットの場合は，長さ0バイトの文字列を返却します。

releaseID

string

リリースIDを1〜30バイトの文字列で返却します。

情報を取得できない場合，または情報がないユニットの場合は，長さ0バイトの文字列を返却します。

releaseStatus

string

リリース状態を定数ReleaseStatusに規定されている文字列定数で返却します。ReleaseStatusの詳細については，「7.4.6(1) ReleaseStatus」を参照してください。

情報を取得できない場合，または情報がないユニットの場合は，「NONE（該当なし）」を返却します。

7.3.4　起動条件パラメーターオブジェクト

起動条件パラメーターを示すオブジェクトです。

形式

{
  "times":起動条件の有効範囲の回数,
  "period":"起動条件の有効範囲の時間",
  "periodType":"起動条件の有効範囲の時間の種別"
}

メンバー

メンバーを次の表に示します。

表7‒47　起動条件パラメーターオブジェクトのメンバー一覧

メンバー

データ型

説明

必須・任意

times

int

起動条件の有効範囲を回数で指定します。回数は1〜999の範囲の数値を指定してください。回数を無制限にする場合は，「0」を指定してください。

このメンバーの指定を省略した場合は，「0」が仮定されます。

任意

period

string

起動条件の有効範囲を時間で指定します。

メンバーperiodTypeで時間種別に「ABSOLUTE（絶対時間）」または「RELATIVE（相対時間）」を指定した場合，必ずこのメンバーで時間を指定してください。このメンバーを指定しなかった場合，またはこのメンバーに「null」を指定した場合，エラーになります。

メンバーperiodTypeで指定した時間種別によって，次に示すとおりに指定してください。

メンバーperiodTypeに「ABSOLUTE」を指定している場合

「hh:mm」形式で指定します。

hhに指定できる値は，00〜47（単位：時）です。

mmに指定できる値は，00〜59（単位：分）です。

指定する時刻は，要求先JP1/AJS3 - Managerのスケジューラーサービスローカル日時で指定してください。

メンバーperiodTypeに「RELATIVE」を指定している場合

「hh:mm」形式で指定します。

hhに指定できる値は，00〜47（単位：時）です。

mmに指定できる値は，00〜59（単位：分）です。ただし，00:00は指定できません。00:01〜47:59の範囲で指定できます。

メンバーperiodTypeに「NO（無制限）」を指定している場合

指定した値は無効になります。

任意

periodType

string

起動条件の有効範囲の時間種別を定数TimeTypeに規定されている値で指定します。指定できる値と内容については，「7.4.7(1) TimeType」を参照してください。

このメンバーの指定を省略した場合，またはこのメンバーに「null」を指定した場合，「NO（無制限）」が仮定されます。

任意

7.3.5　マクロ変数オブジェクト

マクロ変数を示すオブジェクトです。

形式

{
  "name":"マクロ変数名",
  "value":"引き継ぎ情報"
}

メンバー

メンバーを次の表に示します。

表7‒48　マクロ変数オブジェクトのメンバー一覧

メンバー

データ型

説明

必須・任意

name

string

マクロ変数名を，「AJS2xxxxx」の形式で指定します。前後の?は不要です。先頭は大文字で「AJS2」と指定してください。「xxxxx」は任意の文字列で，大文字のアルファベット，数字，「.（ピリオド）」が指定できます。

指定できない形式，文字が指定された場合はエラーになります。

指定できる文字列は，「AJS2」も含めて62バイト以内です。

必須

value

string

引き継ぎ情報を，0〜255バイトの文字列で指定します。引き継ぎ情報には，改行文字，タブ文字，および機種依存文字を指定しないでください。これらを指定した場合，ジョブネット実行登録時に正しく引き継がれないことがあります。

必須

7.3.6　実行エージェントの操作結果オブジェクト

実行エージェントまたは実行エージェントグループを操作した結果を表すオブジェクトです。

形式

{
  "execAgent":"実行エージェント名または実行エージェントグループ名",
  "rtnCode":"対象処理の結果コード",
  "messageID":"メッセージID",
  "message":"メッセージ文",
  "output":{
    "definitions":[実行エージェント定義情報オブジェクト,...],
    "statuses":[実行エージェントの状況オブジェクト,...],
    "text":"APIの操作結果",
    "serverTime":"接続先ホストのローカル日時"
  }
}

メンバー

返却されるメンバーを次の表に示します。

表7‒49　実行エージェントの操作結果オブジェクトのメンバー一覧

メンバー

データ型

説明

execAgent

string

リクエストのメソッドによって，次に示す内容を返却します。

GETの場合

長さ0バイトの文字列を返却します。

POSTの場合

操作対象の実行エージェント（実行エージェント名または実行エージェントグループ名）を1〜255バイトの文字列で返却します。

rtnCode

string

処理結果をコードで返却します。正常終了時，「0」が返却されます。

messageID

string

メンバーrtnCodeの値が「0」の場合，メッセージIDを返却します。

それ以外の場合，この項目は返却しません。

message

string

メンバーrtnCodeの値が「0」の場合，メッセージ文を返却します。

それ以外の場合，この項目は返却しません。

output

object

リクエストのメソッドによって，次に示す内容を返却します。

メソッドがGETの場合

APIで取得した情報を配下のオブジェクト（definitionsまたはstatuses）に格納して返却します。

メソッドがPOSTの場合，APIによって，次に示す内容を返却します。

・ジョブ配信遅延の軽減機能の通信状態確認の場合

APIの操作結果を配下のオブジェクト（text）に格納して返却します。

・上記以外の場合

「null」を返却します。

definitions

object[]

登録されている実行エージェントまたは実行エージェントグループの定義情報を，実行エージェント定義情報オブジェクトの配列で返却します。

APIによって，次に示す内容を返却します。

実行エージェントの定義取得，実行エージェントグループの定義取得の場合

実行エージェント定義情報オブジェクトの配列の0番目の要素に，定義情報を格納して返却します。

上記以外の場合

「null」を返却します。

実行エージェント定義情報オブジェクトの詳細については，「7.3.7 実行エージェント定義情報のオブジェクト」を参照してください。

statuses

object[]

登録されている実行エージェントまたは実行エージェントグループの状況を，実行エージェントの状況オブジェクトの配列で返却します。

APIによって，次に示す内容を返却します。

実行エージェントの状況一覧の取得の場合，および実行エージェントグループの状況一覧の取得の場合

実行エージェントの状況オブジェクトの配列を返却します。

実行エージェントの状況取得の場合および実行エージェントの実行状況一覧の取得の場合

実行エージェントの状況オブジェクトの配列の0番目の要素に，実行エージェントの状況を格納して返却します。

ただし，queryで指定された実行エージェントが存在しない場合は，要素数0個の配列を返却します。

上記以外の場合

「null」を返却します。

実行エージェントの状況オブジェクトの詳細については，「7.3.8 実行エージェントの状況オブジェクト」を参照してください。

text

string

APIの操作結果を文字列で返却します。

serverTime

string

JP1/AJS3 - Managerホストのローカル日時を返却します。JP1/AJS3 - Managerのローカル日時は，1970年1月1日0時0分0秒からの経過時間（秒単位）が，次のISO 8601形式に変換されます。

「YYYY-MM-DDThh:mm:ssTZD」

ISO 8601形式の詳細については，「6.3 APIで利用できるデータ型」を参照してください。

また，APIによって，次に示す内容を返却します。

実行エージェントの状況一覧の取得の場合，実行エージェントの状況取得の場合，実行エージェントグループの状況一覧取得の場合および実行エージェントの実行状況一覧の取得の場合

上記の日時を格納して返却します。

上記以外の場合

「null」を返却します。

7.3.7　実行エージェント定義情報のオブジェクト

実行エージェントまたは実行エージェントグループの定義情報を表すオブジェクトです。

形式

{
  "execAgent":"実行エージェント名または実行エージェントグループ名",
  "execHost":"実行ホスト名",
  "status":"受付配信制限の状態",
  "conExe":["時間帯ごとのジョブ実行多重度",...],
  "linkAgents":["関連する実行エージェントと優先順位"],
  "description":"説明文"
}

メンバー

返却されるメンバーを次の表に示します。

表7‒50　実行エージェントの定義情報のオブジェクトのメンバー一覧

メンバー

データ型

説明

execAgent

string

「query」に指定するパラメーターmodeによって，次に示す内容を返却します。

modeが「agent（実行エージェント）」の場合

実行エージェント名を1〜255バイトの文字列で返却します。

modeが「agentGroup（実行エージェントグループ）」の場合

実行エージェントグループ名を1〜255バイトの文字列で返却します。

execHost

string

「query」に指定するパラメーターmodeによって，次に示す内容を返却します。

modeが「agent（実行エージェント）」の場合

ジョブの実行先ホスト名を1〜255バイトの文字列で返却します。

modeが「agentGroup（実行エージェントグループ）」の場合

この項目を返却しません。

status

string

「query」に指定するパラメーターmodeによって，次に示す内容を返却します。

modeが「agent（実行エージェント）」の場合

実行エージェントの受付配信制限の状態を，定数ExecAgentStatusに規定した文字列定数で返却します。

modeが「agentGroup（実行エージェントグループ）」の場合

実行エージェントグループの受付配信制限の状態を，定数ExecAgentStatusに規定した文字列定数で返却します。

定数ExecAgentStatusの詳細については，「7.4.14(1) ExecAgentStatus」を参照してください。

conExe

string[]

「query」に指定するパラメーターmodeによって，次に示す内容を返却します。

modeが「agent（実行エージェント）」の場合

時間帯ごとのジョブ実行多重度を配列で返却します。時間帯ごとのジョブ実行多重度は，次の形式で返却します。

時間帯=ジョブ実行多重度

時間帯は「hh:mm-hh:mm」形式で返却します。

hhは，0〜23の数値（単位：時），mmは，0または30（単位：分）の数値で返却します。

ジョブ実行多重度は0〜4294967295の範囲の数値で返却します。

modeが「agentGroup（実行エージェントグループ）」の場合は「null」を返却します。

linkAgents

string[]

「query」に指定するパラメーターmodeによって，次に示す内容を返却します。

modeの値が「agent（実行エージェント）」の場合

「null」を返却します。

modeの値が「agentGroup（実行エージェントグループ）」の場合

関連する実行エージェントと優先順位を配列で返却します。関連する実行エージェントと優先順位は次の形式で返却します。

実行エージェント名:優先順位

実行エージェント名は1〜255バイトの文字列で返却します。

優先順位は1〜16の範囲の数値で返却します。

ただし，関連する実行エージェントが存在しない場合は，要素数0個の配列を返却します。

description

string

説明文を0〜80バイトの文字列で返却します。

7.3.8　実行エージェントの状況オブジェクト

実行エージェントまたは実行エージェントグループの状況を表すオブジェクトです。

形式

{
  "execAgent":"実行エージェント名または実行エージェントグループ名",
  "execHost":"実行ホスト名",
  "status":"受付配信制限の状態",
  "comStatus":"実行エージェントの状態",
  "conExe":ジョブ実行多重度,
  "job":実行中ジョブ数,
  "event":実行中イベントジョブ数および実行中カスタムイベントジョブ数,
  "que":キューイング中ジョブ数,
  "linkAgents":["関連する実行エージェントと優先順位"],
  "description":"説明文"
  "jobExecutionStatuses":[{
   "jobClass":"実行エージェントで管理されているジョブの分類",
   "serviceName":"スケジューラーサービス名",
   "unitName":"ユニット完全名",
   "execID":"実行ID",
   "errorMessage":"実行エージェントの実行状況を取得できない要因"
  },...]
}

メンバー

返却されるメンバーを次の表に示します。

表7‒51　実行エージェントの状況オブジェクトのメンバー一覧

メンバー

データ型

説明

execAgent

string

「query」に指定するパラメーターmodeによって，次に示す内容を返却します。

modeが「agent（実行エージェント）」の場合

実行エージェント名を1〜255バイトの文字列で返却します。

modeが「agentGroup（実行エージェントグループ）」の場合

実行エージェントグループ名を1〜255バイトの文字列で返却します。

execHost

string

「query」に指定するパラメーターmodeによって，次に示す内容を返却します。

modeが「agent（実行エージェント）」の場合

ジョブの実行先ホスト名を1〜255バイトの文字列で返却します。ただし，実行エージェントの実行状況一覧の取得のときは，この項目を返却しません。

modeが「agentGroup（実行エージェントグループ）」の場合

この項目を返却しません。

status

string

「query」に指定するパラメーターmodeによって，次に示す内容を返却します。

modeが「agent（実行エージェント）」の場合

実行エージェントの受付配信制限の状態を，定数ExecAgentStatusに規定した文字列定数で返却します。ただし，実行エージェントの実行状況一覧の取得のときは，この項目を返却しません。

modeが「agentGroup（実行エージェントグループ）」の場合

実行エージェントグループの受付配信制限の状態を，定数ExecAgentStatusに規定した文字列定数で返却します。

定数ExecAgentStatusの詳細については，「7.4.14(1) ExecAgentStatus」を参照してください。

comStatus

string

「query」に指定するパラメーターmodeによって，次に示す内容を返却します。

modeが「agent（実行エージェント）」の場合

実行エージェントの状態を，定数ComStatusに規定した文字列定数で返却します。ただし，ジョブ配信遅延の軽減機能が無効な場合は，「NONE（該当せず）」を返却します。実行エージェントの実行状況一覧の取得のときは，この項目を返却しません。

modeが「agentGroup（実行エージェントグループ）」の場合

この項目を返却しません。

定数ComStatusの詳細については，「7.4.14(2) ComStatus」を参照してください。

conExe

long

「query」に指定するパラメーターmodeによって，次に示す内容を返却します。

modeの値が「agent（実行エージェント）」の場合

ジョブ実行多重度を0〜4294967295の範囲の数値で返却します。ただし，実行エージェントの実行状況一覧の取得のときは，この項目を返却しません。

modeの値が「agentGroup（実行エージェントグループ）」の場合

この項目を返却しません。

que

long

キューイング中のUNIXジョブ，PCジョブ，アクションジョブ，カスタムジョブ，および引き継ぎ情報設定ジョブの数を0以上の数値で返却します。ただし，実行エージェントの実行状況一覧の取得の場合は，この項目を返却しません。

job

long

「query」に指定するパラメーターmodeによって，次に示す内容を返却します。

modeの値が「agent（実行エージェント）」の場合

実行中のUNIXジョブ，PCジョブ，アクションジョブ，カスタムジョブ，および引き継ぎ情報設定ジョブの数を0以上の数値で返却します。ただし，実行エージェントの実行状況一覧の取得のときは，この項目を返却しません。

modeの値が「agentGroup（実行エージェントグループ）」の場合

この項目を返却しません。

event

long

「query」に指定するパラメーターmodeによって，次に示す内容を返却します。

modeの値が「agent（実行エージェント）」の場合

実行中のイベントジョブ数および実行中カスタムイベントジョブ数を0以上の数値で返却します。ただし，実行エージェントの実行状況一覧の取得のときは，この項目を返却しません。

modeの値が「agentGroup（実行エージェントグループ）」の場合

この項目を返却しません。

linkAgents

string[]

「query」に指定するパラメーターmodeによって，次に示す内容を返却します。

modeの値が「agent（実行エージェント）」の場合

この項目を返却しません。

modeの値が「agentGroup（実行エージェントグループ）」の場合

関連する実行エージェントと優先順位を配列で返却します。関連する実行エージェントと優先順位は次の形式で返却します。

実行エージェント名:優先順位

実行エージェント名は1〜255バイトの文字列で返却します。

優先順位は1〜16の範囲の数値で返却します。

ただし，関連する実行エージェントが存在しない場合は，要素数0個の配列を返却します。

description

string

説明文を0〜80バイトの文字列で返却します。ただし，実行エージェントの実行状況一覧の取得の場合は，この項目を返却しません。

jobExecutionStatuses

object[]

APIによって，次に示す内容を返却します。

実行エージェントの実行状況一覧の取得の場合

実行エージェントの実行状況を，オブジェクトの配列で返却します。取得データが存在しない場合は，要素数0個の配列を返却します。

上記以外の場合

この項目を返却しません。

jobClass

string

実行エージェントで管理されているジョブの分類を，定数ExecAgentJobClassに規定した文字列定数で返却します。情報を取得できない場合は，「NONE（該当なし）」を返却します。

定数ExecAgentJobClassの詳細については，「7.4.14(3) ExecAgentJobClass」を参照してください。

serviceName

string

スケジューラーサービス名を，1〜30バイトの文字列で返却します。

情報を取得できない場合は，長さ0バイトの文字列を返却します。

unitName

string

ユニット完全名を1〜930バイトの文字列で返却します。

情報を取得できない場合は，長さ0バイトの文字列を返却します。

execID

string

実行IDを「@[mmmm]{A〜Z}nnnn」の形式で指定します（例：@10A200）。

情報を取得できない場合は，長さ0バイトの文字列を返却します。

errorMessage

string

実行エージェントの実行状況を取得できない場合に，取得できない要因を返却します。

情報を取得できない場合は，長さ0バイトの文字列を返却します。

7.4　定数の詳細

JP1/AJS3で公開されている定数の形式や詳細について説明します。

7.4.1　API共通で使用する定数

(1)　DateType

期間を指定する場合に，その期間を暦上の日付で指定するか，JP1/AJS3の実行日で指定するかを示します。

定数DateTypeの一覧を次の表に示します。

表7‒52　DateTypeの一覧

定数

説明

CALENDAR_DATE

期間を暦上の日付で指定します。

EXECUTION_DATE

期間を実行日で指定します。

(2)　Status

ユニットの状態を示します。

定数Statusの一覧を次の表に示します。

表7‒53　Statusの一覧

定数

説明

NONE

該当するユニットがないことを示します。

UNSUPPORTED

「未サポート」状態を示します。

NOENTRY

「未登録」状態を示します。

NOPLAN

「未計画」状態を示します。

UNEXEC

「未実行終了」状態を示します。

BYPASS

「計画未実行」状態を示します。

EXECDEFFER

「繰越未実行」状態を示します。

SHUTDOWN

「閉塞」状態を示します。

TIMEWAIT

「開始時刻待ち」状態を示します。

TERMWAIT

「先行終了待ち」状態を示します。

EXECWAIT

「実行待ち」状態を示します。

QUEUING

「キューイング」状態を示します。

CONDITIONWAIT

「起動条件待ち」状態を示します。

HOLDING

「保留中」状態を示します。

RUNNING

「実行中」状態を示します。

WACONT

「警告検出実行中」状態を示します。

ABCONT

「異常検出実行中」状態を示します。

MONITORING

「監視中」状態を示します。

ABNORMAL

「異常検出終了」状態を示します。

INVALIDSEQ

「順序不正」状態を示します。

INTERRUPT

「中断」状態を示します。

KILL

「強制終了」状態を示します。

FAIL

「起動失敗」状態を示します。

UNKNOWN

「終了状態不正」状態を示します。

MONITORCLOSE

「監視打ち切り終了」状態を示します。

WARNING

「警告検出終了」状態を示します。

NORMAL

「正常終了」状態を示します。

NORMALFALSE

「正常終了-偽」状態を示します。

UNEXECMONITOR

「監視未起動終了」状態を示します。

MONITORINTRPT

「監視中断」状態を示します。

MONITORNORMAL

「監視正常終了」状態を示します。

(3)　DelayStart

開始遅延の有無を示します。

定数DelayStartの一覧を次の表に示します。

表7‒54　DelayStartの一覧

定数

説明

NONE

該当するユニットがないことを示します。

UNSUPPORTED

未サポートを示します。

YES

開始遅延ありを示します。

NO

開始遅延なしを示します。

(4)　DelayEnd

終了遅延の有無を示します。

定数DelayEndの一覧を次の表に示します。

表7‒55　DelayEndの一覧

定数

説明

NONE

該当するユニットがないことを示します。

UNSUPPORTED

未サポートを示します。

YES

終了遅延ありを示します。

NO

終了遅延なしを示します。

7.4.2　ユニット一覧の取得APIで使用する定数

(1)　LowerType

ユニット配下のジョブを取得対象とするかを示します。

定数LowerTypeの一覧を次の表に示します。

表7‒56　LowerTypeの一覧

定数

説明

YES

ユニットの配下をすべて取得対象にします。

NO

ユニットの直下1階層にあるユニットだけを取得対象にします。

(2)　SearchTargetType

取得する情報の範囲を示します。

定数SearchTargetTypeの一覧を次の表に示します。

表7‒57　SearchTargetTypeの一覧

定数

説明

DEFINITION

ユニットの定義だけを取得対象にします。

DEFINITION_AND_STATUS

ユニットの実行状態や世代数などを考慮して，ユニットの定義および状態を取得対象にします。

(3)　MatchMethods

文字列の比較方法を示します。

定数MatchMethodsの一覧を次の表に示します。

表7‒58　MatchMethodsの一覧

定数

説明

NO

この比較方法を検索条件にしません。

EQ

検索条件の値と完全に一致する（完全一致）。

BW

検索条件の値で始まる（前方一致）。

EW

検索条件の値で終わる（後方一致）。

NE

検索条件の値と一致しない（不一致）。

CO

検索条件の値が含まれる。

NC

検索条件の値が含まれない。

RE

検索条件の値を正規表現として扱います。正規表現については，表7-59を参照してください。

表7‒59　 正規表現で指定できる記号，指定例，および取得例

記号

説明

指定例

取得例

?

任意の1文字

A?

AB，A1，A?，A*，A¥

?E

DE，1E，?E，*E，¥E

*

任意の文字列

B*

B，BC，B12，B?*¥

¥

直後の記号を文字として扱う

C¥?

C?

(4)　UnitType

情報を取得するユニットのユニット種別を示します。

定数UnitTypeの一覧を次の表に示します。

表7‒60　UnitTypeの一覧

定数

説明

NO

ユニット種別を検索条件にしません。

GROUP

ジョブグループの情報だけを取得します。

情報取得の対象となるユニット種別は，次のとおりです。

ジョブグループ

プランニンググループ

マネージャージョブグループ

ROOT

ルートジョブネットの情報だけを取得します。

情報取得の対象となるユニット種別は，次のとおりです。

ルートジョブネット

ルートリモートジョブネット

ルートマネージャージョブネット

NET

ジョブネットの情報だけを取得します。

情報取得の対象となるユニット種別は，次のとおりです。

ルートジョブネット

ルートリモートジョブネット

マネージャージョブネット

ネストジョブネット

ネストリモートジョブネット

JOB

ジョブの情報だけを取得します。

情報取得の対象となるユニット種別は，次のとおりです。

標準ジョブ

イベントジョブ

アクションジョブ

カスタムジョブ

引き継ぎ情報設定ジョブ

HTTP接続ジョブ

フレキシブルジョブ

カスタムイベントジョブ

(5)　GenerationType

情報を取得するユニットの世代を示します。

定数GenerationTypeの一覧を次の表に示します。

表7‒61　GenerationTypeの一覧

定数

説明

NO

世代を検索条件にしません。

STATUS

最新状態の世代を取得します。取得対象となる世代は，ログインしているJP1/AJS3 - Managerの環境設定パラメーターVIEWSTATUSRANGEの設定値に従います。環境設定パラメーターVIEWSTATUSRANGEの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　20.4.2(70) VIEWSTATUSRANGE」を参照してください。

RESULT

最新結果の世代を取得します。

PERIOD

指定した期間に存在する世代を取得します。

EXECID

指定した実行IDの世代を取得します。

(6)　UnitStatus

情報を取得するユニットのユニット状態を示します。

定数UnitStatusの一覧を次の表に示します。

表7‒62　UnitStatusの一覧

定数

説明

NO

ユニット状態を検索条件にしません。

UNREGISTERED

「未登録」状態のユニットの情報を取得します。

NOPLAN

「未計画」状態のユニットの情報を取得します。

UNEXEC

「未実行終了」状態のユニットの情報を取得します。

BYPASS

「計画未実行」状態のユニットの情報を取得します。

EXECDEFFER

「繰越未実行」状態のユニットの情報を取得します。

SHUTDOWN

「閉塞」状態のユニットの情報を取得します。

TIMEWAIT

「開始時刻待ち」状態のユニットの情報を取得します。

TERMWAIT

「先行終了待ち」状態のユニットの情報を取得します。

EXECWAIT

「実行待ち」状態のユニット情報を取得します。

QUEUING

「キューイング」状態のユニットの情報を取得します。

CONDITIONWAIT

「起動条件待ち」状態のユニットの情報を取得します。

HOLDING

「保留中」状態のユニット情報を取得します。

RUNNING

「実行中」状態のユニット情報を取得します。

WACONT

「警告検出実行中」状態のユニットの情報を取得します。

ABCONT

「異常検出実行中」状態のユニットの情報を取得します。

MONITORING

「監視中」状態のユニットの情報を取得します。

ABNORMAL

「異常検出終了」状態のユニットの情報を取得します。

INVALIDSEQ

「順序不正」状態のユニットの情報を取得します。

INTERRUPT

「中断」状態のユニットの情報を取得します。

KILL

「強制終了」状態のユニットの情報を取得します。

FAIL

「起動失敗」状態のユニットの情報を取得します。

UNKNOWN

「終了状態不正」状態のユニットの情報を取得します。

MONITORCLOSE

「監視打ち切り終了」状態のユニットの情報を取得します。

WARNING

「警告検出終了」状態のユニットの情報を取得します。

NORMAL

「正常終了」状態のユニットの情報を取得します。

NORMALFALSE

「正常終了-偽」状態のユニットの情報を取得します。

UNEXECMONITOR

「監視未起動終了」状態のユニットの情報を取得します。

MONITORINTRPT

「監視中断」状態のユニットの情報を取得します。

MONITORNORMAL

「監視正常終了」状態のユニットの情報を取得します。

GRP_WAIT

次のユニット状態のユニットの情報を取得します。

開始時刻待ち

先行終了待ち

実行待ち

キューイング

起動条件待ち

GRP_RUN

次のユニット状態のユニットの情報を取得します。

実行中

警告検出実行中

異常検出実行中

監視中

GRP_ABNORMAL

次のユニット状態のユニットの情報を取得します。

異常検出終了

順序不正

中断

強制終了

起動失敗

終了状態不明

監視打ち切り終了

GRP_NORMAL

次のユニット状態のユニットの情報を取得します。

正常終了

正常終了-偽

監視未起動終了

監視中断

監視正常終了

(7)　DelayType

情報を取得するユニットの，開始遅延または終了遅延の有無を示します。

定数DelayTypeの一覧を次の表に示します。

表7‒63　DelayTypeの一覧

定数

説明

NO

開始遅延または終了遅延の有無を検索条件にしません。

START

開始遅延のあるユニットの情報を取得します。

END

終了遅延のあるユニットの情報を取得します。

YES

開始遅延，または終了遅延のあるユニットの情報を取得します。

(8)　HoldPlan

情報を取得するユニットの，保留予定の有無を示します。定数HoldPlanの一覧を次の表に示します。

表7‒64　HoldPlanの一覧

定数

説明

NO

保留予定の有無を検索条件にしません。

PLAN_NONE

保留予定のないユニットの情報を取得します。

PLAN_YES

保留予定のあるユニットの情報を取得します。

(9)　ReleaseInfoSearchMethods

情報を取得するユニットのリリースIDを示します。

定数ReleaseInfoSearchMethodsの一覧を次の表に示します。

表7‒65　ReleaseInfoSearchMethodsの一覧

定数

説明

NO

リリースIDを検索条件にしません。

ID

リリースIDを検索条件にします。

7.4.3　実行登録APIで使用する定数

(1)　PlannedTimePassedType

スケジューラーサービス起動時および実行登録時に，予定時刻を超過していたときの動作の種類を示します。

定数PlannedTimePassedTypeの一覧を次の表に示します。

表7‒66　PlannedTimePassedTypeの一覧

定数

説明

IMMEDIATE

スケジューラーサービス起動時および実行登録時に，予定時刻を超過していたとき，ジョブネットをすぐに実行します。

NEXTTIME

スケジューラーサービス起動時および実行登録時に，予定時刻を超過していたとき，ジョブネットを実行しません。次回から実行します。

なお，日時を指定して確定実行登録する場合，この値を指定すると予定時刻を超過しているジョブネットを実行しません。

7.4.4　ユニット定義情報オブジェクトで使用する定数

(1)　Type

ユニットの種別を示します。

定数Typeの一覧を次の表に示します。

表7‒67　Typeの一覧

定数

説明

NONE

検索条件に該当するユニットがないことを示します。

UNSUPPORTED

未サポートを示します。

GROUP

ジョブグループを示します。

MANGROUP

マネージャージョブグループを示します。

PLNGROUP

プランニンググループを示します。

ROOTNET

ルートジョブネットを示します。

NET

ネストジョブネットを示します。

ROOTRMNET

ルートリモートジョブネットを示します。

RMNET

ネストリモートジョブネットを示します。

MANNET

マネージャージョブネットを示します。

JOB

UNIXジョブを示します。

PJOB

PCジョブを示します。

QJOB

QUEUEジョブを示します。

NETCN

ジョブネットコネクタを示します。

JDJOB

判定ジョブを示します。

ORJOB

ORジョブを示します。

CMSJB

JP1/Cm2状態通知ジョブを示します。

EVWJB

JP1イベント受信監視ジョブを示します。

FLWJB

ファイル監視ジョブを示します。

MLWJB

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

MQWJB

メッセージキュー受信監視ジョブを示します。

MSWJB

MSMQ受信監視ジョブを示します。

LFWJB

ログファイル監視ジョブを示します。

NTWJB

Windowsイベント監視ジョブを示します。

TMWJB

実行間隔制御ジョブを示します。

EVSJB

JP1イベント送信ジョブを示します。

MLSJB

メール送信ジョブを示します。

MQSJB

メッセージキュー送信ジョブを示します。

MSSJB

MSMQ送信ジョブを示します。

PWLJB

ローカル電源制御ジョブを示します。

PWRJB

リモート電源制御ジョブを示します。

COND

起動条件を示します。

AJSVAR

引き継ぎ情報設定ジョブを示します。

HTPJ

HTTP接続ジョブを示します。

FXJ

フレキシブルジョブを示します。

CUSTOM

カスタムジョブを示します。

EVCUSTOM

カスタムイベントジョブを示します。

(2)　RegisterStatus

ユニットの登録状態を示します。

定数RegisterStatusの一覧を次の表に示します。

表7‒68　RegisterStatusの一覧

定数

説明

NONE

検索条件に該当するユニットがないことを示します。

UNSUPPORTED

未サポートを示します。

YES

登録済みのユニットを示します。

NO

未登録のユニットを示します。

7.4.5　ステータス情報オブジェクトで使用する定数

(1)　ChangeType

計画一時変更の有無を示します。

定数ChangeTypeの一覧を次の表に示します。

表7‒69　ChangeTypeの一覧

定数

説明

NONE

該当するユニットがないことを示します。

UNSUPPORTED

未サポートを示します。

NO

計画一時変更なしを示します。

TIME

日時変更ありを示します。

CANCEL

実行中止ありを示します。

MOVEMENT

連動一時変更（計画一時変更によって配下の開始日時をずらす）ありを示します。

(2)　HoldAttr

保留属性を示します。

定数HoldAttrの一覧を次の表に示します。

表7‒70　HoldAttrの一覧

定数

説明

NONE

該当するユニットがないことを示します。

UNSUPPORTED

未サポートを示します。

NO

定義に従う（保留しない）を示します。

YES

定義に従う（保留する）を示します。

YES_ERR

定義に従う（前回異常時だけ保留する）を示します。

YES_WAR

定義に従う（前回異常警告時だけ保留する）を示します。

HOLD

保留ありを示します。

RELEASE

保留なしを示します。

(3)　TimeType

起動条件の有効範囲の時間種別を示します。

定数TimeTypeの一覧を次の表に示します。

表7‒71　TimeTypeの一覧

定数

説明

NONE

該当するユニットがないことを示します。

UNSUPPORTED

未サポートを示します。

NO

時間種別の指定がないことを示します。

ABSOLUTE

絶対時間を示します。

RELATIVE

相対時間を示します。

UNLIMITED

無制限を示します。

(4)　Waiting

成立していない待ち合わせ条件の有無を示します。

定数Waitingの一覧を次の表に示します。

表7‒72　 Waitingの一覧

定数

説明

NONE

該当する情報がないことを示します。

UNSUPPORTED

未サポートを示します。

WAITING_YES

成立していない待ち合わせ条件があることを示します。

WAITING_NO

成立していない待ち合わせ条件がないことを示します。

(5)　DelayMonitor

ジョブネットの遅延監視方法を示します。

定数DelayMonitorの一覧を次の表に示します。

表7‒73　DelayMonitorの一覧

定数

説明

NONE

該当する情報がないことを示します。

UNSUPPORTED

未サポートを示します。

NOT

遅延監視を実施しないことを示します。

ABSOLUTE

絶対時刻で監視することを示します。

ROOT

ルートジョブネットの開始予定時刻からの相対時刻で監視することを示します。

TOP

上位ジョブネットの開始予定時刻からの相対時刻で監視することを示します。

OWN

自ジョブネットの開始予定時刻からの相対時刻で監視することを示します。

(6)　MonitoringJobnet

ジョブネットの実行所要時間による終了遅延の監視の方法を示します。

定数MonitoringJobnetの一覧を次の表に示します。

表7‒74　MonitoringJobnetの一覧

定数

説明

NONE

該当する情報がないことを示します。

UNSUPPORTED

未サポートを示します。

TIME_REQUIRED_FOR_EXECUTION_NO

ジョブネットの実行所要時間による終了遅延の監視を実施しないことを示します。

TIME_REQUIRED_FOR_EXECUTION_YES

ジョブネットの実行所要時間による終了遅延の監視を実施することを示します。

(7)　ExecOrderMethod

ジョブネットの実行順序制御方式を示します。

定数ExecOrderMethodの一覧を次の表に示します。

表7‒75　ExecOrderMethodの一覧

定数

説明

NONE

該当する情報がないことを示します。

UNSUPPORTED

未サポートを示します。

ASYNC

定義に従う（非同期）ことを示します。

SYNC

定義に従う（同期）を示します。

CHANGE_ASYNC

非同期を示します。

CHANGE_SYNC

同期を示します。

7.4.6　リリース情報オブジェクトで使用する定数

(1)　ReleaseStatus

リリース状態を示します。

定数ReleaseStatusの一覧を次の表に示します。

表7‒76　ReleaseStatusの一覧

定数

説明

NONE

検索条件に該当するユニットがないことを示します。

UNSUPPORTED

未サポートを示します。

RELEASE_WAIT

リリース待ちを示します。

BEING_APPLIED

適用中を示します。

APPLIED

適用終了を示します。

DELETE_WAIT

削除待ちを示します。

RELEASE_ENTRY_WAIT

リリース登録待ちを示します。

7.4.7　起動条件パラメーターオブジェクトで使用する定数

(1)　TimeType

起動条件の有効範囲の時間種別を示します。

定数TimeTypeの一覧を次の表に示します。

表7‒77　TimeTypeの一覧

定数

説明

ABSOLUTE

絶対時間を示します。

RELATIVE

相対時間を示します。

NO

無制限を示します。

7.4.8　保留属性変更APIで使用する定数

(1)　ChangeHoldAttr

保留属性の変更を示します。

定数ChangeHoldAttrの一覧を次の表に示します。

表7‒78　ChangeHoldAttrの一覧

定数

説明

SET

保留属性設定を示します。

RELEASE

保留解除を示します。

7.4.9　計画一時変更APIで使用する定数

(1)　ChangeStartTimeType

計画一時変更するときの，実行開始日時の種類を示します。

定数ChangeStartTimeTypeの一覧を次の表に示します。

表7‒79　ChangeStartTimeTypeの一覧

定数

説明

ABSOLUTETIME

絶対日時を指定します。

RELATIVETIME

相対日時を指定します。

(2)　ChangePushedAheadType

計画一時変更する場合に，開始時間を前倒しにするときの動作を示します。

定数ChangePushedAheadTypeの一覧を次の表に示します。

表7‒80　ChangePushedAheadTypeの一覧

定数

説明

ADD

次回予定追加を示します。

MOVE

次回予定移動を示します。

(3)　ChangeLowerType

上位のジョブネットを計画一時変更するとき，配下のジョブネットの開始日時を連動して変更するかどうかを示します。

定数ChangeLowerTypeの一覧を次の表に示します。

表7‒81　ChangeLowerTypeの一覧

定数

説明

NOTSHIFT

配下のジョブネットの開始日時は変更しません。

指定したジョブネットだけ，開始日時を変更します。

SHIFT

配下のジョブネットの開始日時も連動して変更します。

指定したジョブネットの配下にあるすべてのネストジョブネットの開始日時を，相対的に変更します。

7.4.10　再実行APIで使用する定数

(1)　RootRerunType

ルートジョブネットを再実行する方法を示します。

定数RootRerunTypeの一覧を次の表に示します。

表7‒82　RootRerunTypeの一覧

定数

説明

TOP

指定したルートジョブネットの先頭のジョブから再実行します。

ABNORMAL_JOB

指定したルートジョブネットの配下のジョブの中で，異常終了したジョブから再実行します。

ABNORMAL_NEXT

指定したルートジョブネットの配下のジョブの中で，異常終了したジョブの次のジョブから再実行します。

ABNORMAL_JOBNET

指定したルートジョブネットの配下のネストジョブネットの中で，異常終了したジョブネットから再実行します。

WARNING

指定したルートジョブネットの配下のジョブの中で，警告終了したジョブだけ再実行します。

(2)　RerunType

ネストジョブネットまたはジョブを再実行する方法を示します。

定数RerunTypeの一覧を次の表に示します。

表7‒83　RerunTypeの一覧

定数

説明

FROM

指定したユニットを再実行します。再実行が終了したら，後続ユニットの処理が続行されます。

ONLY

指定したユニットだけを再実行します。

NEXT

指定したユニットの次のユニットから再実行します。

(3)　RerunOption

再実行のオプションを示します。

定数RerunOptionの一覧を次の表に示します。

表7‒84　RerunOptionの一覧

定数

説明

HOLD

再実行するユニットを保留状態にします。

なお，再実行するユニットがネストジョブネットまたはジョブの場合，再実行方法の定数RerunTypeで「FROM」または「ONLY」を指定したときだけこの値を指定できます。定数RerunTypeに「NEXT」を指定した場合，この値を指定するとエラーになります。

また，再実行するユニットがジョブネットコネクタの場合，この値は指定できません。

WARNING

異常状態の先行ユニットがある場合に，そのユニットの終了状態を警告終了にします。

なお，再実行するユニットがルートジョブネットの場合，再実行方法の定数RootRerunTypeに「ABNORMAL_NEXT」を指定したときだけ指定できます。それ以外の再実行方法の場合，この値を指定するとエラーになります。

7.4.11　遅延監視変更APIで使用する定数

(1)　DelayMonitorType

ジョブネットの遅延監視方法を示します。

定数DelayMonitorTypeの一覧を次の表に示します。

表7‒85　DelayMonitorTypeの一覧

定数

説明

NOT

監視しないことを示します。

ABSOLUTE

絶対時刻での遅延監視を示します。

ROOT※

ルートジョブネットの開始予定時刻からの相対時刻での遅延監視を示します。

TOP※

上位ジョブネットの開始予定時刻からの相対時刻での遅延監視を示します。

OWN

自ジョブネットの開始予定時刻からの相対時刻での遅延監視を示します。

注※

遅延状態を変更するユニットがルートジョブネットの場合，指定できません。

(2)　MonitoringJobnetType

ジョブネットの実行所要時間による終了遅延の監視方法を示します。

定数MonitoringJobnetTypeの一覧を次の表に示します。

表7‒86　MonitoringJobnetTypeの一覧

定数

説明

NOT

監視しないことを示します。

TIME_REQUIRED_FOR_EXECUTION

ジョブネットの実行所要時間での遅延監視を示します。

7.4.12　ジョブ状態変更APIで使用する定数

(1)　ChangeStatus

ジョブの変更後の状態を示します。

定数ChangeStatusの一覧を次の表に示します。

表7‒87　ChangeStatusの一覧

定数

説明

NORMAL

ジョブの状態を正常終了にします。

FAIL

ジョブの状態を起動失敗にします。

WARNING

ジョブの状態を警告検出終了にします。

ABNORMAL

ジョブの状態を異常検出終了にします。

BYPASS

ジョブの状態を計画未実行にします。

RETURNCODE

ジョブの状態を終了コードで判定し，指定した終了コードに変更します。

7.4.13　待ち合わせで使用する定数

(1)　WaitMethod

待ち合わせが成立する条件を示します。

定数Waitmethodの一覧を次の表に示します。

表7‒88　Waitmethodの一覧

定数

説明

AND

すべてのユニットが実行終了すると待ち合わせが成立します。

OR

どれか一つのユニットが実行終了すると待ち合わせが成立します。

(2)　WaitingAction

待ち合わせ条件付きユニットの動作を示します。

定数WaitingActionの一覧を次の表に示します。

表7‒89　WaitingActionの一覧

定数

説明

EXECUTE

待ち合わせ条件付きユニットの実行を開始します。

NOT_EXECUTE

待ち合わせ条件付きユニットの実行を開始しません。

NOT_EXECUTE_DEFFER

待ち合わせ条件付きユニットの実行を開始しません。ただし，実行世代が「繰り越し未実行」状態の場合は，実行を開始します。

(3)　WaitingStatus

待ち合わせ条件付きユニットと待ち合わせ対象ユニットの待ち合わせの状態を示します。

定数Waitingstatusの一覧を次の表に示します。

表7‒90　Waitingstatusの一覧

定数

説明

INCOMPLETE

未完了を示します。

INCOMPLETE_MANUALLY

未完了（手動）を示します。

INCOMPLETE_RERUN

未完了（再実行）を示します。

COMPLETE

完了を示します。

COMPLETE_MANUALLY

完了（手動）を示します。

(4)　WaitingStatusAction

待ち合わせを有効化するか無効化するかを示します。

定数WaitingStatusActionの一覧を次の表に示します。

表7‒91　WaitingStatusActionの一覧

定数

説明

ENABLE

待ち合わせを有効化します。

DISABLE

待ち合わせを無効化します。

7.4.14　実行エージェントのオブジェクトで使用する定数

(1)　ExecAgentStatus

実行エージェントまたは実行エージェントグループの受付配信制限の状態を示します。

定数ExecAgentStatusの一覧を次の表に示します。

表7‒92　ExecAgentStatusの一覧

定数

説明

EFFECTIVE

実行エージェントの受付配信制限が有効であることを示します。

INEFFECTIVE

実行エージェントの受付配信制限が無効であることを示します。

HOLD

実行エージェントの受付配信制限が保留されていることを示します。

BLOCKADE

実行エージェントの受付配信制限が閉塞していることを示します。

(2)　ComStatus

実行エージェントの状態を示します。

定数ComStatusの一覧を次の表に示します。

表7‒93　ComStatusの一覧

定数

説明

NONE

マネージャーホストでジョブ配信遅延の軽減機能が無効になっていることを示します。

NOTCHECKED

実行エージェントが未確認状態であることを示します。

CONNECTABLE

実行エージェントが接続できる状態であることを示します。

UNCONNECTABLE

実行エージェントが接続できない状態であることを示します。

UNAVAILABLE

実行エージェントが使用できない状態であることを示します。

(3)　ExecAgentJobClass

実行エージェントで管理されているジョブの分類を示します。

定数ExecAgentJobClassの一覧を次の表に示します。

表7‒94　ExecAgentJobClassの一覧

定数

説明

NONE

該当するジョブがないことを示します。

QUE

キューイング中のUNIXジョブ，PCジョブ，フレキシブルジョブ，HTTP接続ジョブ，アクションジョブ，カスタムジョブおよび引き継ぎ情報設定ジョブを示します。

JOB

実行中のUNIXジョブ，PCジョブ，フレキシブルジョブ，HTTP接続ジョブ，アクションジョブ，カスタムジョブおよび引き継ぎ情報設定ジョブを示します。

EVENT

実行中のイベントジョブおよびカスタムイベントジョブを示します。

7.4.15　実行順序制御方式の変更APIで使用する定数

(1)　ChangeExecOrderMethod

変更後の実行順序制御方式を示します。

定数ChangeExecOrderMethodの一覧を次の表に示します。

表7‒95　ChangeExecOrderMethodの一覧

定数

説明

ASYNC

非同期に変更します。

SYNC

同期に変更します。

7.4.16　ユニット情報の取得APIで使用する定数

(1)　ConnectInfoType

ステータス監視リソースの「ステータス情報オブジェクト（unitStatus）」を取得するときに，接続情報を取得するか，接続情報を取得しないかを示します。

定数ConnectInfoTypeの一覧を次の表に示します。

表7‒96　ConnectInfoTypeの一覧

定数

説明

YES

接続情報を取得します。

NO

接続情報を取得しません。

ステータス情報オブジェクトについては，「7.3.2 ステータス情報オブジェクト」を参照してください。接続情報とは次のメンバーです。

表7‒97　接続情報のメンバーの一覧

メンバー名

説明

destHostName

接続先ホスト名

destServiceName

接続先スケジューラーサービス名

destUnitName

接続先ユニット完全名

destExecID

接続先の実行ID

srcHostName

接続元ホスト名

srcServiceName

接続元スケジューラーサービス名

srcUnitName

接続元ユニット完全名

srcExecID

接続元の実行ID

execOrderMethod

実行順序制御方式

付録

付録A　環境変数および環境変数ファイルを定義する場合の注意事項

付録A.1　環境変数を定義するときの注意事項

ジョブ実行時に使用する環境変数を定義する場合の注意事項を示します。

なお，環境変数の一覧については，「1.4 環境変数一覧」を参照してください。

JP1/AJS3 - Viewのダイアログボックスで環境変数を定義する場合，「環境変数名=値」の形式で指定してください。環境変数を複数指定する場合は，「環境変数名=値」ごとに改行文字で区切ってください。

（例）

環境変数名1=ABCD<改行>

環境変数名2=EFGH<改行>

<改行>は改行コードで区切り，「；」や「：」などの文字は使用しないでください。

ユニット定義ファイルで環境変数を定義する場合，「env="環境変数名=値";」の形式で指定してください。環境変数を複数指定する場合は，「env="環境変数名=値";」の形式を複数記載してください。JP1/AJS3 - Viewのように<改行>は必須ではありません。

（例）

env="環境変数1=ABCD";<改行>

env="環境変数2=EFGH";<改行>

ajschgjobコマンドで環境変数を定義する場合，「-en 環境変数名=値」の形式で指定してください。環境変数を複数指定する場合は，-enオプションを複数指定してください。

（例）

ajschgjob -en 環境変数1=ABCD -en 環境変数2=EFGH ...

「環境変数名=値」の形式以外の文字列は指定しないでください。ジョブを実行するホスト側のOSによってはジョブが異常終了する場合があります。

「AJS」で始まる環境変数（例：AJSxxxx（xxxxは任意の文字列））は，システムで予約しているため，大文字・小文字に関係なく，使用しないでください。

「JP1」で始まる環境変数（例：JP1xxxx（xxxxは任意の文字列））は，システムで予約しているため，大文字・小文字に関係なく，使用しないでください。

JP1/AJS3から実行されるジョブ実行時に設定される環境変数（「1.4.2 JP1/AJS3から実行されるジョブ実行時に設定される環境変数」の表1-6に示す環境変数）は，ジョブ定義の「環境変数」や「環境変数ファイル名」に指定するファイルの中には設定できません。

環境変数には，JP1/AJS3で設定されるもの（「1.4.2 JP1/AJS3から実行されるジョブ実行時に設定される環境変数」の表1-6に示す環境変数，ジョブ定義時に指定した環境変数，ジョブ定義時に環境変数ファイルとして指定したファイル内の環境変数）のほかに，ジョブ定義時に指定したコマンド文やスクリプトファイル，ローカルログインスクリプト，システムログインスクリプトにも設定できます。これらの中で同じ環境変数があった場合，次に示す優先順位に従って有効になります（優先順位がいちばん高いのは1です）。

Windowsの場合

1.　環境変数※1に指定した環境変数

2.　環境変数ファイル※2に指定した環境変数

3.　システム環境変数

UNIXの場合

1.　ジョブ定義時に指定したコマンドやスクリプトファイルでの定義

2.　ローカルログインスクリプトでの定義

3.　システムログインスクリプトでの定義

4.　環境変数※1に指定した環境変数

5.　環境変数ファイル※2に指定した環境変数

6.　キューレスエージェントサービス起動時の環境変数※3

注※1

JP1/AJS3 - Viewのダイアログボックスで環境変数に指定した変数，またはjpqjobsubコマンドの-envオプションに指定した変数

注※2

JP1/AJS3 - Viewのダイアログボックスで環境変数ファイルに指定した変数，またはjpqjobsubコマンドの-evオプションに指定した変数ファイル

注※3

実行先サービスが［キューレス］のジョブの場合だけ該当します。

JP1/AJS3 - View のダイアログボックスで環境変数を定義する場合，またはjpqjobsubコマンドの-envオプションで，次の例のように値に環境変数を参照する指定はできません。

環境変数'xyz'には'%abc%'がそのまま文字列として設定されます。

（例）

abc=1

xyz=%abc%

環境変数の値を参照する指定をする場合は，実行するジョブのバッチファイルまたはスクリプトファイルで指定してください。

注意事項

Windowsの場合，通常JP1/AJS3サービス起動時にはシステム環境変数の設定を有効にし，ユーザー環境変数は読み込まれません。ジョブ実行時には，このシステム環境変数の設定を使用します。ただし，クラスタシステムをセットアップした論理ホストでは，システム起動時にフェールオーバークラスタ※がユーザー環境変数を読み込みます。フェールオーバークラスタから起動した論理ホストのJP1/AJS3サービスでは，ユーザー環境変数が有効になり，ジョブ実行時にもユーザー環境変数が使用されます。

なお，JP1/AJS3サービス起動時に読み込まれる環境変数には，システム環境変数のほかにOSが起動するときに設定する環境変数も含まれます。

注※

フェールオーバークラスタ以外のクラスタソフトについては仕様を確認してください。

付録A.2　環境変数ファイルを定義するときの注意事項

ジョブ実行時に使用する環境変数ファイルに環境変数名を定義する前に，実行するホスト側のOSで有効な名称かどうか確認してください。

定義した環境変数名が，実行するホスト上で扱えない名称の場合は，環境変数ファイルに指定した内容は無効になります。この場合，ホスト側では環境変数は設定されません。

次に，ジョブ実行時に使用する環境変数ファイルに環境変数を定義する場合の文法上の注意事項を示します。

(1)　Windows環境で環境変数ファイルを定義するときの注意事項

環境変数名は，行の先頭から記載してください。

環境変数を複数指定する場合は，「環境変数名=値」ごとに改行文字で区切ってください。

（例）

環境変数名1=ABCD<改行>

環境変数名2=EFGH<改行>

「環境変数名=値」の形式以外の文字列は指定しないでください。ジョブを実行するホスト側のOSによってはジョブが異常終了する場合があります。

値は，"="以降から改行コードまでを一つとします。

「AJS」で始まる環境変数（例：AJSxxxx（xxxxは任意の文字列））は，システムで予約しているため，大文字・小文字に関係なく，使用しないでください。

「JP1」で始まる環境変数（例：JP1xxxx（xxxxは任意の文字列））は，システムで予約しているため，大文字・小文字に関係なく，使用しないでください。

JP1/AJS3から実行されるジョブ実行時に設定される環境変数（「1.4.2 JP1/AJS3から実行されるジョブ実行時に設定される環境変数」の表1-6に示す環境変数）は，JP1/AJS3で値が設定されているため，環境変数ファイルの中に指定しないでください。

次の例のように値に環境変数を参照する指定はできません。

環境変数'xyz'には'%abc%'がそのまま文字列として設定されます。

（例）

abc=1

xyz=%abc%

環境変数の値を参照する指定をする場合は，実行するジョブのバッチファイルで指定してください。

(2)　UNIX環境で環境変数ファイルを定義するときの注意事項

環境変数名は，行の先頭から記載してください。

環境変数を複数指定する場合は，「環境変数名=値」ごとに改行文字で区切ってください。

（例）

環境変数名1=ABCD<改行>

環境変数名2=EFGH<改行>

「環境変数名=値」の形式以外の文字列は指定しないでください。ジョブを実行するホスト側のOSによってはジョブが異常終了する場合があります。

値は，"="以降から改行コードまでを一つとします。

「AJS」で始まる環境変数（例：AJSxxxx（xxxxは任意の文字列））は，システムで予約しているため，大文字・小文字に関係なく，使用しないでください。

「JP1」で始まる環境変数（例：JP1xxxx（xxxxは任意の文字列））は，システムで予約しているため，大文字・小文字に関係なく，使用しないでください。

JP1/AJS3から実行されるジョブ実行時に設定される環境変数（「1.4.2 JP1/AJS3から実行されるジョブ実行時に設定される環境変数」の表1-6に示す環境変数）は，JP1/AJS3で値が設定されているため，環境変数ファイルの中に指定しないでください。

次の例のように値に環境変数を参照する指定はできません。

環境変数'xyz'には'$abc'がそのまま文字列として設定されます。

（例）

abc=1

xyz=$abc

環境変数の値を参照する指定をする場合は，実行するジョブのスクリプトファイルで指定してください。

付録B　組み込みDBの操作コマンド使用時の注意事項

ajsembdbadduserコマンドで新たにユーザーを追加，変更した場合，次に示す組み込みDBの操作コマンドでは，コマンドを実行するユーザーの認可識別子（-a），パスワード（-ap）が使用できます。

ajsembdbstatus

ajsembdbrorg

ajsembdbreclaim

ajsembdbsetup

-a，-apオプションの説明を次に示します。

-a ユーザーID

コマンドを実行するユーザーの認可識別子を指定します。

通常，認可識別子は「root」が仮定されるため，この値を指定する必要はありません。ajsembdbadduserコマンドを使用して，新たに組み込みDBに管理者を追加・変更した場合だけ指定してください。

指定された値は，大文字・小文字が区別されます。

-ap パスワード

-aオプションで指定した認可識別子に対応するパスワードを指定します。

通常，認可識別子は「root」が仮定されるため，この値を指定する必要はありません。ajsembdbadduserコマンドを使用して，新たに組み込みDBに管理者を追加・変更した場合だけ指定してください。

指定された値は，大文字・小文字が区別されます。

コマンド実行時にエラーが発生する場合があります。エラーが発生した場合は次の表に従って対処し，コマンドを再実行してください。

メッセージID

原因

対処方法

KAVS0983-E

ユーザー名またはパスワードに誤りがあるためデータベースに接続できない。

-a，-apオプションに正しい値を指定して再実行してください。

また，「SHIFT TABLE」のメッセージ出力中にこのエラーが発生した場合は構成定義を見直してください。

構成定義には，正しく動作する移行前の設定がされている必要があります。

KAVS1003-E

-aオプションに指定された値が不正。

-aオプションの値に，存在するDB管理者の認可識別子を指定してください。

KFPA11564-E

-aオプションに指定された文字列の長さが8バイトを超えている。

-aオプションの引数を8バイト以下にして再実行してください。

KFPA11107-E

-apオプションに指定された文字列の長さが30バイトを超えている。

-apオプションの引数を30バイト以下にして再実行してください。

KFPA11104-E

-a，-apオプションの引数に，英数字以外の文字が指定されている。

-a，-apオプションの引数を英数字にして再実行してください。

KFPA11204-E

表がない。

-a，-apオプションに指定している値を見直して，表を所有している認可識別子を指定してください。

KFPA11561-E

指定された認可識別子は有効ではない。

-a，-apオプションに指定した値を，DBA権限を持っているユーザーに変更して再実行してください。

付録B.1　組み込みDBに新たに管理者を追加・変更する

ここでは，新たに組み込みDBに管理者を追加・変更する手順について説明します。

組み込みDBでは，デフォルトでDB管理者が作成されています。認可識別子は"root"，パスワードは"root"として作成されています。ajsembdbadduserコマンドを使用すると，新たにDB管理者の追加またはパスワードの変更ができます。

ajsembdbadduserコマンドの詳細については，「付録B.3 ajsembdbadduser」を参照してください。

なお，ajsembdbadduserコマンドを実行するには環境変数PDUSERを設定する必要があります。次に示す設定例を参考にして，環境変数PDUSERを設定してください。

Windowsホスト設定例

x:¥> set PDUSER="root"/"root"

UNIXホストの設定例

# PDUSER='"root"/"root"'

# export PDUSER

注意事項

AJS管理者が設定されている場合は，デフォルトの組み込みDB管理者である"root"に加えて，認可識別子"AJS管理者用のOSユーザー名"，パスワード"AJS管理者用のOSユーザー名"のユーザーが追加で作成されます。

（例）

認可識別子が"root"であるDB管理者のパスワードを"jp1ajs2"に変更する場合

Windowsホストの場合

（組み込みDBインストール先ディレクトリはC:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JF0）

ajsembdbadduser -i "C:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JF0" -a root -ap jp1ajs2

UNIXホストの場合

（組み込みDBインストール先ディレクトリは/opt/jp1ajs2/embdb/_JF0）

ajsembdbadduser -i /opt/jp1ajs2/embdb/_JF0 -a root -ap jp1ajs2

DB管理者のパスワードを変更した場合，ajsembdbrorgコマンドやajsembdbreclaimコマンドで指定する-apオプションの値を変更する必要があります。

また，新たにDB管理者を作成することもできます。

(例)

新たに組み込みDB認可識別子"jp1ajs2"のDB管理者を，パスワードを"jp1ajs2"として作成する場合

Windowsホストの場合

（組み込みDBインストール先ディレクトリはC:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JF0）

ajsembdbadduser -i "C:¥Program Files¥HITACHI¥JP1AJS2¥embdb¥_JF0" -a jp1ajs2 -ap jp1ajs2

UNIXホストの場合

（組み込みDBインストール先ディレクトリは/opt/jp1ajs2/embdb/_JF0）

ajsembdbadduser -i /opt/jp1ajs2/embdb/_JF0 -a jp1ajs2 -ap jp1ajs2

DB管理者のパスワードを変更する場合の注意事項

認可識別子"root"のパスワードをデフォルト値の"root"から変更している場合は，jajs_setupコマンドを実行できません。認可識別子"root"のパスワードを変更した場合には，組み込みDBの高度なセットアップによってスケジューラーのセットアップを実施してください。組み込みDBの高度なセットアップの詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド　23.4 組み込みDBの高度なセットアップ」を参照してください。

認可識別子"root"のパスワードをデフォルト値の"root"から変更している場合は，次のコマンドを実行する際に認可識別子およびパスワードを-aオプション，-apオプションに指定してください。

ajsembdbstatus

ajsembdbrorg

ajsembdbreclaim

ajsembdbsetup

-aオプション，-apオプションの詳細については，「付録B 組み込みDBの操作コマンド使用時の注意事項」を参照してください。

一つのホストで複数の組み込みDBを使用していて，"root"のパスワードにそれぞれ異なる設定をしている場合，ajsembdbreclaimコマンドの-mオプションにmanagerを指定して実行すると，コマンドがエラーになります。その場合は，スケジューラーサービスのデータベースとして使用している組み込みDBごとに-aオプションおよび-apオプションを指定し，-mオプションにscheduler，-Fオプションに組み込みDBに対応したスケジューラーサービスを指定してメンテナンスを実施してください。また，エージェント管理データベースについても，格納している組み込みDBの認可識別子とパスワードを-aオプションおよび-apオプションに指定し，-mオプションにagentを指定してメンテナンスを実施してください。各スケジューラーサービス，およびエージェント管理データベースを格納している組み込みDBを確認する場合は，ajsembdbidlistコマンドに-aオプションを指定して実行してください。ajsembdbidlistコマンドの詳細については，「2. セットアップコマンド　ajsembdbidlist」を参照してください。

AJS管理者が設定されている場合は，デフォルトの組み込みDB管理者である"root"に加えて，認可識別子"AJS管理者用のOSユーザー名"，パスワード"AJS管理者用のOSユーザー名"のユーザーが追加で作成されます。そのため，それぞれの認可識別子についてパスワードの変更を検討する必要があります。

付録B.2　組み込みDBのテーブルのオプションを変更する

組み込みDBをスケジューラーサービスのデータベースに指定している場合，JP1/AJS3の運用によってはデータ量的には余裕があったとしても，組み込みDBのデータ格納領域が想定しているよりも早く満杯になってしまう場合があります。これは，データの追加と削除を繰り返すことによって，テーブルに予約された無効領域が発生するために起こる現象です。

ここでは，組み込みDBのデータ領域の仕組みと，無効領域の発生を抑止するためのコマンドについて説明します。

(1)　組み込みDBの領域の仕組み

ここでは，組み込みDBの領域の仕組みについて説明します。

組み込みDBでは，データベース内の実際のデータを「ページ」に格納します。このページを複数集めたものを「セグメント」と呼び，セグメントごとにデータベース内のテーブルを結び付けて管理します。

組み込みDBの領域管理方法を次に示します。

図B‒1　組み込みDBの領域管理方法

組み込みDBへのアクセスでは，次に示す規則で領域を使用します。

一つのセグメント内に，複数のテーブルの情報を格納することはできません。

一つのセグメント内のページが満杯になった場合，新たにセグメントをテーブルに割り当てます。

レコード削除を行った場合，ページおよびセグメントは無効領域となります。ただし，通常，自動的には再利用されません。

再利用できるセグメントおよびページがあっても，未使用領域の使用を優先します。

JP1/AJS3のスケジューラーデータベースには11個のテーブルがあります。ただし，一つのテーブルが多くの無効領域を保持している状態では，データが格納されていない状態でも，それ以外のテーブルで新たな領域は取得できません。これによって，領域不足のエラーが発生してしまうことがあります。

図B‒2　特定のテーブルの無効領域が空き領域をすべて使用してしまった場合

上記の図のように，領域をすべて使用してしまうことによって，新たにデータを格納しようとしたときに，テーブルA以外のテーブルでの領域確保時に未使用領域を確保できません。このため，無効領域が存在する場合でも領域不足エラーとなってしまいます。

(2)　空き領域再利用機能の適用

再利用できるセグメントがあっても，未割り当てセグメントが存在すれば使用するのが組み込みDBの標準的な領域割り当て方法です。

組み込みDBには，テーブルごとにデータベース領域内のセグメント再利用を促す空き領域再利用機能があります。この機能を使用することによって，新たなセグメントが必要となった場合で，かつあらかじめ設定したセグメント数を超えようとした場合，そのテーブルに予約されている（過去に使用したことがあり削除されている）セグメントを優先的に再利用します。

例えば，テーブルAに対して50%程度のセグメント数を設定すると，領域内の半分程度のセグメントを使った時点で，新規割り当てによる拡張をいったんやめて，再利用できるセグメントを探すようになります。このため，特定のテーブルで無効領域を占有してしまう状況にはなりません。

組み込みDBのセットアップ時に空き領域再利用機能を有効にしたい場合は，ajsembdbsetupコマンドの-ruオプションを指定する必要があります。ajsembdbsetupコマンドの使用方法については，「2. セットアップコマンド　ajsembdbsetup」を参照してください。

大規模モデルで組み込みDBを構築して，物理ホストのデフォルトスケジューラーサービス（AJSROOT1）で組み込みDBを使用し，空きページ再利用機能を有効にしたい場合は，次のコマンドを実行してください。

ajsembdbsetup -F AJSROOT1 -ru l

すでに組み込みDBのセットアップが完了している環境で，空き領域再利用機能を有効にしたい場合は，ajsembdbreuseコマンドを実施する必要があります。ajsembdbreuseコマンドの詳細については，「付録B.4 ajsembdbreuse」を参照してください。

（例）

ajsembdbbuildコマンドで大規模（-lオプション）を指定した組み込みDBの環境で，表の定義を変更したい場合

Windowsホストの場合

（組み込みDBインストール先ディレクトリはC:¥Program Files (x86)¥HITACHI¥JP1AJS2¥embdb¥_JF0）

ajsembdbreuse -i "C:¥Program Files (x86)¥HITACHI¥JP1AJS2¥embdb¥_JF0" -l

UNIXホストの場合

（組み込みDBインストール先ディレクトリは/opt/jp1ajs2/embdb/_JF0）

ajsembdbreuse -i /opt/jp1ajs2/embdb/_JF0 -l

なお，バックアップ強化機能が有効の場合，上記に加えて次のコマンドを実行する必要があります。

Windowsホストの場合

（組み込みDBインストール先ディレクトリはC:¥Program Files (x86)¥HITACHI¥JP1AJS2¥embdb¥_JF0）

ajsembdbreuse -i "C:¥Program Files (x86)¥HITACHI¥JP1AJS2¥embdb¥_JF0" -l -b

UNIXホストの場合

（組み込みDBインストール先ディレクトリは/opt/jp1ajs2/embdb/_JF0）

ajsembdbreuse -i /opt/jp1ajs2/embdb/_JF0 -l -b

（例）

組み込みDBの環境を構築後，組み込みDBのajsembdbaddareaコマンドでデータベース領域を拡張している場合（AJS2DATAの総セグメント数を200,000としている場合）

Windowsホストの場合

（組み込みDBインストール先ディレクトリはC:¥Program Files (x86)¥HITACHI¥JP1AJS2¥embdb¥_JF0）

ajsembdbreuse -i "C:¥Program Files (x86)¥HITACHI¥JP1AJS2¥embdb¥_JF0" -n 200000

UNIXホストの場合

（組み込みDBインストール先ディレクトリは/opt/jp1ajs2/embdb/_JF0）

ajsembdbreuse -i /opt/jp1ajs2/embdb/_JF0 -n 200000

なお，バックアップ強化機能が有効で，かつデータベース領域（AJS2DATA2）を拡張している場合は，次のコマンドを実行する必要があります。次はAJS2DATA2の総セグメント数を300としている場合の例です。

Windowsホストの場合

（組み込みDBインストール先ディレクトリはC:¥Program Files (x86)¥HITACHI¥JP1AJS2¥embdb¥_JF0）

ajsembdbreuse -i "C:¥Program Files (x86)¥HITACHI¥JP1AJS2¥embdb¥_JF0" -n 300 -b

UNIXホストの場合

（組み込みDBインストール先ディレクトリは/opt/jp1ajs2/embdb/_JF0）

ajsembdbreuse -i /opt/jp1ajs2/embdb/_JF0 -n 300 -b

空き領域再利用機能は，テーブルに対して有効な機能であるため，インデクス領域に対しては適用できません。インデクス領域で発生する無効領域は，定期的にメンテナンスすることが必要です。メンテナンス方法については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド　9.2.2(1) ajsembdbreclaimコマンドを自動で実行する」，およびマニュアル「JP1/Automatic Job Management System 3 運用ガイド　9.2.2(2) ajsembdbreclaimコマンドを手動で実行する」を参照してください。

なお，空き領域再利用機能を有効にした場合でも，業務量の増加や異例運用などによって，領域の占有量が増加してしまうことが考えられます。このため，定期的に未使用領域セグメントを監視する必要があります。

付録B.3　ajsembdbadduser

形式

ajsembdbadduser
     [-i 組み込みDB運用ディレクトリ名称]
     [-mh 論理ホスト名]
     [-p 組み込みDB通信ポート]
     -a 組み込みDB認可識別子
     -ap 組み込みDB認可識別子パスワード

機能

指定された組み込みDB認可識別子と組み込みDB認可識別子パスワードで，新規にDB管理者を作成します。

また，既存のDB認可識別子を指定するとパスワードの変更ができます。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

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

UNIXの場合

/opt/jp1ajs2/tools/

引数

-i 組み込みDB運用ディレクトリ名称

組み込みDBの運用ディレクトリを指定します。ディレクトリは絶対パスで指定してください。Windowsの場合，指定する絶対パスに空白文字を含む場合は，パスを「"（ダブルクォーテーションマーク）」で囲んでください。

組み込みDBの運用ディレクトリのパスについては，ajsembdbidlistコマンドで確認できます。ajsembdbidlistコマンドの詳細については，「2. セットアップコマンド　ajsembdbidlist」を参照してください。

省略時は次の値が仮定されます。

UNIXの場合：/opt/jp1ajs2/embdb/_JF0

Windowsの場合：組み込みDBのセットアップ識別子_JF0に対応する組み込みDB運用ディレクトリ

-mh 論理ホスト名

処理対象とするJP1論理ホスト名を指定します。指定できる文字数は，1〜32（単位：バイト）です。

省略した場合，環境変数JP1_HOSTNAMEの設定があれば，環境変数値が仮定されます。環境変数JP1_HOSTNAMEの指定がない場合は，物理ホストが仮定されます。

-p 組み込みDB通信ポート

組み込みDB接続ポートを10進数で指定します。

指定する組み込みDBの接続ポートについては，スケジューラーサービスの環境設定パラメーターRDBPORTの指定値を参照してください。

スケジューラーサービスと組み込みDBの関連づけについては，ajsembdbidlistコマンドで確認できます。ajsembdbidlistコマンドの詳細については，「2. セットアップコマンド　ajsembdbidlist」を参照してください。

省略した場合，「22220」が仮定されます。

-a 組み込みDB認可識別子

新たに作成したいJP1/AJS3スケジューラーデータベースのテーブル所有者を指定してください。この組み込みDB認可識別子には，DBアクセスユーザー（RDBUSER）を指定しないでください。既存の組み込みDB認可識別子を指定した場合は，-apオプションに指定したパスワードに変更します。

8バイト以内の半角英数字（ただし，先頭文字は英字）で指定してください。

-ap 組み込みDB認可識別子パスワード

組み込みDB認可識別子パスワードを指定します。

30バイト以内の半角英数字（ただし，先頭文字は英字）で指定してください。

注意事項

組み込みDBが動作中に実行できます。組み込みDBが停止している状態で実行するとエラーとなります。

ajsembdbadduserコマンドを実行する前に，環境変数PDUSERを既存のDB管理者の認可識別子と認可識別子パスワードで設定してください。設定しないで実行した場合，エラーとなります。

ajsembdbadduserコマンドを実行して組み込みDBサーバへのアクセスでエラーが発生した場合，組み込みDB接続時のエラー情報が，ajsembdbadduserコマンド実行時の作業ディレクトリにpderr1.trcおよびpderr2.trcのファイル名称で作成されます。コマンド再実行によって正常終了した場合は，これらのファイルを削除してください。

-a，-apオプションに指定できる文字を次に示します。

オプション名

制限バイト数

半角文字の使用可否

全角文字の使用可否

英大文字数字

英小文字

カタカナ文字

下線

（_）

空白

ハイフン

（-）

-a

8バイト

○

○

×

×

×

×

×

-ap

30バイト

○

○

×

×

×

×

×

このコマンドを同時に複数実行しないでください。同時に複数実行した場合，このコマンドが不当にエラーになるおそれがあります。

-aオプションに「root」を指定して組み込みDB認可識別子のパスワードを変更した場合は，jajs_setupコマンドがエラーになることがあります。

戻り値

0

正常終了（ただし，エラーメッセージが出力される場合はメッセージに従って対処してください）。

0以外

異常終了。

エラー発生時の対処

ajsembdbadduserコマンドを実行して，エラーが発生した場合は次の表に従って対処してください。

表B‒1　ajsembdbadduserコマンドエラー発生時の対処

メッセージ

原因

対処

KAVS0996-E

指定されたオプション，および値が不正です。

オプション，およびオプションに指定する値を修正して再実行してください。

KFPA11723-E

組み込みDBが停止しています。

または，-p，-mhオプションに指定した値が誤っています。

組み込みDBを起動してください。

組み込みDBが起動している場合は，-p，-mhオプションに指定した値を見直して再実行してください。

KFPA11564-E

-aオプションに指定された文字列の長さが8バイトを超えています。

-aオプションの引数を8バイト以下にして再実行してください。

KFPA11107-E

-apオプションに指定された文字列の長さが30バイトを超えています。

-apオプションの引数を30バイト以下にして再実行してください。

KFPA11104-E

-a，-apオプションの引数に，英数字以外の文字，または先頭の文字が数字で指定されています。

-a，-apオプションの引数を，半角英数字（ただし，先頭文字は英字）にして再実行してください。

Bad directory specified in -i option

-iオプションに指定したディレクトリが,組み込みDBの運用ディレクトリでないか，セットアップが正常に行われていません。

-iオプションに正しい組み込みDBの運用ディレクトリを指定してください。組み込みDBの運用ディレクトリを指定している場合は，組み込みDBの再セットアップを行ってください。

AuthID is not Specified

-aオプションのオプション引数が指定されていません。

-aオプションのオプション引数を指定してください。

AuthIDPassword is not Specified

-apオプションのオプション引数が指定されていません。

-apオプションのオプション引数を指定してください。

KAVS0101-E

引数を必要とするオプションに対して，引数を指定していません。

オプション引数を指定したあと，コマンドを再実行してください。

KFPA11724-E

-p，-mhオプションに指定した値が誤っているため，組み込みDBに接続できません。

-p，-mhオプションの値に指定した値を修正して再実行してください。

KFPA11560-E

PDUSERに指定した認可識別子パスワードが誤っています。

PDUSERに指定した認可識別子の認可識別子パスワードを指定して再実行してください。

KFPA11561-E

指定された認可識別子は有効ではありません。

PDUSERに指定したユーザーを，DB管理者権限を持っているユーザーに変更して再実行してください。

付録B.4　ajsembdbreuse

形式

ajsembdbreuse
     {{-l | -m | -s | -n セグメント数} | -D}
     [-mh 論理ホスト名]
     [-p 組み込みDB通信ポート]
     [-tp テーブルプリフィックス]
     [-a 組み込みDB認可識別子]
     [-ap 組み込みDB認可識別子パスワード]
     [-i 組み込みDB運用ディレクトリ名称]
     [-b]

機能

指定されたプリフィックスと一致する組み込みDBに作成したJP1/AJS3のテーブルに対して，空き領域の再利用機能を使用できるようにします。

実行権限

Windowsの場合：Administrators権限

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

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

UNIXの場合

/opt/jp1ajs2/tools/

引数

-l|-m|-s|-n セグメント数

空き領域の再利用機能の再利用開始ポイントを指定します。データ領域の使用率がここで指定したポイントに達した場合，空き領域の再利用機能が動作します。

-l，-m，-sオプションは，それぞれajsembdbbuildコマンドのデータベースモデル，大・中・小規模に対応しています。ajsembdbbuildコマンドで指定したデータベースモデルの規模と同じオプションを指定してください。

-nオプションは，データベース領域（AJS2DATA）の総セグメント数がデータベースモデル，大・中・小規模の値と異なる場合に，データベース領域の総セグメント数を指定してください。

-nオプションの値は，100〜確保されているセグメント数までの範囲で指定してください。なお，指定する値は，半角整数で指定してください。範囲外，および半角整数以外の値を指定した場合は，正しい値を指定して再実行してください。

AJS1JINFテーブルの再利用開始ポイントを変更する場合は，-l，-m，-s，-nオプションと同時に-bオプションを指定してください。また，-bオプションを指定した場合，-nオプションにはデータベース領域（AJS2DATA2）の総セグメント数を指定してください。

データベース領域（AJS2DATA，AJS2DATA2）の総セグメント数を調べるには，ajsembdbstatusコマンドの-dbオプション指定を実施してください。

各テーブルに設定されるデータベース領域に対する空き領域の再利用機能の再利用開始ポイントは，次のとおりになります。

表B‒2　各テーブルに設定されるデータベース領域に対する空き領域の再利用機能の再利用開始ポイント

テーブル名

各テーブルで設定される空き領域の再利用機能の再利用開始ポイント

AJS1UNIT

データベース領域AJS2DATA全体のセグメントの6%

（-sオプションを指定した場合は18，-mオプションを指定した場合は183，-lオプションを指定した場合は957を指定します）

AJS1ARROW

AJS1BODY

AJS1SCH

AJS1CAL

AJS1PERF

AJS1ENTRY

AJS1GEN

AJS1STAT

データベース領域AJS2DATA全体のセグメントの16%

（-sオプションを指定した場合は48，-mオプションを指定した場合は489，-lオプションを指定した場合は2553を指定します）

AJS1RELS

データベース領域AJS2DATA全体のセグメントの6%

（-sオプションを指定した場合は18，-mオプションを指定した場合は183，-lオプションを指定した場合は957を指定します）

AJS1ID

AJSAGTEXECCNT

データベース領域AJS2DATA全体のセグメントの1%

（-sオプションを指定した場合は3，-mオプションを指定した場合は30，-lオプションを指定した場合は159を指定します）

AJSEXECAGT

AJSEXECAGTGRP

AJSLINKAGT

AJS1JINF

データベース領域AJS2DATA2全体のセグメントの70%

（-s，-m，-lのどれを指定した場合でも70を指定します）

注

テーブル名は，テーブルプリフィックスを標準の「AJS1」としている場合の名称です。

ajsembdbreuseコマンドの-nオプションで，空き領域の再利用機能の再利用開始ポイントを変更した場合，小数点以下は切り捨てて指定します。

AJS1JINFテーブルとデータベース領域AJS2DATA2は，バックアップ強化機能が有効の場合だけ存在します。

なお，ajsembdbbuildコマンドのデータベースモデル，大・中・小規模で作成される領域のセグメントの全体量は次の表のとおりです。

表B‒3　ajsembdbbuildコマンドのデータベースモデル，大・中・小規模で作成される領域のセグメントの全体量

データベース領域・名称

小規模

中規模

大規模

データベース領域AJS2DATA

300

3,060

15,960

データベース領域AJS2DATA2

100

100

100

-mh 論理ホスト名

処理対象とするJP1論理ホスト名を指定します。指定できる文字数は，1〜32（単位：バイト）です。

省略した場合，環境変数JP1_HOSTNAMEの設定があれば，環境変数値が仮定されます。環境変数JP1_HOSTNAMEの指定がない場合は，物理ホストが仮定されます。

-p 組み込みDB通信ポート

組み込みDB接続ポートを10進数で指定します。

指定する組み込みDBの接続ポートについては，スケジューラーサービスの環境設定パラメーターRDBPORTの指定値を参照してください。

スケジューラーサービスと組み込みDBの関連づけについては，ajsembdbidlistコマンドで確認できます。ajsembdbidlistコマンドの詳細については，「2. セットアップコマンド　ajsembdbidlist」を参照してください。

省略した場合，「22220」が仮定されます。

-tp テーブルプリフィックス

JP1/AJS3スケジューラーデータベースのテーブル名プリフィックスを4バイト以内で指定します。省略時は「AJS1」を仮定します。

指定するテーブルプリフィックスは，空き領域の再利用機能を適用するスケジューラーサービスの環境設定パラメーターTABLENAMEPREFIXの指定値を参照してください。

-a 組み込みDB認可識別子

JP1/AJS3スケジューラーデータベースのテーブル所有者を指定してください。

8バイト以内の半角英数字（ただし，先頭文字は英字）で指定してください。省略した場合は，「root」が仮定されます。

-ap 組み込みDB認可識別子パスワード

組み込みDB認可識別子パスワードを指定します。

30バイト以内の半角英数字（ただし，先頭文字は英字）で指定してください。省略した場合は，「root」が仮定されます。

-D

空き領域の再利用機能を無効にします。空き領域の再利用機能が有効になっていない状態でこのオプションを指定してもエラーにはなりません。

AJS1JINFテーブルの再利用機能を無効にする場合は，-bオプションを同時に指定してください。

-i 組み込みDB運用ディレクトリ名称

組み込みDBの運用ディレクトリを指定します。ディレクトリは絶対パスで指定してください。Windowsの場合，指定する絶対パスに空白文字を含む場合は，パスを「"（ダブルクォーテーションマーク）」で囲んでください。

組み込みDBの運用ディレクトリのパスについては，ajsembdbidlistコマンドで確認できます。ajsembdbidlistコマンドの詳細については，「2. セットアップコマンド　ajsembdbidlist」を参照してください。

省略時は次の値が仮定されます。

UNIXの場合：/opt/jp1ajs2/embdb/_JF0

Windowsの場合：組み込みDBのセットアップ識別子_JF0に対応する組み込みDB運用ディレクトリ

-b

AJS1JINFテーブルの再利用開始ポイントを変更する場合に指定してください。

バックアップ強化機能が無効な組み込みDBに対してこのコマンドを実行する場合は指定しないでください。バックアップ強化機能の設定状況は，ajsembdbstatusコマンドで確認できます。ajsembdbstatusコマンドの詳細については，「3. 通常の運用で使用するコマンド　ajsembdbstatus」を参照してください。

注意事項

このコマンドを実行する前に，JP1/AJS3 - Managerホストで論理ホストを含む，すべてのJP1/AJS3サービスを停止してください。JP1/AJS3が組み込みDBにアクセスしている状態で実行した場合，エラーとなります。

組み込みDBが動作中に実行できます。組み込みDBが停止している状態で実行するとエラーとなります。

ajsembdbreuseコマンドを実行して組み込みDBサーバへのアクセスでエラーが発生した場合，組み込みDB接続時のエラー情報が，ajsembdbreuseコマンド実行時の作業ディレクトリにpderr1.trcおよびpderr2.trcのファイル名称で作成されます。コマンド再実行によって正常終了した場合は，これらのファイルを削除してください。

このコマンドを同時に複数実行しないでください。同時に複数実行した場合，このコマンドが不当にエラーになるおそれがあります。

戻り値

0

正常終了（ただし，エラーメッセージが出力される場合はメッセージに従って対処してください）。

0以外

異常終了。

エラー発生時の対処

ajsembdbreuseコマンドを実行してエラーが発生した場合は，次の表に従って対処してください。

表B‒4　ajsembdbreuseコマンドエラー発生時の対処

メッセージ

原因

対処

KAVS0996-E

指定されたオプション，および値が不正です。

オプション，およびオプションに指定する値を修正して再実行してください。

KFPA11723-E

組み込みDBが停止しています。

または，-p，-mhオプションに指定した値が誤っています。

組み込みDBを起動してください。

組み込みDBが起動している場合は，-p，-mhオプションに指定した値を見直して再実行してください。

KFPA11564-E

-aオプションに指定された文字列の長さが8バイトを超えています。

-aオプションの引数を8バイト以下にして再実行してください。

KFPA11107-E

-apオプションに指定された文字列の長さが30バイトを超えています。

-apオプションの引数を30バイト以下にして再実行してください。

KFPA11104-E

-a，-apオプションの引数に，英数字以外の文字が指定されています。

-a，-apオプションの引数を英数字にして再実行してください。

KFPA11204-E

テーブルがありません。

-a，-apオプションに指定している値を見直して，テーブルを所有している認可識別子を指定してください。

また，-tpオプションの値を見直して，正しいテーブルプリフィックスを指定してください。

バックアップ強化機能が無効の場合は，-bオプションを指定しないでください。

上記のことを見直して再実行してください。

KFPA11561-E

指定された認可識別子は有効ではありません。

-a，-apオプションに指定した値を，DBA権限を持っているユーザーに変更して再実行してください。

KFPA11563-E

KFPA11732-E

組み込みDBにほかのユーザーがアクセスしているため，排他待ちタイムアウトになりました。

JP1/AJS3から組み込みDBへのアクセスをすべて停止してから再実行してください。

Bad directory specified in -i option

-iオプションに指定したディレクトリが,組み込みDBの運用ディレクトリでないか,セットアップが正常に行われていません。

-iオプションに正しい組み込みDBの運用ディレクトリを指定してください。組み込みDBの運用ディレクトリを指定している場合は,組み込みDBの再セットアップを行ってください。

-D cannot be specified with these options.

-Dオプションと同時に指定できない-l，-m，-s，-nオプションのどれかと同時に指定されています。

指定しているオプションを修正して再実行してください。

KAVS0101-E

引数を必要とするオプションに対して，引数を指定していません。

オプションの引数を指定したあと，コマンドを再実行してください。

KFPA11560-E

-apオプションに指定した認可識別子パスワードが誤っています。

-aオプションに指定した認可識別子の認可識別子パスワードを指定して再実行してください。

KFPA11724-E

-p，-mhオプションに指定した値が誤っているため組み込みDBに接続できません。

-p，-mhオプションの値に指定した値を見直して再実行してください。

KFPA11105-E

KFPA11705-E

ERROR Invalid value specified in -n option.

-nオプションに不正な値が指定されています。

10〜確保されているセグメント数までの範囲で値を指定してください。なお，指定する値は，半角整数で指定してください。

付録C　AJS管理者で運用する場合の権限

付録C.1　AJS管理者で運用する場合の，コマンドの実行権限

JP1/AJS3をAJS管理者で運用する場合，AJS管理者は，コマンドの実行にスーパーユーザー権限が必要なコマンドを実行できます。ただし，次に示すコマンドについては，コマンドの機能が制限されます。

表C‒1　AJS管理者で機能が制限されるコマンド

項番

コマンド

制限される機能

1

ajs2collectcore（UNIX限定）

コアダンプファイルから情報を採取するには，コアダンプファイルのOS参照権限が必要です。OS参照権限がないと，このコマンドは実行できません。

AJS管理者がOS参照権限を持っている場合，このコマンドは実行できます。

2

ajsatsetup

AJS管理者では，このコマンドを実行しても，ポート番号を登録できません。コマンドの実行後，スーパーユーザー権限を持つユーザーでポート番号を登録し直してください。

3

ajsbkudel

退避ファイルおよびディレクトリを削除するには，退避ファイルおよびディレクトリに対するOS実行権限が必要です。OS実行権限がないと，このコマンドは実行できません。

AJS管理者がOS実行権限を持っている場合，このコマンドは実行できます。

4

ajschksetup

AJS管理者では，このコマンドを実行しても，ポート番号を登録できません。コマンドの実行後，スーパーユーザー権限を持つユーザーでポート番号を登録し直してください。

5

ajsovsetup

AJS管理者では，このコマンドを実行してもCm2連携機能をセットアップできません。スーパーユーザー権限を持つユーザーで実行してください。

6

ajsovremove

AJS管理者では，このコマンドを実行してもCm2連携機能をアンセットアップできません。スーパーユーザー権限を持つユーザーで実行してください。

7

ajsqlsetup

AJS管理者では，このコマンドを実行しても，ポート番号を登録できません。コマンドの実行後，スーパーユーザー権限を持つユーザーでポート番号を登録し直してください。

8

ajssysctlsetup

AJS管理者では，このコマンドを実行しても，ポート番号を登録できません。コマンドの実行後，スーパーユーザー権限を持つユーザーでポート番号を登録し直してください。

9

ajswebsetup

Web Consoleサーバのセットアップには，スーパーユーザー権限が必要です。AJS管理者では実行できません。

10

jajs_killall.cluster（UNIX限定）

起動中のJP1/AJS3プロセスを強制終了するには，スーパーユーザー権限が必要です。AJS管理者では実行できません。

付録C.2　AJS管理者で運用する場合の，コマンドで操作するディレクトリまたはファイルのアクセス権限

JP1/AJS3をAJS管理者で運用する場合，コマンドで操作したり指定したりするディレクトリまたはファイルには，AJS管理者のアクセス権限が必要です。AJS管理者でコマンドを実行してディレクトリまたはファイルを操作する場合は，事前に適切なアクセス権限を設定しておいてください。

また，AJS管理者で運用する場合には，スーパーユーザーでコマンドを実行するときにも，コマンドで操作したり指定したりするディレクトリまたはファイルには，AJS管理者のアクセス権限が必要です。この場合も，事前に適切なアクセス権限を設定しておいてください。

コマンドで操作するディレクトリまたはファイルと，AJS管理者に必要なアクセス権限を次に示します。

表C‒2　AJS管理者がディレクトリまたはファイルをコマンドで操作する際に必要なアクセス権限

項番

コマンド

オプション

アクセス権限が必要なファイルまたはディレクトリ

AJS管理者に必要な権限

1

ajs2collectcore

f

出力先ディレクトリ

rwx

2

−

コアダンプがあるディレクトリまたはコアダンプファイル

コアダンプがあるディレクトリ：rx

コアダンプファイル：r

3

ajschkdef

p

実行エージェントプロファイル

r

4

e

ユニット属性プロファイル

r

5

o

出力ファイル

rw

6

ajscnvdbexport

b

データベース退避ファイル格納ディレクトリ

rwx

7

ajscnvdbimport

b

データベース退避ファイル格納ディレクトリ

rx

8

ajsembdbaddarea

d

データベース拡張領域格納ディレクトリ

rwx

9

ajsembdbaddlog

d

拡張領域格納ディレクトリ

rwx

10

du

拡張領域格納ディレクトリ（二重化）

rwx

11

ajsembdbbackup

i

組み込みDB運用ディレクトリ

rwx

12

d

データ領域

rw

13

b

バックアップファイル格納ディレクトリ

rwx

14

ajsembdbbuild

d

データ領域ディレクトリ

rwx

15

ld

作業領域ディレクトリ

rwx

16

i

組み込みDB運用ディレクトリ

rwx

17

bl

アンロードログファイル作成ディレクトリ

rwx

18

conf

組み込みDB設定ファイル

r

19

ajsembdbinstl

s

組み込みDBインストール媒体格納ディレクトリ

rx

20

i

組み込みDB運用ディレクトリ

rwx

21

ajsembdboplog

o

出力先ファイル

rw

22

ajsembdbrorg

d

アンロードファイル格納ディレクトリ

rwx

23

ajsembdbrstr

i

組み込みDB運用ディレクトリ

rwx

24

d

データ領域

rw

25

bf

バックアップファイル

r

26

l

アンロードログファイル

r

27

ld

アンロードログ格納ディレクトリ

rx

28

e

出力結果ファイルを格納するディレクトリ

rwx

29

ajsembdbunset

i

組み込みDB運用ディレクトリ

rwx

30

jajs_migrate

T

ワークディレクトリ

rwx

31

jajs_rpenvexport

d

出力ディレクトリ

rwx

32

jajs_rpenvimport

d

入力ディレクトリ

rx

33

jajs_setup

d

データベースディレクトリ

rwx

34

t

テンポラリーディレクトリ

rwx

35

j

ジョブ情報ディレクトリ

rwx

36

b

退避情報ディレクトリ

rwx

37

D

論理ホスト共有ディレクトリ

rwx

38

jajs_setup_cluster

d

共有ディレクトリ

rwx

39

C

組み込みDB設定ファイル

r

40

jp1ajs2_setup_cluster

d

共有ディレクトリ

rwx

41

jpqdbcond

d

ワークファイルのディレクトリ

rwx

42

jpqexport

co

ジョブ実行環境を出力するファイル

rw

43

dp

データベース格納ディレクトリ

rx

44

jpqimport

ci

サブミットジョブ実行環境構成定義ファイル

r

45

dp

データベース格納ディレクトリ

rwx

46

jajs_dbbackup

o

バックアップデータ格納ディレクトリ

rwx

47

jajs_dbrestore

i

バックアップデータ

rwx

（凡例）

−：該当しない。

付録D　APIで取得できるユニット情報

APIで取得できるユニット情報を示します。

付録D.1　APIで取得できるステータス監視リソースのメンバーの一覧

APIで取得できるステータス監視リソースのメンバーの一覧を次の表に示します。

表D‒1　APIで取得できるステータス監視リソースのメンバー

項番

メンバー

取得情報

ユニット一覧の取得API

ユニット情報の取得API

情報を取得できない場合のデフォルト値

1

definition

ユニット定義情報オブジェクト

○

○

−

2

unitStatus

ステータス情報オブジェクト

○※1

○

null

3

release

リリース情報オブジェクト

○※2

○※2

null

（凡例）

○：取得できます。

注※1

次の場合は，情報を取得しません。デフォルト値を返却します。

ユニットが未登録の場合

取得対象の範囲に「定義だけ」を指定した場合

注※2

リリース登録されていない場合は，情報を取得しません。デフォルト値を返却します。

付録D.2　APIで取得できるユニット定義情報オブジェクトのメンバーの一覧

APIで取得できるユニット定義情報オブジェクトのメンバーの一覧を次の表に示します。

表D‒2　APIで取得できるユニット定義情報オブジェクトのメンバー

項番

メンバー

取得情報

ユニット一覧の取得API

ユニット情報の取得API

情報を取得できない場合のデフォルト値

1

unitName

ユニット完全名

○

○

""（空文字）

2

simpleUnitName

ユニット名

○

○

""（空文字）

3

unitComment

ユニットのコメント

○

○

""（空文字）

4

unitType

ユニット種別

○

○

"NONE"

5

customJobType

カスタムジョブの種別

○

○

""（空文字）

6

owner

所有者

○

○

""（空文字）

7

jp1ResourceGroup

JP1資源グループ名

○

○

""（空文字）

8

execAgent

実行エージェント名

○

○

""（空文字）

9

execFileName

実行ファイル名またはスクリプトファイル名

○

○

""（空文字）

10

parameters

パラメーター

○

○

""（空文字）

11

registerStatus

ユニットの登録状態

○※

○

"NONE"

12

unitID

ユニットID

○

○

-1

13

recoveryUnit

リカバリーユニットかどうか

○

○

false

14

jobnetReleaseUnit

リリース登録されているかどうか

○

○

false

15

wait

待ち合わせ条件付きユニットかどうか

○

○

false

16

rootJobnetName

ルートジョブネットのユニット完全名

○

○

""（空文字）

17

customEventJobType

カスタムイベントジョブの種別

○

○

""（空文字）

（凡例）

○：取得できます。

×：取得できません。デフォルト値を返却します。

注※

取得対象の範囲に「定義だけ」を指定した場合は，情報を取得しません。デフォルト値を返却します。

付録D.3　APIで取得できるステータス情報オブジェクトのメンバーの一覧

APIで取得できるステータス情報オブジェクトのメンバーの一覧を次の表に示します。

表D‒3　APIで取得できるステータス情報オブジェクトのメンバー

項番

メンバー

取得情報

ユニット一覧の取得API

ユニット情報の取得API

情報を取得できない場合のデフォルト値

1

unitName

ユニット完全名

○

○

""（空文字）

2

simpleUnitName

ユニット名

○

○

""（空文字）

3

execID

実行ID

○

○

""（空文字）

4

status

ユニットの状態

○

○

"NONE"

5

schStartTime

開始予定日時

○

○

""（空文字）

6

startTime

開始日時

○

○

""（空文字）

7

reStartTime

再実行開始日時

○

○

""（空文字）

8

endTime

終了日時

○

○

""（空文字）

9

startDelayStatus

開始遅延有無

○

○

"NONE"

10

nestStartDelayStatus

配下の開始遅延有無

○

○

"NONE"

11

endDelayStatus

終了遅延有無

○

○

"NONE"

12

nestEndDelayStatus

配下の終了遅延有無

○

○

"NONE"

13

startDelayTime

開始遅延日時

○

○

""（空文字）

14

endDelayTime

終了遅延日時

○

○

""（空文字）

15

changeType

計画一時変更の有無

○

○

"NONE"

16

holdAttr

保留属性

○

○

"NONE"

17

registerTime

ジョブ登録日時

○

○

""（空文字）

18

jobNumber

ジョブ番号

○

○

-1

19

retCode

終了コード

○

○

""（空文字）

20

execHost

実行ホスト名

○

○

""（空文字）

21

delayedStart

開始遅延を監視する方法

×

○※

"NONE"

22

delayedStartTime

開始遅延の監視を始める時刻

×

○※

""（空文字）

23

delayedEnd

終了遅延を監視する方法

×

○※

"NONE"

24

delayedEndTime

終了遅延の監視を始める時刻

×

○※

""（空文字）

25

monitoringJobnet

ジョブネットの実行所要時間による終了遅延の監視の有無

×

○※

"NONE"

26

timeRequiredForExecution

ジョブネットの実行所要時間

×

○※

""（空文字）

（凡例）

○：取得できます。

×：取得できません。デフォルト値を返却します。

注※

ジョブネット（ネストジョブネットを含む）およびリモートジョブネット以外の場合は情報を取得しません。デフォルト値を返却します。

付録D.4　APIで取得できるリリース情報オブジェクトのメンバーの一覧

APIで取得できるリリース情報オブジェクトのメンバーの一覧を示します。

表D‒4　APIで取得できるリリース情報オブジェクトのメンバー

項番

メンバー

取得情報

ユニット一覧の取得API

ユニット情報の取得API

情報を取得できない場合のデフォルト値

1

releaseID

リリースID

○

○

""（空文字）

2

releaseTime

リリース日時

○

○

""（空文字）

3

releaseStatus

リリース状態

○

○

"NONE"

（凡例）

○：取得できます。

×：取得できません。デフォルト値を返却します。

付録E　各バージョンの変更内容

各バージョンでの変更点については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　付録B 各バージョンの変更内容」を参照してください。

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

このマニュアルを読むに当たっての参考情報については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　付録C このマニュアルの参考情報」を参照してください。

付録G　用語解説

用語解説については，マニュアル「JP1/Automatic Job Management System 3 導入ガイド　付録D 用語解説」を参照してください。

索引

記号

_04.bat（Windows限定）[1]

_04（UNIX限定）[1]

A

ab（起動条件定義情報）[1]

abr（HTTP接続ジョブ定義情報）[1]

abr（QUEUEジョブ定義情報）[1]

abr（UNIX／PCカスタムジョブ定義情報）[1]

abr（UNIX／PCジョブ定義情報）[1]

abr（フレキシブルジョブ定義情報）[1]

ajs[1]

ajs_adapter_setup[1]

AJS_AJSCONF[1]

ajs2collectcore（UNIX限定）[1]

ajsagtadd[1]

ajsagtalt[1]

ajsagtcheck[1]

ajsagtdel[1]

ajsagtprint[1]

ajsagtreport[1]

ajsagtshow[1]

ajsalter[1]

ajsatmstart（Linux限定）[1]

ajsatmstop（Linux限定）[1]

ajsatsetup[1]

ajsatstart（Linux限定）[1]

ajsatstatus（Linux限定）[1]

ajsatstop（Linux限定）[1]

AJSAUTOJUDGE[1]

ajsbackup[1]

ajsbkudel[1]

ajscalendar[1]

ajscalutil[1]

ajschange[1]

ajschgjob[1]

ajschgnet[1]

ajschgstat[1]

ajschkdef[1]

ajschksetup[1]

ajschkstart（UNIX限定）[1]

ajschkstop（UNIX限定）[1]

ajschktrsetsz[1]

ajscnvdbexport[1]

ajscnvdbimport[1]

AJSCONF[1]

AJSCONVERTUTF8[1]

ajscopy[1]

ajsdefine[1]

ajsdelete[1]

AJSDISPSUBUNITTYPE[1]

ajsembdbaddarea[1]

ajsembdbaddlog[1]

ajsembdbadduser[1]

ajsembdbbackup[1]

ajsembdbbuild[1]

ajsembdbcancel[1]

ajsembdbidlist[1]

ajsembdbinstl[1]

ajsembdboplog[1]

ajsembdbreclaim[1]

ajsembdbreuse[1]

ajsembdbrorg[1]

ajsembdbrstr[1]

ajsembdbsetup[1]

ajsembdbstart[1]

ajsembdbstatus[1]

ajsembdbstop[1]

ajsembdbuninstl[1]

ajsembdbunset[1]

ajsentry[1]

AJSENV[1]

AJSEXDATE[1]

AJSEXECID[1]

AJSEXECPID[1]

ajsexport[1]

ajsfxbcstatus[1]

ajsgtroot[1]

AJSHOST[1]

ajsimport[1]

ajsintrpt[1]

AJSJOBNAME[1]

ajskill[1]

ajsleave[1]

ajslocaldate[1]

ajslogprint[1]

AJSMANAGERHOST[1]

ajsname[1]

AJSNETNAME[1]

AJSPATH[1]

ajsplan[1]

ajsplanout[1]

AJSPRE_RC[1]

AJSPRE_ST[1]

ajsprint[1]

ajsprofalter[1]

ajsprofstatus[1]

ajsqlalter[1]

ajsqlattach[1]

ajsqldetach[1]

ajsqlexecsetsz[1]

ajsqlftpstart（UNIX限定）[1]

ajsqlftpstop[1]

AJSQLManagerName[1]

ajsqlsetup[1]

ajsqlstart（UNIX限定）[1]

ajsqlstatus[1]

ajsqlstop[1]

ajsqltrsetsz[1]

ajsrelease[1]

ajsreport[1]

ajsrerun[1]

ajsrestore[1]

ajsrgexport[1]

ajsrgimport[1]

ajsschedule[1]

ajssetup[1]

ajsshow[1]

ajssosetup[1]

ajsstart[1]

ajsstatus[1]

ajsstop[1]

ajssuspend[1]

ajssysctlsetup[1]

ajssysctlstart（UNIX限定）[1]

ajssysctlstatus[1]

ajssysctlstop（UNIX限定）[1]

ajstrsetsz[1]

ajswebsetup[1]

ajswebtz.bat（Windows限定）[1]

ajswebtz（Linux限定）[1]

AJS管理者で運用する場合の権限[1]

API一覧[1]

API共通で使用する定数[1]

APIで利用できるデータ型[1]

APIの詳細[1]

API利用時の注意事項[1]

API利用時の認証[1]

ar（ジョブネット定義情報）[1]

AS/400（JP1/OJE for Midrange Computer）と連携する場合[1]

AS/400（JP1/OJE for Midrange Computer）と連携する場合の制限値一覧[1]

AS/400システム[1]

C

cd（ジョブネット定義情報）[1]

cety（カスタムイベントジョブ定義情報）[1]

cftd（ジョブネット定義情報）[1]

cgs（起動条件定義情報）[1]

ChangeExecOrderMethod[1]

ChangeHoldAttr[1]

ChangeLowerType[1]

ChangePushedAheadType[1]

ChangeStartTimeType[1]

ChangeStatus[1]

ChangeType[1]

cl（ジョブグループ定義情報）[1]

cm（属性定義情報）[1]

cmaif（JP1/Cm2状態通知ジョブ定義情報）[1]

cmsts（JP1/Cm2状態通知ジョブ定義情報）[1]

ComStatus[1]

cond（起動条件定義情報）[1]

ConnectInfoType[1]

cprm（カスタムイベントジョブ定義情報）[1]

cty（UNIX／PCカスタムジョブ定義情報）[1]

cty（引き継ぎ情報設定ジョブ定義情報）[1]

cy（ジョブネット定義情報）[1]

D

da（フレキシブルジョブ定義情報）[1]

DateType[1]

de（ジョブネット定義情報）[1]

DelayEnd[1]

DelayMonitor[1]

DelayMonitorType[1]

DelayStart[1]

DelayType[1]

E

ed（ジョブネット定義情報）[1]

ega（HTTP接続ジョブ定義情報）[1]

ega（JP1/Cm2状態通知ジョブ定義情報）[1]

ega（JP1イベント受信監視ジョブ定義情報）[1]

ega（JP1イベント送信ジョブ定義情報）[1]

ega（MSMQ受信監視ジョブ定義情報）[1]

ega（MSMQ送信ジョブ定義情報）[1]

ega（QUEUEジョブ定義情報）[1]

ega（UNIX／PCカスタムジョブ定義情報）[1]

ega（UNIX／PCジョブ定義情報）[1]

ega（Windowsイベントログ監視ジョブ定義情報）[1]

ega（カスタムイベントジョブ定義情報）[1]

ega（実行間隔制御ジョブ定義情報）[1]

ega（ジョブネットコネクタ定義情報）[1]

ega（ジョブネット定義情報）[1]

ega（引き継ぎ情報設定ジョブ定義情報）[1]

ega（ファイル監視ジョブ定義情報）[1]

ega（フレキシブルジョブ定義情報）[1]

ega（メール受信監視ジョブ定義情報）[1]

ega（メール送信ジョブ定義情報）[1]

ega（メッセージキュー受信監視ジョブ定義情報）[1]

ega（メッセージキュー送信ジョブ定義情報）[1]

ega（リモート電源制御ジョブ定義情報）[1]

ega（ローカル電源制御ジョブ定義情報）[1]

ega（ログファイル監視ジョブ定義情報）[1]

ej（判定ジョブ定義情報）[1]

ejc（判定ジョブ定義情報）[1]

ejf（判定ジョブ定義情報）[1]

ejg（判定ジョブ定義情報）[1]

ejh（判定ジョブ定義情報）[1]

eji（判定ジョブ定義情報）[1]

ejl（判定ジョブ定義情報）[1]

ejm（判定ジョブ定義情報）[1]

ejn（ジョブネット定義情報）[1]

ejs（判定ジョブ定義情報）[1]

ejt（判定ジョブ定義情報）[1]

eju（判定ジョブ定義情報）[1]

ejv（判定ジョブ定義情報）[1]

el（ユニット構成定義情報）[1]

env（UNIX／PCカスタムジョブ定義情報）[1]

env（UNIX／PCジョブ定義情報）[1]

env（引き継ぎ情報設定ジョブ定義情報）[1]

env（フレキシブルジョブ定義情報）[1]

etm（HTTP接続ジョブ定義情報）[1]

etm（JP1/Cm2状態通知ジョブ定義情報）[1]

etm（JP1イベント受信監視ジョブ定義情報）[1]

etm（JP1イベント送信ジョブ定義情報）[1]

etm（MSMQ受信監視ジョブ定義情報）[1]

etm（MSMQ送信ジョブ定義情報）[1]

etm（UNIX／PCカスタムジョブ定義情報）[1]

etm（UNIX／PCジョブ定義情報）[1]

etm（Windowsイベントログ監視ジョブ定義情報）[1]

etm（カスタムイベントジョブ定義情報）[1]

etm（実行間隔制御ジョブ定義情報）[1]

etm（ファイル監視ジョブ定義情報）[1]

etm（メール受信監視ジョブ定義情報）[1]

etm（メール送信ジョブ定義情報）[1]

etm（メッセージキュー受信監視ジョブ定義情報）[1]

etm（メッセージキュー送信ジョブ定義情報）[1]

etm（リモート電源制御ジョブ定義情報）[1]

etm（ローカル電源制御ジョブ定義情報）[1]

etm（ログファイル監視ジョブ定義情報）[1]

etn（実行間隔制御ジョブ定義情報）[1]

ets（JP1イベント受信監視ジョブ定義情報）[1]

ets（MSMQ受信監視ジョブ定義情報）[1]

ets（Windowsイベントログ監視ジョブ定義情報）[1]

ets（カスタムイベントジョブ定義情報）[1]

ets（実行間隔制御ジョブ定義情報）[1]

ets（ファイル監視ジョブ定義情報）[1]

ets（メール受信監視ジョブ定義情報）[1]

ets（メッセージキュー受信監視ジョブ定義情報）[1]

ets（ログファイル監視ジョブ定義情報）[1]

eu（HTTP接続ジョブ定義情報）[1]

eu（JP1/Cm2状態通知ジョブ定義情報）[1]

eu（JP1イベント受信監視ジョブ定義情報）[1]

eu（JP1イベント送信ジョブ定義情報）[1]

eu（MSMQ受信監視ジョブ定義情報）[1]

eu（MSMQ送信ジョブ定義情報）[1]

eu（QUEUEジョブ定義情報）[1]

eu（UNIX／PCカスタムジョブ定義情報）[1]

eu（UNIX／PCジョブ定義情報）[1]

eu（Windowsイベントログ監視ジョブ定義情報）[1]

eu（カスタムイベントジョブ定義情報）[1]

eu（実行間隔制御ジョブ定義情報）[1]

eu（ファイル監視ジョブ定義情報）[1]

eu（フレキシブルジョブ定義情報）[1]

eu（メール受信監視ジョブ定義情報）[1]

eu（メール送信ジョブ定義情報）[1]

eu（メッセージキュー受信監視ジョブ定義情報）[1]

eu（メッセージキュー送信ジョブ定義情報）[1]

eu（リモート電源制御ジョブ定義情報）[1]

eu（ローカル電源制御ジョブ定義情報）[1]

eu（ログファイル監視ジョブ定義情報）[1]

eun（HTTP接続ジョブ定義情報）[1]

eun（JP1/Cm2状態通知ジョブ定義情報）[1]

eun（JP1イベント受信監視ジョブ定義情報）[1]

eun（JP1イベント送信ジョブ定義情報）[1]

eun（MSMQ受信監視ジョブ定義情報）[1]

eun（MSMQ送信ジョブ定義情報）[1]

eun（QUEUEジョブ定義情報）[1]

eun（UNIX／PCカスタムジョブ定義情報）[1]

eun（UNIX／PCジョブ定義情報）[1]

eun（Windowsイベントログ監視ジョブ定義情報）[1]

eun（カスタムイベントジョブ定義情報）[1]

eun（実行間隔制御ジョブ定義情報）[1]

eun（ジョブネットコネクタ定義情報）[1]

eun（ジョブネット定義情報）[1]

eun（引き継ぎ情報設定ジョブ定義情報）[1]

eun（ファイル監視ジョブ定義情報）[1]

eun（フレキシブルジョブ定義情報）[1]

eun（メール受信監視ジョブ定義情報）[1]

eun（メール送信ジョブ定義情報）[1]

eun（メッセージキュー受信監視ジョブ定義情報）[1]

eun（メッセージキュー送信ジョブ定義情報）[1]

eun（リモート電源制御ジョブ定義情報）[1]

eun（ローカル電源制御ジョブ定義情報）[1]

eun（ログファイル監視ジョブ定義情報）[1]

ev（UNIX／PCカスタムジョブ定義情報）[1]

ev（UNIX／PCジョブ定義情報）[1]

evdet（JP1イベント受信監視ジョブ定義情報）[1]

evesc（JP1イベント受信監視ジョブ定義情報）[1]

evgid（JP1イベント受信監視ジョブ定義情報）[1]

evgrp（JP1イベント受信監視ジョブ定義情報）[1]

evhst（JP1イベント受信監視ジョブ定義情報）[1]

evhst（JP1イベント送信ジョブ定義情報）[1]

evipa（JP1イベント受信監視ジョブ定義情報）[1]

evpid（JP1イベント受信監視ジョブ定義情報）[1]

evsfr（JP1イベント送信ジョブ定義情報）[1]

evsid（JP1イベント送信ジョブ定義情報）[1]

evsms（JP1イベント送信ジョブ定義情報）[1]

evspl（JP1イベント送信ジョブ定義情報）[1]

evsrc（JP1イベント送信ジョブ定義情報）[1]

evsrt（JP1イベント送信ジョブ定義情報）[1]

evssv（JP1イベント送信ジョブ定義情報）[1]

evtmc（JP1イベント受信監視ジョブ定義情報）[1]

evuid（JP1イベント受信監視ジョブ定義情報）[1]

evusr（JP1イベント受信監視ジョブ定義情報）[1]

evwfr（JP1イベント受信監視ジョブ定義情報）[1]

evwid（JP1イベント受信監視ジョブ定義情報）[1]

evwms（JP1イベント受信監視ジョブ定義情報）[1]

evwsv（JP1イベント受信監視ジョブ定義情報）[1]

ex（HTTP接続ジョブ定義情報）[1]

ex（JP1/Cm2状態通知ジョブ定義情報）[1]

ex（JP1イベント受信監視ジョブ定義情報）[1]

ex（JP1イベント送信ジョブ定義情報）[1]

ex（MSMQ受信監視ジョブ定義情報）[1]

ex（MSMQ送信ジョブ定義情報）[1]

ex（UNIX／PCカスタムジョブ定義情報）[1]

ex（UNIX／PCジョブ定義情報）[1]

ex（Windowsイベントログ監視ジョブ定義情報）[1]

ex（カスタムイベントジョブ定義情報）[1]

ex（実行間隔制御ジョブ定義情報）[1]

ex（ジョブネット定義情報）[1]

ex（ファイル監視ジョブ定義情報）[1]

ex（フレキシブルジョブ定義情報）[1]

ex（メール受信監視ジョブ定義情報）[1]

ex（メール送信ジョブ定義情報）[1]

ex（メッセージキュー受信監視ジョブ定義情報）[1]

ex（メッセージキュー送信ジョブ定義情報）[1]

ex（リモート電源制御ジョブ定義情報）[1]

ex（ローカル電源制御ジョブ定義情報）[1]

ex（ログファイル監視ジョブ定義情報）[1]

ExecAgentJobClass[1]

ExecAgentStatus[1]

ExecOrderMethod[1]

ey（ジョブネット定義情報）[1]

F

fd（HTTP接続ジョブ定義情報）[1]

fd（JP1/Cm2状態通知ジョブ定義情報）[1]

fd（JP1イベント受信監視ジョブ定義情報）[1]

fd（JP1イベント送信ジョブ定義情報）[1]

fd（MSMQ受信監視ジョブ定義情報）[1]

fd（MSMQ送信ジョブ定義情報）[1]

fd（QUEUEジョブ定義情報）[1]

fd（UNIX／PCカスタムジョブ定義情報）[1]

fd（UNIX／PCジョブ定義情報）[1]

fd（Windowsイベントログ監視ジョブ定義情報）[1]

fd（カスタムイベントジョブ定義情報）[1]

fd（実行間隔制御ジョブ定義情報）[1]

fd（ジョブネット定義情報）[1]

fd（ファイル監視ジョブ定義情報）[1]

fd（メール受信監視ジョブ定義情報）[1]

fd（メール送信ジョブ定義情報）[1]

fd（メッセージキュー受信監視ジョブ定義情報）[1]

fd（メッセージキュー送信ジョブ定義情報）[1]

fd（リモート電源制御ジョブ定義情報）[1]

fd（ローカル電源制御ジョブ定義情報）[1]

fd（ログファイル監視ジョブ定義情報）[1]

flco（ファイル監視ジョブ定義情報）[1]

flwc（ファイル監視ジョブ定義情報）[1]

flwf（ファイル監視ジョブ定義情報）[1]

flwi（ファイル監視ジョブ定義情報）[1]

fxg（フレキシブルジョブ定義情報）[1]

G

GenerationType[1]

gty（ジョブグループ定義情報）[1]

H

ha（HTTP接続ジョブ定義情報）[1]

ha（JP1/Cm2状態通知ジョブ定義情報）[1]

ha（JP1イベント受信監視ジョブ定義情報）[1]

ha（JP1イベント送信ジョブ定義情報）[1]

ha（MSMQ受信監視ジョブ定義情報）[1]

ha（MSMQ送信ジョブ定義情報）[1]

ha（QUEUEジョブ定義情報）[1]

ha（UNIX／PCカスタムジョブ定義情報）[1]

ha（UNIX／PCジョブ定義情報）[1]

ha（Windowsイベントログ監視ジョブ定義情報）[1]

ha（カスタムイベントジョブ定義情報）[1]

ha（実行間隔制御ジョブ定義情報）[1]

ha（ジョブネット定義情報）[1]

ha（判定ジョブ定義情報）[1]

ha（ファイル監視ジョブ定義情報）[1]

ha（フレキシブルジョブ定義情報）[1]

ha（メール受信監視ジョブ定義情報）[1]

ha（メール送信ジョブ定義情報）[1]

ha（メッセージキュー受信監視ジョブ定義情報）[1]

ha（メッセージキュー送信ジョブ定義情報）[1]

ha（リモート電源制御ジョブ定義情報）[1]

ha（ローカル電源制御ジョブ定義情報）[1]

ha（ログファイル監視ジョブ定義情報）[1]

HoldAttr[1]

HoldPlan[1]

HOME[1]

htcdm（HTTP接続ジョブ定義情報）[1]

htcfl（HTTP接続ジョブ定義情報）[1]

htexm（HTTP接続ジョブ定義情報）[1]

htknd（HTTP接続ジョブ定義情報）[1]

htrbf（HTTP接続ジョブ定義情報）[1]

htrhf（HTTP接続ジョブ定義情報）[1]

htrqf（HTTP接続ジョブ定義情報）[1]

htrqm（HTTP接続ジョブ定義情報）[1]

htrqu（HTTP接続ジョブ定義情報）[1]

htspt（HTTP接続ジョブ定義情報）[1]

htstf（HTTP接続ジョブ定義情報）[1]

HTTP接続ジョブ定義情報[1]

I

IPv6アドレスの指定方法[1]

J

jajs_config[1]

jajs_dbbackup[1]

jajs_dbrestore[1]

jajs_extdb[1]

jajs_hstd[1]

jajs_hstd_stop[1]

jajs_killall.cluster（UNIX限定）[1]

jajs_log.bat（Windows限定）[1]

jajs_log（UNIX限定）[1]

jajs_maintain[1]

jajs_migrate[1]

jajs_pmtcon[1]

jajs_rpenvexport[1]

jajs_rpenvimport[1]

jajs_rpsite[1]

jajs_setup[1]

jajs_setup_cluster[1]

jajs_spmd[1]

jajs_spmd_status[1]

jajs_spmd_stop[1]

jajs_start.cluster（UNIX限定）[1]

jajs_start（UNIX限定）[1]

jajs_status[1]

jajs_stop.cluster（UNIX限定）[1]

jajs_stop（UNIX限定）[1]

jajs_web_stop（Linux限定）[1]

jajs_web（Linux限定）[1]

jajsacfg（Windows限定）[1]

jajsshowadminusr（UNIX限定）[1]

jc（ジョブネット定義情報）[1]

jd（HTTP接続ジョブ定義情報）[1]

jd（QUEUEジョブ定義情報）[1]

jd（UNIX／PCカスタムジョブ定義情報）[1]

jd（UNIX／PCジョブ定義情報）[1]

jd（フレキシブルジョブ定義情報）[1]

jdf（HTTP接続ジョブ定義情報）[1]

jdf（UNIX／PCカスタムジョブ定義情報）[1]

jdf（UNIX／PCジョブ定義情報）[1]

jdf（フレキシブルジョブ定義情報）[1]

JP1_HOSTNAME[1]、[2]

JP1_USERNAME[1]、[2]

JP1/AJS3を制御するコマンドの一覧[1]

JP1/AJS3 - Managerのプロトコルバージョンの取得API[1]

JP1/Cm2状態通知ジョブ定義情報[1]

JP1/OJE for VOS3と連携する場合の制限値一覧[1]

jp1exec（Windows限定）[1]

jp1exit（Windows限定）[1]

JP1JobID[1]

JP1JobName[1]

JP1NBQSClientName[1]

JP1NBQSQueueName[1]

JP1Priority[1]

JP1UNCName[1]

JP1UserName[1]

JP1イベント受信監視ジョブ定義情報[1]

JP1イベント送信ジョブ定義情報[1]

jpoagoec[1]

jpoagtjobshow[1]

jpoif（JP1イベント受信監視ジョブ定義情報）[1]

jpoif（MSMQ受信監視ジョブ定義情報）[1]

jpoif（Windowsイベントログ監視ジョブ定義情報）[1]

jpoif（カスタムイベントジョブ定義情報）[1]

jpoif（実行間隔制御ジョブ定義情報）[1]

jpoif（ファイル監視ジョブ定義情報）[1]

jpoif（メール受信監視ジョブ定義情報）[1]

jpoif（メッセージキュー受信監視ジョブ定義情報）[1]

jpoif（ログファイル監視ジョブ定義情報）[1]

jpomailprof（Windows限定）[1]

jpomailrecv（UNIX限定）[1]

jpomanevreset[1]

jpomanevshow[1]

jpomanjobshow[1]

jpqagtadd[1]

jpqagtalt[1]

jpqagtdel[1]

jpqagtlink[1]

jpqagtshow[1]

jpqagtunlink[1]

jpqdbcond[1]

jpqendjobshow[1]

jpqexport[1]

jpqimport[1]

jpqjobalt[1]

jpqjobcan[1]

jpqjobdel[1]

jpqjobget[1]

jpqjobmove[1]

jpqjobshow[1]

jpqjobsub[1]

jpqqueadd[1]

jpqquealt[1]

jpqqueclose[1]

jpqquedel[1]

jpqqueopen[1]

jpqqueshow[1]

jpqregguestuser[1]

jpqreguser[1]

jpqresadd[1]

jpqresdel[1]

jpqresshow[1]

jty（JP1/Cm2状態通知ジョブ定義情報）[1]

jty（JP1イベント送信ジョブ定義情報）[1]

jty（MSMQ送信ジョブ定義情報）[1]

jty（UNIX／PCジョブ定義情報）[1]

jty（メール送信ジョブ定義情報）[1]

jty（メッセージキュー送信ジョブ定義情報）[1]

jty（リモート電源制御ジョブ定義情報）[1]

jty（ローカル電源制御ジョブ定義情報）[1]

L

LANG[1]、[2]

LC_ALL[1]

lfcre（ログファイル監視ジョブ定義情報）[1]

lfdft（ログファイル監視ジョブ定義情報）[1]

lffnm（ログファイル監視ジョブ定義情報）[1]

lfhds（ログファイル監視ジョブ定義情報）[1]

lfmks（ログファイル監視ジョブ定義情報）[1]

lfmxl（ログファイル監視ジョブ定義情報）[1]

lfrft（ログファイル監視ジョブ定義情報）[1]

lfsiv（ログファイル監視ジョブ定義情報）[1]

lfsrc（ログファイル監視ジョブ定義情報）[1]

lftpd（ログファイル監視ジョブ定義情報）[1]

ln（ジョブネット定義情報）[1]

LOGNAME[1]

LowerType[1]

M

MAIL[1]

MatchMethods[1]

mcs（起動条件定義情報）[1]

md（ジョブグループ定義情報）[1]

mh（マネージャーユニット定義情報）[1]

mladr（メール受信監視ジョブ定義情報）[1]

mladr（メール送信ジョブ定義情報）[1]

mlafl（メール受信監視ジョブ定義情報）[1]

mlafl（メール送信ジョブ定義情報）[1]

mlatf（メール送信ジョブ定義情報）[1]

mlftx（メール送信ジョブ定義情報）[1]

mllst（メール受信監視ジョブ定義情報）[1]

mlprf（メール受信監視ジョブ定義情報）[1]

mlprf（メール送信ジョブ定義情報）[1]

mlsav（メール受信監視ジョブ定義情報）[1]

mlsbj（メール受信監視ジョブ定義情報）[1]

mlsbj（メール送信ジョブ定義情報）[1]

mlsfd（メール受信監視ジョブ定義情報）[1]

mlstx（メール受信監視ジョブ定義情報）[1]

mltxt（メール受信監視ジョブ定義情報）[1]

mltxt（メール送信ジョブ定義情報）[1]

mm（HTTP接続ジョブ定義情報）[1]

mm（JP1/Cm2状態通知ジョブ定義情報）[1]

mm（JP1イベント受信監視ジョブ定義情報）[1]

mm（JP1イベント送信ジョブ定義情報）[1]

mm（MSMQ受信監視ジョブ定義情報）[1]

mm（MSMQ送信ジョブ定義情報）[1]

mm（QUEUEジョブ定義情報）[1]

mm（UNIX／PCカスタムジョブ定義情報）[1]

mm（UNIX／PCジョブ定義情報）[1]

mm（Windowsイベントログ監視ジョブ定義情報）[1]

mm（カスタムイベントジョブ定義情報）[1]

mm（実行間隔制御ジョブ定義情報）[1]

mm（ジョブネットコネクタ定義情報）[1]

mm（ジョブネット定義情報）[1]

mm（引き継ぎ情報設定ジョブ定義情報）[1]

mm（ファイル監視ジョブ定義情報）[1]

mm（フレキシブルジョブ定義情報）[1]

mm（メール受信監視ジョブ定義情報）[1]

mm（メール送信ジョブ定義情報）[1]

mm（メッセージキュー受信監視ジョブ定義情報）[1]

mm（メッセージキュー送信ジョブ定義情報）[1]

mm（リモート電源制御ジョブ定義情報）[1]

mm（ローカル電源制御ジョブ定義情報）[1]

mm（ログファイル監視ジョブ定義情報）[1]

MonitoringJobnet[1]

MonitoringJobnetType[1]

mp（ジョブネット定義情報）[1]

mqcor（メッセージキュー受信監視ジョブ定義情報）[1]

mqcor（メッセージキュー送信ジョブ定義情報）[1]

mqdsc（メッセージキュー受信監視ジョブ定義情報）[1]

mqdsc（メッセージキュー送信ジョブ定義情報）[1]

mqeqn（メッセージキュー送信ジョブ定義情報）[1]

mqhld（メッセージキュー送信ジョブ定義情報）[1]

mqmdl（メッセージキュー受信監視ジョブ定義情報）[1]

mqmdl（メッセージキュー送信ジョブ定義情報）[1]

mqmdn（メッセージキュー送信ジョブ定義情報）[1]

mqmfn（メッセージキュー送信ジョブ定義情報）[1]

mqmgr（メッセージキュー送信ジョブ定義情報）[1]

mqpgm（メッセージキュー送信ジョブ定義情報）[1]

mqpri（メッセージキュー送信ジョブ定義情報）[1]

mqprm（メッセージキュー送信ジョブ定義情報）[1]

mqque（メッセージキュー受信監視ジョブ定義情報）[1]

mqque（メッセージキュー送信ジョブ定義情報）[1]

mqsfn（メッセージキュー受信監視ジョブ定義情報）[1]

ms（ジョブネット定義情報）[1]

msapl（MSMQ受信監視ジョブ定義情報）[1]

msapl（MSMQ送信ジョブ定義情報）[1]

mshld（MSMQ送信ジョブ定義情報）[1]

msjnl（MSMQ送信ジョブ定義情報）[1]

mslbl（MSMQ受信監視ジョブ定義情報）[1]

mslbl（MSMQ送信ジョブ定義情報）[1]

mslmt（MSMQ送信ジョブ定義情報）[1]

msmod（MSMQ送信ジョブ定義情報）[1]

MSMQ受信監視ジョブ定義情報[1]

MSMQ送信ジョブ定義情報[1]

mspri（MSMQ送信ジョブ定義情報）[1]

msqlb（MSMQ送信ジョブ定義情報）[1]

msqpt（MSMQ受信監視ジョブ定義情報）[1]

msqpt（MSMQ送信ジョブ定義情報）[1]

msrer（MSMQ受信監視ジョブ定義情報）[1]

msrer（MSMQ送信ジョブ定義情報）[1]

mssvf（MSMQ受信監視ジョブ定義情報）[1]

mstfn（MSMQ送信ジョブ定義情報）[1]

msttp（MSMQ送信ジョブ定義情報）[1]

msunr（MSMQ送信ジョブ定義情報）[1]

mu（マネージャーユニット定義情報）[1]

N

ncex（ジョブグループ定義情報）[1]

ncex（ジョブネットコネクタ定義情報）[1]

ncex（ジョブネット定義情報）[1]

nchn（ジョブグループ定義情報）[1]

nchn（ジョブネットコネクタ定義情報）[1]

nchn（ジョブネット定義情報）[1]

ncl（ジョブグループ定義情報）[1]

ncl（ジョブネット定義情報）[1]

ncn（ジョブグループ定義情報）[1]

ncn（ジョブネット定義情報）[1]

ncr（ジョブネットコネクタ定義情報）[1]

ncs（ジョブグループ定義情報）[1]

ncs（ジョブネット定義情報）[1]

ncsv（ジョブグループ定義情報）[1]

ncsv（ジョブネットコネクタ定義情報）[1]

ncsv（ジョブネット定義情報）[1]

ni（ジョブネット定義情報）[1]

nmg（HTTP接続ジョブ定義情報）[1]

nmg（JP1/Cm2状態通知ジョブ定義情報）[1]

nmg（JP1イベント受信監視ジョブ定義情報）[1]

nmg（JP1イベント送信ジョブ定義情報）[1]

nmg（MSMQ受信監視ジョブ定義情報）[1]

nmg（MSMQ送信ジョブ定義情報）[1]

nmg（QUEUEジョブ定義情報）[1]

nmg（UNIX／PCカスタムジョブ定義情報）[1]

nmg（UNIX／PCジョブ定義情報）[1]

nmg（Windowsイベントログ監視ジョブ定義情報）[1]

nmg（カスタムイベントジョブ定義情報）[1]

nmg（実行間隔制御ジョブ定義情報）[1]

nmg（ジョブネットコネクタ定義情報）[1]

nmg（ジョブネット定義情報）[1]

nmg（引き継ぎ情報設定ジョブ定義情報）[1]

nmg（ファイル監視ジョブ定義情報）[1]

nmg（フレキシブルジョブ定義情報）[1]

nmg（メール受信監視ジョブ定義情報）[1]

nmg（メール送信ジョブ定義情報）[1]

nmg（メッセージキュー受信監視ジョブ定義情報）[1]

nmg（メッセージキュー送信ジョブ定義情報）[1]

nmg（リモート電源制御ジョブ定義情報）[1]

nmg（ローカル電源制御ジョブ定義情報）[1]

nmg（ログファイル監視ジョブ定義情報）[1]

ntcls（Windowsイベントログ監視ジョブ定義情報）[1]

ntdis（Windowsイベントログ監視ジョブ定義情報）[1]

nteid（Windowsイベントログ監視ジョブ定義情報）[1]

ntevt（Windowsイベントログ監視ジョブ定義情報）[1]

ntlgt（Windowsイベントログ監視ジョブ定義情報）[1]

ntncl（Windowsイベントログ監視ジョブ定義情報）[1]

ntnei（Windowsイベントログ監視ジョブ定義情報）[1]

ntnsr（Windowsイベントログ監視ジョブ定義情報）[1]

ntolg（Windowsイベントログ監視ジョブ定義情報）[1]

ntsrc（Windowsイベントログ監視ジョブ定義情報）[1]

O

op（ジョブグループ定義情報）[1]

P

PATH[1]

pfm（JP1/Cm2状態通知ジョブ定義情報）[1]

pfm（JP1イベント送信ジョブ定義情報）[1]

pfm（メール受信監視ジョブ定義情報）[1]

pfm（メール送信ジョブ定義情報）[1]

pfm（メッセージキュー送信ジョブ定義情報）[1]

pfm（リモート電源制御ジョブ定義情報）[1]

pfm（ローカル電源制御ジョブ定義情報）[1]

PlannedTimePassedType[1]

pr（HTTP接続ジョブ定義情報）[1]

pr（QUEUEジョブ定義情報）[1]

pr（UNIX／PCカスタムジョブ定義情報）[1]

pr（UNIX／PCジョブ定義情報）[1]

pr（ジョブネット定義情報）[1]

prm（QUEUEジョブ定義情報）[1]

prm（UNIX／PCカスタムジョブ定義情報）[1]

prm（UNIX／PCジョブ定義情報）[1]

prm（引き継ぎ情報設定ジョブ定義情報）[1]

prm（フレキシブルジョブ定義情報）[1]

pwlf（ローカル電源制御ジョブ定義情報）[1]

pwlt（ローカル電源制御ジョブ定義情報）[1]

pwrf（リモート電源制御ジョブ定義情報）[1]

pwrh（リモート電源制御ジョブ定義情報）[1]

pwrn（リモート電源制御ジョブ定義情報）[1]

pwrp（リモート電源制御ジョブ定義情報）[1]

pwrr（リモート電源制御ジョブ定義情報）[1]

pwrw（リモート電源制御ジョブ定義情報）[1]

Q

qm（QUEUEジョブ定義情報）[1]

qu（QUEUEジョブ定義情報）[1]

QUEUEジョブ定義情報[1]

R

rec（HTTP接続ジョブ定義情報）[1]

rec（QUEUEジョブ定義情報）[1]

rec（UNIX／PCカスタムジョブ定義情報）[1]

rec（UNIX／PCジョブ定義情報）[1]

rec（フレキシブルジョブ定義情報）[1]

RegisterStatus[1]

rei（HTTP接続ジョブ定義情報）[1]

rei（QUEUEジョブ定義情報）[1]

rei（UNIX／PCカスタムジョブ定義情報）[1]

rei（UNIX／PCジョブ定義情報）[1]

rei（フレキシブルジョブ定義情報）[1]

ReleaseInfoSearchMethods[1]

ReleaseStatus[1]

req（QUEUEジョブ定義情報）[1]

RerunOption[1]

RerunType[1]

rg（ジョブネット定義情報）[1]

rh（ジョブネット定義情報）[1]

rje（HTTP接続ジョブ定義情報）[1]

rje（QUEUEジョブ定義情報）[1]

rje（UNIX／PCカスタムジョブ定義情報）[1]

rje（UNIX／PCジョブ定義情報）[1]

rje（フレキシブルジョブ定義情報）[1]

rjs（HTTP接続ジョブ定義情報）[1]

rjs（QUEUEジョブ定義情報）[1]

rjs（UNIX／PCカスタムジョブ定義情報）[1]

rjs（UNIX／PCジョブ定義情報）[1]

rjs（フレキシブルジョブ定義情報）[1]

RootRerunType[1]

S

sc（QUEUEジョブ定義情報）[1]

sc（UNIX／PCカスタムジョブ定義情報）[1]

sc（UNIX／PCジョブ定義情報）[1]

sc（引き継ぎ情報設定ジョブ定義情報）[1]

sc（フレキシブルジョブ定義情報）[1]

sd（ジョブネット定義情報）[1]

sdd（ジョブグループ定義情報）[1]

se（HTTP接続ジョブ定義情報）[1]

se（UNIX／PCカスタムジョブ定義情報）[1]

se（UNIX／PCジョブ定義情報）[1]

sea（UNIX／PCカスタムジョブ定義情報）[1]

sea（UNIX／PCジョブ定義情報）[1]

SearchTargetType[1]

sh（ジョブネット定義情報）[1]

shd（ジョブネット定義情報）[1]

SHELL[1]

si（UNIX／PCカスタムジョブ定義情報）[1]

si（UNIX／PCジョブ定義情報）[1]

so（HTTP接続ジョブ定義情報）[1]

so（UNIX／PCカスタムジョブ定義情報）[1]

so（UNIX／PCジョブ定義情報）[1]

soa（UNIX／PCカスタムジョブ定義情報）[1]

soa（UNIX／PCジョブ定義情報）[1]

st（ジョブネット定義情報）[1]

Status[1]

stt（ジョブグループ定義情報）[1]

sy（ジョブネット定義情報）[1]

sz（ユニット構成定義情報）[1]

T

td1（QUEUEジョブ定義情報）[1]

td1（UNIX／PCカスタムジョブ定義情報）[1]

td1（UNIX／PCジョブ定義情報）[1]

td2（QUEUEジョブ定義情報）[1]

td2（UNIX／PCカスタムジョブ定義情報）[1]

td2（UNIX／PCジョブ定義情報）[1]

td3（QUEUEジョブ定義情報）[1]

td3（UNIX／PCカスタムジョブ定義情報）[1]

td3（UNIX／PCジョブ定義情報）[1]

td4（QUEUEジョブ定義情報）[1]

td4（UNIX／PCカスタムジョブ定義情報）[1]

td4（UNIX／PCジョブ定義情報）[1]

te（UNIX／PCカスタムジョブ定義情報）[1]

te（UNIX／PCジョブ定義情報）[1]

tho（HTTP接続ジョブ定義情報）[1]

tho（QUEUEジョブ定義情報）[1]

tho（UNIX／PCカスタムジョブ定義情報）[1]

tho（UNIX／PCジョブ定義情報）[1]

tho（引き継ぎ情報設定ジョブ定義情報）[1]

tho（フレキシブルジョブ定義情報）[1]

TimeType（起動条件パラメーターオブジェクト）[1]

TimeType（ステータス情報オブジェクト）[1]

tmitv（実行間隔制御ジョブ定義情報）[1]

top1（UNIX／PCカスタムジョブ定義情報）[1]

top1（UNIX／PCジョブ定義情報）[1]

top2（UNIX／PCカスタムジョブ定義情報）[1]

top2（UNIX／PCジョブ定義情報）[1]

top3（UNIX／PCカスタムジョブ定義情報）[1]

top3（UNIX／PCジョブ定義情報）[1]

top4（UNIX／PCカスタムジョブ定義情報）[1]

top4（UNIX／PCジョブ定義情報）[1]

ts1（QUEUEジョブ定義情報）[1]

ts1（UNIX／PCカスタムジョブ定義情報）[1]

ts1（UNIX／PCジョブ定義情報）[1]

ts2（QUEUEジョブ定義情報）[1]

ts2（UNIX／PCカスタムジョブ定義情報）[1]

ts2（UNIX／PCジョブ定義情報）[1]

ts3（QUEUEジョブ定義情報）[1]

ts3（UNIX／PCカスタムジョブ定義情報）[1]

ts3（UNIX／PCジョブ定義情報）[1]

ts4（QUEUEジョブ定義情報）[1]

ts4（UNIX／PCカスタムジョブ定義情報）[1]

ts4（UNIX／PCジョブ定義情報）[1]

ty（属性定義情報）[1]

ty（引き継ぎ情報設定ジョブ定義情報）[1]

Type[1]

TZ[1]

U

uem（HTTP接続ジョブ定義情報）[1]

uem（JP1/Cm2状態通知ジョブ定義情報）[1]

uem（JP1イベント受信監視ジョブ定義情報）[1]

uem（JP1イベント送信ジョブ定義情報）[1]

uem（MSMQ受信監視ジョブ定義情報）[1]

uem（MSMQ送信ジョブ定義情報）[1]

uem（QUEUEジョブ定義情報）[1]

uem（UNIX／PCカスタムジョブ定義情報）[1]

uem（UNIX／PCジョブ定義情報）[1]

uem（Windowsイベントログ監視ジョブ定義情報）[1]

uem（カスタムイベントジョブ定義情報）[1]

uem（実行間隔制御ジョブ定義情報）[1]

uem（ジョブネットコネクタ定義情報）[1]

uem（ジョブネット定義情報）[1]

uem（引き継ぎ情報設定ジョブ定義情報）[1]

uem（ファイル監視ジョブ定義情報）[1]

uem（フレキシブルジョブ定義情報）[1]

uem（メール受信監視ジョブ定義情報）[1]

uem（メール送信ジョブ定義情報）[1]

uem（メッセージキュー受信監視ジョブ定義情報）[1]

uem（メッセージキュー送信ジョブ定義情報）[1]

uem（リモート電源制御ジョブ定義情報）[1]

uem（ローカル電源制御ジョブ定義情報）[1]

uem（ログファイル監視ジョブ定義情報）[1]

un（HTTP接続ジョブ定義情報）[1]

un（UNIX／PCカスタムジョブ定義情報）[1]

un（UNIX／PCジョブ定義情報）[1]

UnitStatus[1]

UnitType[1]

UNIX／PCカスタムジョブ定義情報[1]

UNIX／PCジョブ定義情報[1]

W

Waiting[1]

WaitingAction[1]

WaitingStatus[1]

WaitingStatusAction[1]

WaitMethod[1]

wc（ジョブネット定義情報）[1]

Windowsイベントログ監視ジョブ定義情報[1]

wkp（UNIX／PCカスタムジョブ定義情報）[1]

wkp（UNIX／PCジョブ定義情報）[1]

wt（ジョブネット定義情報）[1]

wth（HTTP接続ジョブ定義情報）[1]

wth（QUEUEジョブ定義情報）[1]

wth（UNIX／PCカスタムジョブ定義情報）[1]

wth（UNIX／PCジョブ定義情報）[1]

wth（引き継ぎ情報設定ジョブ定義情報）[1]

wth（フレキシブルジョブ定義情報）[1]

お

オブジェクト一覧[1]

オブジェクトの詳細[1]

オプション[1]

か

外部DBを操作するコマンドの一覧[1]

確定実行登録API[1]

各バージョンの変更内容[1]

カスタムイベントジョブ定義情報の記述方法[1]

環境変数一覧[1]

完全名[1]

き

起動条件定義情報[1]

起動条件パラメーターオブジェクト[1]

起動条件パラメーターオブジェクトで使用する定数[1]

強制終了API[1]

く

組み込みDBに新たに管理者を追加・変更する[1]

組み込みDBの操作コマンド使用時の注意事項[1]

組み込みDBのテーブルのオプションを変更する[1]

組み込みDBを操作するコマンドの一覧[1]

け

計画一時変更（実行中止）API[1]

計画一時変更（即時実行）API[1]

計画一時変更（日時変更）API[1]

計画一時変更（変更解除）API[1]

計画一時変更APIで使用する定数[1]

計画実行登録API[1]

こ

コマンド一覧[1]

コマンド共通の注意事項[1]

コマンド実行時に使用される環境変数の一覧[1]

コマンド実行時の環境変数[1]

コマンド実行の前提条件[1]

コマンド使用時の注意事項[1]

コマンドの指定方法[1]

コマンドの文法の説明に使用する記号[1]

コマンドのリモート実行[1]

コマンドを実行するコンソールでの操作に関する注意事項[1]

コマンドを実行する際に起動しておく必要があるサービス[1]

さ

再実行API[1]

再実行APIで使用する定数[1]

サブミットジョブ実行環境構成定義ファイル（jpqsetup.conf）の定義方法[1]

し

システムリソースを大量に消費するコマンドに関する注意事項[1]

実行ID[1]

実行エージェントグループの受付配信制限の状態の変更API[1]

実行エージェントグループの削除API[1]

実行エージェントグループの状況一覧の取得API[1]

実行エージェントグループの設定変更API[1]

実行エージェントグループの追加API[1]

実行エージェントグループの定義の取得API[1]

実行エージェント定義情報のオブジェクト[1]

実行エージェントの受付配信制限の状態の変更API[1]

実行エージェントの運用に使用するコマンドの一覧[1]

実行エージェントのオブジェクトで使用する定数[1]

実行エージェントの削除API[1]

実行エージェントの実行状況一覧の取得API[1]

実行エージェントの状況一覧の取得API[1]

実行エージェントの状況オブジェクト[1]

実行エージェントの状況の取得API[1]

実行エージェントの状態の変更API[1]

実行エージェントの除外，追加，優先順位の変更API[1]

実行エージェントの設定変更API[1]

実行エージェントの操作結果オブジェクト[1]

実行エージェントの追加API[1]

実行エージェントの定義の取得API[1]

実行間隔制御ジョブ定義情報[1]

実行結果詳細の取得API[1]

実行順序制御方式の変更API[1]

実行順序制御方式の変更APIで使用する定数[1]

実行登録APIで使用する定数[1]

障害時に使用するコマンドの一覧[1]

ジョブ強制終了[1]

ジョブグループ定義情報[1]

ジョブ実行時に設定される環境変数の一覧[1]

ジョブ状態変更API[1]

ジョブ状態変更APIで使用する定数[1]

ジョブ制限[1]

ジョブネットコネクタ定義情報[1]

ジョブネット制限[1]

ジョブネット定義情報[1]

ジョブの実行に使用するコマンドの一覧[1]

ジョブ配信遅延の軽減機能の通信状態確認API[1]

処理同士が競合するコマンドに関する注意事項[1]

す

推定所要時間を算出する[1]

スケジューラーサービス強制終了[1]

スケジューラーサービスに関するコマンドの注意事項[1]

スケジューラーサービス名[1]

スケジュール制限[1]

ステータス監視のリソース[1]

ステータス情報オブジェクト[1]

ステータス情報オブジェクトで使用する定数[1]

せ

正規表現で指定できる記号，指定例，および取得例[1]

セットアップ時に使用するコマンドの一覧[1]

そ

総称名の指定方法[1]

即時実行登録API[1]

属性定義情報[1]

た

他プログラムとの連携[1]

ち

遅延監視変更API[1]

遅延監視変更APIで使用する定数[1]

中断API[1]

と

登録解除API[1]

特別な運用で使用するコマンドの一覧（QUEUEジョブ，サブミットジョブ実行環境で使用するコマンド）[1]

特別な運用で使用するコマンドの一覧（運用テストで使用するコマンド）[1]

特別な運用で使用するコマンドの一覧（キューレスジョブ使用時に使用するコマンド）[1]

は

バージョン情報の取得API[1]

判定ジョブ定義情報[1]

ひ

引数[1]

引き継ぎ情報設定ジョブ定義情報[1]

ふ

ファイル監視ジョブ定義情報[1]

プランニンググループ使用時のコマンドでのユニット名の指定方法[1]

プランニンググループの下にあるユニット名の指定方法[1]

フレキシブルジョブ定義情報[1]

ほ

保留属性変更API[1]

保留属性変更APIで使用する定数[1]

ま

マクロ変数オブジェクト[1]

待ち合わせ条件の状態一覧の取得API[1]

待ち合わせ状態の変更API[1]

待ち合わせで使用する定数[1]

待ち合わせのリソース[1]

マネージャーユニット定義情報[1]

め

メール受信監視ジョブ定義情報[1]

メール送信ジョブ定義情報[1]

メッセージキュー受信監視ジョブ定義情報[1]

メッセージキュー送信ジョブ定義情報[1]

も

文字コードUTF-8を使用している場合の注意事項[1]

ゆ

ユニット一覧の取得API[1]

ユニット一覧の取得APIで使用する定数[1]

ユニット構成定義情報[1]

ユニット情報の取得API[1]

ユニット情報の取得APIで使用する定数[1]

ユニット定義情報オブジェクト[1]

ユニット定義情報オブジェクトで使用する定数[1]

ユニット名[1]

ユニット名の指定方法[1]

ユニットを操作するコマンドの一覧[1]

り

リクエストの形式[1]

リソース一覧[1]

リソースの詳細[1]

リモート実行できるコマンドとリモート実行の方法[1]

リモート電源制御ジョブ定義情報[1]

リリース情報オブジェクト[1]

リリース情報オブジェクトで使用する定数[1]

れ

レスポンスの形式[1]

ろ

ローカル電源制御ジョブ定義情報[1]

ログファイル監視ジョブ定義情報[1]

論理ホスト名[1]