JP1 Version 10　JP1/Automatic Job Management System 3 - Software Development Kit 設計・構築ガイド

解説・手引・操作書

3021-3-118-10

前書き

対象製品

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

P-2A12-32A4 JP1/Automatic Job Management System 3 - Software Development Kit 10-10　（適用OS：Windows 8，Windows Server 2012，Windows 7，Windows Server 2008，Windows Server 2003）

輸出時の注意

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

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

商標類

Active Directoryは，米国Microsoft Corporationの，米国およびその他の国における登録商標または商標です。

Microsoftは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

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

Windowsは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

Windows NTは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

Windows Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

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

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

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

表記

製品名

Windows 7

Microsoft(R) Windows(R) 7 Professional

Microsoft(R) Windows(R) 7 Enterprise

Microsoft(R) Windows(R) 7 Ultimate

Windows 8

Windows(R) 8

Windows(R) 8 Pro

Windows(R) 8 Enterprise

Windows Server 2003

Windows Server 2003

Microsoft(R) Windows Server(R) 2003, Enterprise Edition

Microsoft(R) Windows Server(R) 2003, Standard Edition

Windows Server 2003 R2

Microsoft(R) Windows Server(R) 2003 R2, Enterprise Edition

Microsoft(R) Windows Server(R) 2003 R2, Standard Edition

Windows Server 2003（x64）

Microsoft(R) Windows Server(R) 2003, Enterprise x64 Edition

Microsoft(R) Windows Server(R) 2003, Standard x64 Edition

Windows Server 2003 R2（x64）

Microsoft(R) Windows Server(R) 2003 R2, Enterprise x64 Edition

Microsoft(R) Windows Server(R) 2003 R2, Standard x64 Edition

Windows Server 2008

Windows Server 2008

Microsoft(R) Windows Server(R) 2008 Enterprise

Microsoft(R) Windows Server(R) 2008 Standard

Windows Server 2008 R2

Microsoft(R) Windows Server(R) 2008 R2 Datacenter

Microsoft(R) Windows Server(R) 2008 R2 Enterprise

Microsoft(R) Windows Server(R) 2008 R2 Standard

Windows Server 2012

Microsoft(R) Windows Server(R) 2012 Standard

Microsoft(R) Windows Server(R) 2012 Datacenter

発行

2013年 9月 3021-3-118-10

著作権

Copyright (C) 2012, 2013, Hitachi, Ltd.

Copyright (C) 2012, 2013, Hitachi Solutions, Ltd.

変更内容

変更内容（3021-3-118-10）

追加・変更内容

変更個所

記載内容を変更した。詳細については，付録Eを参照のこと。

付録E

はじめに

このマニュアルはJP1/Automatic Job Management System 3 - Software Development Kit（以降，JP1/AJS3 - SDKと省略します）について説明したものです。このマニュアルを利用することで，JP1/AJS3 - Managerを操作するためのアプリケーションを開発および運用できるようになることを目的としています。

対象読者

このマニュアルはJP1/AJS3 - SDKを使ってシステムを開発するソフトウェア開発者の方を対象としています。また，次の知識を持っていることを前提としています。

JP1/AJS3およびJP1/Baseの機能に関する知識

Javaプログラミングでのアプリケーション開発に関する十分な知識

マニュアルの構成

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

第1章 JP1/AJS3 - SDKの概要

JP1/AJS3 - SDKの機能概要と特長について説明しています。

第2章 システム設計

JP1/AJS3 - SDKを使用するシステムを構築する上で必要な検討項目について説明しています。

第3章 インストールとセットアップ

JP1/AJS3 - SDKのインストールおよびセットアップの方法について説明しています。

第4章 ユーザーアプリケーションの設計

ユーザーアプリケーションを開発する上で必要な検討項目について説明しています。

第5章 ユーザーアプリケーションの開発

JP1/AJS3 - SDKを利用したユーザーアプリケーションの開発例について説明しています。

第6章 運用

JP1/AJS3 - SDKを使用したユーザーアプリケーションの運用時に必要な操作について説明しています。

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

JP1/AJS3 - SDKを使用したユーザーアプリケーションの運用中にトラブルが発生したときの対処方法について説明しています。

読書手順

このマニュアルは，利用目的に合わせて章を選択して読むことができます。利用目的別にお読みいただくことをお勧めします。

マニュアルを読む目的

記述個所

JP1/AJS3 - SDKがどんな製品か知りたい。

1章

JP1/AJS3 - SDKを使用してシステムを構築したい。

2章，3章

ユーザーアプリケーションを開発したい。

4章，5章

JP1/AJS3 - SDKを使用してユーザーアプリケーションを運用するときに，設定を変更する方法やJP1/AJS3 - Managerでの操作方法を知りたい。

6章

トラブルの対処方法を知りたい。

7章

このマニュアルの変更内容について知りたい。

付録E

このマニュアルの参考情報について知りたい。

付録F

JP1/AJS3 - SDKマニュアルの使い分けについて

JP1/AJS3 - SDKのマニュアルは2冊に分かれています。次に示す表でマニュアルの記載内容をご確認の上，利用目的に合わせてマニュアルをお読みください。

マニュアル名

記載内容

JP1/Automatic Job Management System 3 - Software Development Kit 設計・構築ガイド

JP1/AJS3 - SDKの機能概要

JP1/AJS3 - SDKの設計および構築

ユーザーアプリケーションの設計および開発

トラブルシューティング

JP1/Automatic Job Management System 3 - Software Development Kit APIリファレンス

APIの文法

メッセージ

1　JP1/AJS3 - SDKの概要

この章では，JP1/AJS3 - SDKの特長やJP1/AJS3 - Managerとの連携の仕組みについて説明します。

1.1　JP1/AJS3 - SDKの特長

JP1/AJS3 - SDKとはどのような製品であるのか，またJP1/AJS3 - SDKを使用してできることについて説明します。

1.1.1　JP1/AJS3 - SDKとは

JP1/AJS3 - SDKは，JP1/AJS3上のジョブネットを操作するための，Java言語で実装したクラスライブラリを提供します。JP1/AJS3 - SDKを使用することで，JP1/AJS3と連携したシステムを構築できます。また，ユーザーの運用に合わせた独自のインターフェースを作成しやすくなります。

1.1.2　JP1/AJS3 - SDKでできること

JP1/AJS3 - SDKを使用してできることについて説明します。

(1)　運用方法に合わせたGUIを作成してJP1/AJS3を操作できます

JP1/AJS3 - SDKを使用することで，独自のGUIを実装したユーザーアプリケーションを開発できます。例えば，各操作ボタンの使用頻度を考慮してボタンを配置したり，ボタン名を運用現場で使用する用語に合わせたりするなど，さまざまなユーザーのニーズに対応することができます。

図1‒1　ユーザーアプリケーションの画面例

(2)　さまざまな場所からJP1/AJS3を操作できます

ユーザーアプリケーションをWebアプリケーションとして実装できます。Webアプリケーションとして実装することで，インターネットを利用してJP1/AJS3を操作できます。運用時に利用する機器に合わせたWebアプリケーションを開発することで，モバイル機器を使用してさまざまな場所からJP1/AJS3を操作できます。

1.2　ユーザーアプリケーションでできる操作

ユーザーアプリケーションでできる操作を次の表に示します。

表1‒1　ユーザーアプリケーションでできる操作

項番

操作

操作例

1

認証

ログイン

ログアウト

2

ジョブネットの実行登録および実行登録解除

即時実行登録

計画実行登録

確定実行登録

実行登録の解除

3

ジョブ・ジョブネットの実行予定の変更

実行予定の追加

実行開始予定日時の変更

一時的な即時実行

実行中止

実行開始予定日時の変更の解除

4

ジョブ・ジョブネットの属性の変更

保留属性の変更

遅延監視の変更

実行状態の変更

5

ジョブ・ジョブネットの実行の中断および再実行

実行の中断

強制終了

再実行

6

ユニット情報の取得

ユニット一覧情報の取得

ユニット一覧情報の取得の中止

ユニット詳細情報の取得

実行結果詳細の取得

引き継ぎ結果の取得

ユニット定義情報，最新状態情報，および最新結果情報の取得

ユニット定義情報の取得

ユニット状態情報の取得

関連線情報の取得

予実績情報の取得

予実績情報の取得の中止

カレンダー情報の取得

サマリー情報の取得

リリース情報の取得

7

スケジューラーサービス情報の取得

スケジューラーサービス一覧の取得

スケジューラーサービス情報の取得

8

JP1/AJS3 - Manager情報の取得

JP1/AJS3 - Manager情報の取得

9

その他

文字コードの取得

文字コードの設定

1.3　ユーザーアプリケーションで作成できる画面例

ユーザーアプリケーションで独自のGUIを実装する場合，JP1/AJS3 - SDKのAPIを呼び出すことで，次のような画面を作成できます。

図1‒2　監視対象ユニットの一連の情報を確認する画面例

関連項目

5.2　画面作成例

1.4　JP1/AJS3 - SDKのシステム概要

JP1/AJS3 - SDKのシステムの概要について説明します。

1.4.1　JP1/AJS3 - SDKを使用したJP1/AJS3 - Managerの操作の仕組み

ユーザーアプリケーションでの操作内容は，JP1/AJS3 - SDKが提供するAPIおよびクラスライブラリを利用してJP1/AJS3 - Managerで実行されます。JP1/AJS3 - SDKを使用してJP1/AJS3 - Managerを操作する仕組みを次の図に示します。

図1‒3　JP1/AJS3 - Managerの操作の仕組み

ユーザーアプリケーションからAPIが発行されると，JP1/AJS3 - SDKからJP1/AJS3 - ManagerにAPIの実行を要求します。JP1/AJS3 - Managerで処理を実行したあと，実行結果はJP1/AJS3 - SDKを介してユーザーアプリケーションに返却されます。

ユーザーアプリケーションは，WebアプリケーションまたはC/Sアプリケーションとして実装できます。

1.4.2　Webアプリケーションとして実装する場合のシステムの概要

ユーザーアプリケーションは，Webアプリケーションとして実装できます。Webアプリケーションとして実装する場合のシステムの概要を次の図に示します。

図1‒4　Webアプリケーションとして実装する場合のシステムの概要

ユーザーは，WebブラウザーからWebアプリケーションを通じてJP1/AJS3 - Managerを操作できます。

1.4.3　C/Sアプリケーションとして実装する場合のシステムの概要

ユーザーアプリケーションは，C/Sアプリケーションとして実装できます。C/Sアプリケーションとして実装する場合のシステムの概要を次の図に示します。

図1‒5　C/Sアプリケーションとして実装する場合のシステムの概要

ユーザーは，クライアントアプリケーションからサーバアプリケーションを通じてJP1/AJS3 - Managerを操作できます。

1.5　運用までの流れ

JP1/AJS3 - SDKを使用したユーザーアプリケーションを運用するまでの流れを次の図に示します。

図1‒6　JP1/AJS3 - SDKを使用したユーザーアプリケーションの運用までの流れ

2　システム設計

この章では，JP1/AJS3 - SDKのシステムを設計する際のポイントについて説明します。

2.1　システムの前提条件

ここでは，JP1/AJS3 - SDKの前提OS，ならびにユーザーアプリケーションを開発および実行する環境に必要なプログラムについて説明します。

2.1.1　前提OS

JP1/AJS3 - SDKの前提OSを次に示します。

Windows 8

Windows Server 2012

Windows 7

Windows Server 2008

Windows Server 2003

2.1.2　前提プログラム

ユーザーアプリケーションの開発環境または実行環境に必要な前提プログラムを次に示します。

開発環境の前提プログラム

JP1/AJS3 - Manager 10-00以降

32ビット版のJava(TM) Platform, Standard Edition Development Kit 6

または

32ビット版のJava(TM) Platform, Standard Edition Development Kit 7

実行環境の前提プログラム

JP1/AJS3 - Manager 10-00以降

32ビット版のJava(TM) Platform, SE Runtime Environment Version 6

または

32ビット版のJava(TM) Platform, SE Runtime Environment Version 7

注意事項

接続先のJP1/AJS3 - Managerのデータベース構成は，標準構成で使用することを推奨します。接続先のJP1/AJS3 - Managerのデータベース構成が互換用ISAM構成の場合，使用できるAPIの機能が大幅に制限されます。接続先のJP1/AJS3 - Managerのデータベース構成を考慮した上で，システム構成を検討してください。接続先のJP1/AJS3 - Managerの違いによる機能差異については，マニュアル「JP1/Automatic Job Management System 3 - Software Development Kit APIリファレンス」を参照してください。

なお，ユーザーアプリケーションがWebアプリケーションの場合には，Webアプリケーションを開発または実行するための環境が必要です。

2.2　システム設計時の検討項目一覧

JP1/AJS3 - SDKのシステムを設計するときに検討が必要な項目を，次の表に示します。

表2‒1　システム設計時の検討項目一覧

項番

検討項目

マニュアル参照先

1

システム構成

2.3

2

ネットワーク構成

2.4

3

JP1/AJS3 - Managerの環境設定

2.5

4

JP1/AJS3 - SDKの環境設定

2.6

5

システム環境

2.7

6

クラスタシステムでの運用

2.8

7

クラスライブラリの参照方法

2.9

関連項目

2.1 システムの前提条件

2.3　システム構成の検討

JP1/AJS3 - SDKのシステム構成について説明します。ここでは，ユーザーアプリケーションを開発する環境（開発環境）とユーザーアプリケーションを実行する環境（実行環境）に分けて説明します。

2.3.1　開発環境のシステム構成（最小構成）

開発環境の最小構成は，JP1/AJS3 - SDKと前提プログラムを1台のホストに構築した構成です。

開発環境の最小構成例を次の図に示します。

図2‒1　開発環境のシステム構成例（最小構成）

最小構成の場合，前提プログラムの前提OSとJP1/AJS3 - SDKの前提OSが同一である必要があります。

関連項目

2.1.1 前提OS

2.1.2 前提プログラム

2.3.2　開発環境のシステム構成（基本構成）

開発環境の基本構成は，システムを，ユーザーアプリケーションを開発するホストとJP1/AJS3 - Managerホストに分けて構築します。この構成では，すでに構築されているJP1/AJS3 - Managerの環境を利用したり，複数の開発者からJP1/AJS3 - Managerの環境を利用したりできます。

開発環境の基本構成例を次の図に示します。

図2‒2　開発環境のシステム構成例（基本構成）

関連項目

2.1.2 前提プログラム

2.3.3　実行環境のシステム構成（基本構成）

実行環境の基本構成は，システムを，ユーザーアプリケーションを実行するホストとJP1/AJS3 - Managerホストに分けて構築します。この構成では，すでに構築されているJP1/AJS3 - Managerの環境を利用したり，すでに構築されているユーザーアプリケーションの実行環境を利用したりできます。

実行環境の基本構成例を次の図に示します。

図2‒3　実行環境のシステム構成例（基本構成）

関連項目

2.1.2 前提プログラム

2.3.4　実行環境のシステム構成（社外アクセスを考慮した構成）

ユーザーアプリケーションがWebアプリケーションの場合，社外からのアクセスがあるかどうかを考慮する必要があります。社外からのアクセスがある場合，セキュリティを考慮したシステムを構築してください。

社外アクセスがある場合の，実行環境の構成例を次の図に示します。

図2‒4　実行環境のシステム構成例（社外アクセスを考慮した構成）

関連項目

2.1.2 前提プログラム

2.4　ネットワーク構成の検討

ここでは，JP1/AJS3 - SDKで利用できるネットワークの設定について説明します。利用できるネットワークの設定を踏まえてネットワーク構成を検討してください。

NATの対応

JP1/AJS3 - SDKはスタティック・モードのNATに対応しています。

ダイナミック・モードのNATおよびNAPTには対応していません。

通信プロトコルの対応

JP1/AJS3 - SDKは，IPv6での通信には対応していません。そのため，システムを構成するホストには，IPv4プロトコルだけに対応するホスト，またはIPv4プロトコルとIPv6プロトコルの両方に対応するホストを使用してください。

2.5　JP1/AJS3 - Managerの環境設定の検討

ここでは，接続先のJP1/AJS3 - Managerでの環境設定について説明します。

2.5.1　JP1/AJS3 - SDKの導入時に検討が必要なJP1/AJS3 - Managerの環境設定項目一覧

JP1/AJS3 - Managerでの環境設定の項目一覧を次の表に示します。

表2‒2　JP1/AJS3 - Managerでの環境設定項目一覧

項番

設定項目

参照先

1

最大同時セッション数

2.5.2

2

JP1/AJS3 - Managerとの接続打ち切り時間

2.5.3

3

デスクトップヒープ領域が不足した場合のログオン情報の再利用

2.5.4

4

スケジューラーログの出力

2.5.5

5

開始および終了メッセージの出力

2.5.6

6

内部ログのサイズ

2.5.7

7

ルートジョブネットのスケジュールの有効範囲

2.5.8

8

世代情報の範囲

2.5.9

9

JP1イベントの発行

2.5.10

2.5.2　最大同時セッション数の検討

接続先のJP1/AJS3 - Managerと通信する際，JP1/AJS3 - SDKのAPIは通信用のインスタンスを生成します。そのインスタンス単位でJP1/AJS3 - Managerのスケジューラーサービスと接続し，セッションを確立します。1つのインスタンスが複数のスケジューラーサービスと接続する場合は，複数のセッションが確立します。スケジューラーサービスに対するセッションが多数ある場合，APIの処理が多発してJP1/AJS3 - Managerホストに負荷が掛かる原因になります。

そのため，JP1/AJS3 - Managerと通信するためのセッション数を，JP1/AJS3 - Managerホスト単位で制限できます。デフォルトの最大同時セッション数は32です。

最大同時セッション数が5の場合に確立できるセッションの例を，次に説明します。

図2‒5　ユーザーアプリケーションからのセッション

ユーザーごとに生成される通信用のインスタンス（AjsCdApiインスタンス）が，各スケジューラーサービスに対して最初に処理を要求したときにセッションが確立されます。例えば，最大同時セッション数が5の場合，接続先のスケジューラーサービスに関係なくJP1/AJS3 - Managerホスト全体でのセッション数が5になると，以降のセッションを拒否します。

最大同時セッション数の見積もり式を次に示します。

JP1/AJS3 - SDKの最大同時セッション数 ＝

128※ − JP1/AJS3 - SDK以外のセッション数の合計

注※

1つの組み込みDBに対する最大同時接続数です。組み込みDBの最大同時接続数については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド1」の組み込みDBのセットアップについて記載している個所を参照してください。

関連項目

3.4.5 JP1/AJS3 - Managerの環境設定

2.5.3　JP1/AJS3 - Managerとの接続打ち切り時間の検討

JP1/AJS3 - Managerとの接続で最後の通信から一定時間が経過した場合に，自動的に接続を打ち切る時間を設定できます。デフォルトは3分です。

例えば，通信障害が発生してログアウト処理が実行されない場合，通信がない状態でセッションが維持されます。このとき，接続打ち切り時間を設定しておくと，自動的に接続が切断され，セッションが解放されます。

接続打ち切り時間を長く設定すると，通信していないセッションが長い時間残り，最大同時セッション数を超えるおそれがあります。そのため，最大同時セッション数を考慮して接続打ち切り時間を検討してください。

関連項目

2.5.2 最大同時セッション数の検討

3.4.5 JP1/AJS3 - Managerの環境設定

2.5.4　デスクトップヒープ領域が不足した場合のログオン情報の再利用の検討

同一のOSユーザーへマッピングして実行されるセッションが多数ある場合，デスクトップヒープが不足します。このような場合，ログオン情報をセッションごとに再利用することで，デスクトップヒープの使用量を節約できます。デスクトップヒープの不足が発生する場合は，ログオン情報を再利用するように設定を変更してください。デフォルトではログオン情報を再利用しません。

また，ログオン情報を再利用する場合，デスクトップヒープを共有するセッション数も同時に検討してください。デフォルトではデスクトップヒープを共有するセッション数は50セッションです。

デスクトップヒープを共有するセッション数が指定値を超えた場合，新しいデスクトップヒープ領域が割り当てられます。デスクトップヒープを共有するセッション数は，デスクトップヒープの容量に合わせて次の式を満たすように指定してください。

ログオン情報を共有するセッション数 ＜

非対話型プロセスに割り当てられるデスクトップヒープの容量※（キロバイト） ／ 10（キロバイト）

注※

非対話型プロセスに割り当てられるデスクトップヒープの容量については，使用するOSのドキュメントを参照してください。

注意事項

この設定を変更するとJP1/AJS3全体の動作に影響があります。

関連項目

3.4.5 JP1/AJS3 - Managerの環境設定

2.5.5　スケジューラーログの出力の検討

JP1/AJS3 - SDKからスケジューラーサービスへの接続開始および終了のメッセージを，スケジューラーログに出力するかどうかを設定できます。デフォルトではスケジューラーログに出力されません。運用に応じて出力するように設定してください。

注意事項

この設定を変更するとJP1/AJS3全体の動作に影響があります。

関連項目

3.4.5 JP1/AJS3 - Managerの環境設定

2.5.6　開始および終了メッセージの出力の検討

JP1/AJS3 - SDKの開始および終了メッセージを次に示すログに出力するかどうか設定できます。デフォルトでは，メッセージがログに出力されます。障害発生時の原因を究明するために必要であるため，デフォルトから変更しないことを推奨します。ログの出力先を次に示します。

Windowsの場合

Windowsイベントログおよび統合トレースログ

UNIXの場合

syslogおよび統合トレースログ

メッセージが出力されるプロセスの種類および出力のタイミングを次の表に示します。

表2‒3　ログに出力されるプロセスの種類および出力のタイミング

項番

プロセス

タイミング

出力されるメッセージ

1

ajscdinetd

起動

KAVS0560-I

2

終了

KAVS0561-I

3

受付処理開始

KAVS0562-I

4

受付処理終了

KAVS0563-I

5

ajsmonsvr

起動

KAVS0564-I

6

終了

KAVS0565-I

注意事項

この設定を変更するとJP1/AJS3全体の動作に影響があります。

関連項目

3.4.5 JP1/AJS3 - Managerの環境設定

2.5.7　内部ログのサイズの検討

JP1/AJS3 - SDKからJP1/AJS3 - Managerへの接続に関する内部ログのサイズを設定できます。

内部ログを出力するプロセスとデフォルトのサイズを次の表に示します。

表2‒4　内部ログを出力するプロセスとデフォルトのサイズ

項番

内部ログを出力するプロセス

デフォルトのサイズ

1

ajscdinetd

128キロバイト

2

ajsmonsvr

4,096キロバイト

関連項目

3.4.5 JP1/AJS3 - Managerの環境設定

2.5.8　ルートジョブネットのスケジュールの有効範囲の検討

ルートジョブネットのスケジュールの有効範囲を指定できます。デフォルトでは，ルートジョブネットのスケジュールの有効範囲は24時間です。有効範囲を48時間にしたい場合に変更します。

なお，世代情報の範囲をすべての日にちにしている場合にだけ，ルートジョブネットのスケジュールの有効範囲を48時間に設定できます。

注意事項

この設定を変更するとJP1/AJS3全体の動作に影響があります。

関連項目

2.5.9 世代情報の範囲の検討

3.4.5 JP1/AJS3 - Managerの環境設定

2.5.9　世代情報の範囲の検討

JP1/AJS3 - SDKにユニットの状態を表示する場合に，情報取得の基にする世代情報の範囲を指定できます。デフォルトでは，すべての日にちを世代情報の範囲として，実行中の世代または予定世代の情報から表示する状態を決定します。世代情報の範囲を当日分にしたい場合に変更します。

なお，ルートジョブネットのスケジュールの有効範囲を48時間に設定している場合，世代情報の範囲を当日分に設定することはできません。

注意事項

この設定を変更するとJP1/AJS3全体の動作に影響があります。

関連項目

2.5.8 ルートジョブネットのスケジュールの有効範囲の検討

3.4.5 JP1/AJS3 - Managerの環境設定

2.5.10　JP1イベントの発行の検討

JP1/AJS3 - SDKから操作したときに，JP1イベントを発行するかどうかを指定できます。デフォルトでは，JP1イベントは発行されません。運用に応じて発行するように設定してください。

注意事項

この設定を変更するとJP1/AJS3全体の動作に影響があります。

関連項目

3.4.5 JP1/AJS3 - Managerの環境設定

2.6　JP1/AJS3 - SDKの環境設定の検討

JP1/AJS3 - SDKは，ユーザーアプリケーションごとに動作環境を環境設定ファイルで設定できます。環境設定ファイルがない場合，ユーザーアプリケーションは各設定項目でデフォルト値を仮定して動作します。

環境設定ファイルで設定する項目を次の表に示します。

表2‒5　環境設定ファイルで設定する項目

項番

設定項目

設定内容

デフォルト

1

接続ポート番号（port_number）

JP1/AJS3 - Managerへの接続ポート番号を設定します。

22250

2

文字コード（default_charcode）

JP1/AJS3 - Managerの文字コードを取得できない場合に仮定する文字コードのデフォルト値を設定します。

MS932

3

接続タイムアウト時間※1（connect_timeout）

JP1/AJS3 - Managerとの接続が通信エラーの場合に，タイムアウト処理を実行する時間を設定します。

0秒（タイムアウト処理を実行しない）

4

通信接続リトライ回数（connect_retry_count）

JP1/AJS3 - Managerとの接続が通信エラーの場合に，接続をリトライする回数を設定します。

3回

5

通信接続リトライ間隔（connect_retry_interval）

JP1/AJS3 - Managerとの接続が通信エラーの場合に，接続をリトライする間隔を設定します。

12秒

6

受信タイムアウト時間（receive_timeout）

JP1/AJS3 - Managerからデータを受信する場合のタイムアウト時間を設定します。

180秒

7

ログイン待ち時間（login_wait）

JP1/AJS3 - Managerの認証に失敗した場合に，ログイン待ちをする時間を設定します。

1秒

8

トレースログの出力先フォルダ（tracelog_dir）

トレースログを出力するフォルダを指定します。

JP1/AJS3 - SDK運用フォルダ¥log

9

トレースログファイルのサイズ（tracelog_size）

トレースログファイルのサイズを指定します。

2,097,152バイト

10

トレースログファイルの面数（tracelog_num）

トレースログファイルの面数を設定します。

3個

11

トレースログの出力レベル（tracelog_level）

トレースログの出力レベルを指定します。

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

12

文字コードの取得※2（getmanager_charcode）

JP1/AJS3 - Managerの文字コードを取得するかどうか設定します。

JP1/AJS3 - Managerの文字コードを取得する

13

言語設定（lang）

メッセージの言語を設定します。

Java Runtime Environmentのロケール設定の言語

14

情報取得APIの取得結果の上限数（api_search_resultmax）

情報取得APIで取得する情報の上限数を設定します。

1,000個

注※1

OSの接続タイムアウト仕様とその設定によって，環境設定ファイルに設定した値より前に接続のタイムアウトが発生することがあります。

注※2

中国語環境で使用するJP1/AJS3 - Managerと接続する場合だけ変更します。

関連項目

2.7.2 使用する文字コードの検討

3.1.7 JP1/AJS3 - SDK運用フォルダの確認

3.5.1 環境設定ファイルの反映手順

3.5.3 環境設定ファイルの設定項目の詳細

2.7　システム環境の検討

システム環境の検討について説明します。

2.7.1　タイムゾーンの検討

JP1/AJS3 - SDKがインストールされているホストのタイムゾーンは，接続先のJP1/AJS3 - Managerホストと同じタイムゾーンで運用することを推奨します。

APIの引数として扱われる日時情報は，接続先のJP1/AJS3 - Managerホストのタイムゾーンに従って処理されます。そのため，接続先のJP1/AJS3 - Managerホストと異なるタイムゾーンで運用する場合，接続先のJP1/AJS3 - Managerホストのタイムゾーンを考慮して運用する必要があります。また，接続先のJP1/AJS3 - Managerで，対象のスケジューラーサービスがローカル日時で運用されているときは，ローカル日時に従って処理されます。

2.7.2　使用する文字コードの検討

APIの引数として扱われる文字情報は，Java規定のエンコーディングセットに自動的に変換されます。ただし，接続先のJP1/AJS3 - Managerを中国語環境で使用する場合は，取得したJP1/AJS3 - Managerの文字コードをJava規定のエンコーディングセットに正しく変換できません。そのため，環境設定ファイルに次の設定をしてください。

表2‒6　接続先のJP1/AJS3 - Managerを中国語環境で使用する場合の環境設定

設定項目

設定値

デフォルトの文字コード（default_charcode）※

接続先のJP1/AJS3 - Managerの文字コードに対応するJava規定のエンコーディングセット名

文字コードの取得（getmanager_charcode）

no

注※

この設定は，環境設定ファイルで文字コードの取得（getmanager_charcode）に「no」が指定されている場合にだけ有効になります。

また，ユーザーアプリケーションの開発時には，文字コードを設定するAPI（setCharCodeメソッド）を使用して，接続先のJP1/AJS3 - Managerの文字コードに対応するJava規定のエンコーディングセット名を設定してください。なお，文字コードを設定するAPIは，JP1/AJS3 - Managerへのログインを要求するメソッドの直後に設定してください。

注意事項

環境設定ファイルのデフォルトの文字コード（default_charcode），および文字コードを設定するAPI（setCharCodeメソッド）の両方で文字コードを設定した場合，APIで設定した文字コードが有効になります。

2.8　クラスタシステムでの運用の検討

JP1/AJS3 - SDKがインストールされているホストをクラスタシステムで運用する場合，サーバでフェールオーバーが発生した場合の対処を検討してください。

ユーザーアプリケーションの実行中にサーバで障害が発生してフェールオーバーした場合，JP1/AJS3 - SDKは認証や接続先ホストなどの情報を引き継ぐことはできません。再度，クラスの生成や認証からの操作が必要です。

2.9　クラスライブラリの参照方法の検討

ユーザーアプリケーションをWebアプリケーションとして運用する場合，JP1/AJS3 - SDKが提供するクラスライブラリの参照方法を検討してください。

WebアプリケーションがJP1/AJS3 - SDKのクラスライブラリを参照する方法は，2通りあります。それぞれの方法で，クラスライブラリの入れ替え時に必要な操作が異なります。そのため，システム全体の運用を考慮してJP1/AJS3 - SDKのクラスライブラリの参照方法を検討してください。

クラスライブラリの参照方法を次に説明します。

WebアプリケーションにJP1/AJS3 - SDKのクラスライブラリを含めないで参照する方法

この方法では，Webアプリケーションサーバに複数のWebアプリケーションが存在する場合に，JP1/AJS3 - SDKのクラスライブラリの入れ替えは1回で済みます。ただし，クラスライブラリの入れ替え時には，Webアプリケーションサーバの再起動が必要です。Webアプリケーションサーバを再起動すると，JP1/AJS3 - SDKのクラスライブラリを参照していないWebアプリケーションにも影響します。

WebアプリケーションにJP1/AJS3 - SDKのクラスライブラリを含めて参照する方法

この方法では，JP1/AJS3 - SDKのクラスライブラリの入れ替え時に，サーバを再起動する必要がありません。ただし，必要に応じてWebアプリケーションの数だけJP1/AJS3 - SDKのクラスライブラリを入れ替える必要があります。

3　インストールとセットアップ

この章では，インストールおよびセットアップの作業について説明します。

3.1　インストール前の作業

JP1/AJS3 - SDKのインストール前に必要な作業について説明します。

3.1.1　インストール前の確認項目一覧

JP1/AJS3 - SDKのインストール前に確認が必要な項目を，次の表に示します。

表3‒1　インストール前の確認項目一覧

項番

確認項目

マニュアル参照先

1

前提OS

3.1.2

2

OSのサービスの設定

3.1.3

3

前提プログラム

3.1.4

4

インストールするOSユーザーの権限

3.1.5

5

インストール先フォルダ

3.1.6

6

JP1/AJS3 - SDK運用フォルダ

3.1.7

3.1.2　前提OSの確認

インストールするホストのOSが，JP1/AJS3 - SDKの前提OSであることを確認してください。

関連項目

2.1.1 前提OS

3.1.3　OSのサービスの設定の確認

次に示すOSのサービスの設定で，スタートアップの種類が「自動」または「手動」であることを確認してください。

Windows 8，Windows Server 2012，Windows 7，およびWindows Server 2008の場合

Application Experience サービス

Windows Server 2003の場合

Application Experience Lookup Service サービス※

注※　サービスが存在しない場合は，設定する必要はありません。

スタートアップの種類が「無効」の場合，インストールに失敗することがあります。

3.1.4　前提プログラムの確認

前提プログラムがインストールされていることを確認してください。

関連項目

2.1.2 前提プログラム

3.1.5　インストールするOSユーザーの権限の確認

インストールするOSユーザーの権限が，Administrators権限であることを確認してください。

Windows 8，Windows Server 2012，Windows 7，およびWindows Server 2008の環境でAdministratorsグループのOSユーザーがインストールする場合，OSのユーザーアカウント制御機能（UAC）によって，インストール中にユーザーアカウント制御のダイアログが表示されることがあります。その場合，ダイアログの［続行］ボタンをクリックして，インストールを続行してください。

3.1.6　インストール先フォルダの確認

JP1/AJS3 - SDKのインストール先フォルダを確認してください。デフォルトのインストール先フォルダを変更する場合は，インストール時に指定する必要があります。

Windows 8，Windows Server 2012，Windows 7，およびWindows Server 2008の環境では，デフォルトでインストールすると，ログの出力先フォルダおよび環境設定ファイルなどを格納するフォルダ（JP1/AJS3 - SDK運用フォルダ）が，インストール先フォルダと異なります。なお，インストール先フォルダをデフォルトから変更する場合，指定したインストール先フォルダの下にログの出力先フォルダおよび環境設定ファイルなどを格納するフォルダが変更されます。

関連項目

3.1.7 JP1/AJS3 - SDK運用フォルダの確認

付録A ファイルおよびフォルダ一覧

付録E.6 デフォルトのインストール先フォルダ

3.1.7　JP1/AJS3 - SDK運用フォルダの確認

JP1/AJS3 - SDKでは，次に示すフォルダを配置するフォルダを，JP1/AJS3 - SDK運用フォルダといいます。

logフォルダ（ログの出力先フォルダ）

confフォルダ（環境設定ファイルの格納先フォルダ）

JP1/AJS3 - SDK運用フォルダは，インストールするOSおよびデフォルトのインストール先フォルダにインストールするかどうかで格納先が異なります。

JP1/AJS3 - SDK運用フォルダを次の図に示します。

図3‒1　JP1/AJS3 - SDK運用フォルダ

注意事項

Windows 8，Windows Server 2012，Windows 7，およびWindows Server 2008で，システムで保護されたフォルダ※1配下にインストールした場合，運用フォルダは次に示すフォルダになります。

%ALLUSERSPROFILE%※2¥Hitachi¥jp1¥jp1_default¥JP1AJS3SDK

注※1

「システムで保護されたフォルダ」とは，次のパスを指します。

「システムドライブ¥Windows」配下

「システムドライブ¥Program Files」配下

「システムドライブ¥Program Files (x86)」配下（64ビット版のWindowsの場合）

注※2

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

関連項目

付録E.6 デフォルトのインストール先フォルダ

3.2　JP1/AJS3 - SDKのインストールおよびアンインストール手順

JP1/AJS3 - SDKのインストールおよびアンインストール手順について説明します。

3.2.1　新規インストール手順

JP1/AJS3 - SDKを新規インストールする手順を次に示します。

インストールするホストに，Administrators権限でログインする。

インストールする前に，すべてのプログラムを終了する。

インストール媒体をセットする。

インストールの実行を確認する画面が表示されます。

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

インストール先フォルダをデフォルトから変更する場合は，インストール先フォルダを指定します。

関連項目

付録E.6 デフォルトのインストール先フォルダ

3.2.2　上書きインストール手順

JP1/AJS3 - SDKを上書きインストールする手順を次に示します。

上書きインストールするホストに，Administrators権限でログインする。

上書きインストールする前に，すべてのプログラムを終了する。

インストール媒体をセットする。

上書きインストールの実行を確認する画面が表示されます。

日立総合インストーラーの指示に従って，上書きインストールする。

注意事項

インストールされているJP1/AJS3 - SDKのバージョンよりも古いバージョンのJP1/AJS3 - SDKを上書きインストールすることはできません。古いバージョンのJP1/AJS3 - SDKをインストールしたい場合は，すでにインストールされているJP1/AJS3 - SDKをアンインストールしてから，再度インストールしてください。

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

JP1/AJS3 - SDKのバージョンアップインストールの手順を次に示します。

バージョンアップインストールするホストに，Administrators権限でログインする。

バージョンアップインストールする前に，すべてのプログラムを終了する。

インストール媒体をセットする。

バージョンアップインストールの実行を確認する画面が表示されます。

日立総合インストーラーの指示に従って，バージョンアップインストールする。

3.2.4　リモートインストール手順

JP1/AJS3 - SDKは，JP1/NETM/DMを使ったリモートインストール（ソフトウェア配布）に対応しています。JP1/NETM/DMを使った実際のリモートインストール方法については，マニュアル「JP1/NETM/DM 運用ガイド1 (Windows(R)用)」，または「JP1/NETM/DM 運用ガイド2 (Windows(R)用)」を参照してください。

3.2.5　アンインストール手順（Windows 8，Windows Server 2012，Windows 7，Windows Server 2008の場合）

Windows 8，Windows Server 2012，Windows 7，およびWindows Server 2008の場合の，JP1/AJS3 - SDKのアンインストール手順を次に示します。

アンインストールするホストに，Administrators権限でログインする。

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

Windowsの［コントロールパネル］−［プログラムと機能］で「Automatic Job Management System 3 - Software Development Kit」を選択する。

［アンインストール］ボタンをクリックする。

プログラムの削除を確認するダイアログボックスが表示されます。

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

JP1/AJS3 - SDKがアンインストールされます。

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

アンインストールでは，インストール後に作成された環境設定ファイルやログファイルは削除されません。これらのファイルを削除する場合は，JP1/AJS3 - SDKのインストール先フォルダや，JP1/AJS3 - SDK運用フォルダを削除してください。

関連項目

3.1.7 JP1/AJS3 - SDK運用フォルダの確認

3.2.6　アンインストール手順（Windows Server 2003の場合）

Windows Server 2003の場合の，JP1/AJS3 - SDKのアンインストール手順を次に示します。

アンインストールするホストに，Administrators権限でログインする。

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

Windowsの［コントロールパネル］−［プログラムの追加と削除］で，「Automatic Job Management System 3 - Software Development Kit」を選択する。

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

プログラムの削除を確認するダイアログボックスが表示されます。

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

JP1/AJS3 - SDKがアンインストールされます。

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

アンインストールでは，インストール後に作成された環境設定ファイルやログファイルは削除されません。これらのファイルを削除する場合は，JP1/AJS3 - SDKのインストール先フォルダや，JP1/AJS3 - SDK運用フォルダを削除してください。

関連項目

3.1.7 JP1/AJS3 - SDK運用フォルダの確認

3.3　セットアップの作業一覧

セットアップが必要な作業の一覧を次の表に示します。

表3‒2　セットアップの作業一覧

項番

セットアップ項目

セットアップの必要性

参照先

1

JP1/AJS3 - Managerのプロセスの起動の設定

○

3.4.1，3.4.2，3.4.3

2

JP1/AJS3 - Managerのプロセスの再起動の設定

△

3.4.4

3

JP1/AJS3 - Managerの環境設定

△

3.4.5

4

JP1/AJS3 - Managerのファイアウォールの通過の設定

△

3.4.6

5

JP1/AJS3 - SDKの環境設定

△

3.5.1，3.5.2，3.5.3，3.5.4，3.5.5

6

資料採取ツールの設定

○

3.5.6，3.5.7，3.5.8，3.5.9，3.5.10，3.5.11

7

クラスパスへのJP1/AJS3 - SDKのクラスライブラリの追加

△

3.5.12

8

クラスパスへの日立ネットワークオブジェクトプラザトレース共通ライブラリの追加

○

3.5.13

9

Javaシステムプロパティの設定

○

3.5.14

10

トレースログのファイルサイズおよび面数の変更

△

3.5.15

（凡例）

○：必ずセットアップしてください。

△：必要に応じてセットアップしてください。

3.4　JP1/AJS3 - Managerの設定

JP1/AJS3 - SDKの接続に関する，接続先のJP1/AJS3 - Managerの設定について説明します。

3.4.1　JP1/AJS3 - Managerのプロセスの起動の設定

JP1/AJS3 - ManagerでJP1/AJS3 - SDKからの接続を受け付けるためには，JP1/AJS3 - Managerのajscdinetdプロセスを起動しておく必要があります。ajscdinetdプロセスを起動するには，JP1/AJS3 - ManagerのJP1/AJS3用起動プロセス定義ファイル（jp1ajs_hstd.conf）を定義します。また，ajscdinetdプロセスが使用するポート番号をservicesファイルに追加する必要があります。

JP1/AJS3用起動プロセス定義ファイルの設定手順は，すでにJP1/AJS3用起動プロセス定義ファイルが変更されているかどうかで異なります。

注意事項

JP1/AJS3 - Managerのデータベース構成が互換用ISAM構成の場合は，JP1/AJS3用起動プロセス定義ファイルが変更されているかどうかに関係なく，JP1/AJS3用起動プロセス定義ファイルが変更されている場合の手順に従ってセットアップしてください。

補足事項

JP1/ASJ3用起動プロセス定義ファイルが変更されているかどうかは，jp1ajs_hstd.confファイルをテキストエディターで開いて確認してください。jp1ajs_hstd.confファイルに情報が定義されていれば，変更されています。jp1ajs_hstd.confファイルの格納先を次の表に示します。

表3‒3　JP1/AJS3用起動プロセス定義ファイルとモデルファイルの格納先

OS

物理ホストの場合

論理ホストの場合

Windows

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

共有フォルダ¥conf

UNIX

/etc/opt/jp1ajs2/conf

共有ディレクトリ/conf

関連項目

3.4.2 JP1/AJS3 - Managerのプロセスの起動の設定手順（JP1/AJS3用起動プロセス定義ファイルが変更されていない場合）

3.4.3 JP1/AJS3 - Managerのプロセスの起動の設定手順（JP1/AJS3用起動プロセス定義ファイルが変更されている場合）

3.4.2　JP1/AJS3 - Managerのプロセスの起動の設定手順（JP1/AJS3用起動プロセス定義ファイルが変更されていない場合）

接続先のJP1/AJS3 - Managerのデータベース構成が標準構成で，JP1/AJS3用起動プロセス定義ファイルが変更されていない場合の，JP1/AJS3 - Managerのプロセスの起動の設定手順を次に示します。

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

jp1ajs_hstd.confファイルのバックアップを作成する。

モデルファイル（jp1ajs_hstd_cd.conf.modelファイル）をコピーして，jp1ajs_hstd.confにリネームする。

論理ホストで運用している場合は，手順3で作成したファイルを共有フォルダにコピーする。

servicesファイルにajscdinetdプロセスが使用するポート番号を追加する。

デフォルトのポート番号

22250

ポート番号の追加例

jp1ajs3cdinetd 22250/tcp # JP1/AJS3 - SDK

注意事項

デフォルトのポート番号を使用できない場合，ほかのプロセスが使用するポート番号と重複しないように，ajscdinetdプロセスが使用するポート番号を指定してください。また，環境設定ファイルの接続ポート番号も変更する必要があります。

なお，ポート番号の指定が重複している場合，ajscdinetdプロセスを起動したときに，統合トレースログにメッセージKAVS0904-Eが出力されます。

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

注意事項

ファイアウォールを設定した環境で運用する場合は，JP1/AJS3 - SDKからの通信がファイアウォールを通過できるように設定してください。

servicesファイルに追加したポート番号の設定は，JP1/AJS3 - Managerのアンインストールでは削除されません。設定が不要になった場合には，手動で削除する必要があります。

関連項目

2.6 JP1/AJS3 - SDKの環境設定の検討

3.4.1 JP1/AJS3 - Managerのプロセスの起動の設定

3.4.6 JP1/AJS3 - Managerのファイアウォールの通過の設定

3.4.3　JP1/AJS3 - Managerのプロセスの起動の設定手順（JP1/AJS3用起動プロセス定義ファイルが変更されている場合）

接続先のJP1/AJS3 - Managerのデータベース構成が標準構成で，JP1/AJS3用起動プロセス定義ファイルが変更されている場合，または接続先のデータベース構成が互換用ISAM構成の場合の，JP1/AJS3 - Managerのプロセスの起動の設定手順を次に示します。

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

jp1ajs_hstd.confファイルを開く。

任意の行にajscdinetdプロセスの定義を追加する。

Windowsの場合

次の定義を追加してください。

ajscdinetd|ajscdinetd.exe|||1800|

UNIXの場合

次の定義を追加してください。

ajscdinetd|/opt/jp1ajs2/bin/ajscdinetd|||1800|

jp1ajs_hstd.confファイルを保存する。

servicesファイルにajscdinetdプロセスが使用するポート番号を追加する。

デフォルトのポート番号

22250

ポート番号の追加例

jp1ajs3cdinetd 22250/tcp # JP1/AJS3 - SDK

注意事項

デフォルトのポート番号を使用できない場合，ほかのプロセスが使用するポート番号と重複しないように，ajscdinetdプロセスが使用するポート番号を指定してください。また，環境設定ファイルの接続ポート番号も変更する必要があります。

なお，ポート番号の指定が重複している場合，ajscdinetdプロセスを起動したときに，統合トレースログにメッセージKAVS0904-Eが出力されます。

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

注意事項

ファイアウォールを設定した環境で運用する場合は，JP1/AJS3 - SDKからの通信がファイアウォールを通過できるように設定してください。

servicesファイルに追加したポート番号の設定は，JP1/AJS3 - Managerのアンインストールでは削除されません。設定が不要になった場合には，手動で削除する必要があります。

関連項目

2.6 JP1/AJS3 - SDKの環境設定の検討

3.4.1 JP1/AJS3 - Managerのプロセスの起動の設定

3.4.6 JP1/AJS3 - Managerのファイアウォールの通過の設定

3.4.4　JP1/AJS3 - Managerのプロセスの再起動の設定

JP1/AJS3 - ManagerとJP1/AJS3 - SDKとの接続で必要なJP1/AJS3 - Managerのajscdinetdプロセスが異常終了した場合に備えて，ajscdinetdプロセスの再起動の設定ができます。JP1/AJS3 - Managerの初期設定では，ajscdinetdプロセスが異常終了した場合，再起動するように設定されています。必要に応じてajscdinetdプロセスの再起動の設定を変更してください。

ajscdinetdプロセスの再起動は，JP1/AJS3 - Managerの拡張起動プロセス定義ファイルに定義されています。拡張起動プロセス定義ファイルの詳細については，マニュアル「JP1/Automatic Job Management System 3 運用ガイド」の異常終了したJP1/AJS3のプロセスの再起動について記載している個所を参照してください。

拡張起動プロセス定義ファイル

jp1ajs_hstd_0700.conf

拡張起動プロセス定義ファイルの格納先

Windowsの場合

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

UNIXの場合

/etc/opt/jp1ajs2/conf

初期設定の定義内容

Windowsの場合

標準構成の場合と互換用ISAM構成の場合の初期設定の定義内容を示します。なお，物理ホストと論理ホストで差異はありません。

・標準構成の場合

　ajscdinetd|ajscdinetd.exe||1|3|3|21600|0|0|hostevam|1|||||||

・互換用ISAM構成の場合

　ajscdinetd|ajscdinetd.exe||1|3|3|21600|0|0|evactionm|1|||||||

UNIXの場合

物理ホストの場合と論理ホストの場合の初期設定の定義内容を示します。なお，標準構成と互換用ISAM構成で差異はありません。

・物理ホストの場合

　ajscdinetd|/opt/jp1ajs2/bin/ajscdinetd||1|3|3|21600|0|0|jpomanager_hst|1|||||||

・論理ホストの場合

　ajscdinetd|/opt/jp1ajs2/bin/ajscdinetd||0|3|3|21600|0|0|jpomanager_hst|1|||||||

初期設定で定義されている設定値を次の表に示します。

表3‒4　初期設定の設定値

詳細プロセス名称

再起動可否

再起動回数

リトライ間隔（秒）

再起動回数リセット時間（秒）

ajscdinetd.exe（Windowsの場合）

する

3

3

21,600

ajscdinetd（UNIXの場合）

注意事項

JP1/AJS3 - Managerをバージョンアップインストールした場合，カスタマイズ前のモデルファイルがアップデートされます。そのため，拡張起動プロセス定義ファイルをカスタマイズしている場合は，モデルファイルをコピーして再度カスタマイズしてください。カスタマイズしていない場合は，コピーだけしてください。JP1/AJS3 - Managerのカスタマイズできるファイルの扱いについては，マニュアル「JP1/Automatic Job Management System 3 構築ガイド1」のバージョンアップインストールの注意事項について記載している個所を参照してください。

関連項目

付録E.6 デフォルトのインストール先フォルダ

3.4.5　JP1/AJS3 - Managerの環境設定

接続先のJP1/AJS3 - Managerで，JP1/AJS3 - SDKからの接続に対する動作環境を環境設定パラメーターで変更できます。変更できるJP1/AJS3 - Managerの環境設定パラメーターを次の表に示します。JP1/AJS3 - Managerの環境設定パラメーターについては，マニュアル「JP1/Automatic Job Management System 3 構築ガイド2」を参照してください。

表3‒5　変更できるJP1/AJS3 - Managerの環境設定パラメーター

項番

設定項目

環境設定パラメーター

1

最大同時セッション数

CDMAXSESSION

2

JP1/AJS3 - Managerとの接続打ち切り時間

CDSESSIONTIMEOUT

3

デスクトップヒープ領域が不足した場合のログオン情報の再利用

REUSELOGON

4

ログオン情報を再利用する場合のログオン共有セッション数

LOGONSHMAX

5

スケジューラーログの出力

MONLOG

6

開始および終了メッセージの出力

MONSYSLOG

7

ajscdinetd内部ログのサイズ

AJSCDINETDLOGSIZE

8

ajsmonsvr内部ログのサイズ

CDMONSVRLOGSIZE

9

ルートジョブネットのスケジュールの有効範囲

ROOTJOBNETSCHEDULERANGE

10

世代情報の範囲

VIEWSTATUSRANGE

11

JP1イベントの発行

COMMANDEVENT

関連項目

2.5 JP1/AJS3 - Managerの環境設定の検討

3.4.6　JP1/AJS3 - Managerのファイアウォールの通過の設定

ファイアウォールを設定した環境で運用する場合，JP1/AJS3 - SDKからの通信がファイアウォールを通過できるように設定する必要があります。

ファイアウォールを通過するための方向を次の表に示します。

表3‒6　ファイアウォールの通過方向

JP1/AJS3 - SDKの使用ポート番号

ファイアウォールの通過方向

接続先のJP1/AJS3 - Managerの使用ポート番号

ANY

→

22250※/tcp

（凡例）

ANY：OSによって割り当てられる空きポート番号を使用します。使用するポート番号の範囲は，OSによって異なります。

→：JP1/AJS3 - SDKからJP1/AJS3 - Managerへファイアウォールを通過します。

注※

使用するポート番号を変更している場合は，変更したポート番号に読み替えてください。

3.5　JP1/AJS3 - SDKの設定

JP1/AJS3 - SDKの設定について説明します。

3.5.1　環境設定ファイルの反映手順

ユーザーアプリケーションの動作環境およびログの出力設定を環境設定ファイルに設定します。環境設定ファイルの反映手順を次に示します。

JP1/AJS3 - SDK運用フォルダ¥confにある，環境設定ファイルのモデルファイル（ajscd_APP.properties.model）をコピーして，ajscd_ユーザーアプリケーション名.propertiesにリネームする。

環境設定ファイルをテキストエディターで開く。

定義内容を変更する。

ファイルを保存する。

ユーザーアプリケーションを起動する。

変更後の設定内容が有効になります。ユーザーアプリケーションの起動中に環境設定ファイルを変更した場合は，ユーザーアプリケーションの再起動時に変更後の設定内容が有効になります。

注意事項

次の場合は，デフォルト値が仮定されます。

環境設定ファイルのファイル名が誤っている場合

環境設定ファイルの格納先が誤っている場合

環境設定ファイルが存在しない場合

関連項目

3.1.7 JP1/AJS3 - SDK運用フォルダの確認

3.5.2　環境設定ファイルの形式

環境設定ファイルの形式について説明します。定義行の形式を次に示します。

ajscd.環境設定項目名=定義内容

関連項目

3.5.4 環境設定ファイルを編集するときの注意事項

3.5.3　環境設定ファイルの設定項目の詳細

環境設定ファイルで設定できる各項目の詳細について説明します。

(1)　port_number

JP1/AJS3 - Managerへの接続ポート番号を設定します。

形式

ajscd.port_number=JP1/AJS3 - Managerへの接続ポート番号

指定できる値

5001〜65535

デフォルト値

22250

デフォルト値を変更する場合の理由

デフォルトのポート番号がJP1/AJS3 - Managerで使用できない場合に変更します。

(2)　default_charcode

JP1/AJS3 - Managerの文字コードを取得できない場合に仮定する文字コードを設定します。

形式

ajscd.default_charcode=JP1/AJS3 - Managerの文字コード

指定できる値

Java規定のエンコーディングセット名

指定できる値は，起動するJavaVMに依存します。JavaVMで規定されているエンコーディングセットのjava.ioおよびjava.lang APIで使用される文字セットを指定してください。詳細については，JavaVMのドキュメントを参照してください。

デフォルト値

MS932

デフォルト値を変更する場合の理由

デフォルト値でJP1/AJS3 - Managerの文字が表示できない場合に変更します。

注意事項

この設定は，環境設定ファイルで文字コードの取得（getmanager_charcode）に「no」が指定されている場合にだけ有効になります。

ユーザーアプリケーションで文字コードを設定するAPI（setCharCodeメソッド）を使用している場合は，APIで設定した文字コードが有効になります。

関連項目

2.7.2 使用する文字コードの検討

(3)　connect_timeout

JP1/AJS3 - Managerとの接続タイムアウト時間を設定します。

形式

ajscd.connect_timeout=JP1/AJS3 - Managerとの接続タイムアウト時間

指定できる値

0〜86,400（単位：秒）

0を指定した場合，接続タイムアウト処理を行いません。

デフォルト値

0（接続タイムアウト処理を行わない）（単位：秒）

デフォルト値を変更する場合の理由

JP1/AJS3 - Managerからの接続タイムアウト処理を行う場合に変更します。

注意事項

OSの接続タイムアウト仕様とその設定によって，環境設定ファイルに設定した値より前に接続のタイムアウトが発生することがあります。

(4)　connect_retry_count

JP1/AJS3 - Managerとの接続が通信エラーで遮断された場合に，接続をリトライする回数を設定します。

形式

ajscd.connect_retry_count=JP1/AJS3 - Managerへの接続リトライ回数

指定できる値

0〜100（単位：回）

デフォルト値

3（単位：回）

デフォルト値を変更する場合の理由

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

(5)　connect_retry_interval

JP1/AJS3 - Managerとの接続で通信エラーが発生した場合に，接続をリトライする間隔を設定します。

形式

ajscd.connect_retry_interval=JP1/AJS3 - Managerへの接続リトライ間隔

指定できる値

0〜300（単位：秒）

デフォルト値

12（単位：秒）

デフォルト値を変更する場合の理由

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

(6)　receive_timeout

JP1/AJS3 - Managerからデータを受信する場合のタイムアウト時間を設定します。

形式

ajscd.receive_timeout=受信タイムアウト時間

指定できる値

0〜86,400（単位：秒）

0を指定した場合，受信タイムアウト処理を行いません。

デフォルト値

180（単位：秒）

デフォルト値を変更する場合の理由

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

(7)　login_wait

JP1/AJS3 - Managerの認証に失敗した場合に，loginメソッドでの待ち時間（スリープ状態にする時間）を設定します。

形式

ajscd.login_wait=ログイン待ち時間

指定できる値

1〜10（単位：秒）

デフォルト値

1（単位：秒）

デフォルト値を変更する場合の理由

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

(8)　tracelog_dir

トレースログを出力するフォルダを指定します。

形式

ajscd.tracelog_dir=トレースログの出力先フォルダ

指定できる値

1バイト以上の文字列

デフォルト値

JP1/AJS3 - SDK運用フォルダ¥¥log

デフォルト値を変更する場合の理由

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

注意事項

トレースログの出力先フォルダは，ローカルフォルダを絶対パスで指定してください。ネットワークフォルダは指定できません。

トレースログの出力先フォルダのパスに，マルチバイト文字は指定できません。

補足事項

JP1/AJS3 - SDK運用フォルダは，「<jp1ajscd.home>」でも指定できます。

関連項目

3.1.7 JP1/AJS3 - SDK運用フォルダの確認

(9)　tracelog_size

トレースログのファイルサイズを指定します。

形式

ajscd.tracelog_size=トレースログのファイルサイズ

指定できる値

4,096〜16,777,216（単位：バイト）

デフォルト値

2,097,152（単位：バイト）

デフォルト値を変更する場合の理由

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

注意事項

トレースログのファイルサイズの変更するためには，所定のファイルを削除する必要があります。

関連項目

3.5.15 トレースログのファイルサイズおよび面数の変更手順

(10)　tracelog_num

トレースログの面数を指定します。初期化時に，ここで指定した面数分のトレースログファイルが作成されます。

形式

ajscd.tracelog_num=トレースログの面数

指定できる値

1〜16（単位：個）

デフォルト値

3（単位：個）

デフォルト値を変更する場合の理由

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

注意事項

トレースログの面数の変更するためには，所定のファイルを削除する必要があります。

関連項目

3.5.15 トレースログのファイルサイズおよび面数の変更手順

(11)　tracelog_level

トレースログの出力レベルを指定します。

形式

ajscd.tracelog_level=トレースログの出力レベル

指定できる値

0

トレースログを出力しません。

1

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

2

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

3

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

デフォルト値

3

デフォルト値を変更する場合の理由

障害発生時の原因特定に必要となるため，ログを出力することを推奨します。出力するメッセージの種類は，運用環境に応じて設定してください。

(12)　getmanager_charcode

JP1/AJS3 - Managerの文字コードを取得するかどうかを設定します。

形式

ajscd.getmanager_charcode={yes|no}

指定できる値

yes

JP1/AJS3 - Managerの文字コードを取得します。

no

JP1/AJS3 - Managerの文字コードを取得しません。

デフォルト値

yes

デフォルト値を変更する場合の理由

JP1/AJS3 - Managerを中国語環境で使用する場合に変更します。JP1/AJS3 - Managerを中国語環境で使用する場合，文字コードを正しく取得できないため「no」を設定してください。

(13)　lang

JP1/AJS3 - SDKが出力するメッセージの言語を設定します。

形式

ajscd.lang={system|ja|en}

指定できる値

system

Java Runtime Environmentのロケール設定に従って，メッセージを出力します。ロケールの言語が「ja」の場合，メッセージを日本語で出力します。そのほかの言語が設定されている場合，メッセージを英語で出力します。

ja

メッセージを日本語で出力します。

en

メッセージを英語で出力します。

デフォルト値

system

デフォルト値を変更する場合の理由

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

(14)　api_search_resultmax

ユニットの情報を取得するAPI（searchUnitメソッド）で取得する情報の上限数を設定します。

形式

ajscd.api_search_resultmax=取得するユニット情報の上限数

指定できる値

1〜2,147,483,646（単位：個）

デフォルト値

1,000（単位：個）

デフォルト値を変更する場合の理由

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

3.5.4　環境設定ファイルを編集するときの注意事項

環境設定ファイルを編集するときの注意事項を次に示します。

定義内容に文字列を指定する場合，大文字と小文字は区別されます。ただし，フォルダ名およびファイル名の指定で使用できる文字は，OSの種類に依存します。

フォルダ名のパスの区切りには，「¥¥」を使用してください。

行の終わりは必ず改行してください。

コメントを記載する際は，行の先頭に「#（シャープ）」を記載してください。

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

設定できるキー名称以外を指定した場合，その行を無視して処理します。

キー名称は，すべて小文字で指定する必要があります。キー名称に大文字が混在する場合，その行を無視して処理します。

定義内容を文字列で指定する場合，半角スペースを利用できます。

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

関連項目

3.5.2 環境設定ファイルの形式

3.5.5　環境設定ファイルの設定例

環境設定ファイルの設定例を次に示します。

ajscd.port_number=6000
ajscd.default_charcode=MS932
ajscd.connect_timeout=0
ajscd.connect_retry_count=3
ajscd.connect_retry_interval=12
ajscd.receive_timeout=180
ajscd.login_wait=1
ajscd.tracelog_dir=<jp1ajscd.home>¥¥log
ajscd.tracelog_size=2097152
ajscd.tracelog_num=3
ajscd.tracelog_level=3
ajscd.getmanager_charcode=yes
ajscd.lang=system
ajscd.api_search_resultmax=1000

関連項目

3.5.3 環境設定ファイルの設定項目の詳細

3.5.4 環境設定ファイルを編集するときの注意事項

3.5.6　資料採取ツールのセットアップ項目一覧

トラブルが発生したときに，ログ情報などを採取できるようにJP1/AJS3 - SDKでは資料採取ツールのサンプルバッチファイルを提供しています。

資料採取ツールのセットアップ項目一覧を次の表に示します。

表3‒7　資料採取のセットアップ項目一覧

セットアップする項目

Windows 8

Windows Server 2012

Windows 7

Windows Server 2008

Windows Server 2003

資料採取ツール

○

○

○

○

○

ダンプファイル

メモリーダンプの出力

○

○

○

○

○

クラッシュダンプの出力

○

○

○

○

○

（凡例）

○：セットアップが必要です。

注意事項

Windows 8，Windows Server 2012，Windows 7，およびWindows Server 2008では，ダンプファイルを自動で取得できないため，手動で採取する必要があります。

関連項目

3.5.7 資料採取ツールのセットアップ手順

3.5.8 メモリーダンプの出力設定手順（Windows 8，Windows Server 2012，Windows 7，Windows Server 2008の場合）

3.5.9 メモリーダンプの出力設定手順（Windows Server 2003の場合）

3.5.10 クラッシュダンプの出力設定手順（Windows 8，Windows Server 2012，Windows 7，Windows Server 2008の場合）

3.5.11 クラッシュダンプの出力設定手順（Windows Server 2003の場合）

7.4.6 ダンプファイルの採取手順（Windows 8，Windows Server 2012，Windows 7，Windows Server 2008の場合）

3.5.7　資料採取ツールのセットアップ手順

トラブルが発生したときにログ情報などを採取するための資料採取ツールをセットアップします。JP1/AJS3 - SDKでは，資料採取ツールのサンプルバッチファイルを提供しています。

資料採取ツールのセットアップ手順を次に示します。

資料採取ツールのサンプルバッチファイルを任意のフォルダにコピーする。

サンプルバッチファイルの格納先

JP1/AJS3 - SDKのインストール先フォルダ¥tools¥_04.bat

コピーしたバッチファイルをテキストエディターで編集する。

バッチファイルに記述されている標準値を次に示します。この標準値と異なる場合は，バッチファイルの記述を変更してください。

@set LOG_DIR_DRWTSN=%ALLUSERSPROFILE%¥Documents¥DrWatson※

ワトソン博士のログファイルパスを指定します。

@set DIR_BACKLOG=%TEMP%¥jp1ajs2¥backlog

ツールで採取した情報の退避先を指定します。

注※

Windows 8，Windows Server 2012，Windows 7，およびWindows Server 2008の場合は取得できません。

任意のファイル名に変更して保存する。

3.5.8　メモリーダンプの出力設定手順（Windows 8，Windows Server 2012，Windows 7，Windows Server 2008の場合）

トラブルが発生した場合に，メモリーダンプが必要となることがあります。トラブル発生時にメモリーダンプが出力されるように，あらかじめ設定してください。

メモリーダンプの出力設定手順を次に示します。

コントロールパネルの［システム］をクリックする。

［システム］ダイアログボックスが表示されます。

［システムの詳細設定］をクリックする。

［システムのプロパティ］ダイアログボックスが表示されます。

［詳細設定］タブの［起動と回復］の［設定］ボタンをクリックする。

［起動と回復］ダイアログボックスが表示されます。

［デバッグ情報の書き込み］で，［完全メモリ ダンプ］を選択し，［ダンプ ファイル］に出力先のファイルを指定する。

搭載しているメモリーのサイズによっては［完全メモリ ダンプ］が表示されないことがあります。その場合は［カーネル メモリ ダンプ］を選択してください。

注意事項

メモリーダンプのサイズは，実メモリーのサイズによって異なります。搭載している物理メモリーが大きいと，メモリーダンプのサイズも大きくなります。メモリーダンプを採取できるだけのディスク領域を確保してください。詳細については，Microsoftのドキュメントを参照してください。

3.5.9　メモリーダンプの出力設定手順（Windows Server 2003の場合）

トラブルが発生した場合に，メモリーダンプが必要となることがあります。トラブル発生時にメモリーダンプが出力されるように，あらかじめ設定してください。

メモリーダンプの出力設定手順を次に示します。

［コントロールパネル］の［システム］をダブルクリックする。

［システムのプロパティ］ダイアログボックスが表示されます。

［詳細設定］タブの［起動と回復］の［設定］ボタンをクリックする。

［起動と回復］ダイアログボックスが表示されます。

［デバッグ情報の書き込み］で，［完全メモリ ダンプ］を選択し，［ダンプ ファイル］に出力先のファイルを指定する。

搭載しているメモリーのサイズによっては［完全メモリ ダンプ］が表示されないことがあります。その場合は［カーネル メモリ ダンプ］を選択してください。

注意事項

メモリーダンプのサイズは，実メモリーのサイズによって異なります。搭載している物理メモリーが大きいと，メモリーダンプのサイズも大きくなります。メモリーダンプを採取できるだけのディスク領域を確保してください。詳細については，Microsoftのドキュメントを参照してください。

3.5.10　クラッシュダンプの出力設定手順（Windows 8，Windows Server 2012，Windows 7，Windows Server 2008の場合）

トラブルが発生した場合に，クラッシュダンプ（トラブル時のデバッグ情報を書き出したファイル）が必要となることがあります。クラッシュダンプを出力するためには，Windowsのレジストリー情報を設定する必要があります。詳細な設定方法については，MicrosoftのWindows Error Reporting（WER）関連のサポート技術情報を参照してください。設定する際には，完全なダンプ情報を出力するように設定してください。

注意事項

クラッシュダンプはJP1だけでなく，ほかのアプリケーションプログラムがクラッシュしたときでも出力されます。また，クラッシュダンプが出力されると，その分ディスク容量が圧迫されます。クラッシュダンプが出力されるように設定する場合は，十分なディスク領域を確保しておいてください。

3.5.11　クラッシュダンプの出力設定手順（Windows Server 2003の場合）

トラブルが発生した場合に，クラッシュダンプ（トラブル時のデバッグ情報を書き出したファイル）が必要となることがあります。Windows Server 2003の場合は，トラブル発生時にクラッシュダンプが出力されるように，あらかじめ設定してください。

クラッシュダンプの出力設定手順を次に示します。

Windowsの［スタート］メニューから［ファイル名を指定して実行］を選択する。

［ファイル名を指定して実行］ダイアログボックスが表示されます。

［名前］に「drwtsn32」と入力し，［OK］ボタンをクリックする。

［ワトソン博士］ダイアログボックスが表示されます。

［クラッシュ ダンプ］に出力先のファイルを指定する。

［オプション］の［クラッシュダンプファイルの作成］をチェックする。

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

注意事項

クラッシュダンプはJP1だけでなく，ほかのアプリケーションプログラムがクラッシュしたときでも出力されます。また，クラッシュダンプが出力されると，その分ディスク容量が圧迫されます。クラッシュダンプが出力されるように設定する場合は，十分なディスク領域を確保してください。

3.5.12　クラスパスへのJP1/AJS3 - SDKのクラスライブラリの追加

次に示す場合は，クラスパスへJP1/AJS3 - SDKのクラスライブラリを追加する必要があります。

ユーザーアプリケーションをWebアプリケーションとして運用し，JP1/AJS3 - SDKのクラスライブラリをユーザーアプリケーションに含めない場合

ユーザーアプリケーションをC/Sアプリケーションとして運用する場合

クラスパスへJP1/AJS3 - SDKのクラスライブラリを追加する手順を次に示します。

クラスパスにJP1/AJS3 - SDKのクラスライブラリを追加する。

デフォルトの格納先

JP1/AJS3 - SDKのインストール先フォルダ¥lib¥ajscd.jar

関連項目

2.9 クラスライブラリの参照方法の検討

3.5.13　クラスパスへの日立ネットワークオブジェクトプラザトレース共通ライブラリの追加

クラスパスに日立ネットワークオブジェクトプラザトレース共通ライブラリを追加する必要があります。

クラスパスに日立ネットワークオブジェクトプラザトレース共通ライブラリを追加する。

デフォルトの格納先

システムドライブ¥Program Files¥Hitachi¥HNTRLib2¥classes¥hntrlibMj.jar

補足事項

日立ネットワークオブジェクトプラザトレース共通ライブラリのクラスパスは，次に示すレジストリーを参照して確認することもできます。

¥¥HKEY_LOCAL_MACHINE¥SOFTWARE※¥Hitachi¥HNTRLib2¥HNTR1¥HntrMpClassPath

注※

64ビット版のWindows 8，Windows Server 2012，Windows 7，およびWindows Server 2008，ならびにWindows Server 2003（x64）およびWindows Server 2003 R2（x64）の場合は，「SOFTWARE」を「SOFTWARE¥Wow6432Node」と読み替えてください。

3.5.14　Javaシステムプロパティの設定

JP1/AJS3 - SDKが動作するJavaで，システムプロパティを設定します。

Javaで設定するシステムプロパティを次の表に示します。

表3‒8　Javaのシステムプロパティの設定

項番

システムプロパティのキー名

説明

指定できる値

デフォルト

1

jp1ajscd.home

JP1/AJS3 - SDK運用フォルダを設定します。

1バイト以上の文字列※

−

（省略できません）

2

jp1ajscd.comlog_dir

共通トレースログを出力するフォルダを設定します。

1バイト以上の文字列※

JP1/AJS3 - SDK運用フォルダ¥log

3

jp1ajscd.comlog_level

共通トレースログの出力レベルを設定します。

0

ログを出力しない

1

エラーメッセージを出力する

2

エラーおよび警告メッセージを出力する

3

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

3

注※

ローカルフォルダを絶対パスで指定します。ネットワークフォルダは指定できません。また，フォルダのパスには，マルチバイト文字を指定することはできません。

補足事項

Javaシステムプロパティの変更を有効にするためには，ユーザーアプリケーションを再起動する必要があります。

関連項目

3.1.7 JP1/AJS3 - SDK運用フォルダの確認

付録A ファイルおよびフォルダ一覧

3.5.15　トレースログのファイルサイズおよび面数の変更手順

環境設定ファイルでトレースログのファイルサイズおよび面数を変更する場合，所定のファイルを削除する必要があります。トレースログのファイルサイズおよび面数の変更手順を次に示します。

環境設定ファイルを変更するユーザーアプリケーションをすべて停止する。

トレースログファイルをバックアップする。

トレースログファイルのデフォルトの格納先

JP1/AJS3 - SDK運用フォルダ¥log

環境設定ファイルを変更するユーザーアプリケーションのトレースログファイルをすべて削除する。

トレースログのファイル名

ajscdtrace_ユーザーアプリケーション名_面数.log

環境設定ファイルを変更するユーザーアプリケーションのトレースログファイルの管理ファイルを削除する。

管理ファイルのデフォルトの格納先

JP1/AJS3 - SDK運用フォルダ¥log¥mmap

管理ファイルのファイル名

ajscdtrace_ユーザーアプリケーション名_面数.mm

環境設定ファイルでトレースログのファイルサイズおよび面数を変更する。

ユーザーアプリケーションを起動する。

トレースログファイルが新規に作成されていることを確認する。

関連項目

3.1.7 JP1/AJS3 - SDK運用フォルダの確認

4　ユーザーアプリケーションの設計

この章では，ユーザーアプリケーションの設計時に検討が必要な項目および注意事項について説明します。

4.1　ユーザーアプリケーションの配布方法の検討

ユーザーアプリケーションは，次に示す方法で配布できます。

ユーザーアプリケーションにJP1/AJS3 - SDKのクラスライブラリを含めないで配布する方法

ユーザーアプリケーションにJP1/AJS3 - SDKのクラスライブラリを含めて配布する方法

どちらの方法でも，配布元と配布先のホストに同じバージョンのJP1/AJS3 - SDKがインストールされている必要があります。

また，ユーザーアプリケーションの配布方法に応じて，JP1/AJS3 - SDKのクラスライブラリの入れ替え時に必要な操作が異なります。そのため，システム全体の運用方法を考慮してJP1/AJS3 - SDKのユーザーアプリケーションの配布方法を検討してください。

関連項目

2.9 クラスライブラリの参照方法の検討

4.2　APIの利用方法

ユーザーアプリケーションの開発には，JP1/AJS3 - SDKが提供するクラスを利用します。JP1/AJS3 - SDKが提供するクラスおよびAPIの利用の流れについて説明します。

4.2.1　JP1/AJS3 - SDKが提供するクラス

JP1/AJS3 - SDKが提供するクラスと生成単位を次の表に示します。

表4‒1　JP1/AJS3 - SDKが提供するクラスと生成単位

項番

クラス名

説明

生成単位

1

AjsCdFactory

AjsCdインスタンスの生成および破棄機能を持つファクトリクラスです。

JavaVMごとに1つ生成※

2

AjsCd

AjsCdApiインスタンスの生成および破棄をするクラスです。

ユーザーアプリケーションごとに1つ生成

3

AjsCdApi

次に示す機能を提供します。

JP1/AJS3 - Managerの操作

JP1/AJS3 - Manager情報の取得

Webアプリケーションの場合

HTTPセッションごとに生成

C/Sアプリケーションの場合

ユーザーアプリケーションを利用するクライアントユーザーごとに生成

注※

ユーザーアプリケーションが，JP1/AJS3 - SDKのクラスライブラリを含めているWebアプリケーションの場合，JP1/AJS3 - SDKのクラスライブラリを読み込んだクラスローダーごとに1つ生成されます。

4.2.2　API利用の流れ

JP1/AJS3 - Managerを操作する各種APIを呼び出す流れを次の図に示します。

図4‒1　API利用の流れ

関連項目

4.2.1 JP1/AJS3 - SDKが提供するクラス

4.3　ユーザーアプリケーション開発時の検討

ユーザーアプリケーションの処理効率やAPI以外に関する部分の実装など，ユーザーアプリケーションの開発時のポイントを説明します。

4.3.1　APIの実装方法の検討

1セッションで同時に実行できるAPIは1つです。複数のAPIを同時に発行した場合でも，APIは発行された順に1つずつ処理されます。それを考慮して，APIの実装方法を検討してください。検討が必要なAPIの実装方法について次に説明します。

(1)　複数のユニットを対象としてAPIを実行する方法

複数のユニットに対してAPIを発行した場合，対象ユニットの数だけAPIが発行されます。しかし，APIは1つずつ処理されるため，APIの処理に時間が掛かります。そのため，APIの操作対象を選択するGUI画面では，1つのユニットだけを対象にするなど，操作対象のユニット数を制限するように設計してください。

APIの操作対象を選択する画面例を次の図に示します。

図4‒2　APIの操作対象を選択する画面例

1つのユニットだけを操作できる画面の場合，ユニットAに対して操作を要求するため，APIは1つしか発行されません。複数のユニットを操作できる画面の場合，ユニットAおよびユニットBを操作対象にすると，APIは2つ発行されます。この場合，実行するAPIの数が増えるため，1つのユニットだけを操作するときよりもユーザーへの応答が遅くなります。

(2)　複数のユニットの情報を取得する方法

同じジョブグループに属している複数のユニットの情報を取得する場合，情報取得のAPIをユニットの個数分実行するよりも，対象のジョブグループに対して一覧情報取得のAPIを1回実行する方が，APIの処理速度は速いことがあります。操作対象のユニットの個数を考慮して，APIの実装方法を検討してください。

(3)　複数のジョブグループの一覧情報を取得する方法

操作対象のユニットが複数のジョブグループに存在する場合，情報取得のAPIをジョブグループ数分発行する必要があります。そのため，同一の画面に複数のジョブグループの情報を表示させようとしても，同時には更新されません。このような場合，次に示す実装方法を検討してください。

1画面に，同時に複数のジョブグループの情報を表示させない

操作対象のユニットが，1ジョブグループで管理できるように構成する

4.3.2　ユーザーアプリケーションの実装に関する検討

ユーザーアプリケーションの実装時に検討が必要な項目を次の表に示します。

表4‒2　ユーザーアプリケーション開発時の検討項目（APIの実装以外）

項番

項目

検討内容

1

ユーザーアプリケーション名

ユーザーアプリケーションがWebアプリケーションの場合，JP1/AJS3 - SDKを使用するWebアプリケーションが同一のWebアプリケーションサーバに複数存在するときは，ユーザーアプリケーション名がWebアプリケーションサーバでユニークな名前になるように実装してください。

2

入力データの誤り検出

入力データの誤りを検出する実装を検討してください。

3

操作ボタンの連打対策

操作ボタンが複数回クリックされた場合に，余分なAPIを発行しない実装を検討してください。

4

セキュリティ対策

ユーザーアプリケーションをWebアプリケーションにする場合は，セキュリティ対策を講じた実装を検討してください。

5

例外処理

APIのエラー時に生成される例外クラスのインスタンスに応じた対処をするように，APIの実装を検討してください。

6

クラスタシステムの利用

JP1/AJS3 - SDKがインストールされているホストをクラスタシステムで運用する場合，サーバで障害が発生したときの対策を講じた実装を検討してください。

ユーザーアプリケーションの実行中にサーバで障害が発生してフェールオーバーした場合，再度，クラスの生成や認証からの操作が必要です。

関連項目

7.2.2 ログファイル一覧

4.4　JP1/AJS3 - Managerホストへの負荷が増える操作と対策

システム構成や構築されているユニットの個数によって，JP1/AJS3 - Managerへの負荷が増える場合があります。JP1/AJS3 - Managerホストへの負荷が増える操作，およびその対策について説明します。

4.4.1　多数のユーザーによるAPIの多重実行とJP1/AJS3 - Managerへの負荷

複数のユーザーが同じJP1/AJS3 - Managerのスケジューラーサービスに対して同時にAPIを実行すると，JP1/AJS3 - ManagerでAPIが多重実行されます。多重実行するAPIの数が多い場合，処理に時間が掛かったり，JP1/AJS3 - Managerホストに負荷が掛かったりすることがあります。この場合，JP1/AJS3 - SDKからの業務以外にも影響を及ぼすことがあるため，JP1/AJS3 - Managerを操作できるユーザーの数（最大同時セッション数）を制限してください。

関連項目

2.5.2 最大同時セッション数の検討

4.4.2　APIの発行間隔とJP1/AJS3 - Managerへの負荷

APIの発行頻度が高い場合，APIの処理頻度も高くなるためJP1/AJS3 - Managerに継続的な負荷が掛かります。例えば，ユニットの実行結果を確認するために情報取得APIを1秒間隔で発行すると，JP1/AJS3 - Managerには継続的に負荷が掛かります。また，APIの多重実行が発生すると，JP1/AJS3 - Managerの負荷が増加してしまいます。そのため，ユーザーアプリケーションでAPIを繰り返して実行する場合は，JP1/AJS3 - Managerへの負荷を考慮してAPIの発行が頻発しないように設計してください。

4.4.3　ユニットの総数および世代数によって負荷が掛かるAPI操作とJP1/AJS3 - Managerへの負荷

APIの発行対象にするユニットの配下に多数のユニットがある場合，または世代数が多い場合，APIの処理でJP1/AJS3 - Managerに負荷が掛かることがあります。JP1/AJS3 - Managerに負荷が掛かるAPI操作を次に示します。

(1)　確定実行登録

確定実行登録は，ルートジョブネットの配下にあるユニットの総数や実行登録する世代数が多い場合，JP1/AJS3 - Managerに負荷が掛かることがあります。JP1/AJS3 - Managerへの負荷を考慮して，確定実行登録する世代数や期間を検討してください。

(2)　実行登録の解除

実行登録の解除は，実行登録されている世代数や対象ジョブネットの総ユニット数によって，JP1/AJS3 - Managerに負荷が掛かることがあります。JP1/AJS3 - Managerへの負荷を考慮して，実行登録の解除を行ってください。

(3)　ユニット一覧情報の取得

ユニット一覧情報の取得は，取得対象のユニット数によって，JP1/AJS3 - Managerやネットワークに負荷が掛かることがあります。一度に取得するユニット数が適切になるような検索条件を設定するなどの実装を検討してください。

(4)　予実績情報の取得

予実績情報の取得は，取得対象の世代数や対象ジョブネットの総ユニット数によって，JP1/AJS3 - Managerやネットワークに負荷が掛かることがあります。JP1/AJS3 - Manager への負荷を考慮して，取得する期間を検討してください。

(5)　サマリー情報の取得

サマリー情報の取得は，取得対象の世代数や対象ジョブネットの総ユニット数によって，JP1/AJS3 - Managerやネットワークに負荷が掛かることがあります。JP1/AJS3 - Manager への負荷を考慮して，取得する期間を検討してください。

4.5　API利用時の注意事項

API利用時の注意事項について説明します。

4.5.1　操作対象のユニットに対するJP1ユーザーの権限

実行登録などの操作およびユニット情報取得などの参照の権限は，JP1ユーザーの権限に従います。実行権限のないユニットに対して実行登録などの操作をした場合は，エラーになります。また，ユニットの情報を取得する場合は，参照権限のあるユニットの情報だけが取得できます。各APIの操作に必要な実行権限は，マニュアル「JP1/Automatic Job Management System 3 - Software Development Kit APIリファレンス」を参照してください。

補足事項

JP1/AJS3 - SDKで使用するJP1ユーザーは，あらかじめユーザーマッピングを設定しておく必要があります。ユーザーマッピングの詳細については，マニュアル「JP1/Automatic Job Management System 3 - Manager 設計ガイド（業務設計編）」のアクセス権について記載されている個所を参照してください。

JP1資源グループを設定していないユニットは，すべてのJP1ユーザーが操作および参照できます。

4.5.2　APIの引数に使用できる文字

ユニット名やスケジューラーサービス名など，APIの引数の名称に使用できる文字の種類は，JP1/AJS3 - Managerと同じです。また，APIの引数に使用できる文字の範囲は，接続先のJP1/AJS3 - Managerの文字コードの設定に応じて異なります。接続先のJP1/AJS3 - Managerの文字コードに応じて使用できない文字があるため，接続先のJP1/AJS3 - Managerの文字コードおよび使用できる文字を確認してください。ユニットの名称に使用できる文字については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）」のユニットの制限値について記載されている個所を参照してください。また，使用できる文字の範囲については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）」のシステムで使用する言語種別について記載されている個所を参照してください。

4.5.3　APIの引数のバイト数

APIの引数に使用できるバイト数は，接続先のJP1/AJS3 - Managerに依存します。

JP1/AJS3 - Managerの文字コードがUTF-8の場合，シフトJISの場合よりも指定できる文字数が少なくなります。ただし，UTF-8環境でユニット名などに指定できる文字数を変更するための設定（環境設定パラメーターDEFLENTYPE）を「sjis」に指定しているときは，シフトJISと同じ文字数が使用できます。LinuxのUTF-8環境でユニット名などに指定できる文字数を変更するための設定については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド1」を参照してください。

4.5.4　操作対象のユニットの実行IDの管理

実行登録したジョブネットを操作するAPIやユニット情報を参照するAPIには，引数として実行IDを指定します。そのため，ユーザーアプリケーションではAPIで取得した実行IDを適切に管理してください。

実行IDを取得できるAPIを次に示します。

ユニット一覧情報の取得

即時実行登録

実行予定の追加

ジョブグループ直下のユニットのユニット定義情報，最新状態情報，および最新結果情報の取得

ジョブネットの予実績情報の取得

サマリー情報の取得

4.5.5　ユニット一覧情報の取得の対象世代

ユニット一覧情報の取得APIでは，取得対象の世代を指定します。定義されているすべてのユニット情報を取得したい場合は，次に示す世代に対してユニット一覧情報の取得APIをそれぞれ実行してください。

未登録

最新状態

最新結果

補足事項

JP1/AJS3 - Managerでジョブネットリリース機能を使用している場合，ユニット一覧情報を取得すると，リリース情報の異なる同一ユニット名のユニット情報を複数取得します。ジョブネットリリース機能を使用している場合は，リリースIDを指定してユニット一覧情報を取得してください。

4.5.6　JP1/AJS3 - Managerからのログアウト処理の実装

ユーザーアプリケーションの終了前に，JP1/AJS3 - Managerからログアウトする処理を必ず実装してください。ログアウトが実行されないとセッションが解放されないため，JP1/AJS3 - Managerへの接続数が減少します。ログアウトするタイミングを次に示します。

ユーザーが明示的にJP1/AJS3 - Managerからログアウトするとき

ユーザーセッション※が終了したとき

セッションタイムアウトなど，ユーザーセッションの終了時に，同じユーザーがログインしているすべてのJP1/AJS3 - Managerからログアウトするように実装してください。

注※

ユーザーセッションとは，ユーザーアプリケーションを利用するユーザーの利用開始から利用終了までの一連の処理のことです。

関連項目

5.2.7 JP1/AJS3 - Managerからログアウトするコーディング例

4.5.7　情報取得のAPIとルートジョブネットの保存世代数

ルートジョブネットの状態の情報は，JP1/AJS3 - Managerで設定されている保存世代数を上限として，実行が完了するたびに上書きされます。そのため，次に示すAPIの利用時に，ルートジョブネットの保存世代数の設定が小さいと，情報を取得できないことがあります。

詳細情報の取得

実行結果詳細の取得

引き継ぎ結果の取得

4.5.8　ユーザーアプリケーションのタイムアウト時間の設定

ユーザーアプリケーションでタイムアウト時間を設定する場合は，次の項目を考慮してください。

APIの接続タイムアウト時間

APIの受信タイムアウト時間

APIの処理時間

APIの処理時間は，JP1/AJS3 - Managerの処理時間に依存します。JP1/AJS3 - Managerに負荷の掛かるAPIを利用する場合，処理時間は長くなります。

関連項目

3.5.3(3) connect_timeout

3.5.3(6) receive_timeout

4.4.3 ユニットの総数および世代数によって負荷が掛かるAPI操作とJP1/AJS3 - Managerへの負荷

4.5.9　認証エラーへの対応

JP1/AJS3 - Managerへログインしたあと，JP1/Baseの認証サーバの再起動などがあると，APIの発行時に認証エラーが発生する場合があります。この場合，JP1/AJS3 - Managerへのログインから再実行するようにユーザーアプリケーションを実装してください。

4.5.10　接続先のJP1/AJS3 - Managerのデータベース構成によるAPIの機能差異

JP1/AJS3 - SDKが提供するAPIは，接続先のJP1/AJS3 - Managerのデータベース構成によって機能に差異があります。接続先のJP1/AJS3 - Managerの違いによる機能差異については，マニュアル「JP1/Automatic Job Management System 3 - Software Development Kit APIリファレンス」を参照してください。

5　ユーザーアプリケーションの開発

この章では，ユーザーアプリケーションの開発時に必要な設定およびAPIの利用例を説明します。

5.1　ユーザーアプリケーションの基本的な処理の流れ

ユーザーアプリケーションがWebアプリケーションの場合の，ユーザーアプリケーションの処理の例とコーディング例について説明します。

図5‒1　APIの利用例

5.1.1　AjsCdインスタンスを生成するコーディング例

AjsCdインスタンスは，ユーザーアプリケーションの初期化時に生成します。ユーザーアプリケーションごとに，1つのAjsCdインスタンスを生成する必要があります。

AjsCdインスタンスを生成するコーディング例を次に示します。

try {
  /* ファクトリインスタンスの取得 */
  AjsCdFactory factory = AjsCdFactory.getInstance();

  /* AjsCdインスタンスの生成 */
  /* ユーザーアプリケーション名は環境設定ファイルのファイル名で設定した名称と同じ名称を指定 */
  cdObj = factory.createAjsCd("ユーザーアプリケーション名");

} catch (AjsCdException e) {
  /*エラー処理*/
}

ユーザーアプリケーションの初期化時に生成したAjsCdインスタンスは，アプリケーションの終了時に破棄する必要があります。

関連項目

5.2.9 AjsCdインスタンスを破棄するコーディング例

5.1.2　AjsCdApiインスタンスを生成するコーディング例

AjsCdApiインスタンスは，セッションごとに生成します。ユーザーアプリケーションごとのセッションの単位を次に示します。

Webアプリケーション

HTTPセッションごとにAjsCdApiインスタンスを生成します。生成したAjsCdApiインスタンスは，ユーザーのログアウト操作や，HTTPセッションタイムアウトまたはセッション切断などのタイミングで破棄する必要があります。

C/Sアプリケーション

クライアントアプリケーションとの接続ごとにAjsCdApiインスタンスを生成します。生成したAjsCdApiインスタンスは，ユーザーのログアウト操作や接続の切断などのタイミングで破棄する必要があります。

AjsCdApiインスタンスを生成するコーディング例を次に示します。

try {
  /* AjsCd インスタンスの取得 */
  /* ユーザーアプリケーション名は環境設定ファイルのファイル名で設定した名称と同じ名称を指定 */
  AjsCd cdObj = factory.getAjsCd("ユーザーアプリケーション名");

  /* AjsCdApiインスタンスの取得 */
  /* AjsCdApi識別子にインスタンス識別用のユニークなIDを指定
  */
  AjsCdApi apiObj = cdObj.createAjsCdApi("AjsCdApi識別子");
} catch (AjsCdException e) {
  /* エラー処理 */
  /* 使用中の識別子を指定してcreateAjsCdApiを使用した場合など */
}

関連項目

5.2.8 AjsCdApiインスタンスを破棄するコーディング例

5.1.3　JP1/AJS3 - Managerへログインするコーディング例

AjsCdApiインスタンスごとにJP1/AJS3 - Managerにログインします。これによって，各JP1ユーザーの権限でJP1/AJS3 - Managerから情報を取得したり，操作したりすることができます。1つのAjsCdApiインスタンスから1つのJP1/AJS3 - Managerに対して，複数回ログインすることはできません。

JP1/AJS3 - Managerへログインするコーディング例を次に示します。

try {
  /* JP1/AJS3 - Managerへのログイン */
  /* ログイン画面から次の情報を取得
     ・username（ユーザー名）
     ・password（パスワード）
     ・hostname（接続先JP1/AJS3 - Managerのホスト名）
  */
  /* requestはHttpServletRequestインスタンス */
  /* パスワードのセキュリティはユーザーアプリケーションで実装が必要 */
  String jp1username = request.getParameter("username");
  String password = request.getParameter("password");
  String mgrhost = request.getParameter("hostname");

  /* ログインAPIの呼び出し */
  /* 第１引数はJP1/AJS3 - Managerのホスト名 */
  AjsCd cdObj = factory.getAjsCd("ユーザーアプリケーション名");
  AjsCdApi apiObj = cdObj.getAjsCdApi("AjsCdApi識別子");
  apiObj.login(mgrhost, jp1username, password);

} catch (AjsCdException e) {
  /* エラー処理 */
}

5.1.4　ユニット一覧情報を取得するコーディング例

ユニット一覧情報を取得するコーディング例を次に示します。ここでは，ジョブグループ（/system/sales）直下のユニットについて，最新状態の世代を一覧情報として取得する例を説明します。

try {
  /* 検索条件（/system/sales直下を取得）の設定 */
  AjsCdSearchCondition cond = AjsCdSearchCondition.createAjsCdSearchCondition();
  cond.setSearchLocation("/system/sales");
  cond.setSearchLowerUnits(AjsCdSearchCondition.LowerType.NO)

  /* ジョブグループ（/system/sales）直下のユニットの最新状態を一覧で取得 */
  /* mgrhostはログイン時に指定した接続先JP1/AJS3 - Managerのホスト名 */
  AjsCd cdObj = factory.getAjsCd("ユーザーアプリケーション名");
  AjsCdApi apiObj = cdObj.getAjsCdApi("AjsCdApi識別子");
  AjsCdSearchResult result = apiObj.searchUnit(mgrhost, "AJSROOT1", cond);

} catch (AjsCdApiCancelException e) {
  /* エラー処理 */
  /* ユニット一覧情報取得がキャンセルされた場合 */
} catch (AjsCdInvalidTokenException e) {
  /* エラー処理 */
} catch (AjsCdException e) {
  /* エラー処理 */
}

補足事項

ユニット一覧情報の取得は，API処理に時間が掛かる場合があります。そのため，ユニット一覧情報の取得をキャンセルするためのAPIを提供しています。このAPIを使用すると，現在実行中のユニット一覧情報の取得処理の中止がJP1/AJS3 - Managerに通知されます。

5.1.5　ルートジョブネットを即時実行登録するコーディング例

ルートジョブネットを即時実行登録するコーディング例を次に示します。

try {
  /* 業務一覧画面から実行対象のルートジョブネット名（unitname）を取得 */
  /* requestは，HttpServletRequestインスタンス */
  String unitname = request.getParameter("unitname");

  /* 即時実行登録（起動条件やマクロ変数は指定しない） */
  /* mgrhostはログイン時に指定した接続先JP1/AJS3 - Managerのホスト名 */
  AjsCd cdObj = factory.getAjsCd("ユーザーアプリケーション名");
  AjsCdApi apiObj = cdObj.getAjsCdApi("AjsCdApi識別子");
  String execid = apiObj.registerImmediateExec(mgrhost, "AJSROOT1", unitname, null, null);

  /* 取得した実行IDは中断や状態確認で必要なためユーザーアプリケーションで管理 */

} catch (AjsCdInvalidTokenExceptione e) {
  /* エラー処理 */
} catch (AjsCdException e) {
  /* エラー処理 */
}

5.1.6　実行したルートジョブネットの状態を取得するコーディング例

実行したルートジョブネットの状態を取得するコーディング例を次に示します。

try {
  /* ルートジョブネットの状態情報の取得 */
  /* mgrhostはログイン時に指定した接続先JP1/AJS3 - Managerのホスト名 */
  /* ユニット名（unitname），実行ID（exeid）は管理されている情報を使用  */
  AjsCd cdObj = factory.getAjsCd("ユーザーアプリケーション名");
  AjsCdApi apiObj = cdObj.getAjsCdApi("AjsCdApi識別子");
  AjsCdUnitStatus statinfo = apiObj.getUnitStatus(mgrhost, "AJSROOT1", unitname, exeid);

  /* 状態の取得 */
  AjsCdUnitStatus statusCode =  statinfo.getStatus();

} catch (AjsCdInvalidTokenExceptione e) {
  / *エラー処理 */
} catch (AjsCdException e) {
  /* エラー処理 */
}

5.1.7　JP1/AJS3 - Managerからログアウトするコーディング例

JP1/AJS3 - Managerからログアウトするコーディング例を次に示します。

try {
  /* JP1/AJS3 - Managerからのログアウト */
  /* mgrhostはログイン時に指定した接続先JP1/AJS3 - Managerのホスト名 */
  AjsCd cdObj = factory.getAjsCd("ユーザーアプリケーション名");
  AjsCdApi apiObj = cdObj.getAjsCdApi("AjsCdApi識別子");
  apiObj.logout(mgrhost);

} catch (AjsCdException e) {
  /* エラー処理 */
}

注意事項

ユーザーからの明示的なログアウト以外に，HTTPセッションタイムアウトなどでAjsCdApiインスタンスを破棄する場合，破棄する前に接続先のすべてのJP1/AJS3 - Managerからログアウトする必要があります。その場合は，ログインしているすべてのJP1/AJS3 - Managerに対してログアウト処理を実行するAPIを利用すると，ログイン中のすべてのJP1/AJS3 - Managerからログアウトできます。

関連項目

4.5.6 JP1/AJS3 - Managerからのログアウト処理の実装

5.1.8　AjsCdApiインスタンスを破棄するコーディング例

接続先のすべてのJP1/AJS3 - Managerからログアウトし，AjsCdApiインスタンスが不要になったタイミングでAjsCdApiインスタンスを破棄します。AjsCdApiインスタンスを破棄するコーディング例を次に示します。

try {
  /* AjsCdApiインスタンスの破棄 */
  AjsCd cdObj = factory.getAjsCd("ユーザーアプリケーション名");
  cdObj.destroyAjsCdApi("AjsCdApi識別子");

} catch (AjsCdException e) {
  /*エラー処理*/
}

5.1.9　AjsCdインスタンスを破棄するコーディング例

AjsCdインスタンスは，ユーザーアプリケーションの終了時に破棄する必要があります。AjsCdインスタンスを破棄するコーディング例を次に示します。

try {
  /* ファクトリインスタンスの取得 */
  factory = AjsCdFactory.getInstace();
  /*AjsCdインスタンスを破棄する*/
  factory.destroyAjsCd ("ユーザーアプリケーション名");

} catch (AjsCdException e) {
  /* エラー処理 */
}

5.2　画面作成例

ジョブネットの状態や進行状況を監視する画面をユーザーアプリケーションで作成できます。使用するAPI，画面例，および画面作成時の注意事項について説明します。

5.2.1　ユニット一覧画面

ジョブグループの階層構造をたどって，任意のルートジョブネットを監視する画面例について，次に説明します。

(1)　画面例

図5‒2　画面イメージ（ユニット一覧画面）

ツリーエリア

監視対象のジョブグループおよびその配下にあるジョブグループをツリー表示します。

リストエリア

ツリーエリアで選択したジョブグループの直下のユニットの基本情報を一覧で表示します。

(2)　データ取得の流れ

データを取得する処理の流れを次に示します。

トップのジョブグループのユニット情報を取得します。

初期表示や最新情報への更新などのタイミングで，ツリーエリアのトップノードに表示するスケジューラーサービスの一覧を取得します。

項番

使用するAPI

説明

API①

enumSchService

スケジューラーサービス一覧を取得します。

展開するジョブグループ直下のユニット情報一覧を取得します。

ツリーエリアのノード展開またはノード選択のタイミングや，最新情報への更新などのタイミングで，ジョブグループ直下のユニット情報一覧を取得して，ツリーエリアおよびリストエリアを表示します。

項番

使用するAPI

説明

API②

getCurrentStatusesUnderJobGroup

ジョブグループ直下のユニット情報の一覧を取得します。ルートジョブネットの場合，ユニット情報として定義情報のほかに，最新状態および最新結果が含まれます。

5.2.2　ジョブフロー画面

ジョブの状態/結果をジョブフロー形式で監視する画面例について，次に説明します。

(1)　画面例

図5‒3　画面イメージ（ジョブフロー画面）

ツリーエリア

ルートジョブネット，ネストジョブネット，および起動条件を階層構造で表示します。

マップエリア

ツリーエリアで選択したルートジョブネット，ネストジョブネット，および起動条件の直下のユニット状態情報をジョブフロー形式で表示します。

リストエリア

ツリーエリアで選択したルートジョブネット，ネストジョブネット，および起動条件の直下のユニットの基本情報を一覧で表示します。

(2)　データ取得の流れ

データを取得する処理の流れを次に示します。

ルートジョブネットのユニット情報，ユニット状態情報を取得します。

初期表示や最新情報への更新などのタイミングで，ルートジョブネットのユニット情報，ユニット状態情報を取得します。

項番

使用するAPI

説明

API①

searchUnit

ルートジョブネットのユニット情報，ユニット状態情報を取得します。

ルートジョブネット，ネストジョブネット，および起動条件の直下のユニット情報の一覧とその関連線，およびユニット状態情報の一覧を取得します。

ツリーエリアのノード展開またはノード選択のタイミングや，最新情報への更新などのタイミングで，ルートジョブネット，ネストジョブネット，および起動条件の直下のユニット情報一覧とその関連線情報，およびユニット状態情報一覧を取得して，マップエリアとリストエリアを表示します。

項番

使用するAPI

説明

API②

getDefinitionsUnderJobnet

ルートジョブネット，ネストジョブネット，および起動条件の直下のユニット情報の一覧を取得します。

API③

getRelationsUnderJobnet

ルートジョブネット，ネストジョブネット，および起動条件の直下のユニット関連線情報を取得します。

API④

getStatusesUnderJobnet

ルートジョブネット，ネストジョブネット，および起動条件の直下のユニット状態情報の一覧を取得します。

(3)　画面作成のポイント

ジョブネットリリース機能を使用している場合，リリース情報はsearchUnitメソッドを呼び出したときに取得できます。

起動条件（.CONDITION）を定義している場合は，起動条件（.CONDITION）のユニット情報は，ルートジョブネット直下に含まれています。

取得したユニット情報と関連線情報，およびユニット状態情報を用いて，マップ情報（マップエリアの情報）を表示できます。マップ情報を表示する場合の例とポイントを次に示します。

(a)　マップ情報の表示

前提条件

getDefinitionsUnderJobnetメソッドの戻り値を次に示します。

表5‒1　AjsCdUnitInfoの値

getUnitName

getUnitID

getHorizontalPosition

getVerticalPosition

isRecoveryUnit

Job1

1000

0

0

false

Job2

1001

0

2

false

Job3

1002

1

1

false

判定

1003

2

1

false

Job4

1004

2

3

false

Job5

1005

3

1

false

リカバリー

1006

3

3

true

getRelationsUnderJobnetメソッドの戻り値を次に示します。

表5‒2　AjsCdUnitRelationの値

getPreceding

getSucceeding

getRelationType

1000

1002

NORMAL

1001

1002

NORMAL

1002

1003

NORMAL

1003

1004

JUDGE

1003

1005

NORMAL

1005

1006

NORMAL

画面

図5‒4　マップエリアの表示例

(b)　実現ポイント

マップエリアを開発する場合のポイントを次に示します。番号は，上記の図の番号にリンクしています。

表5‒3　マップエリアの実現ポイント

番号

内容

①

ユニット種別ごとのアイコンイメージを準備してください。それらのユニットアイコンをAjsCdUnitInfoインターフェースで得られるユニット種別および位置情報を用いて，表示エリアに描画してください。リカバリーユニットおよびシナリオの場合は，個別のアイコンイメージとすることをお勧めします。

②

AjsCdUnitRelationインターフェースから得られる情報を用いて，上記①で描画したユニットのユニットIDとの突き合わせを行って，アイコン間にユニットの実行順序を表現する矢印を描画してください。関連線が順接続の場合は，単方向の矢印を，条件接続の場合は，個別の色を用いた双方向の矢印とすることをお勧めします。また，後続がリカバリーユニットの場合は，個別の色を用いた片方向の矢印にして，その実行順序がリカバリーパスであることを表現すると，視認性が向上できます。

③

ユニットアイコンの表示間隔は任意です。関連線が表示できるだけの十分な間隔を設定してください。

④

表示エリアのサイズは任意です。ユーザープログラムの要件に合わせて決定してください。

⑤

ユニット状態情報の取得（getStatusesUnderJobnetメソッド）から得られるユニット状態情報を使用して，上記①で描画したユニットのユニットIDと突き合わせて，それぞれのユニットアイコンに，ユニットの状態を表現する色を描画してください。

5.2.3　実行予実績一覧画面

ジョブの実行予実績をデイリー形式のガントチャートで監視する画面例について，次に説明します。

(1)　画面例

図5‒5　画面イメージ（実行予実績一覧画面）

ツリーエリア

ルートジョブネット，ネストジョブネット，起動条件，ジョブを階層構造で表示します。ジョブネットリリース機能を使用している場合，リリースIDの数分のツリーを表示します。

日時エリア

日付，時間を表示します。

スケジュールエリア

ツリーで表示されているユニットの実行スケジュールを表示します。

実行結果リスト

ツリーエリアと選択枠で選択された実行スケジュールを表示します。

表示日/基準時刻表示

情報の表示日とジョブグループ名に表示されているジョブグループの基準時刻を表示します。

(2)　データ取得の流れ

データを取得する処理の流れを次に示します。

ルートジョブネットのユニット定義情報（種別，コメント，ユニットID）を取得します。ジョブネットリリース機能を使用している場合は，リリース情報を取得します。

初期表示や最新情報への更新などのタイミングで，ルートジョブネットのユニット定義情報を取得します。

項番

使用するAPI

説明

API①

getJobnetReleaseInfo

ジョブネットリリース機能を使用している場合，またはジョブネットリリース機能を使用しているか不明な場合に，リリース情報を取得します。

API②

searchUnit

ルートジョブネットのユニットの定義情報（種別，コメント，ユニットID）を取得します。リリース情報が存在する場合は，上記のgetJobnetReleaseInfoメソッドで取得したリリースIDの数分，searchUnitメソッドに指定して情報を取得してください。

ルートジョブネット全体のスケジュール，基準時刻，現在時刻を取得します。

初期表示や最新情報への更新などのタイミングで，ルートジョブネットの実行スケジュール情報を取得して，スケジュールエリアおよび実行結果リストに表示します。

項番

使用するAPI

説明

−

Javaの標準API

Javaの標準APIで現在の日時を取得します。

API③

getCalendar

ルートジョブネットの基準時刻を取得します。取得開始日と終了日には，上記のJavaの標準APIで取得した日付を使用します。

API④

getSchedule

ルートジョブネット配下すべての実行スケジュール情報（予実績）を取得します。取得開始日と終了日には，上記のJavaの標準APIで取得した日付を使用します。

ルートジョブネットにリリース情報が存在する場合は，取得したい期間に有効となるリリースIDを指定してgetScheduleメソッドを実行してください。

ルートジョブネット，ネストジョブネット，および起動条件を展開したときに，直下のユニット情報の一覧を取得します。

ツリーエリアのノード展開や最新情報への更新などのタイミングで，ルートジョブネット，ネストジョブネット，および起動条件の直下のユニット情報の一覧を取得します。

項番

使用するAPI

説明

API⑤

getDefinitionsUnderJobnet

ルートジョブネット，ネストジョブネット，および起動条件の直下のユニット情報（ユニット名，種別，コメント，ユニットID）を取得します。

ルートジョブネットにリリース情報が存在する場合は，リリースIDを指定してgetDefinitionsUnderJobnetメソッドを実行してください。

(3)　画面作成のポイント

getScheduleメソッドで取得した情報には，ユニット名などの定義情報は含まれません。searchUnitメソッドやgetDefinitionsUnderJobnetメソッドで取得した定義情報と，getScheduleメソッドで取得した実行スケジュール情報は，ユニットIDで突き合わせを行ってください。

5.2.4　サマリー画面

監視対象ユニットの監視対象日の進捗状況を監視する画面例について，次に説明します。

(1)　画面例

図5‒6　画面イメージ（サマリー画面）

監視対象一覧

監視対象ユニットの進捗状況を表示します。監視対象日に複数回実行されるユニットは，複数世代の監視結果を合計して表示します。

ユニット詳細情報一覧

監視対象一覧で選択した監視対象ユニット，および配下のユニットの基本情報を一覧表示します。なお，監視対象一覧で選択したユニットがルートリモートジョブネットの場合，配下のユニットの情報は表示しません。また，監視対象一覧で選択したユニットがプランニンググループの場合，配下のユニットの情報だけを表示します。

注意事項

次の場合は，各世代でユニット情報の数が異なることがあります。

取得対象外となるユニットの状態が存在する場合

ジョブネットリリース機能を使用して，ある日時から定義が切り替わった場合

(2)　データ取得の流れ

データを取得する処理の流れを次に示します。

監視対象ユニットの進捗状況を取得します。複数のユニットの進捗状況を監視する場合は，下記の処理を繰り返し実行します。

初期表示や最新情報への更新などのタイミングで，監視対象ユニットの進捗状況を取得し，監視対象一覧に表示します。

項番

使用するAPI

説明

API①

getJobnetSummary

監視対象ユニットの進捗状況を取得します。

監視対象一覧でユニットを選択したときには，上記1.で取得した情報を取り出し，詳細情報を表示します。

監視対象一覧でユニットを選択したタイミングで，ユニット詳細情報一覧に詳細情報を表示します。

(3)　画面作成のポイント

詳細情報を表示したい場合は，getJobnetSummaryメソッドの「取得対象とする情報の種類」の指定を省略するか，取得できる指定を行ってください。

進捗度，実績，および残りの件数は，実績として扱うユニットによって異なるため，getJobnetSummaryメソッドでは返却しません。getJobnetSummaryメソッドで返却する情報を元に計算する必要があります。

5.2.5　画面作成時の注意事項

画面作成時の注意事項を次に示します。

取得できるユニットの情報は各APIで異なります。各APIで取得できるユニット情報の差異については，マニュアル「JP1/Automatic Job Management System 3 - Software Development Kit　API リファレンス」のメソッドで取得できるユニット情報の差異について記載している個所を参照してください。

複数のAPIを使用して画面を実現する場合は，各APIで取得した情報を一時的に保持するなどして，情報をマージして表示してください。

複数のAPIを使用して画面を実現する場合は，APIを呼び出すタイミングによって，取得した情報が不一致になる可能性を考慮しておく必要があります。このため，情報に不一致が生じた場合のエラー処理や情報全体を再取得するなどの検討が必要です。特にジョブネットリリース機能を使用している場合は，運用中に定義情報が切り替わるため注意が必要です。

たとえば，getDefinitionsUnderJobnetメソッドで取得したユニットの定義情報と，getStatusesUnderJobnetメソッドで取得したユニットの状態情報が，定義情報が切り替わるなどの理由で，不一致になる可能性があります。ジョブネットリリース機能を使用している場合は，APIを呼び出すときに実行IDやリリースIDを指定して取得対象を特定することで，情報に不一致が生じることを回避できることがあります。

6　運用

この章では，JP1/AJS3 - SDKを使用したユーザーアプリケーションの運用時に，JP1/AJS3 - SDKの設定を変更する方法について説明します。

6.1　運用時に構成変更する場合の注意事項

運用中にJP1/AJS3 - SDKを使用しているホストを構成変更する場合，構成の変更中はJP1/AJS3 - SDKのクラスライブラリを参照するユーザーアプリケーションを停止してください。ユーザーアプリケーションの動作中に構成変更すると，API処理に影響するおそれがあります。

構成変更のあとに対処が必要な構成変更の例を次に示します。

JP1/AJS3 - SDKを使用しているホストの構成変更

フォルダ構成の変更

接続先のJP1/AJS3 - Managerホストの構成変更

スケジューラーサービスの追加，変更および削除

JP1/AJS3 - Managerホスト名の変更

IPアドレスの変更

関連項目

6.2.1 JP1/AJS3 - SDKを使用しているホストを構成変更した場合の対処

6.2.2 接続先のJP1/AJS3 - Managerホストを構成変更した場合の対処

6.2　運用時に構成変更した場合の対処

JP1/AJS3 - SDKを使用したユーザーアプリケーションの運用時に，構成を変更した場合の対処について説明します。

6.2.1　JP1/AJS3 - SDKを使用しているホストを構成変更した場合の対処

フォルダ構成を変更した場合，構成を変更したフォルダに応じて次に示す設定項目を変更後のフォルダパスに修正してください。

表6‒1　フォルダ構成を変更した場合に変更する設定

項番

構成を変更したフォルダ

設定項目

1

トレースログの出力先フォルダ

環境設定ファイルのtracelog_dir

2

JP1/AJS3 - SDK運用フォルダ

Javaシステムプロパティのキー名「jp1ajscd.home」

3

共通トレースログの出力先フォルダ

Javaシステムプロパティのキー名「jp1ajscd.comlog_dir」

補足事項

Javaシステムプロパティ，環境設定ファイルの変更を有効にするためには，ユーザーアプリケーションを再起動する必要があります。

関連項目

3.1.7 JP1/AJS3 - SDK運用フォルダの確認

3.5.3(8) tracelog_dir

3.5.14 Javaシステムプロパティの設定

6.2.2　接続先のJP1/AJS3 - Managerホストを構成変更した場合の対処

接続先のJP1/AJS3 - Managerを構成変更した場合，変更した内容に応じて次に示す対処をしてください。

表6‒2　接続先のJP1/AJS3 - Managerを構成変更した場合の対処

項番

構成変更の内容

対処

1

スケジューラーサービスの追加，変更および削除

ユーザーアプリケーションで，再度JP1/AJS3 - Managerにログインし直してください。

2

JP1/AJS3 - Managerホスト名の変更

ユーザーアプリケーションで接続先のJP1/AJS3 - Managerのホスト名またはIPアドレスを直接指定している場合は，変更後のJP1/AJS3 - Managerのホスト名またはIPアドレスに変更してください。

3

IPアドレスの変更

関連項目

付録A ファイルおよびフォルダ一覧

6.3　運用時にJP1/AJS3 - Managerで操作できるコマンド一覧

JP1/AJS3 - SDKを使用したユーザーアプリケーションの運用時に，JP1/AJS3 - SDKからの接続に対してJP1/AJS3 - Managerで操作できるコマンドを次の表に示します。

表6‒3　運用時にJP1/AJS3 - Managerで操作できるコマンド一覧

項番

コマンド名

概要

1

jajs_hstd

JP1/AJS3 - SDKからの接続を受け付けるajscdinetdプロセスを個別に起動できます。

2

jajs_hstd_stop

JP1/AJS3 - SDKからの接続を受け付けるajscdinetdプロセスを個別に停止できます。

3

jajs_status

ajsstatus

JP1/AJS3 - Managerに接続しているJP1/AJS3 - SDKの接続情報を確認できます。

4

ajslogprint

スケジューラーログに出力されたログから，JP1/AJS3 - SDKのログを抽出できます。

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

7　トラブルシューティング

この章では，JP1/AJS3 - SDKを使用したユーザーアプリケーションの運用中にトラブルが発生した場合に必要な作業や対処方法について説明します。

7.1　トラブルへの対処の流れ

JP1/AJS3 - SDKを使用しているときにトラブルが起きた場合の対処の流れを次に示します。

現象の確認

トラブルが発生したときの現象を確認してください。メッセージが出力されている場合は，メッセージの内容を確認してください。

資料の採取

トラブルの要因を調査するために，資料を採取してください。

要因の調査

採取した資料を基に，トラブルの要因を調査してください。

7.2　ログ情報

JP1/AJS3 - SDKで出力されるログについて説明します。

7.2.1　ログの種類

JP1/AJS3 - SDKで出力されるログの種類を次に示します。

(1)　トレースログ

トレースログとは，APIの処理内容やエラーメッセージなどをユーザーアプリケーションごとに出力するログです。

(2)　共通トレースログ

共通トレースログとは，トレースログの初期化前などでトレースログに出力できない場合に出力するログです。

関連項目

7.2.2 ログファイル一覧

7.2.2　ログファイル一覧

JP1/AJS3 - SDKが出力するデフォルトのログファイルを次の表に示します。

表7‒1　JP1/AJS3 - SDKのログファイル一覧

ログの種類

デフォルトのファイル名

出力される情報の内容

デフォルトのディスク占有量※1

最大ディスク占有量※1

ファイルの切り替え時期

トレースログ

ajscdtrace_ユーザーアプリケーション名_{1|2|3}.log※2,3

APIのメソッド名や，引数および戻り値

エラーまたは警告メッセージ

動作中の環境設定の情報

6,304,014

268,502,432

ラップアラウンド時

共通トレースログ

ajscdtrace_{1|2|3}

.log※2

6,304,014

6,304,014

注※1

「デフォルトのディスク占有量」および「最大ディスク占有量」の単位は，バイトです。

注※2

初期化時に面数分のファイルが作成されます。

注※3

トレースログの面数は環境設定ファイルで変更できます。

JP1/AJS3 - SDKのログファイルおよびフォルダ一覧の，表の各列の意味について説明します。

ログの種類

JP1/AJS3 - SDKが出力するログの種類を記載しています。

デフォルトのファイル名

デフォルトのログファイル名を記載しています。

デフォルトのディスク占有量

環境設定がデフォルトの状態で運用した場合のディスク占有量を記載しています。ログファイルが複数ある場合は，その合計量を記載しています。

最大ディスク占有量

定義を変更した場合も含めて，ログファイルが使用する最大のディスク占有量を記載しています。

ファイルの切り替え時期

JP1/AJS3 - SDKが出力先のログファイルを切り替えるタイミングを記載しています。

注意事項

ログファイルの出力先フォルダのパスおよびファイル名には，マルチバイト文字を指定することはできません。

関連項目

3.5.3(9) tracelog_size

3.5.3(10) tracelog_num

付録A ファイルおよびフォルダ一覧

付録D トレースログの出力形式

7.3　トラブル発生時に採取が必要な資料

JP1/AJS3 - SDKを使用したユーザーアプリケーションの運用でトラブルが発生したときに採取が必要な資料について説明します。

7.3.1　トラブル発生時に採取が必要な資料一覧（Windows 8，Windows Server 2012，Windows 7，Windows Server 2008の場合）

Windows 8，Windows Server 2012，Windows 7，およびWindows Server 2008の場合に，JP1/AJS3 - SDKを使用したユーザーアプリケーションの運用でトラブルが発生したときに採取する資料一覧を次の表に示します。

表7‒2　トラブル発生時に採取する資料一覧

項番

採取が必要な資料

マニュアル参照先

1

OSのログ情報

7.3.3

2

JP1の情報

7.3.5

3

プロセス一覧

7.3.6

4

スレッドダンプ

7.3.7

5

Webアプリケーションサーバの情報※

7.3.8

注※

ユーザーアプリケーションがWebアプリケーションの場合，資料の採取が必要です。

関連項目

7.4.1 資料採取の作業項目（Windows 8，Windows Server 2012，Windows 7，Windows Server 2008の場合）

7.3.2　トラブル発生時に採取が必要な資料一覧（Windows Server 2003の場合）

Windows Server 2003の場合に，JP1/AJS3 - SDKを使用したユーザーアプリケーションの運用でトラブルが発生したときに，採取する資料一覧を次の表に示します。

表7‒3　トラブル発生時に採取する資料一覧

項番

採取が必要な資料

マニュアル参照先

1

OSのログ情報

7.3.4

2

JP1の情報

7.3.5

3

プロセス一覧

7.3.6

4

スレッドダンプ

7.3.7

5

Webアプリケーションサーバの情報※

7.3.8

注※

ユーザーアプリケーションがWebアプリケーションの場合，資料の採取が必要です。

関連項目

7.4.2 資料採取の作業項目（Windows Server 2003の場合）

7.3.3　OSのログ情報の採取（Windows 8，Windows Server 2012，Windows 7，Windows Server 2008の場合）

Windows 8，Windows Server 2012，Windows 7，およびWindows Server 2008の場合に，採取が必要なOSのログ情報を次の表に示します。なお，ツールで採取できない情報は，相当する情報をトラブル発生時に手動で採取してください。

表7‒4　トラブル発生時に採取が必要なOSのログ情報（Windows 8，Windows Server 2012，Windows 7，およびWindows Server 2008の場合）

情報の種類

デフォルトのファイル名

ツールでの採取

Windowsイベントログ

−

×※1

Windowsレジストリー情報

−

○

hostsファイルおよびservicesファイル

システムフォルダ¥system32¥drivers¥etc¥hosts

システムフォルダ¥system32¥drivers¥etc¥services

○

マシン構成情報※2

−

○

サービスが起動されているPP一覧※2

−

○

ネットワーク構成情報※2

−

○

ダンプファイル

メモリーダンプ

クラッシュダンプ

−

×

問題レポート

−

×

（凡例）

○：資料採取ツールで資料を採取できる。

×：資料採取ツールで資料を採取できない。

−：デフォルトのファイル名なし。

注※1

JP1/AJS3 - Manager，JP1/AJS3 - AgentおよびJP1/AJS3 - Viewが同一ホスト内に存在する場合は採取できます。

注※2

これらの情報を含めたハードウェア環境，ソフトウェア環境およびインターネットの設定など，コンピュータに関するさまざまな情報が取得されます。なお，資料採取の終了までに数分掛かることがあります。採取中は，［システム情報］ダイアログボックスが表示されますが，自動で閉じるため手動での操作は必要ありません。

関連項目

7.4.3 資料採取ツールの実行手順

7.4.6 ダンプファイルの採取手順（Windows 8，Windows Server 2012，Windows 7，Windows Server 2008の場合）

7.4.7 問題レポートの採取手順（Windows 8，Windows Server 2012，Windows 7，Windows Server 2008の場合）

7.3.4　OSのログ情報の採取（Windows Server 2003の場合）

Windows Server 2003の場合に，採取が必要なOSのログ情報を次の表に示します。

表7‒5　トラブル発生時に採取が必要なOSのログ情報（Windows Server 2003の場合）

情報の種類

デフォルトのファイル名

ツールでの採取

Windowsイベントログ

−

×※1

Windowsレジストリー情報

−

○

hostsファイルおよびservicesファイル

システムフォルダ¥system32¥drivers¥etc¥hosts

システムフォルダ¥system32¥drivers¥etc¥services

○

ワトソンログファイル※2

システムドライブ¥Documents and Settings¥All Users¥Application Data¥Microsoft¥Dr Watson¥drwtsn32.log

○

マシン構成情報

−

○

サービスが起動されているPP一覧

−

○

ネットワーク構成情報

−

○

ダンプファイル※2

メモリーダンプ

クラッシュダンプ

−

○

（凡例）

−：デフォルトのファイル名なし。

○：資料採取ツールで資料を採取できる。

×：資料採取ツールで資料を採取できないため，手動で採取する。

注※1

JP1/AJS3 - Manager，JP1/AJS3 - AgentおよびJP1/AJS3 - Viewが同一ホスト内に存在する場合は採取できます。

注※2

デフォルトのフォルダからログ情報を取得します。別のフォルダを指定している場合は，資料採取ツールのセットアップが必要です。

関連項目

3.5.7 資料採取ツールのセットアップ手順

7.4.3 資料採取ツールの実行手順

7.3.5　JP1の情報の採取

採取が必要なJP1/AJS3 - SDKの情報を次の表に示します。また，接続先のJP1/AJS3 - Managerホスト上のファイルも採取が必要です。

表7‒6　トラブル発生時に採取が必要なJP1の情報

情報の種類

デフォルトのフォルダ名

ツールでの採取

ログファイル

JP1/AJS3 - SDK運用フォルダ¥log

JP1/AJS3 - SDK運用フォルダ¥log¥sys

○

環境設定ファイル

JP1/AJS3 - SDK運用フォルダ¥conf

○

ファイルリスト

JP1/AJS3 - SDKインストール先フォルダ¥lib

○

フォルダのアクセス権限情報

JP1/AJS3 - SDKインストール先フォルダ

○

接続先情報（接続先のJP1/AJS3 - Managerの資料採取ツールで採集した資料※）

接続先のJP1/AJS3 - Managerがインストールされているホストの「%TEMP%¥jp1ajs2¥backlog」（Windowsの場合）

接続先のJP1/AJS3 - Managerがインストールされているホストの「/tmp/jp1ajs2/」配下の情報（UNIXの場合）

△

（凡例）

○：資料採取ツールで採取できる。

△：接続先のJP1/AJS3 - Managerの資料採取ツールで採取できる。

注※

接続先のJP1/AJS3 - Managerの資料採取方法については，マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング」を参照してください。

関連項目

3.1.7 JP1/AJS3 - SDK運用フォルダの確認

7.4.3 資料採取ツールの実行手順

7.3.6　プロセス一覧の採取

接続先のJP1/AJS3 - Managerのプロセスの動作状況を確認して，記録しておいてください。

JP1/AJS3 - Managerのプロセスについては，マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング」を参照してください。

関連項目

3.4.1 JP1/AJS3 - Managerのプロセスの起動の設定

7.4.8 プロセスの状態の確認手順

7.3.7　スレッドダンプの採取

JP1/AJS3 - SDKの動作が止まってしまった場合は，Javaのスレッドダンプを採取する必要があります。スレッドダンプとは，Javaのプロセス内で動作しているスレッドの情報が出力されるファイルです。Javaプログラムのレベルでトラブルの要因を調査するのに役立ちます。

関連項目

7.4.9 スレッドダンプの採取手順

7.3.8　Webアプリケーションサーバの情報の採取

ユーザーアプリケーションがWebアプリケーションの場合，Webアプリケーションサーバでトラブルが発生したときにWebアプリケーションサーバの資料を採取する必要があります。

関連項目

7.4.10 Webアプリケーションサーバの情報の採取手順

7.4　資料の採取の手順

トラブルが発生したときに，資料を採取する手順について説明します。

7.4.1　資料採取の作業項目（Windows 8，Windows Server 2012，Windows 7，Windows Server 2008の場合）

Windows 8，Windows Server 2012，Windows 7，およびWindows Server 2008の場合に，トラブルが発生したときの資料採取の作業項目を次の表に示します。

表7‒7　資料採取の作業項目（Windows 8，Windows Server 2012，Windows 7，およびWindows Server 2008の場合）

項番

作業項目

マニュアル参照先

1

資料採取ツールの実行

7.4.3

2

ダンプファイルの採取

7.4.6

3

問題レポートの採取

7.4.7

4

プロセスの状態の確認

7.4.8

5

スレッドダンプの採取

7.4.9

6

Webアプリケーションサーバの情報の採取

7.4.10

7.4.2　資料採取の作業項目（Windows Server 2003の場合）

Windows Server 2003の場合に，トラブルが発生したときの資料採取の作業項目を次の表に示します。

表7‒8　資料採取の作業項目（Windows Server 2003の場合）

項番

作業項目

マニュアル参照先

1

資料採取ツールの実行

7.4.3

2

プロセスの状態の確認

7.4.8

3

スレッドダンプの採取

7.4.9

4

Webアプリケーションサーバの情報の採取

7.4.10

7.4.3　資料採取ツールの実行手順

資料採取ツールの実行手順を次に示します。

資料採取ツールを実行する。

資料採取ツールの実行例を次に示します。

c:¥>c:¥usertools¥_04.bat

実行結果が出力されます。

実行結果の出力先フォルダを次に示します。

%TEMP%¥jp1ajs2¥backlog¥JP1_DEFAULT¥JP1_DEFAULT_1st

第一報用資料が出力されます。

%TEMP%¥jp1ajs2¥backlog¥JP1_DEFAULT¥JP1_DEFAULT_2nd

第二報用資料が出力されます。

%TEMP%¥jp1ajs2¥backlog¥JP1_DEFAULT¥JP1_DEFAULT_3rd

第三報用資料が出力されます。

実行結果の出力先フォルダをバックアップする。

注意事項

採取した資料は，このツールでは圧縮しません。別途，圧縮ツールなどで圧縮してください。

バッチファイルの実行結果を出力したファイルが作成済みの場合，情報の上書きを確認するメッセージが出力されるので，上書きするときは「y」を，中止するときは「n」を入力して応答してください。

資料採取ツールの実行時に，「プロセスはファイルにアクセスできません。別のプロセスが使用中です。」のメッセージが出力された場合，しばらく待ってから再度資料採取ツールを実行してください。

Windows 8，Windows Server 2012，Windows 7，およびWindows Server 2008の場合，資料採取ツールの実行には管理者権限が必要であるため，コマンドプロンプトを管理者として起動する必要があります。コマンドプロンプトを起動する際は，Windowsの［スタート］メニューの［コマンドプロンプト］を右クリックし，ショートカットメニューから［管理者として実行］を選択してください。なお，Windows 8，Windows Server 2012，Windows 7，およびWindows Server 2008のUAC機能が無効の場合は，コマンドプロンプトを管理者として起動する必要はありません。

関連項目

7.4.4 資料採取ツールの文法

7.4.5 資料採取ツールで採取される資料

7.4.4　資料採取ツールの文法

形式

_04.bat
     [-t]
     [-u]

機能

JP1/AJS3 - SDKの各種ログ，OS情報などの保守情報を採取します。

実行権限

Administrators権限

引数

-t

hosts，servicesファイルを取得しないときに指定します。

-u

ダンプファイルを取得しないときに指定します。

Windows 8，Windows Server 2012，Windows 7，およびWindows Server 2008の場合は取得できません。

戻り値

0

正常終了。

0以外の値

異常終了。

出力先

%TEMP%¥jp1ajs2¥backlog

出力先は，資料採取ツールのセットアップで変更できます。

メッセージ

メッセージ

説明

動作

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.

オプションの指定に誤りがあります。正しいオプションを指定して再度実行してください。

処理を終了します。

関連項目

3.5.7 資料採取ツールのセットアップ手順

7.4.5　資料採取ツールで採取される資料

資料採取ツール（_04.bat）では次の資料を採取できます。

第一報用資料（%TEMP%¥jp1ajs2¥backlog¥JP1_DEFAULT¥JP1_DEFAULT_1st）

採取された資料のフォルダ名・ファイル名

内容

¥FILELIST.txt

JP1/AJS3 - SDKのインストール先フォルダ¥lib以下のファイルリスト

¥GETERROR.log

資料採取ツール（_04.bat）が出力するログ

¥HOSTS

hostsファイル

¥services

servicesファイル

¥jp1ajs3.dat

製品のレジストリー情報

¥WIN.DAT

Windowsレジストリー情報

¥OSINFO.txt

OSバージョン，Windowsの環境変数情報，IPコンフィギュレーション情報，Network構成情報，統計情報

¥PERMISSIONINFO.TXT

JP1/AJS3 - SDKのフォルダのアクセス権限情報

¥conf

環境設定ファイル格納フォルダ

¥drwtsn¥Windows2003¥drwtsn32.log（Windows Server 2003の場合）

ワトソンログ※

¥HNTRLib2¥spool

統合トレースログ

¥log

ログファイル格納フォルダ

¥PATCHLOG.txt

パッチログファイル

注※

Windows 8，Windows Server 2012，Windows 7，およびWindows Server 2008では取得できません。

第二報用資料（%TEMP%¥jp1ajs2¥backlog¥JP1_DEFAULT¥JP1_DEFAULT_2nd）

採取された資料のフォルダ名・ファイル名

内容

¥SHMDUMP¥coreinfo-ISAM.shmdump

¥SHMDUMP¥coreinfo-Scheduler.shmdump

¥SHMDUMP¥ProgMon.shmdump

¥SHMDUMP¥coreinfo-host.shmdump

¥SHMDUMP¥coreinfo-hostprof.shmdump

共有メモリー情報

¥USERDUMP¥*.dmp

¥WTSNDUMP¥*.dmp

ダンプファイル※

注※

Windows 8，Windows Server 2012，Windows 7，およびWindows Server 2008の場合，資料採取ツールでは取得できません。

第三報用資料（%TEMP%¥jp1ajs2¥backlog¥JP1_DEFAULT¥JP1_DEFAULT_3rd）

資料採取ツールの実行時にフォルダが作成されますが，格納される資料はありません。

7.4.6　ダンプファイルの採取手順（Windows 8，Windows Server 2012，Windows 7，Windows Server 2008の場合）

WindowsでSTOPエラーが発生すると，ダンプファイル（メモリーダンプおよびクラッシュダンプ）が出力されます。出力されたダンプファイルを手動で採取してください。ただし，トラブル発生時にダンプファイルが出力されるには，あらかじめ設定が必要です。

関連項目

3.5.8 メモリーダンプの出力設定手順（Windows 8，Windows Server 2012，Windows 7，Windows Server 2008の場合）

3.5.10 クラッシュダンプの出力設定手順（Windows 8，Windows Server 2012，Windows 7，Windows Server 2008の場合）

7.4.7　問題レポートの採取手順（Windows 8，Windows Server 2012，Windows 7，Windows Server 2008の場合）

問題レポートを利用すると，マシン上の問題を検出して，それぞれの問題に対する解決策を調査できます。

(1)　Windows 8，Windows Server 2012，Windows 7，およびWindows Server 2008 R2の場合

Windows 8，Windows Server 2012，Windows 7，およびWindows Server 2008 R2でJP1/AJS3 - Managerのajscdinetdプロセスがアプリケーションエラーで停止した場合，次の手順で問題レポートを採取してください。

コントロールパネルの［アクション センター］をクリックする。

［アクション センター］ダイアログボックスが表示されます。

［メンテナンス］をクリックする。

メンテナンスメニューが表示されます。

［問題レポートの解決策を確認］から，［信頼性履歴の表示］をクリックする。

［信頼性モニター］ダイアログボックスが表示されます。

［問題レポートをすべて表示］をクリックする。

［問題レポート］ダイアログボックスが表示されます。

該当する問題をダブルクリックする。

問題レポートの詳細が表示されます。

［クリップボードにコピー］を選択する。

テキストエディターなどにコピーし，保存する。

保存した問題レポートを，障害調査用の資料として利用してください。

(2)　Windows Server 2008の場合

Windows Server 2008でJP1/AJS3 - Managerのajscdinetdプロセスがアプリケーションエラーで停止した場合，次の手順で問題レポートを採取してください。

Windowsの［ファイル名を指定して実行］でテキストボックスに「wercon」を入力し，［OK］ボタンをクリックする。

［問題のレポートと解決策］ダイアログボックスが表示されます。

左側の領域で，［問題の履歴の表示］をクリックする。

問題の履歴が一覧で表示されます。

該当する問題をダブルクリックする。

問題レポートの詳細が表示されます。

［クリップボードにコピー］を選択する。

テキストエディターなどにコピーし，保存する。

保存した問題レポートを，障害調査用の資料として利用してください。

7.4.8　プロセスの状態の確認手順

接続先のJP1/AJS3 - Managerのプロセスの動作状態を確認してください。プロセスの動作状態の確認手順を次に示します。

接続先のJP1/AJS3 - ManagerホストでWindowsの［タスクマネージャ］を開く。

［プロセス］タブをクリックする。

プロセスの動作状態が表示されます。JP1/AJS3 - Managerのプロセスについては，マニュアル「JP1/Automatic Job Management System 3 トラブルシューティング」を参照してください。

7.4.9　スレッドダンプの採取手順

JP1/AJS3 - SDKの動作が止まってしまった場合は，Javaのスレッドダンプを採取してください。スレッドダンプの採取手順については，Javaのドキュメントを参照してください。

7.4.10　Webアプリケーションサーバの情報の採取手順

ユーザーアプリケーションがWebアプリケーションの場合，Webアプリケーションサーバでトラブルが発生したときにはWebアプリケーションサーバの資料を採取してください。採取する資料の詳細については，ご使用のWebアプリケーションサーバのドキュメントを参照してください。

7.5　トラブルへの対処方法

JP1/AJS3 - SDKを使用しているときに発生したトラブルへの対処方法について説明します。

7.5.1　想定されるトラブル

JP1/AJS3 - SDKを使用しているときに想定されるトラブルの例を次に示します。

表7‒9　一般的に想定されるトラブル

項番

トラブルの内容

マニュアル参照先

1

インストールできない

7.5.2

2

AjsFactoryクラスのインスタンスを取得できない

7.5.3

3

環境設定ファイルの設定内容が有効にならない

7.5.4

4

JP1/AJS3 - SDKが出力するトレースログのファイルサイズおよび面数の変更が有効にならない

7.5.5

5

JP1/AJS3 - Managerに接続できない

7.5.6

6

JP1/AJS3 - Managerの情報を取得できない

7.5.7

7

JP1/AJS3 - Managerでエラーメッセージが出力された

7.5.8

7.5.2　インストールできない場合の対処

考えられるトラブルの要因と対処を次に示します。

インストールユーザーがAdministrators権限を所有していない。

Administrators権限を持つOSユーザーでログインし直したあとでインストールしてください。

インストール対象のホストが前提条件を満たしていない。

インストール作業をする前に，前提となるOSがインストールされていることを確認してください。

関連項目

2.1.1 前提OS

7.5.3　AjsCdFactoryクラスのインスタンスを取得できない場合の対処

考えられるトラブルの要因と対処を次に示します。

Javaシステムプロパティのキー名「jp1ajscd.home」が正しく設定されていない。

Javaシステムプロパティのキー名「jp1ajscd.home」に，JP1/AJS3 - SDK運用フォルダを正しく指定してください。なお，設定値の大文字と小文字は区別されます。

JP1/AJS3 - SDKのクラスライブラリの参照先が正しく指定されていない。

JP1/AJS3 - SDKのクラスライブラリの参照先を正しく指定してください。なお，ユーザーアプリケーションをWebアプリケーションとして運用する場合，JP1/AJS3 - SDKのクラスライブラリをユーザーアプリケーションに含めないで実装するときは，クラスパスへJP1/AJS3 - SDKのクラスライブラリの格納先を追加する必要があります。

JP1/AJS3 - SDKがインストールされていない。

ユーザーアプリケーションにクラスライブラリを含めて配布している場合，JP1/AJS3 - SDKがインストールされていない環境ではJP1/AJS3 - SDKのクラスライブラリを使用できません。クラスライブラリを使用する環境にもJP1/AJS3 - SDKをインストールしてください。

関連項目

3.1.7 JP1/AJS3 - SDK運用フォルダの確認

3.5.12 クラスパスへのJP1/AJS3 - SDKのクラスライブラリの追加

3.5.14 Javaシステムプロパティの設定

4.1 ユーザーアプリケーションの配布方法の検討

7.5.4　環境設定ファイルの設定内容が有効にならない場合の対処

考えられるトラブルの要因と対処を次に示します。

環境設定ファイルの格納先が誤っている。

環境設定ファイルを所定の場所に格納してください。

環境設定ファイルのファイル名が正しく指定されていない。

環境設定ファイルのファイル名に，ユーザーアプリケーション名を正しく指定してください。

APIの引数に指定するユーザーアプリケーション名と，環境設定ファイルのファイル名に指定したユーザーアプリケーション名が異なっている。

APIの引数に指定するユーザーアプリケーション名は，環境設定ファイルのファイル名と同じユーザーアプリケーション名を指定する必要があります。APIの引数および環境設定ファイルのファイル名に，同じユーザーアプリケーション名を指定してください。

関連項目

3.5.1 環境設定ファイルの反映手順

7.5.5　JP1/AJS3 - SDKが出力するトレースログのファイルサイズおよび面数の変更が有効にならない場合の対処

考えられるトラブルの要因と対処を次に示します。

ログファイルのサイズおよび面数を変更したときの手順が正しく行われていない。

JP1/AJS3 - SDKが出力するログファイルのサイズおよび面数の変更を有効にするためには，所定のファイルを削除する必要があります。変更手順に従って，トレースログのファイルサイズおよび面数を変更してください。

関連項目

3.5.15 トレースログのファイルサイズおよび面数の変更手順

7.5.6　JP1/AJS3 - Managerに接続できない場合の対処

考えられるトラブルの要因と対処を次に示します。

接続先のJP1/AJS3 - Managerホスト名の指定が誤っている。

接続先のJP1/AJS3 - ManagerへログインするAPI（loginメソッド）の引数に，接続先のJP1/AJS3 - Managerホスト名を正しく指定してください。

また，正しい値が指定されている場合は，接続先のJP1/AJS3 - Managerホスト名がユーザーアプリケーションの動作するホストで名前解決できるように設定してください。

JP1/AJS3 - ManagerホストでJP1/AJS3 - SDKからの通信用プロセスが起動していない。

JP1/AJS3 - SDKからの通信時に，接続先のJP1/AJS3 - Managerホストでajscdinetdプロセスが起動するように設定してください。なお，JP1/AJS3 - Managerをインストールした状態では，ajscdinetdプロセスは起動しません。接続先のJP1/AJS3 - Managerでajscdinetdプロセスを起動させるためには，あらかじめ設定が必要です。

JP1/AJS3 - SDKが使用するポート番号と，JP1/AJS3 - Managerの通信用プロセスのポート番号が異なっている。

接続先のJP1/AJS3 - Managerホストでajscdinetdプロセスのポート番号をデフォルト（22250番）から変更していないか確認してください。変更している場合は，環境設定ファイルの接続ポート番号をJP1/AJS3 - Managerで設定したポート番号に変更してください。

接続先JP1/AJS3 - Managerの接続許可設定ファイルに接続元JP1/AJS3 - SDKのホストが登録されていない。

接続先JP1/AJS3 - Managerの接続許可設定ファイルに接続元JP1/AJS3 - SDKのホストが登録されていない場合は，接続先JP1/AJS3 - Managerの統合トレースログに出力されているKAVS8040-Eメッセージの対処方法に従ってください。

関連項目

3.4.1 JP1/AJS3 - Managerのプロセスの起動の設定

7.5.7　JP1/AJS3 - Managerの情報を取得できない場合の対処

考えられるトラブルの要因と対処を次に示します。

接続先のJP1/AJS3 - Managerのデータベース構成が互換用ISAM構成である。

接続先のJP1/AJS3 - Managerのデータベース構成が互換用ISAM構成の場合など，データベース構成によっては対応していないAPIの機能があります。APIの機能が接続先のJP1/AJS3 - Managerのデータベース構成に対応しているかどうかを確認してください。接続先のJP1/AJS3 - Managerの違いによる機能差異については，マニュアル「JP1/Automatic Job Management System 3 - Software Development Kit APIリファレンス」を参照してください。

7.5.8　JP1/AJS3 - Managerでエラーメッセージが出力された場合の対処

考えられるトラブルの要因と対処を次に示します。

接続先のJP1/AJS3 - Manager でエラーメッセージが出力されたが要因がわからない。

接続先のJP1/AJS3 - Managerで出力されたエラーメッセージの説明にJP1/AJS3 - Viewの記載がある場合は，JP1/AJS3 - SDKからの操作が該当する可能性があります。JP1/AJS3 - SDKから接続して操作している場合は，JP1/AJS3 - Viewと同様の対応が必要ないか確認してください。

付録

付録A　ファイルおよびフォルダ一覧

JP1/AJS3 - SDKで使用するファイルおよびフォルダの一覧を次の表に示します。

表A‒1　ファイルおよびフォルダ一覧

内容

ファイル名・フォルダ名

readmeファイル

SDK_Path¥Readme.txt

新修正パッチログファイル※

SDK_Path¥PatchLog.txt

環境設定ファイルのモデルファイル

JP1/AJS3 - SDK運用フォルダ¥conf¥ajscd_APP.properties.model

Javaクラスライブラリのファイル

SDK_Path¥lib¥ajscd.jar

ログファイル格納フォルダ

JP1/AJS3 - SDK運用フォルダ¥log

システムファイル格納フォルダ

JP1/AJS3 - SDK運用フォルダ¥log¥sys

資料採取ツール

SDK_Path¥tools¥_04.bat

（凡例）

SDK_Path：JP1/AJS3 - SDKのインストール先フォルダ

注※

修正パッチをインストールしたときに作成されます。

関連項目

3.1.7 JP1/AJS3 - SDK運用フォルダの確認

付録B　ポート番号一覧

JP1/AJS3 - SDKで使用するポート番号の一覧を次の表に示します。使用するプロトコルは，TCP/IPです。

表B‒1　ポート番号一覧

ポート番号

サービス名

説明

22250/tcp

jp1ajs3cdinetd

JP1/AJS3 - Managerとの通信用ポート

関連項目

3.4.6 JP1/AJS3 - Managerのファイアウォールの通過の設定

付録C　制限値一覧

JP1/AJS3 - SDKに関する制限値を次の表に示します。

表C‒1　JP1/AJS3 - SDKの制限値

内容

制限値

1台のJP1/AJS3 - Managerホストに対するJP1/AJS3 - SDKからの接続数

100

1つのスケジューラーサービスに対する1セッション当たりのAPIの多重実行数

1

付録D　トレースログの出力形式

JP1/AJS3 - SDKのトレースログの出力形式について説明します。

トレースログの出力例を次の図に示します。

図D‒1　トレースログの出力例

トレースログファイルのヘッダー情報および出力項目を次の表に示します。

表D‒1　トレースログファイルのヘッダー情報

項番

項目

説明

出力例

1

OS情報

トレース機能が起動しているOSの情報

Microsoft WindowsNT6.1(Build:7601) Service Pack 1

2

ホスト名

トレース機能が起動しているホスト名の情報

host1

3

タイムゾーン

OSのタイムゾーン

TZ=(local)-9:00

4

トレースログ機能起動日時

トレース機能を起動した日時

2012/11/18 08:39:02.500

表D‒2　トレースログファイルの出力項目

項番

項目

説明

出力例

1

番号（4桁）

トレースレコードの通し番号（番号はログを出力したメソッドごとに付けられる）

0001

2

日付（10バイト）

トレースの取得日付：yyyy/mm/dd（年/月/日）

2012/11/22

3

時刻（12バイト）

トレースの取得時刻（ローカル時刻）：hh:mm:ss.sss（時:分:秒.ミリ秒）

11:40:41.763

4

製品名

製品名

JP1/AJS3-SDK

5

pid

プロセスのID（16進数）

00001AFC

6

tid

スレッドを識別するためのID（16進数）

0000144C

7

メッセージID

出力メッセージのメッセージID

KNAK0001-I

8

メッセージテキスト

出力メッセージの本文※

メソッドの処理を開始します メソッド:login(String, String, String) アプリケーション名:sample 識別子:15F85F17A36AEBF2B9F41A67FC096301

注※

次の内容が出力されます。

メソッドトレースの場合，APIのメソッド名，入力引数，戻り値の情報が出力されます。

エラー，警告情報，またはインフォメーションのメッセージが発生した場合，そのメッセージが出力されます。

そのほかの場合，動作中の環境設定の情報がインフォメーションとして出力されます。

付録E　（3021-3-118-10）での変更内容

（3021-3-118-10）の変更内容を次の表に示します。

表E‒1　（3021-3-118-10）の変更内容

項番

変更個所

追加・変更内容

1

1.2，4.4.3(4)，4.4.3(5)，4.5.4，4.5.5

ユーザーアプリケーションでできる操作に次の操作を追加した。

ユニット定義情報，最新状態情報，および最新結果情報の取得

ユニット定義情報の取得

ユニット状態情報の取得

関連線情報の取得

予実績情報の取得

予実績情報の取得の中止

カレンダー情報の取得

サマリー情報の取得

リリース情報の取得

2

1.3，5.2

ユーザーアプリケーションで作成できる画面例の説明を追加した。

3

2.1.1，3.1.3，3.1.5，3.1.6，3.1.7，3.2.5，表3-7，3.5.7，3.5.8，3.5.10，3.5.13，7.3.1，7.3.3，7.4.1，7.4.3，7.4.4，7.4.5，7.4.6，7.4.7

次のOSをサポート対象とした。

Windows 8

Windows Server 2012

4

2.1.2

開発環境の前提プログラムにJava Platform, Standard Edition Development Kit 7を，実行環境の前提プログラムにJava Platform, SE Runtime Environment Version 7を追加した。

5

7.5.1，7.5.8

JP1/AJS3 - Managerで出力されたエラーメッセージの要因がわからない場合の対処方法を追加した。

6

7.5.6

JP1/AJS3 - Managerに接続できない場合の要因と対処を追加した。

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

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

付録F.1　関連マニュアル

関連マニュアルを次に示します。必要に応じてお読みください。

JP1/AJS3関連

JP1 Version 10 JP1/Automatic Job Management System 3 入門（3021-3-101）

JP1 Version 10 JP1/Automatic Job Management System 3 導入ガイド（3021-3-102）

JP1 Version 10 JP1/Automatic Job Management System 3 設計ガイド（システム構築編）（3021-3-103）

JP1 Version 10 JP1/Automatic Job Management System 3 設計ガイド（業務設計編）（3021-3-104）

JP1 Version 10 JP1/Automatic Job Management System 3 構築ガイド1（3021-3-105）

JP1 Version 10 JP1/Automatic Job Management System 3 構築ガイド2（3021-3-106）

JP1 Version 10 JP1/Automatic Job Management System 3 運用ガイド（3021-3-107）

JP1 Version 10 JP1/Automatic Job Management System 3 トラブルシューティング（3021-3-108）

JP1 Version 10 JP1/Automatic Job Management System 3 操作ガイド（3021-3-109）

JP1 Version 10 JP1/Automatic Job Management System 3 コマンドリファレンス1（3021-3-110）

JP1 Version 10 JP1/Automatic Job Management System 3 コマンドリファレンス2（3021-3-111）

JP1 Version 10 JP1/Automatic Job Management System 3 連携ガイド（3021-3-112）

JP1 Version 10 JP1/Automatic Job Management System 3 メッセージ1（3021-3-113）

JP1 Version 10 JP1/Automatic Job Management System 3 メッセージ2（3021-3-114）

JP1 Version 10 JP1/Automatic Job Management System 3 - Software Development Kit APIリファレンス（3020-3-119）

JP1関連

JP1 Version 10 JP1/Base　運用ガイド（3021-3-001）

JP1 Version 9 JP1/NETM/DM　運用ガイド1(Windows(R)用)（3020-3-S81）

JP1 Version 9 JP1/NETM/DM　運用ガイド2(Windows(R)用)（3020-3-S82）

付録F.2　このマニュアルでの表記

このマニュアルでは，日立製品およびその他の製品の名称を省略して表記しています。製品の正式名称とこのマニュアルでの表記を次の表に示します。

このマニュアルでの表記

正式名称

JP1/AJS3

JP1/AJS3 - Manager

JP1/Automatic Job Management System 3 - Manager

JP1/AJS3 - Agent

JP1/Automatic Job Management System 3 - Agent

JP1/AJS3 - View

JP1/Automatic Job Management System 3 - View

付録F.3　このマニュアルで使用する英略語

このマニュアルで使用する英略語を次の表に示します。

英略語

正式名称

API

Application Programming Interface

DB

Database

DNS

Domain Name System

GUI

Graphical User Interface

NAPT

Network Address Port Translation

NAT

Network Address Translation

OS

Operating System

TCP/IP

Transmission Control Protocol/Internet Protocol

UAC

User Account Control

付録F.4　このマニュアルで使用する記号

このマニュアルで使用する記号を次の表に示します。

記号

意味

［ ］

（角括弧）

メニュー項目，ダイアログボックス，ボタンなどを示します。

（例）

［ファイル］−［新規作成］を選択する。

上記の例では，メニューバーの［ファイル］を選んで，ドロップダウンリストの［新規作成］を選択することを示します。

|

（ストローク）

複数の項目に対して項目間の区切りを示し，「または」の意味を示します。

（例）

「A|B|C」は，「A，B，またはC」を示します。

{ }

（波括弧）

この記号で囲まれている複数の項目の中から，1つの項目を必ず選択します。項目と項目の区切りは「|」で示します。

（例）

「{A|B|C}」は，「A，B，またはCのどれかを必ず指定する」ことを示します。

付録F.5　数式で使用する記号

このマニュアルの数式中で使用する記号を次の表に示します。

記号

意味

／

除算記号を示します。

付録F.6　図中で使用する記号

このマニュアルの図中で使用する記号を次の図に示します。

付録F.7　デフォルトのインストール先フォルダ

JP1/AJS3 - SDKのデフォルトのインストール先フォルダは次のとおりです。

デフォルトのインストール先フォルダ

システムドライブ¥Program Files※¥Hitachi¥JP1AJS3SDK

注※

64ビット版のWindows 8，Windows Server 2012，Windows 7，およびWindows Server 2008，ならびにWindows Server 2003（x64）およびWindows Server 2003 R2（x64）の場合は，「Program Files」を「Program Files (x86)」と読み替えてください。

付録F.8　このマニュアルで使用する「Administrators権限」について

このマニュアルで表記している「Administrators権限」とは，ローカルPCに対してAdministrators権限を持つユーザーを指します。ローカルPCに対してAdministrators権限を持つユーザーであれば，ローカルユーザー，ドメインユーザー，およびActive Directory環境で動作に違いはありません。

付録F.9　KB（キロバイト）などの単位表記について

1KB（キロバイト），1MB（メガバイト），1GB（ギガバイト），1TB（テラバイト）はそれぞれ1,024バイト，1,024²バイト，1,024³バイト，1,024⁴バイトです。

付録G　用語解説

（英字）

C/Sアプリケーション

クライアントとサーバの2階層で構成されたアプリケーションのことです。アプリケーションソフトやデータベースなどのリソースをサーバで集中管理し，クライアントはネットワークを利用してそのリソースを利用します。

Java

C++をより移植性と信頼性が高くなるように改良した言語です。Webの普及によってブラウザーに応用されています。

JP1/AJS3

JP1/Automatic Job Management System 3の略称です。

JP1/AJS3は，業務を自動的に運用するためのプログラムです。処理を順序付けて定期的に実行したり，特定の事象が発生したときに処理を開始したりできます。

JP1/AJS3 - Managerホスト

JP1/AJS3 - Managerホストは，ジョブネットの定義情報やスケジュール情報をデータベースで管理し，ジョブの実行をエージェントホストに依頼して実行させます。

JP1/AJS3 - SDK

JP1/AJS3 - Managerを操作するユーザーアプリケーションを独自に作成するためのプログラムです。JP1/AJS3 - SDKは，JP1/AJS3 - Managerでできる操作の一部をJavaクラスライブラリのAPIとして提供しています。

JP1/AJS3 - SDK運用フォルダ

JP1/AJS3 - SDKの環境設定ファイルとログファイルが格納されるフォルダのことです。

JP1/Base

イベントサービス機能を提供するプログラムです。サービスの起動順序を制御したり，JP1イベントを送受信したりできます。また，JP1/Baseは，JP1/AJS3などの前提プログラムです。JP1/AJS3を使ったシステムを導入する場合，JP1ユーザーの操作を制限する機能を提供します。

JP1/NETM/DM

ソフトウェアの配布およびクライアントの管理を，ネットワークを利用し一括して行うシステムの総称です。

JP1イベント

システム内で何らかの事象が発生した際に，その事象の発生を通知する情報です。JP1イベントは，JP1/Baseを経由して，ほかのシステムなどに通知されます。

JP1権限レベル

JP1/AJS3で定義した業務やイベントなどの管理対象（資源）に対して，JP1ユーザーがどのような操作をできるかを表した名称です。JP1/Baseで定義します。

JP1ユーザー

JP1/AJS3を使用するときのユーザー名です。JP1ユーザーとして認証サーバに登録すると，管理対象（資源）へのアクセスが制御されます。

Webアプリケーション

Webブラウザーを備えたクライアントを対象に作成されたアプリケーションです。具体的には，サーブレットプログラム，JSPファイル，およびHTML/XMLドキュメントなどの集合体です。

（カ行）

確定実行登録

スケジュール定義に基づいてあらかじめ実行日時を算出しておき，その日時に従ってジョブネットを起動し，処理を開始する場合の実行登録方法です。

環境設定ファイル

JP1/AJS3 - SDKの動作環境を設定するファイルのことです。1つのユーザーアプリケーションにつき1つの環境設定ファイルを配置できます。

クラスタシステム

クラスタシステムとは，複数のサーバシステムを連携して1つのシステムとして運用するシステムで，障害が発生しても業務を継続できるようにすることを目的としています。業務を実行中のサーバ（実行系）で障害が発生すると，待機していた別のサーバ（待機系）が業務の処理を引き継ぎます。実行「系」から待機「系」へ業務を切り替えるので，「系切り替えシステム」とも呼びます。

計画実行登録

スケジュール定義に基づいてジョブネットを起動し，処理を開始する場合の実行登録方法です。

互換用ISAM構成

JP1/AJS3の情報管理にISAMデータベースだけを使用する構成のことです。Version 8以前のJP1/AJS2からの移行用の構成であり，ディスクやメモリーのなどのリソースを旧バージョンと同程度に抑えることができます。ただし，APIの機能については，一部の機能しか使用できません。

（サ行）

実行ID

最上位ジョブネットの実行予定の1つに対して1つ割り振られる番号のことです。

ジョブ

コマンド，シェルスクリプト，Windows実行ファイルなどの集まりです。

ジョブグループ

複数の業務を分類して管理するためのフォルダです。

ジョブネット

実行順序を関連づけたジョブの集まりです。ジョブネットを実行すると，ジョブネット中のジョブが実行順序に従って自動的に実行されます。

スケジューラーサービス

ジョブネットを実行するスケジュールを管理し，スケジュールに従って，処理を実行します。スケジューラーサービスは，スケジューラーサービス名と同じ名称のルートジョブグループ配下のユニットを管理します。

即時実行登録

実行登録と同時にジョブネットを起動し，処理を開始する場合の実行登録方法です。

（ナ行）

ネストジョブネット

ジョブネット中に定義したジョブネットです。

（ハ行）

標準構成

JP1/AJS3 - ManagerホストでJP1/AJS3の情報管理に組み込みDBを使用する構成のことです。特に断りがないかぎり，マニュアルではこの構成で構築されているものとして説明しています。

プランニンググループ

複数のルートジョブネットを計画的に切り替えて実行するためのユニットです。プランニンググループの直下に異なる定義内容のルートジョブネットを複数作成し，それぞれに異なったスケジュールを定義することで，指定したスケジュールに従って自動的にジョブネットを切り替えて実行できます。

（ヤ行）

ユニット

JP1/AJS3で自動化する業務を構成する一つ一つの要素（ジョブグループ，ジョブネット，ジョブなど）です。

ユニットID

一つのユニットに対して一つ割り振られる番号です。

索引

A

ajscdinetdプロセス[1]

API

JP1ユーザーの権限[1]

機能差異[1]

実行ID[1]

情報取得のAPI[1]

注意事項[1]

引数に使用できる文字[1]

引数のバイト数[1]

ユニット一覧情報の取得[1]

利用の流れ[1]

ログアウト処理[1]

APIの実装方法[1]

C

C/Sアプリケーション〔用語解説〕[1]

J

Javaシステムプロパティの設定[1]

Java〔用語解説〕[1]

JP1/AJS3〔用語解説〕[1]

JP1/AJS3 - Managerとの接続打ち切り時間[1]

JP1/AJS3 - Managerの環境設定[1]

JP1/AJS3 - Managerの環境設定項目一覧[1]

JP1/AJS3 - Managerの環境設定の検討[1]

JP1/AJS3 - Managerの設定[1]

JP1/AJS3 - Managerホストへの負荷[1]

APIの発行間隔[1]

多数のユーザーによるAPIの多重実行[1]

ユニットの総数および世代数[1]

JP1/AJS3 - Managerホスト〔用語解説〕[1]

JP1/AJS3 - SDK

JP1/AJS3 - SDKとは[1]

システム概要[1]

できること[1]

デフォルトのインストール先フォルダ[1]

JP1/AJS3 - SDK運用フォルダ[1]

JP1/AJS3 - SDK運用フォルダ〔用語解説〕[1]

JP1/AJS3 - SDKの概要[1]

JP1/AJS3 - SDKの環境設定の検討[1]

JP1/AJS3 - SDKの特長[1]

JP1/AJS3 - SDKを使用したJP1/AJS3 - Managerの操作の仕組み[1]

JP1/AJS3 - SDK〔用語解説〕[1]

JP1/Base〔用語解説〕[1]

JP1/NETM/DM〔用語解説〕[1]

JP1イベントの発行[1]

JP1イベント〔用語解説〕[1]

JP1権限レベル〔用語解説〕[1]

JP1ユーザー〔用語解説〕[1]

N

NAT[1]

W

Webアプリケーション〔用語解説〕[1]

あ

アンインストール

Windows 8，Windows Server 2012，Windows 7，Windows Server 2008の場合[1]

Windows Server 2003の場合[1]

い

インストール[1]

OSのサービスの設定[1]

OSユーザーの権限[1]

インストール先フォルダ[1]

インストール前の確認項目[1]

上書き[1]

新規[1]

バージョンアップ[1]

リモート[1]

インストール先フォルダ[1]

インストールとセットアップ[1]

インストール前の作業[1]

う

運用フォルダ[1]

運用までの流れ[1]

か

開始および終了メッセージの出力[1]

開発環境のシステム構成（基本構成）[1]

開発環境のシステム構成（最小構成）[1]

確定実行登録〔用語解説〕[1]

画面作成例[1]

画面作成時の注意事項[1]

サマリー画面[1]

実行予実績一覧画面[1]

ジョブフロー画面[1]

ユニット一覧画面[1]

環境設定パラメーター[1]

環境設定ファイル

形式[1]

設定項目の詳細[1]

設定する項目[1]

設定例[1]

注意事項[1]

反映手順[1]

環境設定ファイル〔用語解説〕[1]

関連マニュアル[1]

き

共通トレースログ[1]

く

クラスタシステムでの運用[1]

クラスタシステム〔用語解説〕[1]

クラスと生成単位[1]

クラスライブラリの参照方法[1]

クラスライブラリの追加[1]

け

計画実行登録〔用語解説〕[1]

こ

構成変更

対処[1]

注意事項[1]

コーディング例

AjsCdApiインスタンスを生成する[1]

AjsCdApiインスタンスを破棄する[1]

AjsCdインスタンスを生成する[1]

AjsCdインスタンスを破棄する[1]

JP1/AJS3 - Managerからログアウトする[1]

JP1/AJS3 - Managerへログインする[1]

状態を取得する[1]

即時実行登録する[1]

ユニット一覧情報を取得する[1]

互換用ISAM構成〔用語解説〕[1]

コマンド

JP1/AJS3 - Managerで操作できるコマンド[1]

さ

最大同時セッション数[1]

し

システム概要

C/Sアプリケーション[1]

Webアプリケーション[1]

システム環境の検討[1]

システム構成

開発環境の基本構成[1]

開発環境の最小構成[1]

実行環境の基本構成[1]

社外からのアクセスがある場合[1]

システム構成の検討[1]

システム設計[1]

システム設計時の検討項目一覧[1]

システムの前提条件[1]

実行ID[1]

実行ID〔用語解説〕[1]

実行環境のシステム構成（基本構成）[1]

実行環境のシステム構成（社外アクセスを考慮した構成）[1]

ジョブ[1]

ジョブグループ[1]

ジョブネット[1]

資料採取ツール

クラッシュダンプの出力設定手順（Windows 8，Windows Server 2012，Windows 7，Windows Server 2008の場合）[1]

クラッシュダンプの出力設定手順（Windows Server 2003の場合）[1]

実行手順[1]

セットアップ項目一覧[1]

セットアップ手順[1]

文法[1]

メモリーダンプの出力設定手順（Windows 8，Windows Server 2012，Windows 7，Windows Server 2008の場合[1]

メモリーダンプの出力設定手順（Windows Server 2003の場合）[1]

す

スケジューラーサービス〔用語解説〕[1]

スケジューラーログの出力[1]

せ

制限値一覧[1]

世代情報の範囲[1]

セットアップ[1]

前提OS[1]

前提OSの確認[1]

前提プログラム[1]

前提プログラムの確認[1]

そ

即時実行登録〔用語解説〕[1]

た

タイムアウト時間[1]

タイムゾーンの検討[1]

て

デスクトップヒープの不足[1]

と

トラブルシューティング

資料の採取の手順[1]

想定されるトラブル[1]

対処の流れ[1]

トラブル発生時に採取が必要な資料[1]

Windows 8，Windows Server 2012，Windows 7，Windows Server 2008の場合[1]

Windows Server 2003の場合[1]

トレースログ[1]

ファイルサイズおよび面数の変更手順[1]

トレースログの出力形式[1]

な

内部ログのサイズ[1]

に

認証エラー[1]

ね

ネストジョブネット[1]

ネットワーク構成の検討[1]

ひ

日立ネットワークオブジェクトプラザトレース共通ライブラリの追加[1]

標準構成〔用語解説〕[1]

ふ

ファイアウォール[1]

ファイルおよびフォルダ一覧[1]

プランニンググループ[1]

プロセスの起動の設定[1]

プロセスの再起動の設定[1]

ほ

ポート番号一覧[1]

も

文字コード[1]

ゆ

ユーザーアプリケーション

開発時に検討が必要な項目[1]

処理の流れ[1]

タイムアウト時間[1]

できる操作[1]

認証エラー[1]

配布方法[1]

ユーザーアプリケーションで作成できる画面例[1]

ユーザーアプリケーションの開発[1]

ユニット[1]

ユニットID[1]

る

ルートジョブネットのスケジュールの有効範囲[1]

ろ

ログ[1]

共通トレースログ[1]

トレースログ[1]

トレースログの出力形式[1]

ログファイル一覧[1]

ログオン情報の再利用[1]