Windows NT

Groupmax Agent Version 5 システム管理者ガイド

解説・操作書

3020-3-A76-40

目　　次

前書き

変更内容

はじめに

1.　Groupmax Agentの概要

1.1　Groupmax Agentの機能

1.1.1　エージェントとは

1.1.2　Groupmax Agentでは何ができるか

1.2　Groupmax Agentのプログラム構成

1.2.1　サーバプログラム

1.2.2　クライアントプログラム

1.2.3　プログラミングツール

1.3　Groupmax Agentを使用する環境

1.3.1　登録するエージェント，ユーザ，接続サーバ

1.3.2　必要空きメモリ・ディスク容量

2.　Groupmax Agentの運用例

2.1　Groupmax Agentの運用に必要な製品

2.1.1　Groupmax製品

2.1.2　Groupmax以外の製品

2.2　Workflow Agentを利用する場合の運用例

2.3　Mail Agentを利用する場合の運用例

2.4　Document Manager Agentを利用する場合の運用例

2.5　独自に開発したエージェントを利用する場合の運用例

2.6　リモートアクセスサービス（RAS）を利用する場合の運用例

2.6.1　RASを利用した場合の運用例

2.6.2　クライアントでIPアドレスを取得する場合の注意事項

2.6.3　サーバ間の接続に関する注意事項

3.　運用を開始するまでに必要な操作

3.1　バージョンの移行・混在に関する注意

3.1.1　Agent Serverのバージョン移行

3.1.2　Workflow Agentのバージョン移行

3.1.3　ユーザプログラムのリコンパイル

3.1.4　バージョンの混在

3.2　Agent Serverのインストールと環境設定

3.2.1　Agent Serverのインストール

3.2.2　Agent Serverの環境設定

3.3　Workflow Agentのインストールと環境設定

3.3.1　Workflow Agentのインストール

3.3.2　Workflow Agentの環境設定

3.4　Mail Agentのインストールと環境設定

3.4.1　Mail Agentのインストール

3.4.2　Mail Agentの環境設定

3.5　Document Manager Agentのインストールと環境設定

3.5.1　Document Manager Agentのインストール

3.5.2　Document Manager Agentの環境設定

4.　全体の運用

4.1　各サーバの起動と終了の関係

4.2　サーバ間の情報の一致

4.3　バックアップ・リストア

4.4　IPアドレス及びホスト名の変更

4.4.1　Agent ServerのIPアドレスを変更する場合

4.4.2　Workflow Agent本体のIPアドレスを変更する場合

4.4.3　Mail Agent本体のIPアドレスを変更する場合

4.4.4　Document Manager Agent本体のIPアドレスを変更する場合

4.5　運用上の制限事項

4.5.1　IPアドレスの扱いについて

4.5.2　ホスト名の扱いについて

4.5.3　クラスタシステムを使用する場合の注意事項

5.　Agent Serverの運用

5.1　Agent Serverの起動と終了

5.1.1　Agent Serverの起動

5.1.2　Agent Serverの終了

5.2　Agent Serverの運用コマンド

5.2.1　運用コマンドの概要

5.2.2　Agent Server管理ツールの起動（agmgr）

5.2.3　PPサーバ情報の一覧表示・PPサーバとの整合性の確保（agmatch）

5.2.4　Agent Serverのエージェントのログの参照（aglog）

5.2.5　Agent Serverのトレースの参照（agtrace）

5.2.6　 Agent Serverのトレースの拡張（agtrcex）

5.2.7　Agent Serverのバージョンの移行（agconv）

5.2.8　Agent Serverのバージョンの表示（agver）

5.2.9　Agent Serverのシステムファイルの回復（agrecvry）

5.2.10　サーバのトレースの参照（agpptrc）

5.3　Agent Server管理ツールに関する基礎知識

5.3.1　管理ツールで操作する情報

5.3.2　管理ツールの操作

5.4　エージェント情報の参照

5.4.1　特定のユーザが登録したエージェント情報を表示する

5.4.2　登録ユーザに関する情報を表示する

5.4.3　登録されている全エージェントを一覧表示する

5.4.4　エージェントの名称や状態を表示する

5.4.5　特定のエージェントに関する情報を表示する

5.5　エージェントの活動に関する操作

5.5.1　特定のエージェントを活動させる

5.5.2　特定のエージェントを停止させる

5.5.3　特定のエージェントを削除する

5.5.4　特定ユーザの登録したエージェントの活動ログを一覧表示する

5.5.5　全エージェントの活動ログを一覧表示する

5.5.6　特定のエージェントの活動ログを一覧表示する

5.6　システム情報の参照・更新・初期化

5.6.1　スケジューラに関する情報を参照・更新する

5.6.2　定義情報の上限値を参照・更新する

5.6.3　フォルダ（ディレクトリ）情報を参照・更新する

5.6.4　メールに関する情報を参照・更新する

5.6.5　システム情報を初期化する

5.7　ダンプファイルの出力

5.8　バックアップとリストア

5.8.1　バックアップ

5.8.2　リストア

5.9　操作結果の出力先の指定

5.9.1　操作結果の出力先を指定する

5.9.2　操作結果をエディタ出力する

5.10　エージェントおよびユーザ情報参照

5.11　ユーザ単位のエージェント削除

6.　Workflow Agentの運用

6.1　Workflow Agentの起動と終了

6.1.1　Workflow Agentの起動

6.1.2　Workflow Agentの終了

6.2　Workflow Agentの運用コマンド

6.2.1　運用コマンドの概要

6.2.2　ユーザID一覧ファイルの作成と参照（waulist）

6.2.3　ユーザID・E-mailアドレス対応ファイルの作成と参照（waemtbl）

6.2.4　Workflow Agent管理ツールの起動（wamgr）

6.2.5　Agent Serverのホスト名一覧表示・Agent Serverとの整合性の確保(wamatch)

6.2.6　Workflow Agentのトレースの参照（watrc）

6.2.7　Workflow Agentのバージョンの移行（waconv）

6.2.8　Workflow Agentのファイルの回復(warecvry)

6.3　Workflow Agent管理ツールに関する基礎知識

6.3.1　管理ツールで操作する情報

6.3.2　管理ツールの操作

6.4　システム情報の参照・更新・初期化

6.4.1　システム情報を参照・更新する

6.4.2　システム情報を初期化する

6.5　タイマ情報の参照・更新

6.6　監視エージェント情報の参照・更新

6.6.1　監視エージェント情報を表示する

6.6.2　監視エージェント情報を登録する

6.6.3　監視エージェント情報を削除する

6.7　ダンプファイルの出力

6.8　操作結果のエディタ出力

6.9　バックアップとリストア

6.9.1　バックアップ

6.9.2　リストア

6.10　ユーザトレー内案件の一括新着監視エージェントによるメール宛先BCC化

7.　Mail Agentの運用

7.1　Mail Agentの起動と終了

7.1.1　Mail Agentの起動

7.1.2　Mail Agentの終了

7.2　Mail Agentの運用コマンド

7.2.1　運用コマンドの概要

7.2.2　Mail Agent本体管理ツールの起動（mamgr）

7.2.3　Mail Agent実行エンジン管理ツールの起動（mafmgr）

7.2.4　Agent Serverのホスト名一覧表示・Agent Serverとの整合性の確保(mamatch)

7.2.5　Mail Agent本体のトレースの参照（matrc）

7.2.6　Mail Agent実行エンジンのトレースの参照（maftrc）

7.2.7　メールリカバリ送信機能

7.2.8　リトライ状態解除機能

7.3　Mail Agent管理ツールに関する基礎知識

7.3.1　管理ツールで操作する情報

7.3.2　管理ツールの操作

7.4　システム情報の参照・更新・初期化

7.4.1　システム情報を参照・更新する

7.4.2　システム情報を初期化する

7.5　ダンプファイルの出力

7.6　バックアップとリストア

7.6.1　バックアップ

7.6.2　リストア

7.7　Mail Agentのアクション抑止機能

7.8　自動転送エージェントにおけるASCIIオプション

7.9　自動転送時の返信先変更機能

8.　Document Manager Agentの運用

8.1　Document Manager Agentの起動と終了

8.1.1　Document Manager Agentの起動

8.1.2　Document Manager Agentの終了

8.2　Document Manager Agentの運用コマンド

8.2.1　運用コマンドの概要

8.2.2　Document Manager Agent管理ツールの起動（damgr）

8.2.3　Agent Serverのホスト名一覧表示・Agent Serverとの整合性の確保(damatch)

8.2.4　Document Manager Agentのトレースの参照（datrc）

8.2.5　フォーム文書データベース検索オプション

8.3　Document Manager Agent管理ツールに関する基礎知識

8.3.1　管理ツールで操作する情報

8.3.2　管理ツールの操作

8.4　システム情報の参照・更新・初期化

8.4.1　システム情報を参照・更新する

8.4.2　システム情報を初期化する

8.5　ダンプファイルの出力

8.6　バックアップとリストア

8.6.1　バックアップ

8.6.2　リストア

9.　障害対策

9.1　障害回復の流れ

9.1.1　エージェントの動作に異常がある場合

9.1.2　サーバが異常終了した場合

9.2　サーバ環境で確認する項目

9.2.1　Agent Serverで確認する項目

9.2.2　Workflow Agentで確認する項目

9.2.3　Mail Agentで確認する項目

9.2.4　Document Manager Agentで確認する項目

9.3　情報の回復

9.3.1　システムファイルの回復

9.3.2　サーバ間の情報の一致

9.4　保守情報の採取

9.4.1　Agent Serverで障害が発生した場合

9.4.2　Agent Server Mail Optionで障害が発生した場合

9.4.3　Workflow Agentで障害が発生した場合

9.4.4　Mail Agentで障害が発生した場合

9.4.5　Document Manager Agentで障害が発生した場合

付録

付録A　用語解説

付録B　プログラムを削除する方法

付録B.1　Agent Serverを削除する

付録B.2　Workflow Agentを削除する

付録B.3　Mail Agentを削除する

付録B.4　Document Manager Agentを削除する

付録C　管理ツールのメニューコマンド一覧

付録D　活動ログ及びイベントログのエラーコード

付録E　イベントログメッセージの一覧

付録E.1　Agent Serverのイベントログメッセージ

付録E.2　Workflow Agentのイベントログメッセージ

付録E.3　Mail Agentのイベントログメッセージ

付録E.4　Document Manager Agentのイベントログメッセージ

付録F　フォルダ（ディレクトリ）構成

付録F.1　Agent Server

付録F.2　Workflow Agent

付録F.3　Mail Agent

付録F.4　Document Manager Agent

付録G　Windows Server 2008使用時の注意事項

付録G.1　ファイアウォール

付録G.2　ユーザアカウント制御

付録G.3　非サポート製品

付録H　Windows Server 2012使用時の注意事項

付録H.1　ファイアウォール

付録H.2　ユーザアカウント制御

付録H.3　非サポート製品

索引

[他社商品名称に関する表示]

All Rights Reserved. Copyright (C) 1999, 2015, Hitachi, Ltd.

前書き

■ 対象製品

P-2446-5154　 Groupmax Agent Server Version 5，Groupmax Agent Server Mail Option Version 5　 05-82（適用OS：Windows Server 2003，Windows Server 2008，Windows Server 2012）
P-2446-5254　 Groupmax Agent Server Version 5　 05-82（適用OS：Windows Server 2003，Windows Server 2008，Windows Server 2012）
P-2446-7S34　 Groupmax Agent - Development Kit Version 5　 05-00（適用OS：Windows 2003）
P-2446-7T44　 Groupmax Agent - Document Manager Function Version 5　 05-80（適用OS：Windows Server 2003，Windows Server 2008）
P-2446-7T44　 Groupmax Agent - Document Manager Server Version 5　 05-11（適用OS：Windows Server 2003）
P-2446-7T44　 Groupmax Agent - Workflow Function Version 5　 05-82（適用OS：Windows Server 2003，Windows Server 2008，Windows Server 2012）
P-2446-7T44　 Groupmax Agent - Workflow Server Version 5　 05-82（適用OS：Windows Server 2003，Windows Server 2008，Windows Server 2012）
P-2446-7T44　 Groupmax Agent - Mail Function Version 6　 06-82（適用OS：Windows Server 2003，Windows Server 2008，Windows Server 2012）
P-2446-7T44　 Groupmax Agent - Mail Server Version 6　 06-82（適用OS：Windows Server 2003，Windows Server 2008，Windows Server 2012）
P-2446-7T44　 Groupmax Agent - Mail Web Option Version 6　 06-51（適用OS：Windows Server 2003）

■ 輸出時の注意

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

■ 商標類

Microsoft, Windows, Windows ServerおよびWindows NTは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Microsoft OfficeおよびExcelは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
OracleとJavaは，Oracle Corporation 及びその子会社，関連会社の米国及びその他の国における登録商標です。
UNIXは，The Open Groupの米国ならびに他の国における登録商標です。
その他記載の会社名，製品名は，それぞれの会社の商標もしくは登録商標です。

■ 発行

平成11年6月（第1版）3020-3-A76（廃版）
平成22年4月（第2版）3020-3-A76-10（廃版）
平成22年9月（第3版）3020-3-A76-20（廃版）
平成26年6月（第4版）3020-3-A76-30（廃版）
平成27年3月（第5版）3020-3-A76-40

■ 著作権

All Rights Reserved. Copyright (C) 1999, 2015, Hitachi, Ltd.

変更内容

変更内容（3020-3-A76-40）　Groupmax Agent Server Version 5 05-82，Groupmax Agent Server Mail Option Version 5 05-82，Groupmax Agent - Application Version 6 06-82

追加・変更内容 | 変更個所
Workflow Agentのインストールに必要なプログラムについて説明を追加しました。 | 3.3
サンプルのバッチファイルについて説明を追加しました。 | 4.5.1，付録F-1
ホスト名の扱いについて追加しました。 | 4.5.2
aglog及びagtraceの注意事項を変更しました。 | 5.2.4，5.2.5
Max Reply count及びMax Forward countについての説明を変更しました。 | 7.4.1
E-mailアドレスについての記載を変更しました。 | 7.7
自動転送時の返信先変更機能について追加しました。 | 7.9

単なる誤字・脱字などはお断りなく訂正しました。

変更内容（3020-3-A76-30）　Groupmax Agent Server Version 5 05-82，Groupmax Agent Server Mail Option Version 5 05-82，Groupmax Agent - Application Version 6 06-81-A

追加・変更内容

Windows Server 2012に対応しました。

トレース取得機能について追加しました。

Windows Server 2012使用時の注意事項を追加しました。

変更内容（3020-3-A76-20）　Groupmax Agent Server Version 5 05-80，Groupmax Agent Server Mail Option Version 5 05-80，Groupmax Agent - Application Version 6 06-80

追加・変更内容

Windows 2000，Windows Server 2003，Windows Server 2008に対応しました。

IPアドレスの変更について追加しました。

OS標準のファイアウォールの設定について追加しました。

トレース拡張について説明を変更しました。

エージェントおよびユーザ情報参照について追加しました。

ユーザ単位のエージェント削除について追加しました。

ユーザトレー内案件の一括新着監視エージェントによるメール宛先BCC化について追加しました。

自動転送エージェントにおけるASCIIオプションについて追加しました。

フォーム文書データベース検索オプションについて追加しました。

イベントログメッセージを追加しました。
KDAS00528-I
KDWA00512-I
KDMA02012-I
KDMA03012-I
KDDA04012-I

ディスク容量の内訳についての説明を削除しました。

変更内容（3020-3-A76-10）　Groupmax Agent Server Version 5 05-80，Groupmax Agent Server Mail Option Version 5 05-80

追加・変更内容

Windows 2000，Windows Server 2003，Windows Server 2008に対応しました。

ファイアウォールの設定の説明を追加しました。

トレース拡張について説明を追加しました。

Windows Server 2008使用時の注意事項を追加しました。

はじめに

このマニュアルは，Groupmax Version 7のGroupmax Agent Version 5の運用方法について説明したものです。このマニュアルでは，次のプログラムプロダクトを総称してGroupmax Agent Version 5と表記しています。

Groupmax Agent Server Version 5

Groupmax Agent Server Mail Option Version 5

Groupmax Agent - Application Version 6

Groupmax Agent - Development Kit Version 5

以降，このマニュアルでは，Groupmax Agent Version 5をGroupmax Agentと略します。

対象読者

このマニュアルは，次の方を対象としています。

Agent Server及びAgent - Applicationを使用してGroupmax Agentのシステム環境を管理される方

使用するOS（Operating System）の基本的な知識をお持ちの方

エージェントの基本的な知識をお持ちの方

マニュアルの構成

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

第１章　Groupmax Agentの概要

Groupmax Agentの機能，プログラム構成，使用環境について説明しています。

第２章　Groupmax Agentの運用例

Groupmax Agentが提供する各エージェントを利用する場合の運用例，独自に開発したエージェントを利用する場合の運用例，及びクライアント・サーバ間の通信にリモートアクセスサービスを利用する場合の運用例について説明しています。

第３章　運用を開始するまでに必要な操作

Groupmax Agentの運用を開始するまでに必要な操作として，インストールと環境設定について説明しています。また，Groupmax Agentをバージョンアップする場合に必要な操作や注意事項などについて説明しています。

第４章　全体の運用

各サーバ間の起動と終了の関係，及びバックアップ・リストアについて説明しています。

第５章　Agent Serverの運用

Agent Serverの起動と終了の方法，運用時に必要な運用コマンド及び管理ツールの使用方法について説明しています。

第６章　Workflow Agentの運用

Agent - Applicationの一部であるWorkflow Agentの起動と終了の方法，運用時に必要な運用コマンド及び管理ツールの使用方法について説明しています。

第７章　Mail Agentの運用

Agent - Applicationの一部であるMail Agentの起動と終了の方法，運用時に必要な運用コマンド及び管理ツールの使用方法について説明しています。

第８章　Document Manager Agentの運用

Agent - Applicationの一部であるDocument Manager Agentの起動と終了の方法，運用時に必要な運用コマンド及び管理ツールの使用方法について説明しています。

第９章　障害対策

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

付録Ａ　用語解説

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

付録B　プログラムを削除する方法

インストールしたプログラムを削除する方法について説明しています。

付録C　管理ツールのメニューコマンド一覧

Groupmax Agentが提供する各管理ツールのメニューコマンドについて説明しています。

付録D　活動ログ及びイベントログのエラーコード

活動ログ及びイベントログに出力されるエラーコードについて説明しています。

付録E　イベントログメッセージの一覧

Groupmax Agentがイベントログに出力する内容について説明しています。

付録F　フォルダ（ディレクトリ）構成

インストール後のフォルダ（ディレクトリ）構成について説明しています。

付録G　Windows Server 2008使用時の注意事項

Windows Server 2008使用時の注意事項について説明しています。

付録H　Windows Server 2012使用時の注意事項

Windows Server 2012使用時の注意事項について説明しています。

関連マニュアル

このマニュアルの関連マニュアルを次に示します。必要に応じてお読みください。

Groupmax Agent Version 5 エージェント作成ガイド（3020-3-A77）

サーバで動作する独自のエージェントを作成する方法，及びAgent - Applicationが提供する各エージェントの使用方法について説明しています。

Groupmax Agent Version 5 リファレンス（3020-3-A92）

Groupmax Agentが提供する関数，及びコーディングの形式について説明しています。

Groupmax Integrated Desktop Version 7 ユーザーズガイド（3020-3-D06）

Groupmax Agentが提供するエージェントのテンプレートや，独自に作成したサーバエージェントを使用するのに必要なサーバエージェントマネ－ジャについて説明しています。

Groupmax Address/Mail Version 7 システム管理者ガイド　ユティリティ編（3020-3-D11）

Groupmaxのユーザ管理に使用するユティリティについて説明しています。ユーザ作成ファイルを作成するためにGroupmax Addressの一括登録ユティリティを使用する場合は，このマニュアルを参照してください。

Groupmax Version 6iサーバ環境設定ガイド（3020-3-B73）

Agent Serverの環境設定ができるGroupmax Server Setup Wizardについて説明しています。

Groupmax Object Server Version 6 システム管理者ガイド（3020-3-B56）

Agent ServerやWorkflow Agentなどのservicesファイルの設定ができるGroupmaxサーバ環境設定ユティリティについて説明しています。

Groupmax Workflow Version 6 ビジュアル定義・シミュレータ・運用モニタ ユーザーズガイド（3020-3-B43）

Workflowの運用状況を確認できる運用モニタについて説明しています。

読書手順

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

このマニュアルの図中で使用する記号

このマニュアルの図中で使用する記号を次のように定義します。

このマニュアルで使用する記号

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

記　　号 | 説　　明
［　　］ | ダイアログ名又はボタン名を表します。
「　　」 | ウィンドウやダイアログ中に表示されている項目又は操作時にユーザが入力する文字列を表しています。

マニュアルの表記

このマニュアルで使用する主な英略語を次に示します。

英略語 | 説明
API | Application Programming Interface
CSV | Comma Separated Value
GUI | Graphical User Interface
HTML | Hypertext Markup Language
LAN | Local Area Network
NAT | Network Address Translation
PP | Program Product
RAS | Remote Access Service
SMTP | Simple Mail Transfer Protocol

また，このマニュアルでは，製品名称を次に示す略称で表記しています。

製品名称
略称

Groupmax Agent Version 5
Groupmax Agent

Groupmax Agent Server Version 5
Agent Server

Groupmax Agent Client Version 7
Agent Client

Groupmax Agent Server Mail Option Version 5
Agent Server Mail
Option

Groupmax Agent - Application Version 6
Agent - Application

Groupmax Agent - Workflow Server Version 5
Agent - Workflow
Server

Groupmax Agent - Workflow Function Version 5
Agent - Workflow
Function

Groupmax Agent - Mail Server Version 6
Agent - Mail Server

Groupmax Agent - Mail Function Version 6
Agent - Mail Function

Groupmax Agent - Document Manager Server Version 5
Agent - Document
Manager Server

Groupmax Agent - Mail Web Option Version 6
Agent - Mail Web Option

Groupmax Agent - Document Manager Function Version 5
Agent - Document
Manager Function

Groupmax Agent - Development Kit Version 5
Agent - Development
Kit

Groupmax Integrated Desktop Version 7
Integrated Desktop

Groupmax Address Server Version 7
Groupmax Address
Server

Groupmax Address Server Version 7
Groupmax Address Client Version 7
Groupmax Address

Groupmax Mail Server Version 7
Groupmax Mail Server

Groupmax Mail Server Version 7
Groupmax Mail Client Version 7
Groupmax Mail

Groupmax Workflow Server Version 6
Groupmax Workflow
Server

Groupmax Document Manager Version 6
Groupmax Document
Manager

Groupmax Document Manager Development Kit Version 5
Groupmax Document Manager Development Kit

Groupmax Workflow Server - Library Version 6
Groupmax Workflow Server - Library

Groupmax Workflow Client - Library Version 6
Groupmax Workflow Client - Library

Groupmax Object Server Version 6
Groupmax High-end Object Server Version 6
Groupmax Object
Server

Microsoft(R) Office Excel
Excel

Microsoft(R) Windows NT(R) Server Network Operating System Version 3.51
Microsoft(R) Windows NT(R) Server Network Operating System Version 4.0
Microsoft(R) Windows NT(R) Workstation Operating System Version 3.51
Microsoft(R) Windows NT(R) Workstation Operating System Version 4.0
Windows NT

Microsoft(R) Windows Server(R) 2003，Standard Edition 日本語版
Microsoft(R) Windows Server(R) 2003，Enterprise Edition 日本語版
Microsoft(R) Windows Server(R) 2003 R2，Standard Edition 日本語版
Microsoft(R) Windows Server(R) 2003 R2，Enterprise Edition 日本語版
Windows Server 2003

Microsoft(R) Windows Server(R) 2008 Standard 日本語版
Microsoft(R) Windows Server(R) 2008 Enterprise 日本語版
Microsoft(R) Windows Server(R) 2008 R2 Standard 日本語版
Microsoft(R) Windows Server(R) 2008 R2 Enterprise 日本語版
Windows Server 2008

Microsoft(R) Windows Server(R) 2008 R2 Standard 日本語版
Microsoft(R) Windows Server(R) 2008 R2 Enterprise 日本語版
Windows Server 2008 R2

Microsoft(R) Windows Server(R) 2012 Standard 日本語版
Microsoft(R) Windows Server(R) 2012 Datacenter 日本語版
Microsoft(R) Windows Server(R) 2012 R2 Standard 日本語版
Microsoft(R) Windows Server(R) 2012 R2 Datacenter 日本語版
Windows Server 2012

Groupmax Agent Version 5（Groupmax Agent）は次の製品の総称です。

Groupmax Agent Server Version 5

Groupmax Agent Server Mail Option Version 5

Groupmax Agent - Application Version 6

Groupmax Agent - Development Kit Version 5

Groupmax Agent - Application Version 6（Agent - Application）は次のコンポーネントの総称です。

Groupmax Agent - Workflow Server Version 5

Groupmax Agent - Workflow Function Version 5

Groupmax Agent - Mail Server Version 6

Groupmax Agent - Mail Function Version 6

Groupmax Agent - Document Manager Server Version 5

Groupmax Agent - Document Manager Function Version 5

Groupmax Agent - Mail Web Option Version 6

表記の読み替えについて

Windows Server 2003をご使用の方は，本文中の「Windows NT」を「Windows Server 2003」と読み替えてください。

Windows Server 2008をご使用の方は，本文中の「Windows NT」を「Windows Server 2008」と読み替えてください。

Windows Server 2012をご使用の方は，本文中の「Windows NT」を「Windows 2012」と読み替えてください。

Windows Server 2012をご使用の方は，本文中の「［スタート］メニュー」を「［アプリ］画面」と読み替えてください。

Windows Server 2008をご使用の方は，本文中にあるファイアウォールの設定画面の「Windowsファイアウォールによるプログラムのブロック時に通知を表示する」を「Windowsファイアウォールによる新しいプログラムのブロック時に通知を受け取る」と読み替えてください。

Windows Server 2008 R2をご使用の方は，本文中にあるファイアウォールの設定画面の「Windowsファイアウォールによるプログラムのブロック時に通知を表示する」を「Windowsファイアウォールが新しいプログラムをブロックしたときに通知を受け取る」と読み替えてください。

Windows Server 2012をご使用の方は，本文中にあるファイアウォールの設定画面の「Windowsファイアウォールによるプログラムのブロック時に通知を表示する」を「Windowsファイアウォールが新しいアプリをブロックしたときに通知を受け取る」と読み替えてください。

KB（キロバイト）などの単位表記について

1KB（キロバイト），1MB（メガバイト），1GB（ギガバイト），1TB（テラバイト）はそれぞれ1,024バイト，1,024²バイト，1,024³バイト，1,024⁴バイトです。

1.　Groupmax Agentの概要

この章では，Groupmax Agentの機能概要及びGroupmax Agentを使用する環境について説明します。

＜この章の構成＞

1.1　Groupmax Agentの機能

1.2　Groupmax Agentのプログラム構成

1.3　Groupmax Agentを使用する環境

1.1　Groupmax Agentの機能

この節では，エージェントとは何か，及びGroupmax Agentを使ってどのようなことができるかを説明します。

＜この節の構成＞

1.1.1　エージェントとは

1.1.2　Groupmax Agentでは何ができるか

1.1.1　エージェントとは

エージェントとは，定型的な繰り返し作業や時間のかかる作業をユーザに代わって行うものです。エージェントを利用することによって作業の効率が向上し，ユーザはより創造的な作業に時間をかけることができます。

エージェントは，ユーザの用途に合わせたきっかけ（トリガといいます）と，それに対する仕事（アクションといいます）によって成り立ちます。例えば，「新しいメールが届いたら（トリガ），メッセージを表示する（アクション）」というエージェントが考えられます。

1.1.2　Groupmax Agentでは何ができるか

Groupmax Agentが提供する各機能の概要について説明します。

＜この項の構成＞

(1)　独自のエージェントを開発するAPIを提供

(2)　ユーザインタフェースを作成するテンプレートを提供

(3)　エージェントの動作環境を管理するためのツールを提供

(4)　Groupmax Workflowと連携したエージェントを提供

(5)　Groupmax Mailと連携したエージェントを提供

(6)　Groupmax Document Managerと連携したエージェントを提供

(1)　独自のエージェントを開発するAPIを提供

Groupmax Agentでは，エージェントプログラムの作成に必要なAPIを提供しています。エージェント開発者は，APIを利用してエージェントの活動内容（トリガ，アクションなど）を定義したプログラムを作成します。その場合，業務形態に合わせてエージェントの活動内容を独自に定義できます。作成したプログラムはAgent Serverに格納します。

(2)　ユーザインタフェースを作成するテンプレートを提供

Groupmax Agentでは，エージェント定義画面を提供しています。この画面を利用することによって，一般ユーザは必要なプログラム名を入力するだけでエージェントを生成できます。

さらに，Groupmax Agentでは，このエージェント定義画面のテンプレートを提供しています。エージェント開発者はこのテンプレートを基に，プログラムの内容に合ったエージェント定義画面を作成できます。この画面を利用することによって，一般ユーザはプログラム名を意識することなく容易にエージェントを生成できます。また，トリガとアクションを組み合わせて独自のエージェントを作成したり，トリガやアクションを自分の業務形態に合わせてカスタマイズしたりできます。

(3)　エージェントの動作環境を管理するためのツールを提供

Groupmax Agentでは，エージェントの動作環境に関する設定をしたり，登録されているエージェントのログを参照したりするAgent Server管理ツールを提供しています。システム管理者は，この管理ツールを使用してエージェントを登録しているユーザ数や登録されているエージェント数を監視できます。また，障害が発生した場合は，エージェントの詳細情報や活動ログなどから障害元を特定して回復できます。

また，各Groupmax製品と連携したエージェントを利用する場合の動作環境を管理するためのツールも提供しています。

(4)　Groupmax Workflowと連携したエージェントを提供

Groupmax Agentでは，Groupmax Workflowと連携した次のエージェントを使用できます。

ユーザトレー内案件の着信を監視するエージェント（一般ユーザ用）
自分のユーザトレーを監視し，新規に案件が到着したらメール又はメッセージダイアログで通知します。

ユーザトレー内案件の新着を一括監視するエージェント（管理者用）
ユーザトレーを監視し，新規に案件が到着したらメールで通知します。複数のトレーを一括して監視できます。

業務ロールトレー内案件の着信を監視するエージェント（管理者用）
業務ロールトレーを監視し，新規に案件が到着したらメールで通知します。

ユーザトレー内案件の処理期限を監視するエージェント（一般ユーザ用）
自分のユーザトレーを監視し，案件の処理期限が迫ってきたらメール又はメッセージダイアログで通知します。

ユーザトレー内案件の処理期限を一括監視するエージェント（管理者用）
ユーザトレーを監視し，案件の処理期限が迫ってきたらメールで通知します。複数のトレーを一括して監視できます。

ユーザトレー内案件の処理期限を監視するエージェント（管理者用）
ユーザトレーを監視し，案件の処理期限が迫ってきたらメール又はメッセージダイアログで通知します。

サーバ上の業務プログラムを自動起動するエージェント（管理者用）
指定した時刻にユーザトレーに案件があったら，サーバ上の業務プログラムを起動します。

(5)　Groupmax Mailと連携したエージェントを提供

Groupmax Agentでは，Groupmax Mailと連携した次のエージェントを使用できます。

個人メールを自動返信するエージェント（一般ユーザ用）
特定のメールが到着したら自動的にメールを返信します。

個人メールを自動転送するエージェント（一般ユーザ用）
特定のメールが到着したら，指定したユーザに自動的にメールを転送します。

サーバ上のユーザプログラムを自動起動するエージェント（一般ユーザ用）
特定のメールが到着したら，サーバ上のユーザプログラムを起動します。

(6)　Groupmax Document Managerと連携したエージェントを提供

Groupmax Agentでは，Groupmax Document Managerと連携した次のエージェントを使用できます。

共用キャビネット内の文書を削除するエージェント（管理者用）
指定した時間になったとき指定したフォルダ内の文書を削除します。

条件付きでフォーム文書を削除するエージェント（管理者用）
指定した時間になったときフォーム文書データベース内の文書属性を監視して，条件を満たすフォーム文書があれば，そのフォーム文書を削除します。

条件付きでサーバ上の業務プログラムを自動起動するエージェント（管理者用）
指定した時間になったときフォーム文書データベース内の文書属性を監視して，条件を満たすフォーム文書があれば，サーバ上の業務プログラムを起動します。

共用キャビネット内の文書登録を監視するエージェント（管理者用）
指定した時間になったとき指定したフォルダへの文書の登録を監視して，登録された文書があれば，メールの送信，メッセージの表示，又はサーバ上の業務プログラムを起動します。

1.2　Groupmax Agentのプログラム構成

この節では，Groupmax Agentのプログラム構成について説明します。Groupmax Agentのプログラム構成を図1-1に示します。

図1-1　Groupmax Agentのプログラム構成

＜この節の構成＞

1.2.1　サーバプログラム

1.2.2　クライアントプログラム

1.2.3　プログラミングツール

1.2.1　サーバプログラム

＜この項の構成＞

(1)　Agent Server

(2)　Agent Server Mail Option

(3)　Agent - Application

(1)　Agent Server

Agent Serverは，Groupmax Agentの基本となるプログラムです。Agent Serverは，一般ユーザが生成したエージェントの動作環境を管理するためのツールを提供しています。また，独自のエージェントをプログラムしたり，ユーザインタフェースを作成するためのAPIも提供しています。APIを使ったプログラミングについては，マニュアル「Groupmax Agent Version 5　エージェント作成ガイド」及び「Groupmax Agent Version 5　リファレンス」を参照してください。

(2)　Agent Server Mail Option

上記の基本部分のほかに，Groupmax Mailと連携してメールを送信するアクションを動作させるためのAgentメール送信ライブラリ（Agent Server Mail Option）を提供しています。Agent ServerをMail Serverと別のマシンにインストールする場合に必要です。

(3)　Agent - Application

Groupmaxの各製品と連携したエージェントを簡単に利用できるようにしたオプション製品です。Agent - Applicationは次の三つから成ります。

Groupmax Workflowと連携する部分（Workflow Agent）
Agent Server及びGroupmax Workflowと連携したエージェントを提供しています。本体部分（Agent - Workflow Server）と実行エンジン部分（Agent - Workfow Function）があります。以降，この二つを合わせてWorkflow Agentと呼びます。

Groupmax Mailと連携する部分（Mail Agent）
Agent Server及びGroupmax Mailと連携したエージェントを提供しています。本体部分（Agent - Mail Server）と実行エンジン部分（Agent - Mail Function）があります。以降，この二つを合わせてMail Agentと呼びます。

Groupmax Document Managerと連携する部分（Document Manager Agent）
Agent Server及びGroupmax Document Managerと連携したエージェントを提供しています。本体部分（Agent - Document Manager Server）と実行エンジン部分（Agent - Document Manager Function）があります。以降，この二つを合わせてDocument Manager Agentと呼びます。

本体部分は各PPサーバと同じマシンにインストールし，実行エンジン部分はAgent Serverと同じマシンにインストールします。PPサーバとは，Agent Server以外でエージェント機能を持つ製品のサーバです。Groupmax製品では，Groupmax Mail Server，Groupmax Workflow Server，Groupmax Document ManagerなどがPPサーバにあたります。実行エンジンとは，Agent ServerとPPサーバの間でのエージェント情報のやり取りを制御する部分です。

なお，Agent - Applicationを使った各エージェントの使用方法については，マニュアル「Groupmax Agent Version 5 エージェント作成ガイド」を参照してください。

1.2.2　クライアントプログラム

一般ユーザがクライアントマシンで使用するプログラムは，Agent Clientです。一般ユーザは，Agent Clientが提供するサーバエージェントマネージャを使うことによって，自分用にカスタマイズしたエージェントを生成できます。また，Agent - Applicationが提供する各エージェントを使用する場合はIntegrated Desktopからテンプレートを利用して生成します。クライアントからエージェントを生成する方法については，マニュアル「Groupmax Integrated Desktop Version 7　ユーザーズガイド」を参照してください。

1.2.3　プログラミングツール

Groupmax Agentには，プログラム開発を支援するためのオプション製品として，Agent - Development Kitがあります。Agent - Development Kitは，プログラム作成用のAPIやユーザインタフェース作成用のテンプレートを提供しています。APIには通信支援機能があるため，Agent Serverとは別のサーバマシンで動作するエージェントプログラムを効率的に作成できます。また，テンプレートを利用することによって，ユーザインタフェースを効率的に作成できます。

Agent - Development Kitを利用したエージェントの作成方法については，マニュアル「Groupmax Agent Version 5　エージェント作成ガイド」及び「Groupmax Agent Version 5　リファレンス」を参照してください。

1.3　Groupmax Agentを使用する環境

＜この節の構成＞

1.3.1　登録するエージェント，ユーザ，接続サーバ

1.3.2　必要空きメモリ・ディスク容量

1.3.1　登録するエージェント，ユーザ，接続サーバ

標準値及び設定できる最大値を表1-1に示します。

表1-1　登録する項目の標準値と最大値

登録する項目
標準値
最大値

同時にログインできるユーザ数
64
1,000

同時に接続できるユーザ数※１
16
256

登録できるエージェント数
1,000
3,000

同時に起動されるエージェント数※２
52
96

接続するサーバ数
8
64

接続するAgent Server数
（Workflow Serverから）
4
64

接続するAgent Server数
（Mail Serverから）
8
64

接続するAgent Server数
（Document Managerから）
8
64

注※１

接続できるユーザとは接続状態のユーザのことです。Agent Serverは，ログイン中のユーザがクライアントで操作しない時間が10秒経過すると，接続状態を解除します。その後，クライアントで操作した場合は再度接続状態になります。

注※２

同時に起動されるエージェント数は，Agent Serverのスケジューラが使用するジョブクラス別スレッド数の合計と同じです。

1.3.2　必要空きメモリ・ディスク容量

＜この項の構成＞

(1)　メモリ容量

(2)　ディスク容量

(1)　メモリ容量

次のメモリ容量を確保してください。

表1-2　標準値でのメモリ容量

サーバマシン | インストールする製品 | 仮想メモリ | 実メモリ
エージェントサーバ | Agent Server | 438MB | 44MB
Workflow Agent実行エンジン | 2MB | 1MB
Mail Agent実行エンジン | 135MB | 14MB
Document Manager Agent実行エンジン | 2MB | 1MB
メールサーバ | Mail Agent本体 | 253MB | 26MB
Agentメール送信ライブラリ | 150MB | 15MB
ワークフローサーバ | Workflow Agent本体 | 82MB | 9MB
文書管理サーバ | Document Manager Agent本体 | 204MB | 21MB

表1-3　最大値でのメモリ容量

サーバマシン | インストールする製品 | 仮想メモリ | 実メモリ
エージェントサーバ | Agent Server | 687MB | 69MB
Workflow Agent実行エンジン | 2MB | 1MB
Mail Agent実行エンジン | 198MB | 20MB
Document Manager Agent実行エンジン | 2MB | 1MB
メールサーバ | Mail Agent本体 | 292MB | 30MB
Agentメール送信ライブラリ | 150MB | 15MB
ワークフローサーバ | Workflow Agent本体 | 121MB | 13MB
文書管理サーバ | Document Manager Agent本体 | 232MB | 24MB

御使用の環境で必要な仮想メモリ容量は次のように計算します。実メモリ容量は，仮想メモリ容量の約10％程度の空き容量を確保してください。

(a)　Agent Server

Agent Server
310MB＋(15.0KB×最大登録可能エージェント数)＋
(32.5KB×接続可能PPサーバ数)＋
(0.4KB×最大ログインユーザ数)＋
(532KB×同時接続可能ユーザ数)＋
(2MB×同時に起動されるエージェント数)

Agentメール送信ライブラリ
150MB固定です。

(b)　Agent - Application

Workflow Agent本体
74MB+(2.8MB×↑登録するエージェント数÷1000↑)
+(768KB×↑((0.024KB×通知する案件数)×登録するエージェント数)÷768KB↑)
+(0.236KB×最大登録可能エージェント数)
+(1.7MB×↑((0.044KB+(0.164KB×通知する案件数))×登録するエージェント数)÷1684KB↑)
+(0.5MB×接続するAgent Server数)

Workflow Agent実行エンジン
約2MB固定です。

Mail Agent本体
250MB＋(0.7MB×接続するAgent Server数)

Mail Agent実行エンジン
130MB＋(12KB×最大登録可能エージェント数)＋
(0.5MB×接続するMail Agent本体数)

Document Manager Agent本体
200MB＋(0.5MB×接続するAgent Server数)

Document Manager Agent実行エンジン
2MB固定です。

(2)　ディスク容量

次に示すディスク容量を確保してください。

表1-4　標準値でのディスク占有量

サーバマシン | インストールする製品 | ディスク容量
エージェントサーバ | Agent Server | 50MB
Workflow Agent実行エンジン | 1MB
Mail Agent実行エンジン | 11MB
Document Manager Agent実行エンジン | 3MB
メールサーバ | Mail Agent本体 | 10MB
Agentメール送信ライブラリ | 6MB
ワークフローサーバ | Workflow Agent本体 | 17MB
文書管理サーバ | Document Manager Agent本体 | 7MB

表1-5　最大値でのディスク容量

サーバマシン | インストールする製品 | ディスク容量
エージェントサーバ | Agent Server | 110MB
Workflow Agent実行エンジン | 1MB
Mail Agent実行エンジン | 11MB
Document Manager Agent実行エンジン | 3MB
メールサーバ | Mail Agent本体 | 26MB
Agentメール送信ライブラリ | 6MB
ワークフローサーバ | Workflow Agent本体 | 36MB
文書管理サーバ | Document Manager Agent本体 | 7MB

御使用の環境で必要なディスク容量は次のように計算します。

(a)　Agent Server

Agent Server本体
20MB＋(15KB×最大登録可能エージェント数※)
＋(32.6KB×最大接続PPサーバ数※)
＋(0.4KB×最大ログインユーザ数※)
＋(32KB×同時ログイン可能ユーザ数※)
＋(10KB×登録するエージェント数※)
＋(カスタマイズプログラムサイズ)

Agentメール送信ライブラリ
6MB固定です。

(b)　Agent - Application

Workflow Agent本体
11MB＋(0.3KB×最大登録可能エージェント数※)
＋(768KB×↑((0.24KB×通知する案件数※)×登録するエージェント数※)÷768KB↑)
＋(2992KB×↑登録するエージェント数※÷1000↑)
＋(1680KB×↑((0.044KB+(0.164KB×通知する案件数※))×
登録するエージェント数※÷1680KB)↑)

Workflow Agent実行エンジン
1MB固定です。

Mail Agent本体
8MB＋(280KB×接続するAgent Server数)

Mail Agent実行エンジン
10MB＋(0.2KB×最大登録可能エージェント数※)
＋36KB×(アクション待ちメール数÷3000)

Document Manager Agent本体
6.4MB＋(0.020KB×最大通知文書数)

Document Manager Agent実行エンジン
3MB固定です。

注※

これらの値は，Agent Server及びAgent - Applicationの各管理ツールで指定します。

2.　Groupmax Agentの運用例

この章では，Groupmax Agentの各プログラムを使用する場合の運用例，及びクライアント・サーバ間の通信にリモートアクセスサービスを使用する場合の運用例について説明します。

＜この章の構成＞

2.1　Groupmax Agentの運用に必要な製品

2.2　Workflow Agentを利用する場合の運用例

2.3　Mail Agentを利用する場合の運用例

2.4　Document Manager Agentを利用する場合の運用例

2.5　独自に開発したエージェントを利用する場合の運用例

2.6　リモートアクセスサービス（RAS）を利用する場合の運用例

2.1　Groupmax Agentの運用に必要な製品

この節では，Groupmax Agentの運用に必要となる製品について説明します。

＜この節の構成＞

2.1.1　Groupmax製品

2.1.2　Groupmax以外の製品

2.1.1　Groupmax製品

＜この項の構成＞

(1)　Groupmax Address

(2)　Groupmax Mail

(3)　Groupmax Workflow

(4)　Groupmax Document Manager

(1)　Groupmax Address

Groupmaxアプリケーションへログインしようとするユーザの認証に使用します。また，Groupmax Address Serverが提供しているGroupmax Address Server 一括登録ユティリティを使用してユーザ作成ファイルを作成できます。ユーザ作成ファイルとは，Workflow Agentのエージェントを使用する場合に必要なファイルのことです。

(2)　Groupmax Mail

Agent Serverでは，Groupmax Mailでのメール送信をアクションとして定義できるようなAPIを提供しています。

また，Mail Agentと連携して，Mail Agentが提供する各エージェントを動作させることができます。

(3)　Groupmax Workflow

Groupmax Workflow Server-Library及びGroupmax Workflow Client-Libraryが提供するAPIを使用して，案件を送付するようなアクションをプログラミングできます。

また，Workflow Agentと連携して，Workflow Agentが提供する各エージェントを動作させることができます。

(4)　Groupmax Document Manager

Groupmax Document Manager Development Kitが提供するAPIを使用して，文書を検索するようなアクションをプログラミングできます。

また，Document Manager Agentと連携して，Document Manager Agentが提供する各エージェントを動作させることができます。

2.1.2　Groupmax以外の製品

Groupmax以外の製品でも，その製品から提供されているAPIを使用してプログラムを作成し，その製品のサーバプログラムと連携してエージェントを活動させることができます。

また，メール送信に関しては，Groupmax Mailのほかに，SMTPサーバと連携してE-mailを使用するためのAPIを提供しています。これによって，Groupmax Document Manager以外のデータベースを参照して，その結果をE-mail（SMTP）で送信するといったエージェントも作成できます。

2.2　Workflow Agentを利用する場合の運用例

処理期限が迫っている案件があることをメールで通知するエージェントを利用する場合の運用例を図2-1に示します。

図2-1　Workflow Agentを利用した場合の運用例

2.3　Mail Agentを利用する場合の運用例

特定のメールが到着した場合に自動的にメールを返信するエージェントを利用する場合の運用例を示します。

図2-2　Mail Agentを利用した場合の運用例

2.4　Document Manager Agentを利用する場合の運用例

指定した時刻に，指定したフォルダの文書を削除するエージェントを利用する場合の運用例を示します。

図2-3　Document Manager Agentを利用した場合の運用例

2.5　独自に開発したエージェントを利用する場合の運用例

DBPARTNERを利用して決まった時刻にデータベースを検索し，その結果をGroupmax Mailで送信するエージェントを利用する場合の運用例を示します。

図2-4　独自に開発したエージェントを利用する場合の運用例

2.6　リモートアクセスサービス（RAS）を利用する場合の運用例

Agent ServerとAgent Clientとの間の通信にリモートアクセスサービス（RAS）を利用した場合の運用例と注意点について説明します。

＜この節の構成＞

2.6.1　RASを利用した場合の運用例

2.6.2　クライアントでIPアドレスを取得する場合の注意事項

2.6.3　サーバ間の接続に関する注意事項

2.6.1　RASを利用した場合の運用例

RASを利用した場合の運用について，LANを利用した場合と比較して示します。

図2-5　リモートアクセスサービス（RAS）を利用した場合の運用例

次に，Agent ServerとAgent Client間での通信処理の概要を示します。

図2-6　Agent ServerとAgent Client間の通信処理の概要

2.6.2　クライアントでIPアドレスを取得する場合の注意事項

図2-6に示したように，Agent ClientではAgent Serverに自ホストのIPアドレスを渡すためにIPアドレスを取得する処理をしています。この処理に関する注意事項を説明します。

＜この項の構成＞

(1)　Agent ServerとAgent Clientの通信にLANを使用する場合

(2)　Agent ServerとAgent Clientの通信にRASを使用する場合

(1)　Agent ServerとAgent Clientの通信にLANを使用する場合

図2-6では，(2)で記憶するアドレスがRASのIPアドレスになり，(3)でRASのIPアドレスを使用してしまうため，Agent ServerからAgent Clientへ正しく接続できません。Agent Clientのダイアログ表示がAgent Serverで保留状態になります。

このような場合は，クライアントを再起動し，RASを使用しないで実行してください。保留状態になったダイアログはAgent Clientから再度ログインすると表示されます。また，RASを切断した場合は，Agent Serverからいったんログアウトし，再度ログインしてください。

(2)　Agent ServerとAgent Clientの通信にRASを使用する場合

RASでは，クライアントのIPアドレスを動的に設定する場合と固定で設定する場合があります。

動的に設定する場合，RASをいったん切断すると別のIPアドレスが設定されます。しかし，切断前に使用していたIPアドレスもそのクライアントのIPアドレスとして残ってしまいます。Agent Clientが取得した自ホストのIPアドレスが，現在使用しているIPアドレスではない場合は通信エラーとなります。このような現象が発生した場合には，クライアントを再起動して実行してください。

2.6.3　サーバ間の接続に関する注意事項

次の場合，Agent ServerとPPサーバ間の通信にはRASを使用しないでください。

Workflow Agentを利用する場合
Groupmax Workflow ServerとAgent Serverとの通信にはRASを使用しないでください。

Mail Agentを利用する場合
Groupmax Mail ServerとAgent Serverとの通信はRASを使用しないでください。

Document Manager Agentを利用する場合
Groupmax Document ManagerとAgent Serverとの通信にはRASを使用しないでください。

3.　運用を開始するまでに必要な操作

この章では，Groupmax Agentを運用するまでに必要な操作として，バージョン移行の方法や各プログラムのインストール・環境設定の方法を説明します。

＜この章の構成＞

3.1　バージョンの移行・混在に関する注意

3.2　Agent Serverのインストールと環境設定

3.3　Workflow Agentのインストールと環境設定

3.4　Mail Agentのインストールと環境設定

3.5　Document Manager Agentのインストールと環境設定

3.1　バージョンの移行・混在に関する注意

この節では，バージョンの移行や混在について説明します。

＜この節の構成＞

3.1.1　Agent Serverのバージョン移行

3.1.2　Workflow Agentのバージョン移行

3.1.3　ユーザプログラムのリコンパイル

3.1.4　バージョンの混在

3.1.1　Agent Serverのバージョン移行

Agent Serverをバージョンアップした後で，旧バージョンのAgent Server環境をそのまま使用したい場合は，次の操作が必要です。

＜この項の構成＞

(1)　Workflow Agent実行エンジンのバージョンアップ

(2)　Agent Serverのシステムファイルの変換

(1)　Workflow Agent実行エンジンのバージョンアップ

旧バージョンのWorkflow Agent実行エンジンがインストールされている場合は，バージョン05-00のWorkflow Agent実行エンジンにバージョンアップしてください。

Workflow Agent実行エンジンのインストール方法については，「3.3.1　Workflow Agentのインストール」を参照してください。

注意事項

Workflow Agent実行エンジンは，バージョン02-31とバージョン03-00以降とで名称が異なります。注意してください。

バージョン02-31での名称
バージョン 03-00以降での名称

Groupmax Workflow Agent -
Manipulative Function
Groupmax Agent -
Workflow Function

(2)　Agent Serverのシステムファイルの変換

バージョン02-xxから移行する場合，Workflow Agentの実行エンジンをバージョンアップした後で，システムファイルをバージョン05-00用に変換してください。バージョン03-xxから移行する場合は，この作業は不要です。

Administratorの権限でWindows NTにログオンします。

コマンドプロンプト画面を表示します。

次のフォルダ（ディレクトリ）に移動します。
インストール先¥GroupmaxAgent¥SVbin

バージョン移行コマンド「agconv」を入力します。
システムファイルが変換されます。
ディスク容量が不足している場合は，容量が不足している旨のメッセージが表示されます。この場合，システムファイルは変換されません。

なお，Agent Serverの運用コマンドの詳細については，「5.2　Agent Serverの運用コマンド」を参照してください。

3.1.2　Workflow Agentのバージョン移行

バージョン02-xxから移行する場合，Workflow Agentをバージョンアップした後で，旧バージョンのエージェント定義情報をそのまま使用したい場合は，Workflow Agentのエージェント定義情報を05-00用に変換する必要があります。エージェント定義情報を変換するには，Workflow Agentを起動する前にバージョン移行コマンドを実行します。

＜この項の構成＞

(1)　Workflow Agentのエージェント定義情報の変換

(2)　バージョン移行時の注意事項

(1)　Workflow Agentのエージェント定義情報の変換

Administratorの権限でWindows NTにログオンします。

コマンドプロンプト画面を表示します。

次のフォルダ（ディレクトリ）に移動します。
インストール先¥WorkflowAgent¥SVbin

バージョン移行コマンド「waconv」を入力します。
エージェント定義情報が変換されます。
ディスク容量が不足している場合は，容量が不足している旨のメッセージが表示されます。この場合，エージェント定義は変換されません。

なお，Workflow Agentの運用コマンドについては，「6.2　Workflow Agentの運用コマンド」を参照してください。

(2)　バージョン移行時の注意事項

Workflow Agentをバージョンアップした場合の注意事項について説明します。

(a)　タイマ情報，登録可能エージェント上限値の設定について

waconvコマンドを実行してWorkflow Agent 02-31で使用していた動作環境を03-00以降の動作環境へ移行した場合，次のような変更がありますので注意してください。

項番
02-31環境
03-00以降の環境

1

トリガ監視タイマはWorkflow Agentで一つだけ。

起点時間・監視間隔の組み合わせもWorkflow Agentで1組だけ。

トリガ監視タイマはエージェントの種類別に一つずつ。

起点時間・監視間隔の組み合わせもエージェントの種類別に設定できる。

「ユーザトレー内案件の処理期限監視」エージェントについては02-31環境で使用していた起点時間・監視間隔をそのまま使用する。

2
トリガ監視タイマはWorkflow Agentで一つしかないため，次の2つのエージェントは同じ監視間隔で動作する。

ユーザトレー内案件の処理期限監視

ユーザトレー内案件の着信監視

02-31で登録済みの「ユーザトレー内案件の着信監視」エージェントは「ユーザトレー内案件の処理期限監視」エージェントで設定したタイマ値で動作する。

03-00以降で新規登録した「ユーザトレー内案件の着信監視」エージェントは「ユーザトレー内案件の着信監視」エージェントのタイマ値で動作する。

3
登録可能エージェント数の上限値は1,000エージェントである。

登録可能エージェント数の上限値は3,000エージェントとなる。

登録可能エージェント数は02-31環境で使用していた値のままである。

(b)　エージェントの種類とGroupmax Workflow Serverの前提バージョンについて

Workflow AgentがGroupmax Workflow Serverに情報を問い合わせるときにはGroupmax Workflow Serverが提供するAPIを使用しています。この場合，エージェントの種類ごとに使用するAPIのバージョンが異なるので注意してください。

項番
エージェントの種類
Groupmax Workflow Server
が提供するAPIの前提バージョン

1
ユーザトレー内案件の着信監視
02-31以降

2
サーバ上業務プログラムの自動起動

3
ユーザトレー内案件の処理期限監視（一般ユーザ用）

4
ユーザトレー内案件の処理期限監視（管理者用）

5
ユーザトレー内案件の一括新着監視
03-00以降

6
業務ロールトレー内案件の着信監視

7
ユーザトレー内案件の一括処理期限監視

問い合わせた先のGroupmax Workflow Serverのバージョンが前提バージョンよりも古い場合は，活動ログにその旨メッセージが出力され，エージェントの監視処理が終了します。Groupmax Workflow Serverのバージョンを確認してください。

さらに，複数のGroupmax Workflow Serverを使用していて，個々のGroupmax Workflow Serverのバージョンが異なる場合には，エージェントの種類によって前提となるGroupmax Workflow Serverのバージョンに制限があります。必要に応じてGroupmax Workflow Serverをバージョンアップしてください。複数のGroupmax Workflow Serverを使用する場合に前提となるバージョンと使用できるエージェントの種類について次に示します。

ユーザトレーを監視するエージェントの場合

Workflow
管理サーバ
エージェントを
定義したユーザの
Workflowホームサーバ
監視対象となる
トレーを持つユーザの
Workflowホームサーバ
使用できる
エージェントの種類※

03-00以降
02-31
02-31
1～4

03-00以降
02-31
03-00以降
1～4

03-00以降
03-00以降
02-31
1～3

03-00以降
03-00以降
03-00以降
1～4

注※　1：ユーザトレー内案件の着信監視

　　　2：サーバ上業務プログラムの自動起動

　　　3：ユーザトレー内案件の処理期限監視（一般ユーザ用）

　　　4：ユーザトレー内案件の処理期限監視（管理者用）

ユーザトレーを一括監視するエージェントの場合

Workflow
管理サーバ
エージェントを実行する
Workflowサーバ
使用できる
エージェントの種類※

03-00以降
02-31
なし

03-00以降
03-00以降
5，7

注※　5：ユーザトレー内案件の一括新着監視

　　　7：ユーザトレー内案件の一括処理期限監視

業務ロールトレーを監視するエージェントの場合

Workflow
管理サーバ
業務ロールを登録した
Workflowサーバ
使用できる
エージェントの種類※

03-00以降
02-31
なし

03-00以降
03-00以降
6

注※　6：業務ロールトレー内案件の着信監視

3.1.3　ユーザプログラムのリコンパイル

バージョン02-xxのAgent Server環境で動作していたユーザプログラムは，バージョン03-00以降の環境ではそのままでは動作しません。リコンパイルする必要があります。05-30以前のAgent Server提供ライブラリ(※1)を使用して作成したユーザプログラムは，Windows Server 2008およびWindows Server 2012では正常に動作しないことがあります。Windows Server 2008で動作させる場合は05-80のライブラリで，Windows Server 2012で動作させる場合は05-82のライブラリで，ユーザプログラムをリコンパイルする必要があります。リコンパイルの方法については，マニュアル「Groupmax Agent Version 5リファレンス」を参照してください。

なお，ユーザプログラムのリコンパイルは，「3.1.1　Agent Serverのバージョン移行」及び「3.1.2　Workflow Agentのバージョン移行」の操作の前にしても問題ありません。

※1　<Agent Serverインストールディレクトリ>¥GroupmaxAgent¥SVlib

3.1.4　バージョンの混在

クライアント－サーバ間，及びサーバ－サーバ間でバージョンが異なる場合の接続について説明します。なお，同一マシンに，異なるバージョンのGroupmaxのプログラムを混在させることはできません。

＜この項の構成＞

(1)　クライアント－サーバ間

(2)　サーバ－サーバ間

(1)　クライアント－サーバ間

クライアント－サーバ間でバージョンが異なる場合の接続について表3-1に示します。

表3-1　クライアント－サーバ間でバージョンが異なる場合の接続

クライアント | Agent Server
Version2.0 | Version 3 | Version 5
Version2.0 | 接続できる | 接続できる※ | 接続できる※
Version 3 | 接続できない | 接続できる | 接続できる※
Version 5 | 接続できない | 接続できない | 接続できる

注※　クライアントからサーバにログイン中に接続が切れたときなどに，クライアントのIPアドレスが変更されると，接続は保証されません。DNS/DHCPを使用している場合は，注意が必要です。

(2)　サーバ－サーバ間

サーバ－サーバ間でバージョンが異なる場合の接続について表3-2に示します。

表3-2　サーバ－サーバ間でバージョンが異なる場合の接続

プラット
フォーム
プログラム
バージョン
Agent Server，Agent - Application (実行エンジン)

Windows NT
UNIX

02-31
03-00
03-10
05-00
02-31
03-00
03-10
05-00

Windows NT
Workflow Agent
02-31,03-00
03-10,05-00
○
○
○
○

Mail Agent
03-00,03-10
05-00
×
○
×
○

Document Manager Agent
03-00,03-10
05-00
×
○
×
○

Agent Server
Mail Option
02-31
○
○
○
△

03-00,03-10
05-00
△
○
△
○

Agent -
Development Kit
02-31
○
△
○
△

03-00,03-10
05-00
△
○
△
○

UNIX
Workflow Agent
02-31,03-00
03-10,05-00
○
○
○
○

Mail Agent
03-10,05-00
×
○
×
○

Document Manager Agent
03-10,05-00
×
○
×
○

Agent Server
Mail Option
02-31,03-00
○
△
○
△

03-10,05-00
△
○
△
○

Agent -
Development Kit
02-31
○
△
○
△

03-00
○
△
△
△

03-10,05-00
△
○
△
○

(凡例)

○：

使用できることを表します。ただし，プラットフォーム及びバージョンが異なる場合，サポートするエージェントが異なります。プラットフォーム及びバージョンごとにサポートしているエージェントの一覧は表3-3を参照してください。

△：

サポート機能の違いによって，使用できる機能が限られることを表します。エージェントが生存している間にサーバのIPアドレスが変更されると，エージェントの動作は保証されません。該当サーバがDNS/DHCPを使用している場合は，注意が必要です。

×：

使用できないことを表します。

プラットフォーム及びバージョンごとにサポートしているエージェントの一覧を，表3-3に示します。

表3-3　プラットフォーム及びバージョンごとにサポートしているエージェントの一覧

エージェント名称 | 02-31 | 03-00 | 03-10 | 05-00
| Windows NT，UNIX | Windows NT | UNIX | Windows NT | UNIX | Windows NT | UNIX
ユーザトレー内案件の一括新着監視（管理者用） | － | ○ | － | ○ | ○ | ○ | ○
ユーザトレー内案件の着信監視 | ○ | ○ | ○ | ○ | ○ | ○ | ○
業務ロールトレー内案件の着信監視（管理者用） | － | ○ | － | ○ | ○ | ○ | ○
ユーザトレー内案件の処期限監視（管理者用） | ○ | ○ | ○ | ○ | ○ | ○ | ○
ユーザトレー内案件の処理期限監視 | ○ | ○ | ○ | ○ | ○ | ○ | ○
サーバ上業務プログラムの自動起動（管理者用） | ○ | ○ | ○ | ○ | ○ | ○ | ○
ユーザトレー内案件の一括処理期限監視（管理者用） | － | － | － | ○ | ○ | ○ | ○
個人メールの自動返信 | － | ○ | － | ○ | ○ | ○ | ○
個人メールの自動転送 | － | ○ | － | ○ | ○ | ○ | ○
個人メール監視によるユーザプログラムの自動起動 | － | － | － | ○ | ○ | ○ | ○
条件付きフォーム文書の自動削除（管理者用） | － | ○ | － | ○ | ○ | ○ | ○
共用キャビネット内文書の自動削除（管理者用） | － | ○ | － | ○ | ○ | ○ | ○
フォーム文書監視による業務プログラムの自動起動（管理者用) | － | － | － | ○ | ○ | ○ | ○
共用キャビネット内の登録監視（管理者用) | － | － | － | － | － | ○ | ○

（凡例）○：サポートしていることを表します。

　　　　－：サポートしていないことを表します。

複数サーバで，異なるバージョンのプログラムを使用した場合，サポートエージェントの違いによって，使用できる機能が限られます。

実行エンジンのバージョンが本体部分のバージョンより新しい場合
未サポートのエージェントのテンプレートもエージェント一覧に表示されます。エージェントを登録しようとした場合に，活動ログにエラーが設定され，エージェントの登録が失敗します。
また，本体部分が，Agent - Mail Server及びAgent Document Manager Serverのバージョン03-10以前の場合，活動ログに「エージェント定義データの取得に失敗しました。処理を中断します。」が設定され，本体部分のイベントログに「KDAA01011-E　次のエージェント情報が不正なため処理を中断しました。」が出力されます。

実行エンジンのバージョンが本体部分のバージョンより古い場合
未サポートのエージェントのテンプレートはエージェント一覧に表示されないため，これらのエージェントを操作できません。

3.2　Agent Serverのインストールと環境設定

この節では，Agent Serverのインストール及び環境設定の方法について説明します。インストール時には，起動中のGroupmax Agentのサービスやイベントビューアなどのプログラムを終了させておいてください。

なお，インストールしたプログラムを削除する方法については，「付録B　プログラムを削除する方法」を参照してください。

＜この節の構成＞

3.2.1　Agent Serverのインストール

3.2.2　Agent Serverの環境設定

3.2.1　Agent Serverのインストール

御使用のマシン環境によって，インストール手順が異なりますので注意してください。Agent Serverのインストール手順を図3-1に示します。

図3-1　Agent Serverのインストール

Groupmax Mailと同じマシンにインストールする場合，又はGroupmax Mailを使用しない場合
Agent Serverだけをインストールします。
Agent Serverは，Groupmax Agentの基本プログラムです。上書きしてインストールしても，ユーザが登録したエージェントが格納されているフォルダ（ディレクトリ），クライアント用のテンプレートが格納されているフォルダ（ディレクトリ）及びAgent Serverのシステム環境に関する設定はそのまま残ります。

Groupmax Mailと別のマシンにインストールする場合
Agent Server及びAgent Server Mail Optionをインストールします。
Agent Server Mail Optionは，Groupmax Agentのメール送信ライブラリです。Agent Server Mail Optionは，Groupmax Mail Serverがインストールされているマシンにインストールします。Agent Serverと同じマシンにはインストールできません。

＜この項の構成＞

(1)　Groupmax Mailと同じマシンにインストールする場合，又はGroupmax Mailを使用しない場合

(2)　Groupmax Mailと別のマシンにインストールする場合

(1)　Groupmax Mailと同じマシンにインストールする場合，又はGroupmax Mailを使用しない場合

次の手順でAgent Serverだけをインストールすれば操作は完了です。

Administratorの権限でWindows NTにログオンします。

日立総合インストーラ（HCD_INST.EXE）を起動します。

インストールプログラムの画面に従って作業を進め，インストールする製品を選択するためのダイアログが表示されたら，インストールするサーバセット製品名を選択します。
サーバセット製品をインストールするGroupmax統合インストーラが起動されます。

「標準」か「カスタム」を選択します。
「標準」を選択すると，サーバセットの構成製品のインストールを開始します。
「カスタム」を選択すると，インストールする製品を選択するためのダイアログが表示されます。

4.で「カスタム」を選択した場合は「Groupmax Agent Server Version 5」を選択して実行します。
会社名及び個人名を入力するためのダイアログが表示されます。
ただし，既にAgent Server Mail Optionがインストールされている場合は，インストールを継続できない旨のメッセージが表示されます。Agent Server Mail Optionを削除して，1.の手順から操作し直してください。

会社名及び個人名を入力して［開始］ボタンをクリックします。
インストール先を指定する画面が表示されます。

インストール先フォルダ（ディレクトリ）を指定して［続行］ボタンをクリックします。
インストールが開始されて，ファイルのコピー経過を示すダイアログが表示されます。ただし，次の場合は，ファイルのコピー経過を示すダイアログの前に問い合わせのダイアログが表示されます。

・指定したフォルダ（ディレクトリ）がない場合

新規に作成するかどうか問い合わせる画面が表示されます。新規に作成しても問題ない場合は［はい］ボタンをクリックしてください。

・既にAgent Serverがインストールされている場合

プログラムをインストールするか削除するかを問い合わせるダイアログが表示されます。インストールしてよければ［はい］ボタンをクリックしてください。

［はい］ボタンをクリックすると，必要なディスク空き容量を示し，インストール先フォルダ（ディレクトリ）を確認するダイアログが表示されます。どちらもインストールに問題なければ［続行］ボタンをクリックしてください。上書きインストールの場合は，インストール先フォルダ（ディレクトリ）を変更できません。

インストールが終了すると，環境設定をしてからAgent Serverを起動してくださいという旨のメッセージが表示されます。［ＯＫ］ボタンをクリックします。
インストールが終了した旨のメッセージが表示されます。

［終了］ボタンをクリックします。
これでインストールは終了です。

Agent Serverのインストールが終了したら，運用を開始する前に環境設定をする必要があります。環境設定の方法については「3.2.2　Agent Serverの環境設定」を参照してください。

(2)　Groupmax Mailと別のマシンにインストールする場合

（1）の手順でAgent Serverをインストールします。さらに，Groupmax Mail Serverと同じマシンにAgent Server Mail Option（Agentメール送信ライブラリ）をインストールします。

Agent Server Mail Optionのインストールは，Agent Serverと同様の手順でインストールプログラムの画面に従って操作し，4.のインストール方法で「カスタム」を選択します。インストールする製品を選択するダイアログが表示されたら，「Groupmax Agent Server Mail Option Version 5」を選択して実行します。

Agent Server Mail Optionを使用できるようにするには，インストール後にservicesファイルの設定が必要です。

3.2.2　Agent Serverの環境設定

Agent Serverのインストール後，運用を開始する前に環境設定が必要です。初めてAgent Serverを運用する場合，及び環境を再設定する場合は，次の1.～4.の設定をしてください。

servicesファイルの設定

システム環境の設定（メール環境の設定とシステム情報の初期化）

クライアントの環境設定

Object Serverの環境設定

Agent Serverがインストールされているマシンのservicesファイル，及びメール環境については，Groupmax Server Setup Wizardを使って設定することもできます。Groupmax Server Setup Wizardを使った設定の流れは「3.2.2(5)　Groupmax Server Setup Wizardを使った設定の流れ」で説明します。

なお，バージョンアップして旧バージョンの環境をそのまま使用する場合の操作及び注意事項については，「3.1　バージョンの移行・混在に関する注意」を参照してください。

＜この項の構成＞

(1)　servicesファイルの設定

(2)　システム環境の設定

(3)　クライアントの環境設定

(4)　Object Serverの環境設定

(5)　Groupmax Server Setup Wizardを使った設定の流れ

(1)　servicesファイルの設定

Agent Serverがインストールされているマシンのservicesファイルに，次の内容を追加してください。servicesファイルはWindowsシステムフォルダ（ディレクトリ）¥system32¥drivers¥etcに格納されています。

agcscom   20027/tcp
agsvrcon  20028/tcp
aggml     20039/tcp

Agent ServerをGroupmax Mail Serverと別のマシンにインストールした場合は，Groupmax Mail Serverがインストールされているマシンのservicesファイルに次の内容を追加してください。

agsvrcon  20028/tcp
aggml     20039/tcp

なお，これらのservicesファイルは，Groupmaxサーバ環境設定ユティリティを使って設定することもできます。Groupmaxサーバ環境設定ユティリティの操作方法は，マニュアル「Groupmax Object Server Version 6 システム管理者ガイド」を参照してください。

(2)　システム環境の設定

Agent Serverの運用コマンド及び管理ツールを使用してメール環境の設定及びシステム情報の初期化をします。

Agent Serverの運用コマンドの使用方法については，「5.2　Agent Serverの運用コマンド」を参照してください。また，管理ツールによるメール環境の設定については「5.6.4　メールに関する情報を参照・更新する」を，システム情報の初期化については「5.6.5　システム情報を初期化する」を参照してください。

(a)　電子メール環境の設定

Agent Server管理ツールを使用して電子メール環境を設定します。電子メール環境を設定する場合は，接続するメールサーバのホスト名又はIPアドレスをあらかじめ調べておいてください。また，メールを送信するエージェントを利用した場合のメールの送付元名称を決めておいてください。

Administrator権限でWindows NTにログオンします。

コマンドプロンプト画面を表示します。
フォルダ（ディレクトリ）をインストール先フォルダ（ディレクトリ）¥GroupmaxAgent¥SVbinに移動します。

「agmgr」と入力してリターンキーを押します。

Agent Serverの管理ツールのメインメニューで「Command:」の後に「2」を入力します。

システム情報を参照・更新するためのメニューで「Setup:」の後に「4」を入力します。

メールに関する設定メニューで「Change?(y/n[default]):」の後に「y」を入力します。

使用するメール環境に関して次の情報を設定します。

E-mail use? y/n

E-mail（SMTP）を使用するかどうかを指定します。使用する場合は「y」，使用しない場合は「n」を入力します。

E-mail Server host name

E-mailサーバのホスト名又はIPアドレスを入力します。

Mail sender name

E-mailの送信者名称を入力します。この場合の送信者とは，メールを送信するエージェントを動作させた場合のメールの送付元です。

E-mail送信者の送受信トレーの不要メールはそのまま残りますので，削除してください。

Groupmax Mail use? y/n

Groupmax Mailを使用するかどうかを指定します。使用する場合は「y」，使用しない場合は「n」を入力します。

Mail Server host name

Groupmax Mailサーバのホスト名又はIPアドレスを入力します。

UserID

Agent ServerがGmax MailにログインするためのユーザIDを入力します。

Groupmax MailにログインするためのユーザIDは，そのユーザIDの送受信トレーのメールがすべて削除されるため，エージェント用のIDを指定します。

設定が終わったら，「OK?(y/n[default]):」の後に「y」を入力します。
次にシステム情報を初期化します。

(b)　システム情報の初期化

システム情報を設定するためのメニューに戻ったら「Setup:」の後に「5」を入力します。

「Groupmax Agent Server initialize OK? y/n(default):」の後に「y」を入力します。
これで，システム情報の初期化が終わりました。

注意事項

上書きインストールの場合は，この初期化操作をすると，これまで登録されているエージェントがすべて消去されます。

(3)　クライアントの環境設定

クライアントでテンプレートを使用してサーバエージェントを生成する場合，Agent Clientはエージェント生成のために次のファイルを必要とします。

テンプレート定義ファイル（クライアント用の定義画面）

定義画面で使用する詳細ダイアログのDLLファイル

使用したことのないテンプレートを初めて使用する場合，通常クライアント環境にはこれらのファイルがないため，Agent ClientはこれらのファイルをAgent Serverからダウンロードします。しかし，既にクライアント環境にこれらのファイルがあれば，Agent ClientはAgent Serverからのダウンロードをしません。

したがって，あらかじめクライアントが使用するファイルをAgent ServerからAgent Clientにコピーしておけば，テンプレート使用時のファイルのダウンロードを回避することができます。これは，システム導入時に多数のクライアントからのファイルのダウンロードを回避しサーバの負荷を軽減するのに有効です。

ただし，Agent Clientにコピーしたファイルの更新日時又はサイズがAgent Server側と異なる場合，Agent Clientにあるファイルは使用されません。Agent Serverからダウンロードしたファイルが使用されます。

ファイルのダウンロードを回避するためには，次のAgent ServerのファイルをAgent Clientにコピーしておいてください。なお，Agent Serverのファイルは各Agentの実行エンジンからコピーしておく必要があります。

(a)　テンプレート定義ファイルのコピー

システムテンプレート

Agent Server(コピー元)：＜GmaxAgentDir＞※１¥SVtmp¥templateV3※４¥＜テンプレートファイル＞

Agent Client(コピー先)：＜TransDir＞※２¥template¥system¥＜テンプレートファイル＞

ユーザカスタマイズテンプレート(共通)

Agent Server(コピー元)：＜CustomDir＞※３¥commonV3※４¥＜テンプレートファイル＞

Agent Client(コピー先)：＜TransDir＞※２¥template¥shared¥＜テンプレートファイル＞

ユーザカスタマイズテンプレート(個人用)

Agent Server(コピー元)：＜CustomDir＞※３¥usersV3※４¥＜ユーザID＞¥＜テンプレートファイル＞

Agent Client(コピー先)：＜TransDir＞※２¥template¥users¥＜ユーザID＞¥＜テンプレートファイル＞

(b)　詳細ダイアログのDLLファイルのコピー

システムテンプレート詳細ダイアログのDLL

Agent Server(コピー元)：＜GmaxAgentDir＞※１¥SVtmp¥templateV3※４¥library¥＜詳細ダイアログDLL＞

Agent Client(コピー先)：＜TransDir＞※２¥library¥system¥＜詳細ダイアログDLL＞

ユーザカスタマイズテンプレート(共通)詳細ダイアログのDLL

Agent Server(コピー元)：＜CustomDir＞※３¥commonV3※４¥library¥＜詳細ダイアログDLL＞

Agent Client(コピー先)：＜TransDir＞※２¥library¥shared¥＜詳細ダイアログDLL＞

ユーザカスタマイズテンプレート(個人用)詳細ダイアログのDLL

Agent Server(コピー元)：＜CustomDir＞※３¥usersV3※４¥＜ユーザID＞¥library¥＜詳細ダイアログDLL＞

Agent Client(コピー先)：＜TransDir＞※２¥library¥users¥＜ユーザID＞¥＜詳細ダイアログDLL＞

注※1　＜GmaxAgentDir＞：Agent Serverインストールフォルダ(ディレクトリ)

注※2　＜TransDir＞：ファイル転送用フォルダ(ディレクトリ)

これは，＜Groupmaxインストールフォルダ(ディレクトリ)＞¥Agent¥Tmpに設定されています。

注※3　＜CustomDir＞：ユーザカスタマイズファイル用フォルダ(ディレクトリ)

詳細は，「5.6.3　フォルダ（ディレクトリ）情報を参照・更新する」を参照してください。

手動で「usersV3フォルダ（ディレクトリ）および「usersV3¥ユーザIDフォルダ（ディレクトリ）」を作成する必要があります。

注※4　クライアントのバージョンが02-31の場合は，コピー元はそれぞれ次のフォルダ（ディレクトリ）名となります。

手動で「usersフォルダ（ディレクトリ）および「users¥ユーザIDフォルダ（ディレクトリ）」を作成する必要があります。

templateV3 → template

commonV3 → common

usersV3 → users

(4)　Object Serverの環境設定

システム共通定義ファイルのprc_process_countとtrn_tran_process_countに，1（Agent Serverが使用する分）を加えてください。なお，すでにprc_process_countとtrn_tran_process_countに最大値が設定されている場合には値を変更しないで，他製品のチューニングによって追加した分を-1するよう他製品のチューニングを見直してください。

Agent Server Mail Option（Agentメール送信ライブラリ）を使用している場合は，インストールしたマシンに対して，Agent Serverと同様の設定が必要です。Agentメール送信ライブラリが使用する分のシステム共通定義ファイルのprc_process_countとtrn_tran_process_countは1となります。

注意事項

運用中におけるObject Serverへの接続プロセス数は，xodpinfoコマンドで確認することができます。運用中にObject Serverへの接続数を定期的に確認してObject Serverへの接続数を確認してください。接続数がprc_process_countとtrn_tran_process_countで定義した接続数に満たない場合（Agent Serverの接続数の1が余っている場合）には，他製品のチューニングの見直しは必要ありません。

(5)　Groupmax Server Setup Wizardを使った設定の流れ

Groupmax Server Setup Wizardを使った設定の流れを次に示します。なお，Groupmax Server Setup Wizardの操作方法は，マニュアル「Groupmax Version6iサーバ環境設定ガイド」を参照してください。

Agent Server及びagmgrコマンドが動作している場合は，これらを終了します。

Groupmax Server Setup Wizardを起動します。

Groupmax Server Setup Wizardのダイアログに表示されるポート番号，メール環境，システム情報などの項目を設定します。

Groupmax Server Setup Wizardを終了します。

クライアントの環境設定をします。設定方法は「3.2.2(3)　クライアントの環境設定」を参照してください。

なお，初期設定時だけでなく，運用開始後でもGroupmax Server Setup Wizardを使って次の情報の変更ができます。

Agent Serverのスケジューラ情報，定義情報，フォルダ情報，メール情報，

システム情報

運用開始後に変更する場合は，Agent Server及びagmgrコマンドを停止してからGroupmax Server Setup Wizardを起動してください。

3.3　Workflow Agentのインストールと環境設定

Workflow Agentが提供する各エージェントを使用する場合は，Workflow Agentのインストール，及び環境設定が必要です。この節では，Workflow Agentのインストール，及び環境設定の方法について説明します。インストール時には，起動中のGroupmax Agentのサービスやイベントビューアなどのプログラムを終了させておいてください。

なお，インストールしたプログラムを削除する方法については，「付録B　プログラムを削除する方法」を参照してください。

＜この節の構成＞

3.3.1　Workflow Agentのインストール

3.3.2　Workflow Agentの環境設定

3.3.1　Workflow Agentのインストール

Workflow Agentを使用するためには，次の三つのプログラムをインストールする必要があります。Workflow Agentのインストールを図3-2に示します。

図3-2　Workflow Agentのインストール

Agent - Workflow Server

Workflow Agentの本体です。Workflow Serverがインストールされているマシンにインストールします。

上書きしてインストールしても，システム情報に関する設定はそのまま残ります。

Agent - Workflow Function

Workflow Agentの実行エンジン及びテンプレートファイルです。Agent Serverがインストールされているマシンにインストールします。Agent ServerとWorkflow Serverが同じマシンにあっても，Agent - Workflow Functionはインストールしてください。

Groupmax Workflow Server - Library

Groupmax Workflow Serverと連携するために使用します。Groupmax Workflow Serverがインストールされているマシンにインストールします。

＜この項の構成＞

(1)　 Workflow Agent本体（Agent - Workflow Server）をインストールする

(2)　 Workflow Agent実行エンジン（Agent - Workflow Function）をインストールする

(1)　 Workflow Agent本体（Agent - Workflow Server）をインストールする

Workflow ServerがインストールされているマシンにWorkflow Agent本体をインストールします。

Administratorの権限でWindows NTにログオンします。

日立総合インストーラ（HCD_INST.EXE）を起動します。

インストールプログラムの画面に従って作業を進め，インストールする製品を選択するためのダイアログが表示されたら，「Groupmax Agent - Application Version 6」を選択します。
Groupmax統合インストーラが起動されます。

「標準」か「カスタム」を選択します。
「標準」を選択すると，「Groupmax Agent - Application Version 6」の構成製品のインストールを開始します。
「カスタム」を選択すると，インストールするアプリケーションを選択するためのダイアログが表示されます。

4.で「カスタム」を選択した場合，「Groupmax Agent - Workflow Server Version 5」を選択して実行します。
会社名及び個人名を入力するためのダイアログが表示されます。

会社名及び個人名を入力して［開始］ボタンをクリックします。
インストール先を指定する画面が表示されます。

インストール先フォルダ（ディレクトリ）を指定して［続行］ボタンをクリックします。
インストールが開始されて，ファイルのコピー経過を表示するダイアログが表示されます。
ただし，次の場合は，コピー経過を表示するダイアログの前に更に問い合わせのダイアログが表示されます。

・指定したフォルダ（ディレクトリ）が存在しない場合

新しく作成するかどうか問い合わせる画面が表示されます。新しく作成しても問題ない場合は［はい］ボタンをクリックしてください。

・既にWorkflow Agentがインストールされている場合

プログラムをインストールするか削除するかを問い合わせるダイアログが表示されます。インストールしてよければ［はい］ボタンをクリックしてください。

［はい］ボタンをクリックすると，必要なディスク空き容量を示し，インストール先フォルダ（ディレクトリ）を確認するダイアログが表示されます。どちらもインストールに問題なければ［続行］ボタンをクリックしてください。

なお，上書きインストールの場合は，インストール先フォルダ（ディレクトリ）を変更できません。

インストールが終了すると，インストールが終了した旨のメッセージが表示されます。［終了］ボタンをクリックします。
これでWorkflow Agent本体のインストールは終了です。次に，Workflow Agent実行エンジンをインストールします。

(2)　 Workflow Agent実行エンジン（Agent - Workflow Function）をインストールする

Agent ServerがインストールされているマシンにWorkflow Agent実行エンジンをインストールします。インストール手順はWorkflow Agent本体と同じです。インストールするアプリケーションを選択するためのダイアログが表示されたら，「Groupmax Agent - Workflow Function Version 5」を選択してください。

Workflow Agentを起動して運用を開始するためには，この後，環境設定をする必要があります。

3.3.2　Workflow Agentの環境設定

Workflow Agentの環境設定では，次の項目を設定します。初めてWorkflow Agentを運用する場合は，次の1.～4.を設定してください。バージョンアップして旧バージョンの環境を使用する場合は，2.～5.を設定してください。なお，3.～4.については，利用するエージェントの種類に応じて設定が必要になります。

servicesファイルの設定

Workflow Agent実行エンジンからAgent Serverへのファイルの登録

ユーザID一覧ファイルの作成

ユーザID・E-mailアドレス対応ファイルの作成

エージェント定義の変換

なお，バージョンアップして旧バージョンの環境をそのまま使用する場合の注意事項については，「3.1　バージョンの移行・混在に関する注意」を参照してください。

＜この項の構成＞

(1)　servicesファイルの設定

(2)　 Workflow Agent実行エンジン（Agent - Workflow Function）からAgent Serverへのファイルの登録

(3)　ユーザID一覧ファイルの作成

(4)　ユーザID・E-mailアドレス対応ファイルの作成

(5)　エージェント定義の変換

(1)　servicesファイルの設定

Workflow Agent本体がインストールされているマシンのservicesファイルに次の内容を追加してください。

agsvrcon 20028/tcp

gmaxwasrv 20026/tcp

次に，Workflow Agent実行エンジンがインストールされているマシンのservicesファイルに次の内容を追加してください。

gmaxwasrv 20026/tcp

なお，これらのservicesファイルは，Groupmaxサーバ環境設定ユティリティを使って設定することもできます。Groupmaxサーバ環境設定ユティリティの操作方法は，マニュアル「Groupmax Object Server Version 6 システム管理者ガイド」を参照してください。

(2)　 Workflow Agent実行エンジン（Agent - Workflow Function）からAgent Serverへのファイルの登録

エージェントを一般ユーザが使用できるようにするために，各エージェントが提供する次の定義ファイルをAgent Serverにコピーしてください。

以下に記すV2クライアント，V3クライアントとはI-DesktopのV2，V3を示します。また，V3クライアント用のファイルはV3クライアント以降でも共通のファイルとなります。

(a)　V2クライアントを使用する場合（V2提供機能だけ使用可となる）

Workflow Agent実行エンジンの次のファイルをAgent Serverにコピーしてください。

詳細ダイアログDLLファイルの登録

（コピー元）

＜WorkflowAgentDir＞※１¥SVtmp¥template¥library¥agtdlg.dll

＜WorkflowAgentDir＞※１¥SVtmp¥template¥library¥wfagtdlg.dll

（コピー先）

＜GmaxAgentDir＞※２¥SVtmp¥template¥library

ヘルプファイルの登録

（コピー元）

＜WorkflowAgentDir＞※１¥SVtmp¥help¥gmwfagt.hlp

＜WorkflowAgentDir＞※１¥SVtmp¥help¥gmwfagt.cnt

（コピー先）

＜GmaxAgentDir＞※２¥SVtmp¥help

テンプレート定義データの登録

（コピー元）

＜WorkflowAgentDir＞※１¥SVtmp¥template¥wfalmtad.htm（トレー内処理期限監視（管理者用）エージェント）

＜WorkflowAgentDir＞※１¥SVtmp¥template¥wfalmtps.htm（トレー内処理期限監視エージェント）

＜WorkflowAgentDir＞※１¥SVtmp¥template¥wfalmtwt.htm（案件の着信監視エージェント）

＜WorkflowAgentDir＞※１¥SVtmp¥template¥wfaexup.htm（サーバ上業務プログラムの起動エージェント）

（コピー先）

＜GmaxAgentDir＞※２¥SVtmp¥template

注※1　＜WorkflowAgentDir＞：Workflow Agentインストールフォルダ（ディレクトリ）

注※2　＜GmaxAgentDir＞：Agent Serverインストールフォルダ（ディレクトリ）

ただし，上記のテンプレートを特定ユーザだけに使用できるようにする（例えばwfalmtad.htmを管理者だけが使用できるようにする）には，上記のディレクトリにコピーしないで，「ユーザカスタマイズファイル用フォルダ（ディレクトリ）¥users¥テンプレートを使用するユーザのユーザID」にコピーします。ユーザカスタマイズファイル用フォルダ（ディレクトリ）を参照する場合は，「5.6.3　フォルダ（ディレクトリ）情報を参照・更新する」を参照するか，テンプレートの開発者に問い合わせてください。

注意事項

これらの設定の後でAgent Serverを削除した場合，上記のファイルは削除されます（ただし，ユーザカスタマイズファイル用フォルダ（ディレクトリ）のファイルは削除されません）。Agent Serverを再インストールした場合，上記のファイルを再度コピーする必要があります。

(b)　V3クライアント以降を使用する場合

Workflow Agent実行エンジンの次のファイルをAgent Serverにコピーしてください。

詳細ダイアログDLLファイルの登録

（コピー元）

＜WorkflowAgentDir＞※１¥SVtmp¥templateV3¥library¥agtdlg.dll

＜WorkflowAgentDir＞※１¥SVtmp¥templateV3¥library¥wadlg.dll

＜WorkflowAgentDir＞※１¥SVtmp¥templateV3¥library¥wfagtdlg.dll

（コピー先）

＜GmaxAgentDir＞※２¥SVtmp¥templateV3¥library

ヘルプファイルの登録

（コピー元）

＜WorkflowAgentDir＞※１¥SVtmp¥helpV3¥gmwfagt.hlp

＜WorkflowAgentDir＞※１¥SVtmp¥helpV3¥gmwfagt.cnt

（コピー先）

＜GmaxAgentDir＞※２¥SVtmp¥helpV3

テンプレート定義データの登録

（コピー元）

＜WorkflowAgentDir＞※１¥SVtmp¥templateV3¥wfalmtad.htm（トレー内処理期限監視（管理者用）エージェント）

＜WorkflowAgentDir＞※１¥SVtmp¥templateV3¥wfalmtps.htm（トレー内処理期限監視エージェント）

＜WorkflowAgentDir＞※１¥SVtmp¥templateV3¥wfalmtwt.htm（案件の着信監視エージェント）

＜WorkflowAgentDir＞※１¥SVtmp¥templateV3¥wfaexup.htm（サーバ上業務プログラムの自動起動エージェント）

＜WorkflowAgentDir＞※１¥SVtmp¥templateV3¥wfaarval.htm（ユーザトレー内案件の一括新着監視（管理者用）エージェント）

＜WorkflowAgentDir＞※１¥SVtmp¥templateV3¥wfaarvrl.htm（業務ロールトレー内案件の着信監視（管理者用）エージェント）

＜WorkflowAgentDir＞※１¥SVtmp¥templateV3¥wfaarvtl.htm（ユーザトレー内案件の一括処理期限監視（管理者用）エージェント）

（コピー先）

＜GmaxAgentDir＞※２¥SVtmp¥templateV3

注※1　＜WorkflowAgentDir＞：Workflow Agent実行エンジンのインストールフォルダ（ディレクトリ）

注※2　＜GmaxAgentDir＞：Agent Serverインストールフォルダ（ディレクトリ）

ただし，上記のテンプレートを特定のユーザだけに使用できるようにする（管理者用のテンプレートを管理者だけが使用できるようにする）には，上記のディレクトリにコピーしないで，「ユーザカスタマイズファイル用フォルダ（ディレクトリ）¥usersV3¥テンプレートを使用するユーザのユーザID」にコピーします。ユーザカスタマイズファイル用フォルダ（ディレクトリ）を参照する場合は，「5.6.3　フォルダ（ディレクトリ）情報を参照・更新する」を参照するか，テンプレートの開発者に問い合わせてください。

注意事項

これらの設定の後でAgent Serverを削除した場合，上記のファイルは削除されます（ただし，ユーザカスタマイズファイル用フォルダ（ディレクトリ）のファイルは削除されません）。Agent Serverを再インストールした場合，上記のファイルを再度コピーする必要があります。

(3)　ユーザID一覧ファイルの作成

ユーザID一覧ファイルは，次のエージェントで監視の対象となるユーザをユーザIDで選択する場合に必要なファイルです。

ユーザトレー内案件の新着を一括監視するエージェント

ユーザトレー内案件の処理期限を一括監視するエージェント

ユーザID一覧ファイルは，Workflow Agentの運用コマンドを使用して作成します。ユーザID一覧ファイルの作成の詳細については「6.2.2　ユーザID一覧ファイルの作成と参照（waulist）」を参照してください。

ユーザID一覧ファイルの作成手順について説明します。

CSV形式でユーザ作成ファイルを作成します。
CSV形式のユーザ作成ファイルは次のどちらかの方法で作成してください。

Excelなどを使用してユーザIDをファイルに設定します。次に，このファイルをCSV(Comma Separated Value)形式で格納します。

Groupmax Address Server 一括登録ユティリティを使用して，ユーザID一覧が格納されているユーザ作成ファイルを作成します。Groupmax Address Server 一括登録ユティリティについては，マニュアル「Groupmax Address/Mail Version 7 システム管理者ガイド　ユティリティ編」を参照してください。

ユーザID一覧ファイルを作成します。
Workflow Agentの運用コマンド「waulist」を実行して，1.で作成したユーザ作成ファイルからユーザID一覧ファイルを作成します。

作成したユーザID一覧ファイルをワークフローサーバへ転送します。
ユーザID一覧ファイルは，エージェントサーバ側，ワークフローサーバ側のどちらでも作成できるので，ワークフローサーバとは異なるマシン上でユーザID一覧ファイルを作成した場合は，FTPなどを使用してワークフローサーバの任意のフォルダ（ディレクトリ）に転送してください。

(4)　ユーザID・E-mailアドレス対応ファイルの作成

ユーザID・E-mailアドレス対応ファイルは，次に示すエージェントで監視結果をE-mail（SMTP）で通知する場合に必要なファイルです。

ユーザトレー内案件の新着を一括監視するエージェント

業務ロールトレー内案件の着信を監視するエージェント

ユーザトレー内案件の処理期限を一括監視するエージェント

ユーザID・E-mailアドレス対応ファイルは，Workflow Agentの運用コマンドを使用して作成します。ユーザID・E-mailアドレス対応ファイルの作成の詳細については「6.2.3　ユーザID・E-mailアドレス対応ファイルの作成と参照（waemtbl）」を参照してください。

ユーザID・E-mailアドレス対応ファイルの作成手順について説明します。

CSV形式のユーザ作成ファイルを作成します。
CSV形式のユーザ作成ファイルは次のどちらかの方法で作成してください。

Excelなどを使用してユーザIDとE-mailアドレスをファイルに設定します。次に，このファイルをCSV形式で格納します。

Groupmax Address Server 一括登録ユティリティを使用して，ユーザIDとE-mailアドレスの一覧が格納されているユーザ作成ファイルを作成します。Groupmax Address Server 一括登録ユティリティに関してはマニュアル「Groupmax Address/Mail Version 7システム管理者ガイド　ユティリティ編」を参照してください。

ユーザID・E-mailアドレス対応ファイルを作成します。
Workflow Agentの運用コマンド「waemtbl」を実行して，1.で作成したユーザ作成ファイルから，ユーザID・E-mailアドレス対応ファイルを作成します。

作成したユーザID・E-mailアドレス対応ファイルをワークフローサーバへ転送します。
ユーザID・E-mailアドレス対応ファイルは，エージェントサーバ側，ワークフローサーバ側のどちらでも作成できるので，ワークフローサーバとは異なるマシン上でユーザID・E-mailアドレス対応ファイルを作成した場合は，FTPなどを使用してワークフローサーバの任意のフォルダ（ディレクトリ）に転送してください。

(5)　エージェント定義の変換

Workflow Agentをバージョンアップした後で，旧バージョンのエージェント定義情報をそのまま使用したい場合は，Workflow Agentの運用コマンドを使用してエージェント定義を05-00用に変換してください。

Administratorの権限でWindows NTにログオンします。

コマンドプロンプト画面を表示します。

フォルダ（ディレクトリ）をインストール先フォルダ（ディレクトリ）¥WorkflowAgent¥SVbinに移動します。

「waconv」と入力してリターンキーを押します。
エージェント定義情報が変換されます。
ディスク容量が不足している場合は，容量が不足している旨のメッセージが表示されます。この場合，エージェント定義は変換されません。

なお，Workflow Agentの運用コマンドについては，「6.2　Workflow Agentの運用コマンド」を参照してください。

3.4　Mail Agentのインストールと環境設定

Mail Agentが提供する各エージェントを使用する場合は，Mail Agentのインストール，及び環境設定が必要です。この節では，Mail Agentのインストール，及び環境設定の方法について説明します。インストール時には，起動中のGroupmax Agentのサービスやイベントビューアなどのプログラムを終了させておいてください。

なお，インストールしたプログラムを削除する方法については，「付録B　プログラムを削除する方法」を参照してください。

＜この節の構成＞

3.4.1　Mail Agentのインストール

3.4.2　Mail Agentの環境設定

3.4.1　Mail Agentのインストール

Mail Agentを使用するためには，次の二つをインストールする必要があります。Mail Agentのインストールを図3-3に示します。

図3-3　Mail Agentのインストール

Agent - Mail Server

Mail Agentの本体です。エージェントを動作させたいユーザが登録されているMail Serverがインストールされているマシンにインストールします。

Agent - Mail Function

Mail Agentの実行エンジン及びテンプレートファイルです。Agent Serverがインストールされているマシンにインストールします。Agent ServerとMail Serverが同じマシンにある場合でも，Agent - Mail Functionはインストールしてください。

＜この項の構成＞

(1)　 Mail Agent本体（Agent - Mail Server）をインストールする

(2)　 Mail Agent実行エンジン（Agent - Mail Function）をインストールする

(1)　 Mail Agent本体（Agent - Mail Server）をインストールする

Mail ServerがインストールされているマシンにMail Agent本体をインストールします。

Administratorの権限でWindows NTにログオンします。

日立総合インストーラ（HCD_INST.EXE）を起動します。

インストールプログラムの画面に従って作業を進め，インストールする製品を選択するためのダイアログが表示されたら，「Groupmax Agent - Application Version 6」を選択します。
Groupmax統合インストーラが起動されます。

「標準」か「カスタム」を選択します。
「標準」を選択すると，「Groupmax Agent - Application Version 6」の構成製品のインストールを開始します。
「カスタム」を選択すると，インストールするアプリケーションを選択するためのダイアログが表示されます。

4.で「カスタム」を選択した場合，「Groupmax Agent - Mail Server Version 6」を選択して実行します。
会社名及び個人名を入力するためのダイアログが表示されます。

会社名及び個人名を入力して［開始］ボタンをクリックします。
インストール先を指定する画面が表示されます。

インストール先フォルダ（ディレクトリ）を指定して［続行］ボタンをクリックします。
インストールが開始されて，ファイルのコピー経過を表示するダイアログが表示されます。
ただし，次の場合は，コピー経過を表示するダイアログの前に更に問い合わせのダイアログが表示されます。

・指定したフォルダ（ディレクトリ）がない場合

新しく作成するかどうか問い合わせる画面が表示されます。新しく作成しても問題ない場合は［はい］ボタンをクリックしてください。

・既にMail Agent本体がインストールされている場合

プログラムをインストールするか削除するかを問い合わせるダイアログが表示されます。インストールしてよければ［はい］ボタンをクリックしてください。上書きしてインストールしても，システム環境に関する設定はそのまま残ります。

［はい］ボタンをクリックすると，必要なディスク空き容量を示し，インストール先フォルダ（ディレクトリ）を確認するダイアログが表示されます。どちらもインストールに問題なければ［続行］ボタンをクリックしてください。

なお，上書きインストールの場合は，インストール先フォルダ（ディレクトリ）を変更できません。

インストールが終了すると，インストールが終了した旨のメッセージが表示されます。［終了］ボタンをクリックします。
これでMail Agent本体のインストールは終了です。次に，Mail Agent実行エンジンをインストールします。

(2)　 Mail Agent実行エンジン（Agent - Mail Function）をインストールする

Agent ServerがインストールされているマシンにMail Agent実行エンジン（Agent - Mail Function）をインストールします。インストール手順はMail Agent本体と同じです。インストールするアプリケーションを選択するためのダイアログが表示されたら，「Groupmax Agent - Mail Function Version 6」を選択してください。

Mail Agentを起動して運用を開始するためには，インストール後に環境設定をする必要があります。

3.4.2　Mail Agentの環境設定

Mail Agentの環境設定では，次の項目を設定します。

servicesファイルの設定

Mail Agent実行エンジンからAgent Serverへのファイルの登録

システム情報の初期化

Object Serverの環境設定

＜この項の構成＞

(1)　servicesファイルの設定

(2)　 Mail Agent実行エンジン（Agent - Mail Function）からAgent Serverへのファイルの登録

(3)　システム情報の初期化

(4)　Object Serverの環境設定

(1)　servicesファイルの設定

Mail Agent本体がインストールされているマシンのWindows¥system32¥drivers¥etcにあるservicesファイルに次の内容を追加してください。

agsvrcon      20028/tcp
gmaxmasrv     20081/tcp
gmaxmafsrv    20082/tcp

また，Mail Agent実行エンジンがインストールされているマシンのWindows¥system32¥drivers¥etcにあるservicesファイルに次の内容を追加してください。

gmaxmasrv    20081/tcp
gmaxmafsrv   20082/tcp

なお，これらのservicesファイルは，Groupmaxサーバ環境設定ユティリティを使って設定することもできます。Groupmaxサーバ環境設定ユティリティの操作方法は，マニュアル「Groupmax Object Server Version 6 システム管理者ガイド」を参照してください。

(2)　 Mail Agent実行エンジン（Agent - Mail Function）からAgent Serverへのファイルの登録

Mail Agentの提供する各エージェントを一般ユーザが使用できるようにするために，次のファイルをAgent Serverにコピーしてください。

詳細ダイアログDLLファイルの登録

（コピー元）

＜MailAgentDir＞※１¥SVtmp¥template¥library¥agtdlg.dll

＜MailAgentDir＞※１¥SVtmp¥template¥library¥madlg.dll

（コピー先）

＜GmaxAgentDir＞※２¥SVtmp¥templateV3¥library

ヘルプファイルの登録

（コピー元）

＜MailAgentDir＞※１¥SVtmp¥help¥gmwfagt.hlp

＜MailAgentDir＞※１¥SVtmp¥help¥gmwfagt.cnt

（コピー先）

＜GmaxAgentDir＞※２¥SVtmp¥helpV3

テンプレート定義データの登録

（コピー元）

＜MailAgentDir＞※１¥SVtmp¥template¥MAPMRE.htm（個人メールの自動返信エージェント）

＜MailAgentDir＞※１¥SVtmp¥template¥MAPMFW.htm（個人メールの自動転送エージェント）

＜MailAgentDir＞※１¥SVtmp¥template¥MAPMUPEX.htm（個人メール監視によるユーザプログラムの自動起動エージェント）

（コピー先）

＜GmaxAgentDir＞※２¥SVtmp¥templateV3

注※1　＜MailAgentDir＞：Mail Agent実行エンジンのインストールフォルダ（ディレクトリ）

注※2　＜GmaxAgentDir＞：Agent Serverのインストールフォルダ（ディレクトリ）

ただし，上記のテンプレートを特定ユーザだけに使用できるようにする（管理者用のテンプレートを管理者だけが使用できるようにする）には，上記のディレクトリにコピーしないで，「ユーザカスタマイズファイル用フォルダ（ディレクトリ）¥usersV3¥テンプレートを使用するユーザのユーザID」にコピーします。ユーザカスタマイズファイル用フォルダ（ディレクトリ）を参照する場合は，「5.6.3　フォルダ（ディレクトリ）情報を参照・更新する」を参照するか，テンプレートの開発者に問い合わせてください。

注意事項

これらの設定の後でAgent Serverを削除した場合，上記のファイルは削除されます（ただし，ユーザカスタマイズファイル用フォルダ（ディレクトリ）のファイルは削除されません）。Agent Serverを再インストールした場合，上記のファイルを再度コピーする必要があります。

(3)　システム情報の初期化

Mail Agent管理ツールを使用してシステム情報を初期化します。Mail Agent管理ツールを起動するには，運用コマンドを使用します。Mail Agentの運用コマンドについては「7.2　Mail Agentの運用コマンド」を，管理ツールによるシステム情報の初期化については「7.4.2　システム情報を初期化する」を参照してください。

Mail Agentでは，本体側（メールサーバ側）と実行エンジン側（エージェントサーバ側）の両方のシステム情報を初期化します。

Mail Agent本体側のシステム情報の初期化

Administrator権限でWindows NTにログオンします。

コマンドプロンプト画面を表示します。
フォルダ（ディレクトリ）をインストール先フォルダ（ディレクトリ）¥MailAgent¥SVbinに移動します。

「mamgr」コマンドを入力します。

管理ツールのメニューコマンドを選択してシステム情報を初期化します。

Mail Agent実行エンジン側のシステム情報の初期化

Administrator権限でWindows NTにログオンします。

コマンドプロンプト画面を表示します。
フォルダ（ディレクトリ）をインストール先フォルダ（ディレクトリ）¥MailAgentFunction¥SVbinに移動します。

「mafmgr」コマンドを入力します。

管理ツールのメニューコマンドを選択してシステム情報を初期化します。

(4)　Object Serverの環境設定

システム共通定義ファイルのprc_process_countとtrn_tran_process_countに，3（MailAgent本体が使用する分）を加えてください。なお，すでにprc_process_countとtrn_tran_process_countに最大値が設定されている場合には値を変更しないで，他製品のチューニングによって追加した分を-3するよう他製品のチューニングを見直してください。

注意事項

運用中におけるObject Serverへの接続プロセス数は，xodpinfoコマンドで確認することができます。運用中にObject Serverへの接続数を定期的に確認してObject Serverへの接続数を確認してください。接続数がprc_process_countとtrn_tran_process_countで定義した接続数に満たない場合（MailAgent本体の接続数の3が余っている場合）には，他製品のチューニングの見直しは必要ありません。

3.5　Document Manager Agentのインストールと環境設定

Document Manager Agentが提供する各エージェントを使用する場合は，Document Manager Agentのインストール，及び環境設定が必要です。この節では，Document Manager Agentのインストール，及び環境設定の方法について説明します。インストール時には，起動中のGroupmax Agentのサービスやイベントビューアなどのプログラムを終了させておいてください。

なお，インストールしたプログラムを削除する方法については，「付録B　プログラムを削除する方法」を参照してください。

＜この節の構成＞

3.5.1　Document Manager Agentのインストール

3.5.2　Document Manager Agentの環境設定

3.5.1　Document Manager Agentのインストール

Document Manager Agentを使用するためには，次の二つをインストールする必要があります。Document Manager Agentのインストールを図3-4に示します。

図3-4　Document Manager Agentのインストール

Agent - Document Manager Server

Document Manager Agentの本体です。Groupmax Document Managerがインストールされているマシンにインストールします。

Agent - Document Manager Function

Document Manager Agentの実行エンジン及びテンプレートファイルです。Agent Serverがインストールされているマシンにインストールします。Agent ServerとDocument Managerが同じマシンにある場合でも，Agent - Document Manager Functionはインストールしてください。

＜この項の構成＞

(1)　 Document Manager Agent本体（Agent - Document Manager Server）をインストールする

(2)　 Document Manager Agent実行エンジン（Agent - Document Manager Function）をインストールする

(1)　 Document Manager Agent本体（Agent - Document Manager Server）をインストールする

Document ManagerがインストールされているマシンにDocument Manager Agent本体をインストールします。なお，インストール時はDocument Managerサービスを停止しておいてください。

Administratorの権限でWindows NTにログオンします。

日立総合インストーラ（HCD_INST.EXE）を起動します。

インストールプログラムの画面に従って作業を進め，インストールする製品を選択するためのダイアログが表示されたら，「Groupmax Agent - Application Version 6」を選択します。
Groupmax統合インストーラが起動されます。

「標準」か「カスタム」を選択します。
「標準」を選択すると，「Groupmax Agent - Application Version 6」の構成製品のインストールを開始します。
「カスタム」を選択すると，インストールするアプリケーションを選択するためのダイアログが表示されます。

4.で「カスタム」を選択した場合，「Groupmax Agent - Document Manager Server Version 5」を選択して実行します。
会社名及び個人名を入力するためのダイアログが表示されます。

会社名及び個人名を入力して［開始］ボタンをクリックします。
インストール先を指定する画面が表示されます。

インストール先フォルダ（ディレクトリ）を指定して［続行］ボタンをクリックします。
インストールが開始されて，ファイルのコピー経過を表示するダイアログが表示されます。
ただし，次の場合は，コピー経過を表示するダイアログの前に更に問い合わせのダイアログが表示されます。

・指定したフォルダ（ディレクトリ）がない場合

新しく作成するかどうか問い合わせる画面が表示されます。新しく作成しても問題ない場合は［はい］ボタンをクリックしてください。

・既にDocument Manager Agent本体がインストールされている場合

プログラムをインストールするか削除するかを問い合わせるダイアログが表示されます。インストールしてよければ［はい］ボタンをクリックしてください。上書きしてインストールしても，システム環境に関する設定はそのまま残ります。

［はい］ボタンをクリックすると，必要なディスク空き容量を示し，インストール先フォルダ（ディレクトリ）を確認するダイアログが表示されます。どちらもインストールに問題なければ［続行］ボタンをクリックしてください。

なお，上書きインストールの場合は，インストール先フォルダ（ディレクトリ）を変更できません。

インストールが終了すると，インストールが終了した旨のメッセージが表示されます。［終了］ボタンをクリックします。
これでDocument Manager Agent本体のインストールは終了です。次に，Document Manager Agent実行エンジンをインストールします。

(2)　 Document Manager Agent実行エンジン（Agent - Document Manager Function）をインストールする

Agent ServerがインストールされているマシンにDocument Manager Agent実行エンジン（Agent - Document Manager Function）をインストールします。インストール手順はDocument Manager Agent本体と同じです。インストールするアプリケーションを選択するためのダイアログが表示されたら，「Groupmax Agent - Document Manager Function Version 5」を選択してください。

Document Manager Agentを起動して運用を開始するためには，この後，環境設定をする必要があります。

3.5.2　Document Manager Agentの環境設定

Document Manager Agentの環境設定では次の項目を設定します。

servicesファイルの設定

システム環境変数の設定

文書管理サーバ（Document Manager）での設定

Document Manager Agent実行エンジンからAgent Serverへのファイルの登録

システム情報の初期化

＜この項の構成＞

(1)　servicesファイルの設定

(2)　システム環境変数の設定

(3)　文書管理サーバ（Document Manager）での設定

(4)　 Document Manager Agent実行エンジン（Agent - Document Manager Function）からAgent Serverへのファイルの登録

(5)　システム情報の初期化

(1)　servicesファイルの設定

Document Manager Agent本体をインストールしたマシンのservicesファイルに次の内容を追加してください。

agsvrcon    20028/tcp
gmaxdasrv   20083/tcp

また，Document Manager Agent実行エンジンをインストールしたマシンのservicesファイルに次の内容を追加してください。

gmaxdasrv   20083/tcp

なお，これらのservicesファイルは，Groupmaxサーバ環境設定ユティリティを使って設定することもできます。Groupmaxサーバ環境設定ユティリティの操作方法は，マニュアル「Groupmax Object Server Version 6 システム管理者ガイド」を参照してください。

(2)　システム環境変数の設定

Document Managerがインストールされているマシンに次のシステム環境変数を設定します。

Document Managerシステム環境変数

ISFILETRANSFERDIR
Document Managerで使用する作業領域の絶対パス名（任意）を設定します。

Object Serverシステム環境変数

XODDIR

XODCONFPATH

PATH
XODDIR，XODCONFPATH及びPATHの設定値については，Groupmax Object Serverの管理者にお問い合わせください。

(3)　文書管理サーバ（Document Manager）での設定

文書管理サーバ（Document Manager）で次の設定をします。

「文書管理 管理ツール」の「環境設定」ダイアログで，Document Manager管理者ユーザ名を設定する

「文書管理 管理ツール」の「環境設定」ダイアログで，ユーザ認証方法をGroupmax Addressに設定する

また，共用キャビネット内文書の登録監視エージェントを使用する場合は，次の設定をしてください。

「文書管理 管理ツール」の「環境設定」ダイアログで，イベント通知機能の値を「use」に設定する

イベント通知リストファイル（インストール先フォルダ(ディレクトリ)¥etc¥apnotify.txt）に，次の内容を記述する（1行に一つずつ）

CRT_DOC_OBJ
クライアント又はユーザプログラムから一般文書を新規登録した時にイベント通知を行う場合に指定します。

CRT_DOC_OBJ_UTL
一括登録ユティリティから一般文書を新規登録した時にイベント通知を行う場合に指定します。

CRT_DOC_OBJ_REP
文書配布ユティリティから一般文書を新規登録した時にイベント通知を行う場合に指定します。

COPY_DOC_OBJ
クライアント又はユーザプログラムから一般文書を複製した時にイベント通知を行う場合に指定します。

MOVE_DOC_OBJ
クライアント又はユーザプログラムから一般文書を移動した時にイベント通知を行う場合に指定します。

MOVE_DOC_OBJ_REP
文書配布ユティリティから一般文書を移動して登録した時にイベント通知を行う場合に指定します。

イベント通知リストファイルの記述例を次に示します。

(4)　 Document Manager Agent実行エンジン（Agent - Document Manager Function）からAgent Serverへのファイルの登録

Document Manager Agentの提供する各エージェントを一般ユーザが使用できるようにするために，次のファイルをAgent Serverにコピーしてください。

詳細ダイアログDLLファイルの登録

（コピー元）

＜DocManAgentDir＞※１¥SVtmp¥template¥library¥agtdlg.dll

＜DocManAgentDir＞※１¥SVtmp¥template¥library¥dadlg.dll

（コピー先）

＜GmaxAgentDir＞※２¥SVtmp¥templateV3¥library

ヘルプファイルの登録

（コピー元）

＜DocManAgentDir＞※１¥SVtmp¥help¥gmwfagt.hlp

＜DocManAgentDir＞※１¥SVtmp¥help¥gmwfagt.cnt

（コピー先）

＜GmaxAgentDir＞※２¥SVtmp¥helpV3

テンプレート定義データの登録

（コピー元）

＜DocManAgentDir＞※１¥SVtmp¥template¥DAWTATTR.htm（条件付きフォーム文書の自動削除（管理者用）エージェント）

＜DocManAgentDir＞※１¥SVtmp¥template¥DAWTTIME.htm（共用キャビネット内文書の自動削除（管理者用）エージェント）

＜DocManAgentDir＞※１¥SVtmp¥template¥DAWTUPEX.htm（フォーム文書監視による業務プログラムの自動起動（管理者用）エージェント）

<DocManAgentDir>※１¥SVtmp¥template¥DAWTNOTI.htm（共用キャビネット内文書の登録監視（管理者用）エージェント）

（コピー先）

＜GmaxAgentDir＞※２¥SVtmp¥templateV3

注※1　＜DocManAgentDir＞：Document Manager Agent実行エンジンのインストールフォルダ（ディレクトリ）

注※2　＜GmaxAgentDir＞：Agent Serverインストールフォルダ（ディレクトリ）

ただし，上記のテンプレートを特定ユーザだけに使用できるようにする（管理者用のテンプレートを管理者だけが使用できるようにする）には，上記のディレクトリにコピーしないで，「ユーザカスタマイズファイル用フォルダ（ディレクトリ）¥usersV3¥テンプレートを使用するユーザのユーザID」にコピーします。ユーザカスタマイズファイル用フォルダ（ディレクトリ）を参照する場合は，「5.6.3　フォルダ（ディレクトリ）情報を参照・更新する」を参照するか，テンプレートの開発者に問い合わせてください。

注意事項

これらの設定の後でAgent Serverを削除した場合，上記のファイルは削除されます（ただし，ユーザカスタマイズファイル用フォルダ（ディレクトリ）のファイルは削除されません）。Agent Serverを再インストールした場合，上記のファイルを再度コピーする必要があります。

(5)　システム情報の初期化

Document Manager Agent管理ツールを使用してシステム情報を初期化します。Document Manager Agent管理ツールを起動するには，運用コマンドを使用します。Document Manager Agentの運用コマンドについては「8.2　Document Manager Agentの運用コマンド」を，管理ツールによるシステム情報の初期化については「8.4.2　システム情報を初期化する」を参照してください。

Administrator権限でWindows NTにログオンします。

コマンドプロンプト画面を表示します。
フォルダ（ディレクトリ）をインストール先フォルダ（ディレクトリ）¥DocumentManagerAgent¥SVbinに移動します。

「damgr」コマンドを入力します。

管理ツールのメニューコマンドを選択してシステム情報を初期化します。

4.　全体の運用

この章では，各サーバ間の起動と終了の関係，バックアップ及びリストアについて説明します。

＜この章の構成＞

4.1　各サーバの起動と終了の関係

4.2　サーバ間の情報の一致

4.3　バックアップ・リストア

4.4　IPアドレス及びホスト名の変更

4.5　運用上の制限事項

4.1　各サーバの起動と終了の関係

＜この節の構成＞

(1)　サービスの起動及び終了

(2)　サービスの依存関係

(1)　サービスの起動及び終了

Groupmax Agentを使用するには，関連するプログラムのサービスを起動する必要があります。サービスの構成を図に示します。

図4-1　サービスの構成

起動するサービスは，Groupmax Agentのどのプログラムを使用するかによって異なります。使用するプログラムと起動するサービスの対応を表4-1に示します。

表4-1　使用するプログラムと起動するサービスの対応

使用するプログラム | 起動するサービス
Agent Server(メール送信機能を利用しない) | Agent Server
Agent Server(メール送信機能を利用する) | Agent Server及びMail Server
Agent Server Mail Option | Agent Server Mail Option及びMail Server
Workflow Agent | Agent - Workflow Server及びWorkflow Server
Mail Agent | Agent - Mail Server，Agent - Mail Function及びMail Server
Document Manager Agent | Agent - Document Manager Server及びDocument Manager

Agent関連のサービスの起動・終了は，表4-2に示す順番で行ってください。

表4-2と異なる順番でサービスの起動・終了を行った場合，AgentServerとPPサーバの間で情報の対応がとれないため，次回以降エージェントが動作しなくなることがあります。

その場合には，整合性の確保コマンド（agmatch）を実行して情報の対応を取ってください。

また，サービスの起動・終了を行う際には，Agent関連のサービスをすべて起動・終了させるようにしてください。

表4-2　サービスの起動・終了順番

順番
起動
終了

1

MailAgentFunction

MailAgent

WorkflowAgent

DocumentManagerAgent

2

AgentServer

AgentServer Mail Option

AgentServer

AgentServer Mail Option

3

MailAgent

WorkflowAgent

DocumentManagerAgent

MailAgentFunction

エージェントを生成するときには，実行エンジンがインストールされている必要があります。実行エンジンがない場合は，エージェントは活動状態にならないで，停止状態で生成されます。

トリガの通知依頼をするときやアクションを実行するときに，関連する機能のサービスが起動されていない場合は，活動ログにエラーが出力され，リトライされます。

(2)　サービスの依存関係

Agent Server※ 及びAgent Server Mail Option及びAgent - Mail Serverは，ほかのGroupmaxのサービスと依存関係があります。Agent Server※ 又はAgent Server Mail Option又はAgent - Mail Serverのサービスを起動すると，Object Server及びAddress Serverのサービスが起動していない場合，これらのサービスは自動的に起動されます。また，Object Server又はAddress Serverのサービスを終了させると，Agent Server※ 又はAgent Server Mail Option又はAgent - Mail Serverのサービスが終了していない場合，これらのサービスは自動的に終了します。

これ以外のGroupmax Agentのサービスについては，依存関係はありません。

注※　「5.6.4　メールに関する情報を参照・更新する」の設定で，Groupmax Mailを使用する（Use）を設定した場合に，「Address Server」サービスとの依存関係が設定されます。「Address Server」サービスの依存関係が設定された後で，設定をGroupmax Mailを使用しない（Not use）に設定すると「Address Server」サービスとの依存関係は解除されます。

4.2　サーバ間の情報の一致

Groupmax Agentでは，関連するプログラムが連携して処理を行います。これらのプログラムは，処理に必要な情報をそれぞれ持っています。

Groupmax Agentのプログラムの連携を図4-2に示します。

図4-2　Groupmax Agentのプログラムの連携

エージェントが正常に動作するためには，連携しているプログラム間で情報の対応が取れている必要があります。このため，例えばバックアップを取得する場合は，プログラム間で同時に取得する必要があります。

また，稼働している複数のサーバのうち1台がダウンした場合，プログラム間の情報の対応が取れなくなることがあります。このようなときのために，Groupmax Agentでは整合性確保の機能を提供しています。ダウンしたサーバを回復させ，コマンドを実行してほかのサーバとの整合性を確保します。

複数のサーバにAgentServerとPPサーバをインストールして使用している環境の場合，初期化と整合性の確保は次の手順で行ってください。

以下と異なる手順で処理を行った場合，エージェントが動作しないことがあります。

すべてのマシンにインストールされているAgentのサービスを停止

すべてのマシンにインストールされているPPサーバで初期化を実施

すべてのマシンにインストールされているAgentのサービスを起動

すべてのマシンにインストールされているAgent Serverで整合性の確保を実施

ユーザの削除を行う場合は，削除するユーザが定義したエージェントも削除してください。

エージェントを削除しなかった場合，以下に示す問題が発生する可能性があります。

新規にエージェントを定義しても動作しない。

エージェントを定義していないユーザでエージェントが動作する。

エージェントの削除はAgentServer管理コマンド（agmgr）または，ユーザ単位のエージェント削除コマンド（agusrdel）※を使用することにより行うことができます。

注※　agusrdelはAgent ServerのVRが05-30以降の場合に使用できます。

なお，バックアップの取得及び整合性確保コマンドの詳細は，次の箇所を参照してください。

Agent Server

「5.8 バックアップとリストア」

「5.2.3 PPサーバ情報の一覧表示・PPサーバとの整合性の確保(agmatch)」

Workflow Agent

「6.9 バックアップとリストア」

「6.2.5 Agent Serverのホスト名一覧表示・Agent Serverとの整合性の確保(wamatch)」

Mail Agent

「7.6 バックアップとリストア」

「7.2.4 Agent Serverのホスト名一覧表示・Agent Serverとの整合性の確保(mamatch)」

Document Manager Agent

「8.6 バックアップとリストア」

「8.2.3 Agent Serverのホスト名一覧表示・Agent Serverとの整合性の確保(damatch)」

4.3　バックアップ・リストア

障害が発生したときのために，定期的にバックアップを取得することをお勧めします。取得したバックアップデータをリストアして，環境を再構築することができます。

バックアップを取得する情報には，Agent Serverの情報とAgent - Applicationの情報があります。Agent - Applicationを使用している場合は，Agent ServerとAgent - Applicationの情報の同期を取るために，バックアップを同時に取得してください。また，リストアも同時に行ってください。

Agent - Applicationは，エージェントの定義に関する情報をAgent Serverから取得してエージェントを処理します（ただし，Workflow Agentの業務プログラムを起動するエージェント，及びDocument Manager Agentのエージェントを除く）。このため，Agent Serverに定義されている情報とAgent - Applicationが取得している情報が一致していないと，これらのエージェントは動作しません。

また，Agent - Applicationは関連するPPサーバの情報とも同期を取る必要があります。関連するPPサーバのバックアップを取得する場合は，PPサーバのバックアップを取得する前に，Groupmax Agentのバックアップを取得してください。

Groupmax Agentでは稼働中バックアップをサポートしていませんので，一度サービスを停止させてからバックアップを取得してください。他のPPサーバの稼働中バックアップと併せて行う場合は，稼働中バックアップの前にGroupmax Agentのバックアップを取得してください。

バックアップ・リストアの詳細は，次の箇所を参照してください。

Agent Server：「5.8 バックアップとリストア」

Workflow Agent：「6.9 バックアップとリストア」

Mail Agent：「7.6 バックアップとリストア」

Document Manager Agent：「8.6 バックアップとリストア」

4.4　IPアドレス及びホスト名の変更

ホスト名を変更する場合，以下のIPアドレスをホスト名に読み替えて実施してください。

Agent ServerおよびPPサーバのIPアドレスを変更した場合のそれぞれの手順について説明します。

＜この節の構成＞

4.4.1　Agent ServerのIPアドレスを変更する場合

4.4.2　Workflow Agent本体のIPアドレスを変更する場合

4.4.3　Mail Agent本体のIPアドレスを変更する場合

4.4.4　Document Manager Agent本体のIPアドレスを変更する場合

4.4.1　Agent ServerのIPアドレスを変更する場合

クラインアントからエージェント定義の画面を開き，定義内容を控えてください。

Agent Serverに登録されているエージェントを削除してください。

IPアドレスを変更してください。

クライアントからエージェントを新規に作成し直してください。

4.4.2　Workflow Agent本体のIPアドレスを変更する場合

＜この項の構成＞

(1)　エージェント定義画面からWorkflowサーバのIPアドレスを指定するエージェント※1

(2)　エージェント定義画面からWorkflowサーバのIPアドレスを指定しないエージェント※2

(1)　エージェント定義画面からWorkflowサーバのIPアドレスを指定するエージェント※1

クラインアントからエージェント定義の画面を開き，定義内容を控えてください。

エージェントの状態を停止にしてください。

IPアドレスを変更してください。

クライアントから停止にしたエージェントの定義画面を開き,変更後のIPアドレスを設定してください。

※1　「ユーザトレー内案件の一括処理期限監視(管理者用)」

「ユーザトレー内案件の一括新着監視(管理者用)」

「業務ロールトレー内案件の着信監視(管理者用)」

(2)　エージェント定義画面からWorkflowサーバのIPアドレスを指定しないエージェント※2

クラインアントからエージェント定義の画面を開き,定義内容を控えてください。

エージェントを削除してください。

IPアドレスを変更してください。

クライアントからエージェントを新規に作成し直してください。

※2　「ユーザトレー内案件の着信監視」

「ユーザトレー内案件の処理期限監視」

「ユーザトレー内案件の処理期限監視(管理者用)」

「サーバ上業務プログラムの自動起動(管理者用)」

4.4.3　Mail Agent本体のIPアドレスを変更する場合

クラインアントからエージェント定義の画面を開き，定義内容を控えてください。

エージェントを削除してください。

IPアドレスを変更してください。

クライアントからエージェントを新規に作成し直してください。

4.4.4　Document Manager Agent本体のIPアドレスを変更する場合

クラインアントからエージェント定義の画面を開き,定義内容を控えてください。

エージェントの状態を停止にしてください。

IPアドレスを変更してください。

クライアントから停止にしたエージェントの定義画面を開き,変更後のIPアドレスを設定してください。

4.5　運用上の制限事項

Groupmax Agentのサーバシステムを運用する上での制限事項について説明します。

＜この節の構成＞

4.5.1　IPアドレスの扱いについて

4.5.2　ホスト名の扱いについて

4.5.3　クラスタシステムを使用する場合の注意事項

4.5.1　IPアドレスの扱いについて

エージェントシステムは，サーバ－クライアント間での無通信状態が一定時間（デフォルトは10秒）続くと，サーバ－クライアント間の接続を自動的に切断します。その後，通信が必要になった時点で再度接続します。サーバ－クライアント間の接続はIPアドレスを使用して接続するため，ネットワークの構成には制限事項があります。RAS接続やNAT機能，DNS/DHCP機能を使用する場合には注意が必要です。

＜この項の構成＞

(1)　動的にIPアドレスが割り当てられるネットワーク環境での制限事項

(2)　ファイアウォールの設定についての制限事項

(3)　サーバエージェント定義のIPアドレス指定についての制限事項

(1)　動的にIPアドレスが割り当てられるネットワーク環境での制限事項

サーバからクライアントへの再接続は，クライアントがサーバへログインしたときのクライアントのIPアドレスを使用しています。したがって，再接続時にクライアントIPアドレスが変更されるネットワーク環境では，サーバからクライアントへの接続ができません。

例えば，サーバからクライアントへダイアログを表示するようなエージェントの場合，クライアントへ接続ができないのでダイアログを表示できません。クライアントからサーバへ再度ログインしたときにまとめて表示します。

(2)　ファイアウォールの設定についての制限事項

ファイアウォールの設定には，サーバ－クライアント間の接続が双方向からできる設定と，サーバからクライアントへの接続ができない設定とがあります。

サーバからクライアントへの接続ができないように設定されている場合は，通信の再接続やクライアントへのダイアログ表示ができないなど，エージェントシステムが正しく動きません。ファイアウォールの適応を考えている場合は，サーバ－クライアント間の双方向の通信が遮断されないようにファイアウォールを設定する必要があります。また，サーバ－サーバ間の接続についても，双方向の通信が遮断されないようにファイアウォールを設定する必要があります。

(a)　ポート番号を許可する

「3.2.2　Agent Serverの環境設定(1)　servicesファイルの設定」に記載しているポート番号の通信を許可するようファイアウォールにポート番号を設定してください。

(b)　ファイルを許可する

サーバからクライアントへの接続のために，<Agent Serverのインストールディレクトリ>¥GroupmaxAgent¥SVbin¥agcscom.exeファイルに通信を許可してください。

(c)　OS標準のファイアウォールの設定

Windows 2003，Windows 2008やWindows 2012は，OS標準のファイアウォール機能があります。OS標準のファイアウォールを使用する場合は，ファイアウォールにAgent - Applicationが使用するポート番号を設定する必要があります。

Windows 2008およびWindows 2012ではファイアウォール機能がデフォルトで有効になることから，ファイアウォールにポート番号を設定するためのサンプルのバッチファイルを提供しています。サンプルのバッチファイルは次のファイルです。

Groupmax Agent - Mail Serverで使用するポート番号：<インストール先ディレクトリ>¥SVbin¥portAllowMASW.bat

Groupmax Agent - Mail Funcitonで使用するポート番号：<インストール先ディレクトリ>¥SVbin¥portAllowMAMW.bat

Groupmax Agent - Workflow Serverで使用するポート番号：<インストール先ディレクトリ>¥SVbin¥portAllowWASW.bat

Groupmax Agent - Workflow Funcitonで使用するポート番号：<インストール先ディレクトリ>¥SVbin¥portAllowWAMW.bat

Groupmax Agent - Document Manager Functionで使用するポート番号：<インストール先ディレクトリ>¥SVbin¥portAllowDAMW.bat

Agent Serverで使用するポート番号：<インストール先ディレクトリ>¥SVbin¥portAllowGSVW.bat

Agent Server Mail Optionで使用するポート番号：<インストール先ディレクトリ>¥SVbin¥portAllowGSMW.bat

サンプルのバッチファイルの内容を次のように書き換えて，管理者権限で実行します。

ポート番号，コマンドの設定を行う処理がすべてコメントアウトされていますので，設定するポート番号，コマンドの処理のコメント指定を削除します。

必要に応じてservicesのポート番号定義と同じになるように変更を行います。

注意事項

サンプルのバッチファイルはWindows 2003のファイアウォールには対応していません。

ファイアウォールの設定画面にある「Windowsファイアウォールによるプログラムのブロック時に通知を表示する」（Windows 2008の場合は「Windowsファイアウォールによる新しいプログラムのブロック時に通知を受け取る」，Windows 2012の場合は「Windowsファイアウォールが新しいアプリをブロックしたときに通知を受け取る」）にチェックを入れないでください。チェックを入れた場合は，コマンド実行時に「Windowsセキュリティの重要な警告」ダイアログが表示されることがあります。「Windowsセキュリティの重要な警告」ダイアログが表示された場合は「ブロックを解除する」ボタンを押してください。

(3)　サーバエージェント定義のIPアドレス指定についての制限事項

サーバエージェントは，生成時に接続するPPサーバのIPアドレス／ドメイン名／ホスト名を取得して定義情報に格納しています。IPアドレスを指定してエージェントを定義した場合，ネットワーク構成を変更したときにはエージェントを再度作り直す必要があります。ドメイン名／ホスト名での運用をお勧めします。

4.5.2　ホスト名の扱いについて

ホスト名の大文字小文字が変わるとホスト名変更となります。

ホスト名形式とFQDN形式が変わる場合はホスト名変更となります。

NetBIOSによってNetBIOS名が取得される場合がある為，DNS又はhostsファイルへのホスト名登録を推奨します。

4.5.3　クラスタシステムを使用する場合の注意事項

Groupmax Agentは，クラスタシステム（Windows NT Cluster）に対応していません。プログラム及びデータを共用ディスクに置かないでください。予備機への切り替えが発生した場合，動作は保証されません。Agent Serverは別マシンで構築することをお勧めします。同一マシンにインストールする場合は，ローカルディスクを使用してください。サーバの切り替えが発生した場合は，データをリストアして再起動するか，又は整合性確保の処理が必要です。

5.　Agent Serverの運用

この章では，Agent Serverの起動や終了の操作，及び管理者がAgent Server運用時に使用する運用コマンドや管理ツールの操作について説明します。

＜この章の構成＞

5.1　Agent Serverの起動と終了

5.2　Agent Serverの運用コマンド

5.3　Agent Server管理ツールに関する基礎知識

5.4　エージェント情報の参照

5.5　エージェントの活動に関する操作

5.6　システム情報の参照・更新・初期化

5.7　ダンプファイルの出力

5.8　バックアップとリストア

5.9　操作結果の出力先の指定

5.10　エージェントおよびユーザ情報参照

5.11　ユーザ単位のエージェント削除

5.1　Agent Serverの起動と終了

この節ではAgent Serverの起動と終了の方法について説明します。

＜この節の構成＞

5.1.1　Agent Serverの起動

5.1.2　Agent Serverの終了

5.1.1　Agent Serverの起動

Agent ServerはWindows NTの［サービス］ダイアログから起動します。Agent ServerをGroupmax Mail Serverと別のマシンにインストールした場合は，Agent Serverだけでなく，Agentメール送信ライブラリ（Agent Server Mail Option）を個別に起動します。

＜この項の構成＞

(1)　Agent Serverの起動

(2)　Agent Server Mail Optionの起動

(1)　Agent Serverの起動

Administratorの権限でWindows NTにログオンします。

管理ツールの「サービス」を開いて［サービス］ダイアログを表示します。

「サービス」の欄から「Agent Server」を選択して［開始］ボタンをクリックします。
「状態」の欄に「開始」と表示され，Agent Serverが起動します。

(2)　Agent Server Mail Optionの起動

Agent ServerをGroupmax Mail Serverと別のマシンにインストールした場合は，Agent Serverの起動とは別にAgentメール送信ライブラリ（Agent Server Mail Option）を起動する必要があります。

Administratorの権限でAgent Server Mail Optionをインストールしたマシンにログオンします。

管理ツールの「サービス」を開いて［サービス］ダイアログを表示します。

「サービス」の欄から「Agent Server Mail Option」を選択して［開始］ボタンをクリックします。
「状態」の欄に「開始」と表示され，Agentメール送信ライブラリが起動します。

5.1.2　Agent Serverの終了

終了する場合もインストール状況によって操作が異なります。

＜この項の構成＞

(1)　Agent Serverの終了

(2)　Agent Server Mail Optionの終了

(1)　Agent Serverの終了

Administratorの権限でWindows NTにログオンします。

管理ツールの「サービス」を開いて［サービス］ダイアログを表示します。

「サービス」の欄から「Agent Server」を選択して［停止］ボタンをクリックします。

停止してもよいか問い合わせるダイアログが表示されますので，［はい］ボタンをクリックします。
「状態」の欄が空白となり，Agent Serverが終了します。

(2)　Agent Server Mail Optionの終了

Administratorの権限でAgent Server Mail Optionをインストールしたマシンにログオンします。

管理ツールの「サービス」を開いて［サービス］ダイアログを表示します。

［サービス］ダイアログから「Agent Server Mail Option」を選択して［停止］ボタンをクリックします。

停止してもよいか問い合わせるダイアログが表示されますので，［はい］ボタンをクリックします。
「状態」の欄が空白となり，Agentメール送信ライブラリが終了します。

5.2　Agent Serverの運用コマンド

Agent Serverでは，システム管理者向けに運用コマンドを提供しています。この節では，運用コマンドの概要と各コマンドの使用方法について説明します。

＜この節の構成＞

5.2.1　運用コマンドの概要

5.2.2　Agent Server管理ツールの起動（agmgr）

5.2.3　PPサーバ情報の一覧表示・PPサーバとの整合性の確保（agmatch）

5.2.4　Agent Serverのエージェントのログの参照（aglog）

5.2.5　Agent Serverのトレースの参照（agtrace）

5.2.6　 Agent Serverのトレースの拡張（agtrcex）

5.2.7　Agent Serverのバージョンの移行（agconv）

5.2.8　Agent Serverのバージョンの表示（agver）

5.2.9　Agent Serverのシステムファイルの回復（agrecvry）

5.2.10　サーバのトレースの参照（agpptrc）

5.2.1　運用コマンドの概要

ここでは，どのような場合に運用コマンドを使用するかについて説明します。また，運用コマンドの記述形式や使用方法についても説明します。

＜この項の構成＞

(1)　どのような場合に運用コマンドを使用するか

(2)　運用コマンドの実行手順

(3)　運用コマンドの記述形式

(4)　運用コマンドの説明で使用する記号

(1)　どのような場合に運用コマンドを使用するか

Agent Server管理ツールの起動(agmgr)

エージェントの運用・管理やトラブルシュートを支援するAgent Server管理ツールを起動する場合に使用します。なお，Agent Server管理ツールの詳細については，5.3節以降で説明しています。

整合性対象PPサーバ情報の一覧表示・PPサーバとの整合性の確保(agmatch)

PPサーバのエージェント情報をAgent Serverのエージェント情報と一致させ，両者の整合性を確保する場合に使用します。PPサーバがダウンした場合や，PPサーバのエージェント情報が失われた場合，このコマンドで整合性を確保することによって回復できます。

Agent Serverのエージェントのログの参照(aglog)

Agent Serverに登録されているエージェントのログを参照する場合に使用します。エージェントのログは障害時の保守情報として使用します。

Agent Serverのトレースの参照(agtrace)

Agent Serverが提供する内部関数のトレースを参照する場合に使用します。内部関数のトレースは障害時の保守情報として使用します。

Agent Serverのトレースの拡張(agtrcex)

Agent Serverが提供する内部関数のトレース出力量を拡張する場合に使用します。内部関数のトレースは障害時の保守情報として使用します。

PPサーバのトレースの参照(agpptrc)

PPサーバのトレースを参照したい場合に使用します。内部関数のトレースは障害時の保守情報として使用します。

Agent Serverのバージョンの移行(agconv)

Agent Serverをバージョンアップした場合に使用します。このコマンドを使用すると，旧バージョンで使用してきたエージェント情報を新バージョンでそのまま使用できます。なお，Agent Serverのバージョン移行に必要な操作及び注意事項については，「3.1 バージョンの移行・混在に関する注意」を参照してください。

Agent Serverのバージョンの表示(agver)

Agent Serverをはじめとした，Groupmax Agentの各製品のバージョン情報を知りたい場合に使用します。

Agent Serverのシステムファイルの回復(agrecvry)

マシンダウンなどでAgent Serverが異常終了し，システムファイルが破壊された場合に使用します。このコマンドによって，Agent Serverのシステムファイルを回復できます。

(2)　運用コマンドの実行手順

Agent Serverの運用コマンドを実行できるのは，Administrator権限を持つユーザだけです。次の手順で実行してください。

コマンドプロンプト画面を表示します。

次のディレクトリ（フォルダ）に移動します。

<Agent Serverインストール先>¥GroupmaxAgent¥SVbin

運用コマンドを入力します。

(3)　運用コマンドの記述形式

形式

コマンド名称　[オプション．．．]

機能

コマンドの機能を説明しています。

オプション

スラント記号（/）で始まる文字列です。オプションによっては引数が必要な場合があります。

(4)　運用コマンドの説明で使用する記号

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

記号
意味

[　　]
この記号で囲まれているオペランドは省略できることを示す。
（例）ABC [/D ] [/E ]
この場合，次の指定が可能となる。

ABC

ABC　/D

ABC　/E

ABC　/D　/E

{　　}
この記号で囲まれているオペランドはどちらかを必ず指定しなければならないことを示す。
（例）ABC {/D | /E}

ABC　/D

ABC　/E

5.2.2　Agent Server管理ツールの起動（agmgr）

形式

agmgr

機能

Agent Serverでは，エージェントの運用・管理やトラブルシュート用に管理ツールを提供しています。このコマンドでは，管理ツールを起動してメインメニューを表示します。管理ツールはメインメニューから対話形式で使用できます。なお，Agent Server管理ツールの使用方法については，5.3節以降で説明しています。

オプション

なし

注意事項

このコマンドを実行できるのはAdministrator権限を持つユーザだけです。

5.2.3　PPサーバ情報の一覧表示・PPサーバとの整合性の確保（agmatch）

＜この項の構成＞

(1)　PPサーバ情報の一覧表示

(2)　PPサーバとの整合性の確保

(1)　PPサーバ情報の一覧表示

形式

agmatch  /l  [/o  PPサーバ情報出力先ファイル名]

機能

整合性確保の対象となるすべてのPPサーバのPP種別とサーバ識別情報を一覧表示できます。

オプション

/l

整合性確保の対象となるすべてのPPサーバのPP種別とサーバ識別情報を一覧表示できます。

/o PPサーバ情報出力先ファイル名

PPサーバ情報の一覧を出力するファイル名を指定します。指定したファイル名が既にある場合は，上書きされます。

本オプションを省略した場合は，標準出力に出力されます。

注意事項

このコマンドを実行できるのは，Administrator権限を持つユーザだけです。

このコマンドは，Agent Serverサービスが起動している場合に実行できます。

(2)　PPサーバとの整合性の確保

形式

agmatch  [/p  PP種別  /s  サーバ識別情報]  [/t  タイマ値(分)]

機能

PPサーバのエージェント情報をAgent Serverのエージェント情報と一致させ，両者の整合性を確保します。

オプションを省略した場合は，整合性確保の対象となるすべてのPPサーバと整合性を確保します。オプションの指定によって，特定のPPサーバだけと整合性を確保することもできます。

オプション

/p PP種別

整合性確保の対象となるPPサーバの種別(GroupmaxWorkflow，GroupmaxMail，GroupmaxDocumentManagerなど)を指定します。(1)で取得したPP種別の値を指定してください。本オプションを指定した場合は，/sオプションも指定する必要があります。

/s サーバ識別情報

整合性確保の対象となるPPサーバの識別情報（ホスト名，IPアドレスなど）を指定します。(1)で取得したサーバ識別情報の値を指定してください。本オプションを指定した場合は，/pオプションも指定する必要があります。

/t タイマ値(分)

整合性確保の状態合わせに要する待ち時間を1から60までの数字で指定します。単位は分，デフォルトは15です。

整合性確保の処理中，指定した時間を超えてもPPサーバからの応答がない場合，コマンドは中断されます。

注意事項

このコマンドを実行できるのは，対象となるPPサーバのバージョンが03-00以降の場合です。

Agent Server及び対象となるPPサーバのバージョンが共に03-10の場合は，PPサーバ上でトリガ監視をしないでアクションの実行だけをするエージェント(時間を監視するエージェント)も整合性処理の対象となります。

このコマンドを実行できるのは，Administrator権限を持つユーザだけです。

Agent Serverでエージェント情報が失われた場合は，バックアップした情報からAgent Serverを回復した後でPPサーバとの整合性を確保してください。

/pオプションと/sオプションは同時に指定してください。

整合性処理中にエラーが発生した場合，エラー発生の旨だけが画面上に表示されます。エラーの内容についてはイベントログを参照してください。

すべてのPPサーバとの整合性処理中に一つのPPサーバでエラーが発生した場合，エラー発生後もほかのPPサーバとの整合性処理は続行します。エラーの発生したPPサーバについては，イベントログでエラーの原因を確認して対策してください。その後，このコマンドを再度実行して整合性を確保してください。

Agent Server又は各PPサーバの実行エンジンがバージョン03-00の場合，整合性確保の対象となるPPサーバのサービスが起動していることを確認してからこのコマンドを実行してください。サービスが未起動でもこのコマンドは正常終了しますが，実際には整合性は確保されていません。

5.2.4　Agent Serverのエージェントのログの参照（aglog）

形式

aglog  /a  8  [>障害情報出力先ファイル名]

機能

Agent Serverに登録されているすべてのエージェントのログを参照する場合に使用します。エージェントのログは障害時の保守情報として使用します。

オプション

/a 8

ログを出力する場合のリスト数を指定します。リスト数は，「8」固定となります。

>障害情報出力先ファイル名

ファイル名を，「既存のフォルダ（ディレクトリ）¥任意の障害情報ファイル名」で指定します。

注意事項

このコマンドを実行できるのは，Administrator権限を持つユーザだけです。

Agent Serverで障害が発生した場合は，本コマンドのほかにagtraceコマンドも実行して保守情報を出力します。

5.2.5　Agent Serverのトレースの参照（agtrace）

形式

agtrace  [>障害情報出力先ファイル名]  [/C]

機能

Agent Serverが提供する内部関数のトレースを参照する場合に使用します。内部関数のトレースは障害時の保守情報として使用します。

オプション

>障害情報出力先ファイル名

トレース情報を出力するファイル名を指定します。ファイル名を省略した場合は標準出力に出力します。

/C

Agent Serverが持つトレース情報を初期化する場合に指定します。トレース情報を初期化すると，過去のトレースデータは消去されます。

注意事項

このコマンドを実行できるのは，Administrator権限を持つユーザだけです。

このコマンドで表示できるのは，トレース種別ごとに4,000～400,000エントリまでです。エントリ数は，トレースの拡張コマンド(agtrcex)によって変更できます。

Agent Serverで障害が発生した場合は，本コマンドのほかにaglogコマンドも実行して保守情報を出力します。

5.2.6　 Agent Serverのトレースの拡張（agtrcex）

形式

agtrcex  {/v トレースファイル名 |  /w トレースファイル名 最大エントリ数}

機能

Agent Serverが提供するトレースファイルの容量を拡張する場合に使用します。トレースファイルは障害時の保守情報として使用します。

オプション

/v　トレースファイル名

オプションで指定したトレースファイルの管理情報を表示します。

使用例）

FTtrcNET.datの管理情報を表示する場合，以下のように実行します。

C:¥Groupmax¥GroupmaxAgent¥SVbin>agtrcex /v ..¥SVlog¥FTtrcNET.dat
<Now> MaxEntry: 4000, NowEntry: 1555, NextOffset:00018600​, FileSize: 256320
C:¥Groupmax¥GroupmaxAgent¥SVbin>

実行時の表示例）

<Now> MaxEntry: 4000, NowEntry: 1555, NextOffset:00018600​, FileSize: 256320
　　　　　　　　  1               2                  3                  4

表示内容

トレースファイルのエントリ数

次トレース情報の書き込み位置（エントリ番号）

次トレース情報の書き込み位置（オフセット数）

トレースファイルサイズ（バイト）

/w　トレースファイル名 最大エントリ数

オプションで指定したトレースファイルを指定された最大エントリ数に拡張します。トレース情報を拡張すると，過去のトレースデータは消去されます。最大エントリ数は，400,000まで拡張できます。最大エントリ数は現在の設定値より大きな値を指定してください。なお，1エントリ拡張した場合，トレースファイルサイズは64バイト増加します。

使用例）

FTtrcNET.datを40000エントリに拡張する場合，以下のように実行します。

C:¥Groupmax¥GroupmaxAgent¥SVbin>agtrcex /w ..¥SVlog¥FTtrcNET.dat 40000
<Old> MaxEntry:  4000, NowEntry: 1555, NextOffset:00018600​, FileSize: 256320
<New> MaxEntry: 40000, NowEntry: 1555, NextOffset:00018600​, FileSize: 2560320​

C:¥Groupmax¥GroupmaxAgent¥SVbin>

実行時の表示例）

<Old> MaxEntry:  4000, NowEntry: 1555, NextOffset:00018600​, FileSize: 256320
<New> MaxEntry: 40000, NowEntry: 1555, NextOffset:00018600​, FileSize: 2560320​

最大エントリ数を小さくする場合には以下の手順で実施してください。初期状態のサイズに戻す場合には，1～4の手順を実施してください。

Agent ServerおよびPPサーバのサービスを停止します。

拡張するトレースファイルのバックアップを取得します。

拡張するトレースファイルを削除します。

Agent ServerおよびPPサーバのサービスを起動します。サービス起動時にトレースファイルは初期状態(4000エントリ)で作成されます。

Agent ServerおよびPPサーバのサービスを停止します。

agtrcexコマンドを使用しトレースサイズを拡張します。このとき，最大エントリ数を小さく指定します。

Agent ServerおよびPPサーバのサービスを起動します。

注意事項

このコマンドを実行する前に，トレースファイルのバックアップを取得してください。

トレースファイル名は相対パス名もしくは絶対パス名で指定してください。

このコマンドを実行できるのは，Administrator権限を持つユーザだけです。

/wオプションを指定する場合は，Agent ServerおよびGroupmax World Wide Web Desktopのサービス（サービス名：Groupmax WWW）を含めたすべてのPPサーバのサービスを停止してから実行してください。

エラーメッセージ

Syntax : agtrcex { /v filename | /w filename maxentry}

要因

必須オプションが指定されていません。またはオプションの指定に誤りがあります。

対処

オプションの指定内容を確認して，再度コマンドを実行してください。

Access denied.

要因

Administrator権限がありません。

対処

Administrator権限で実行してください。

Input file not found.

要因

指定したトレースファイルは存在しません。

対処

トレースファイルの有無およびトレースファイル名を確認してから再度コマンドを実行してください。

Input file open error. errno:NO

要因

指定したトレースファイルのオープンに失敗しました。サービスが起動されている可能性があります。

対処

Agent ServerおよびPPサーバのサービスを停止してから再度コマンドを実行してください。

Input maxentry is invalid.

要因

指定した最大エントリの値が不正です。

対処

最大エントリ数を指定しなおしてください。

Write error-ent. len:XX, errno:YY

要因

ディスク容量不足等により，指定したサイズまで拡張できずに拡張処理を中断しました。

対処

トレースファイルを削除してください。再度拡張を行う場合は，ディスクの空き容量を確保した後でAgent ServerおよびPPサーバのサービスの起動・停止を行い，初期状態のトレースファイルが作成されていることを確認してから再度コマンドを実行してください。

Input file is invalid.

要因

トレースファイル以外のファイルを指定しています。

対処

トレースファイル名を確認してください。トレースファイル名が正しい場合，トレースファイルは不正な状態であるため，削除してください。再度拡張を行う場合は，Agent ServerおよびPPサーバのサービスの起動・停止を行い初期状態のトレースファイルを作成してから再度コマンドを実行してください。

Seek error. errno:XX

要因

トレースファイルの更新失敗により，指定したサイズまで拡張できずに途中で中断しました。

対処

トレースファイルが不正な状態になっているため，削除してください。再度拡張を行う場合は，Agent ServerおよびPPサーバのサービスの起動・停止を行い，初期状態のトレースファイルを作成してから再度コマンドを実行してください。

Input file close error.

要因

トレースファイルのクローズ失敗により，指定したサイズまで拡張できずに途中で中断しました。

対処

トレースファイルが不正な状態になっているため，削除してください。再度拡張を行う場合は，Agent ServerおよびPPサーバのサービスの起動・停止を行い，初期状態のトレースファイルを作成してから再度コマンドを実行してください。

Input file no data.

要因

トレースファイル以外のファイルを指定しています。

対処

トレースファイル名を確認してください。トレースファイル名が正しい場合，トレースファイルは不正な状態であるため，削除してください。再度拡張を行う場合は，Agent ServerおよびPPサーバのサービスの起動・停止を行い初期状態のトレースファイルを作成してから再度コマンドを実行してください。

Input file read error. errno:XX

要因

トレースファイルの読み込みに失敗しました。

PPサーバのサービスが起動されている可能性があります。

対処

トレースファイル名を確認してください。トレースファイル名が正しい場合，トレースファイルは不正な状態であるため，削除してください。再度拡張を行う場合は，Agent ServerおよびPPサーバのサービスの起動・停止を行い初期状態のトレースファイルを作成してから再度コマンドを実行してください。

PPサーバのトレース拡張を行う場合，PPサーバのサービスを停止してからコマンドを実行してください。

Write error-cnt. len:XX, errno:YY

要因

ディスク容量不足等により，指定したサイズまで拡張できずに拡張処理を中断しました。

対処

トレースファイルを削除してください。再度拡張を行う場合は，ディスクの空き容量を確保した後でAgent ServerおよびPPサーバのサービスの起動・停止を行い，初期状態のトレースファイルが作成されていることを確認してから再度コマンドを実行してください。

5.2.7　Agent Serverのバージョンの移行（agconv）

形式

agconv

機能

Agent Serverをバージョンアップした時に，今まで使用していたエージェント情報を，バージョンアップした環境でそのまま使用できるようにします。

なお，Agent Serverのバージョン移行時に必要な操作及び注意事項については「3.1　バージョンの移行・混在に関する注意」を参照してください。

オプション

なし

注意事項

このコマンドを実行できるのは，Administrator権限を持つユーザだけです。

5.2.8　Agent Serverのバージョンの表示（agver）

形式

agver  [ /d ]

機能

次の製品についてバージョン情報を表示します。

Agent Server

Agent Serverにインストールされている実行エンジン

Agent Server Mail Option

オプション

/d

バージョンの履歴情報を表示する場合に指定します。バージョンの履歴情報は差分版をインストールした場合に左からインストール順に表示されます。

例えば，Agent Server 03-00に差分版03-00-/A，03-00-/Bをインストールした場合は，バージョンの履歴情報が「0300;0300PA;0300PB」のように表示されます。

注意事項

このコマンドを実行できるのは，Administrator権限を持つユーザだけです。

5.2.9　Agent Serverのシステムファイルの回復（agrecvry）

形式

agrecvry

機能

マシンダウンなどでAgent Serverが異常終了し，システムファイルが破壊された場合に，Agent Serverのシステムファイルを回復します。

Agent Serverが起動できない，又は不正な動作をするなどの現象が起こった場合に，原因を調べ，状況に応じてこのコマンドを実行します。

オプション

なし

注意事項

このコマンドを実行できるのは，Administrator権限を持つユーザだけです。

システムファイルの回復は，エージェント定義情報及びエージェント状態ファイルを基に実施されるため，これらが破壊されている場合は回復できません。

このコマンドを実行すると，活動ログ及び永続メモリの情報が初期化されます。また，Agent Serverで保留していたクライアントへのダイアログがすべて破棄されます。

このコマンドでシステムファイルを回復した後は，Agent Serverを起動し，agmatchコマンドですべてのPPサーバとの整合性を確保する必要があります。整合性の確保が完了していないエージェントは動作しません。ただし，このコマンドの実行後に，agmgrコマンド又はクライアントでエージェントの停止及び再起動を実行したエージェントは動作します。

このコマンドは，Agent Serverサービスが終了している場合に実行できます。

5.2.10　サーバのトレースの参照（agpptrc）

形式

agpptrc  [>出力先ファイル名]  [/C]

機能

PPサーバの内部関数のトレースを参照する場合に使用します。内部関数のトレースは障害時の保守情報として使用します。このコマンドはPPサーバ側の以下のディレクトリにインストールされます。

<Mail Agentインストール先>¥MailAgent¥SVbin

オプション

>出力先ファイル名

トレースを出力するファイル名を指定します。省略した場合は標準出力に出力されます。

/C

PPサーバが持つトレース情報を初期化する場合に指定します。トレース情報を初期化すると，過去のトレースデータは消去されます。

注意事項

このコマンドを実行できるのは，Administrator権限を持つユーザだけです。

このコマンドで表示できるのは，トレース種別ごとに4,000～400,000エントリまでです。

5.3　Agent Server管理ツールに関する基礎知識

Groupmax Agentでは，システム管理者用にAgent Server管理ツールを提供しています。Agent Clientで一般ユーザが生成したエージェントやAgent Serverのシステム情報の運用・管理にはこの管理ツールを使用します。

この節では，Agent Server管理ツールを使ってどのような情報に関する操作をするのかを説明します。また，管理ツールの基本的な操作方法についても説明します。

＜この節の構成＞

5.3.1　管理ツールで操作する情報

5.3.2　管理ツールの操作

5.3.1　管理ツールで操作する情報

＜この項の構成＞

(1)　エージェントやユーザに関する情報の参照と更新

(2)　活動ログの参照

(3)　システムに関する情報の参照と更新

(1)　エージェントやユーザに関する情報の参照と更新

一般ユーザがクライアントマシンから生成したエージェントに関する情報は，Agent Serverに登録されます。管理者は，障害が発生した場合に速やかに対処できるよう，だれがエージェントを登録しているか，各個人が何個エージェントを登録しているかなどといった情報を把握しておく必要があります。

Agent Server管理ツールでは，以下のことができます。

登録されたエージェントの詳細情報の参照

エージェントを登録したユーザ名の参照

特定のエージェントの活動の停止

不要になったエージェントの削除

(2)　活動ログの参照

各エージェントの活動履歴は，活動ログから参照できます。活動ログには，エージェントが実行された結果，正常に終了したかどうか，どのような理由で正常に実行されなかったかが表示されます。このため，障害が発生した場合は，エージェントの活動ログの情報を障害原因を判断するための材料にできます。

Agent Clientにも活動ログを参照する機能がありますが，クライアント側で参照できない場合にはAgent Serverから参照できます。

Agent Server管理ツールでは，状況に応じて，活動ログを参照できます。

ユーザごとの参照

すべてのエージェントの参照

特定のエージェントの参照

(3)　システムに関する情報の参照と更新

Agent Serverが持つシステム環境には，クライアントが生成したエージェントの情報をどこに保存するか，メールには何を使うかなどの情報があります。また，Agent Serverでは，システム環境への負荷を考えて，登録できるエージェントの数や接続できるPPサーバの数を制限できます。

Agent Server管理ツールでは，このようなシステムに関する情報の参照，更新ができます。

なお，バックアップ及びリストアには，Windows NTのバックアップ機能を使用してください。

5.3.2　管理ツールの操作

Agent Server管理ツールは，メニューによる対話形式で操作できます。Agent Server管理ツールの基本的な操作方法について説明します。

＜この項の構成＞

(1)　管理ツールの起動

(2)　管理ツールのメニューコマンド

(3)　コマンドの入力例

(4)　エージェント番号について

(5)　情報の出力について

(1)　管理ツールの起動

Agent Server管理ツールを起動する手順を次に示します。

Administratorの権限でWindows NTにログオンします。

コマンドプロンプト画面を開きます。

次のフォルダ（ディレクトリ）に移動します。

<Agent Serverインストール先>¥GroupmaxAgent¥SVbin

管理ツールを起動するためのコマンド「agmgr」を入力してリターンキーを押します。
管理ツールのメインメニューが開きます。

(2)　管理ツールのメニューコマンド

管理ツールのメニューコマンドの一覧を表5-1に示します。

管理ツールにはAgent Serverを起動している場合にだけ使用できるコマンドと終了している場合にだけ使用できるコマンドがあります。

表5-1　Agent Server管理ツールのメニューコマンド

メインメニューのコマンド
メインメニューのコマンド選択時に開くメニューのコマンド
機能
説明している箇所
Agent Serverの状態と使用できるコマンド

起動時
終了時

(1)UserShow,AgentShow/Change,ActiveLog
(1)UserID show
特定ユーザの登録したエージェントの一覧表示
5.4.1
○
○

(2)UserID list
エージェントを登録しているユーザの一覧表示
5.4.2
○
○

(3)Agent list
登録されている全エージェントの一覧表示
5.4.3
○
○

(4)AgentNum list
特定のエージェントのエージェント名，エージェント番号を表示
5.4.4
○
○

(5)Agent detail
特定のエージェントの詳細情報を表示
5.4.5
○
○

(6)Agent active
エージェントを活動させる
5.5.1
○
×

(7)Agent inactive
エージェントを停止させる
5.5.2
○
×

(8)Agent delete
エージェントを削除する
5.5.3
○
×

(9)UserID ActLog
特定ユーザの登録したエージェントの活動ログ表示
5.5.4
○
○

(a)Agent ActLog
登録されている全エージェントの活動ログ表示
5.5.5
○
○

(b)AgentNum ActLog
特定のエージェントの活動ログ表示
5.5.6
○
○

(o)output control
結果出力先の指定
5.9.1
○
○

(x)editor control
結果出力エディタの表示・非表示
5.9.2
○
○

(e)end
メインメニューに戻る
－
○
○

(q)quit
終了
－
○
○

(2)System Information
(1)AgentScheduler
Agent Serverのスケジューラ情報の参照・更新
5.6.1
参照○
更新×
○

(2)Definition
定義情報の上限値の参照・更新
5.6.2
参照○
更新×
○

(3)Output path
フォルダ情報の参照・更新
5.6.3
参照○
更新×
○

(4)Mail
メール情報の参照・更新
5.6.4
参照○
更新×
○

(5)Initialize
システム情報の初期化
5.6.5
×
○

(e)end
メインメニューに戻る
－
○
○

(q)quit
終了
－
○
○

(3)Dump
(1)Dump
ダンプファイルの出力
5.7
×
○

(e)end
メインメニューに戻る
－
○
○

(q)quit
終了
－
○
○

(4)Backup/Restore※
(1)Backup
バックアップ
5.8.1
×
○

(2)Restore
リストア
5.8.2
×
○

(e)end
メインメニューに戻る
－
○
○

(q)quit
終了
－
○
○

(o)output control
－
結果出力先の変更
5.9.1
○
○

(q)quit
－
終了
－
○
○

（凡例）－：該当しないことを表します。

　　　　○：使用できることを表します。

　　　　×：使用できないことを表します。

注※　通常は，Windows NTのバックアップ機能を使用することをお勧めします。

(3)　コマンドの入力例

例えば，エージェントを登録したユーザを一覧表示させたい場合のコマンドの入力例について説明します。

メインメニューの「Command:」の後に「1」を入力すると，登録ユーザ，登録エージェント，活動ログに関するメニューが表示されます。

さらに，ここで「Command:」の後に「2」を入力すると，エージェントを登録したユーザが一覧表示されます。前の画面に戻る場合は「e」を，管理ツールを終了する場合は「q」を入力します。

(4)　エージェント番号について

エージェント番号とは，登録されたエージェントに対してAgent Serverが割り当てる番号のことです。登録された各エージェントは，それぞれ固有のエージェント番号を持ちます。

Agent Server管理ツールでは，ある特定のエージェントの情報や活動ログなどを参照したい場合，エージェント番号を指定します。エージェント番号を参照する方法については，「5.4　エージェント情報の参照」で説明します。

(5)　情報の出力について

Agent Server管理ツールでは，参照する情報量が多い場合のために，エディタに出力する機能を提供しています。また，出力先の指定ではコンソール出力，ファイル出力が指定できます。これらの操作もメニューから選択します。

5.4　エージェント情報の参照

ここでは，メインメニューで「(1) UserShow,AgentShow/Change,ActiveLog」を選択した場合のうち，エージェント情報の参照について説明します。

Agent Server管理ツールでは，一覧表示によりエージェントの番号や登録ユーザID，エージェントの活動状態を参照できます。

さらに，参照したエージェント番号を使ってエージェント単位で詳細情報を表示したり，参照したユーザIDを使ってユーザ単位で詳細情報を表示できます。

＜この節の構成＞

5.4.1　特定のユーザが登録したエージェント情報を表示する

5.4.2　登録ユーザに関する情報を表示する

5.4.3　登録されている全エージェントを一覧表示する

5.4.4　エージェントの名称や状態を表示する

5.4.5　特定のエージェントに関する情報を表示する

5.4.1　特定のユーザが登録したエージェント情報を表示する

登録されたエージェントのエージェント番号をユーザごとに参照できます。また，エージェントの状態も参照できます。指定するユーザIDをあらかじめ知っておく必要があります。

メインメニューの「Command:」の後に「1」を入力します。
登録ユーザ，登録エージェント，活動ログに関する指定をするメニューが表示されます。

「Command:」の後に「1」を入力します。
「UserID:」と表示されます。

「UserID:」の後に，参照したいユーザのユーザIDを入力します。
指定したユーザが登録したエージェントに関して次の情報が表示されます。

#

エージェント番号が表示されます。

AgentKey

エージェントキーが表示されます。

Status

そのエージェントの現在の状態が表示されます。状態は次の種類に分けられます。

Active

活動中であることを示します。

Inactive

停止中であることを示します。

Active(standby)

活動待機中であることを示します。

Activepending

登録中であることを示します。

Inactivepending

停止処理中であることを示します。

Active(retry)

エラー発生による活動中(リトライ処理中)であることを示します。

Active(err)

エラー発生による活動待機中であることを示します。

Inactive(err)

エラー発生による停止中であることを示します。

Inactpend(err)

エラー発生による停止処理中であることを示します。

Name

エージェントの名称が表示されます。

指定例を次に示します。

5.4.2　登録ユーザに関する情報を表示する

エージェントを登録しているユーザ数を把握できます。また，各ユーザが登録したエージェントが障害を持っているかどうかを表示できます。

メインメニューの「Command:」の後に「1」を入力します。
登録ユーザ，登録エージェント，活動ログに関する指定をするメニューが表示されます。

「Command:」の後に「2」を入力します。
次の内容が表示されます。

User ID

登録されているユーザのユーザ IDが表示されます。

Cnt

そのユーザが登録しているエージェントの数が表示されます。

ErrCnt

そのユーザが登録しているエージェントのうち，障害のあるエージェントの数が表示されます。

指定例を次に示します。

5.4.3　登録されている全エージェントを一覧表示する

登録されているすべてのエージェントを参照できます。

メインメニューの「Command:」の後に「1」を入力します。
登録ユーザ，登録エージェント，活動ログに関する指定をするメニューが表示されます。

「Command:」の後に「3」を入力します。
エージェント番号の昇順に，登録されているすべてのエージェントについて，次の内容が一覧表示されます。

＃

エージェント番号が表示されます。

AgentKey

エージェントキーが表示されます。

Status

Active

活動中であることを示します。

Inactive

停止中であることを示します。

Active(standby)

活動待機中であることを示します。

Activepending

登録中であることを示します。

Inactivepending

停止処理中であることを示します。

Active(retry)

エラー発生による活動中(リトライ処理中)であることを示します。

Active(err)

エラー発生による活動待機中であることを示します。

Inactive(err)

エラー発生による停止中であることを示します。

Inactpend(err)

エラー発生による停止処理中であることを示します。

Name

エージェントの名称が表示されます。

指定例を次に示します。

5.4.4　エージェントの名称や状態を表示する

指定したエージェントに関して，エージェント名称や状態を表示できます。指定するエージェント番号をあらかじめ知っておく必要があります。

メインメニューの「Command:」の後に「1」を入力します。
登録ユーザ，登録エージェント，活動ログに関する指定をするメニューが表示されます。

「Command:」の後に「4」を入力します。
「AgentNumber:」と表示されます。

「AgentNumber:」の後に，表示したいエージェントのエージェント番号を入力します。なお，エージェント番号は，「，」で区切って複数指定したり（例：1,3,5），「－」で範囲を指定（例：1-3,5-7）できます。

指定したエージェントに関して次の内容が表示されます。

＃

エージェント番号が表示されます。

AgentKey

エージェントキーが表示されます。

Status

Active

活動中であることを示します。

Inactive

停止中であることを示します。

Active(standby)

活動待機中であることを示します。

Activepending

登録中であることを示します。

Inactivepending

停止処理中であることを示します。

Active(retry)

エラー発生による活動中(リトライ処理中)であることを示します。

Active(err)

エラー発生による活動待機中であることを示します。

Inactive(err)

エラー発生による停止中であることを示します。

Inactpend(err)

エラー発生による停止処理中であることを示します。

Name

エージェントの名称が表示されます。

指定例を次に示します。

5.4.5　特定のエージェントに関する情報を表示する

障害が発生して，エージェントを個別に調査する場合に，各エージェントの状態や連携しているPPサーバ名称などの詳細を参照できます。指定するエージェント番号をあらかじめ知っておく必要があります。

メインメニューの「Command:」の後に「1」を入力します。
登録ユーザ，登録エージェント，活動ログに関する指定をするメニューが表示されます。

「Command:」の後に「5」を入力します。
「AgentNumber:」と表示されます。

「AgentNumber:」の後に，表示したいエージェントのエージェント番号を入力します。
指定したエージェントに関して次の内容が表示されます。

Agent Key

エージェントキーが表示されます。

Status

Active

活動中であることを示します。

Inactive

停止中であることを示します。

Active(standby)

活動待機中であることを示します。

Activepending

登録中であることを示します。

Inactivepending

停止処理中であることを示します。

Active(retry)

エラー発生による活動中(リトライ処理中)であることを示します。

Active(err)

エラー発生による活動待機中であることを示します。

Inactive(err)

エラー発生による停止中であることを示します。

Inactpend(err)

エラー発生による停止処理中であることを示します。

Name

エージェント名が表示されます。

UserID

登録したユーザのユーザIDが表示されます。

Create Time

生成時刻が表示されます。

LifeTime

生存期間が表示されます。生存期間はクライアントがエージェントを生成するときに指定します。

Trigger Information

トリガプログラムに関する情報が表示されます。

「ServiceName」は，そのプログラムがアクセスするPPサーバ名を表します。

「ParameterCount」は，定義パラメタの数を表示します。定義パラメタとは，トリガやアクションなどのエージェントプログラムの処理で使用するパラメタ文字列のことです。

「ParameterCount」の下には，各定義パラメタが表示されます。例えば，「Data[00001]: 19:Type=TimeLimitWatch」は，19バイトのType=TimeLimitWatchというパラメタであることを示します。

ActionSelect Information

アクションの判定プログラムに関する情報が表示されます。表示される形式は，「Trigger Information」と同じです。

Action Information

アクションプログラムに関する情報が表示されます。表示される形式は，「Trigger Information」と同じです。

指定例を次に示します。

5.5　エージェントの活動に関する操作

ここでは，メインメニューで「(1) UserShow,AgentShow/Change,ActiveLog」を選択した場合のうち，エージェントの活動，停止，削除について説明します。また，活動ログの参照についても説明します。

エージェントの活動，停止，削除の操作ができるのは，Agent Serverが起動している時だけです。

＜この節の構成＞

5.5.1　特定のエージェントを活動させる

5.5.2　特定のエージェントを停止させる

5.5.3　特定のエージェントを削除する

5.5.4　特定ユーザの登録したエージェントの活動ログを一覧表示する

5.5.5　全エージェントの活動ログを一覧表示する

5.5.6　特定のエージェントの活動ログを一覧表示する

5.5.1　特定のエージェントを活動させる

特定のエージェントを活動させます。指定するエージェント番号をあらかじめ知っておく必要があります。

メインメニューの「Command:」の後に「1」を入力します。
登録ユーザ，登録エージェント，活動ログに関する指定をするメニューが表示されます。

「Command:」の後に「6」を入力します。
「Agent Number:」と表示されます。

「Agent Number:」の後に，活動させたいエージェント番号を入力します。なお，エージェント番号は，「，」で区切って複数指定したり（例：1,3,5），「－」で範囲を指定できます（例：1-3,5-7）。
活動したエージェントについて，次の内容が表示されます。

#

エージェント番号が表示されます。

AgentKey

エージェントキーが表示されます。

Status

活動中であることを示す「Active」が表示されます。

Name

エージェント名が表示されます。

指定例を次に示します。

5.5.2　特定のエージェントを停止させる

特定のエージェントを停止させます。指定するエージェント番号をあらかじめ知っておく必要があります。

メインメニューの「Command:」の後に「1」を入力します。
登録ユーザ，登録エージェント，活動ログに関する指定をするメニューが表示されます。

「Command:」の後に「7」を入力します。
「Agent Number:」と表示されます。

「Agent Number:」の後に，停止させたいエージェント番号を入力します。なお，エージェント番号は，「，」で複数指定したり（例：1,3,5），「－」で範囲指定（例：1-3,5-7）できます。
停止したエージェントについて，次の内容が表示されます。

#

エージェント番号が表示されます。

AgentKey

エージェントキーが表示されます。

Status

停止中であることを示す「Inactive」が表示されます。

Name

エージェント名が表示されます。

指定例を次に示します。

5.5.3　特定のエージェントを削除する

不要になったエージェントを削除できます。指定するエージェント番号をあらかじめ知っておく必要があります。

メインメニューの「Command:」の後に「1」を入力します。
登録ユーザ，登録エージェント，活動ログに関する指定をするメニューが表示されます。

「Command:」の後に「8」を入力します。
「Agent Number:」と表示されます。

「Agent Number:」に続けて，削除したいエージェント番号を入力します。なお，エージェント番号は，「，」で複数指定したり（例：1,3,5），「－」で範囲指定（例：1-3,5-7）できます。
「OK?(y/n[default]):」と表示されます。

削除してよい場合は「y」，削除しない場合は「n」を入力します。
削除するよう指定した場合は，指定したエージェントが削除され，そのエージェントに関する次の内容が表示されます。

＃

エージェント番号が表示されます。

AgentKey

エージェントキーが表示されます。

Name

エージェントの名称が表示されます。

指定例を次に示します。

5.5.4　特定ユーザの登録したエージェントの活動ログを一覧表示する

特定のユーザが登録したエージェントの活動ログを参照できます。指定するユーザIDをあらかじめ知っておく必要があります。

メインメニューの「Command:」の後に「1」を入力します。
登録ユーザ，登録エージェント，活動ログに関する指定をするメニューが表示されます。

「Command:」の後に「9」を入力します。
「User ID:」と表示されます。

参照したいユーザのユーザIDを入力します。
次の内容が表示されます。

＃

エージェント番号が表示されます。

T

ログ種別が表示されます。表示されるのは次の三つのうちどれかです。

I：通常の情報

W：警告

E：エラー

Time

イベントの発生日時が表示されます。

Event

「アクション実行開始」のように，イベントの内容が表示されます。

Result

エージェントの実行結果が表示されます。

指定例を次に示します。

5.5.5　全エージェントの活動ログを一覧表示する

すべてのエージェントの活動ログを参照できます。障害発生時に障害元を特定する場合などに参照します。

メインメニューの「Command:」の後に「1」を入力します。
登録ユーザ，登録エージェント，活動ログに関する指定をするメニューが表示されます。

「Command:」の後に「a」を入力します。
登録されている全エージェントに関して次の内容が表示されます。

＃

エージェント番号が表示されます。

T

ログ種別が表示されます。表示されるのは次の三つのうちどれかです。

I：通常の情報

W：警告

E：エラー

Time

イベントの発生日時が表示されます。

Event

「アクション実行開始」のように，イベントの内容が表示されます。

Result

エージェントの実行結果が表示されます。

指定例を次に示します。

5.5.6　特定のエージェントの活動ログを一覧表示する

障害のあるエージェントが特定できている場合などに，特定のエージェントに関する活動ログだけを表示できます。指定するエージェント番号をあらかじめ知っておく必要があります。

メインメニューの「Command:」の後に「1」を入力します。
登録ユーザ，登録エージェント，活動ログに関する指定をするメニューが表示されます。

「Command:」の後に「b」を入力します。
「AgentNumber:」と表示されます。

参照したいエージェントのエージェント番号を入力します。
次の内容が表示されます。

T

ログ種別が表示されます。表示されるのは次の三つのうちどれかです。

I：通常の情報

W：警告

E：エラー

Time

イベントの発生日時が表示されます。

Event

「アクション実行開始」のように，イベントの内容が表示されます。

Result

エージェントの実行結果が表示されます。

指定例を次に示します。

5.6　システム情報の参照・更新・初期化

ここでは，メインメニューで「(2) System Information」を選択してシステム情報の参照・更新・初期化をする場合について説明します。情報を更新・初期化する場合は，Agent Serverを終了してください。

＜この節の構成＞

5.6.1　スケジューラに関する情報を参照・更新する

5.6.2　定義情報の上限値を参照・更新する

5.6.3　フォルダ（ディレクトリ）情報を参照・更新する

5.6.4　メールに関する情報を参照・更新する

5.6.5　システム情報を初期化する

5.6.1　スケジューラに関する情報を参照・更新する

スケジューラとは，Agent Serverが持つ機能の一部で，エージェントの生存期間を何日間隔で監視するかといったような，主に時間に関する情報が設定されています。

メインメニューの「Command:」の後に「2」を入力します。
システム情報を参照・更新するためのメニューが表示されます。

「Setup:」の後に「1」を入力します。
次の内容が表示されます。

AgentClass(A,B,C) Thread count

ジョブクラス別のスレッド数が表示されます。Agent Serverのスケジューラは，登録されたエージェントをジョブクラスという単位で管理します。ジョブクラスはA，B，Cの三つに分けられており，Aクラスは，Agent Serverが内部的に実行する処理に割り当てられます。BクラスとCクラスは，ユーザの登録したエージェントに割り当てられます。管理者は，この各ジョブクラスのスレッド数を任意に割り当てられます。各ジョブクラスに同時に起動できるエージェントがどのくらい必要になるかによって，この値を決定します。デフォルトでは，Aクラスに4，Bクラスに32，Cクラスに16のスレッドが設定されています。

AgentClass(A,B,C) watch time(minutes)

ジョブクラス別動作期限監視時間が表示されます。動作期限とは，アクション実行に掛かる時間の上限のことです。アクションが実行されたときに動作期限を過ぎた場合は，強制的にアクション実行を終了して，スレッドを解放します。

Agent LifeTime watch interval(day(s))

エージェント生存期間の監視時間間隔が表示されます。

PPServer retry time (hour(s))

PPサーバ未起動時のAgent Serverからのリトライ間隔が表示されます。

Max ReserveMessage count

クライアント未起動時の最大保留メッセージ数が表示されます。ここでいうメッセージとは，メッセージダイアログを表示するアクションが実行された場合に表示させるメッセージダイアログのことです。

ReserveMessage LifeTime(day(s))

クライアント未起動時の保留メッセージの生存期間が表示されます。

2.の内容を変更する場合は，「Change?(y/n[default]):」の後に「y」を入力します。変更しない場合は「n」を入力します。

変更を指定した場合は，次の内容が表示され，値を更新できます。

AgentClass(A,B,C) Thread count 1-32[現在のスレッド数]

ジョブクラス別スレッド数を「4,30,16」のようにA，B，Cの順で指定します。1～32の間で指定します。

AgentClass(A,B,C) watch time 10-60 minutes[現在の値]

ジョブクラス別動作期限監視時間を「15,10,15」のようにA，B，Cの順で指定します。10～60の間で指定します。

Agent LifeTime watch interval 1-30 day(s)[現在の値]

エージェント生存期間の監視時間間隔を入力します。1～30の間で入力します。

PPServer retry time 1-24 hour(s)[現在の値]

PPサーバ未起動時のAgent Serverからのリトライ間隔を入力します。1～24の間で入力します。

Max ReserveMessage count 0-10[現在の値]

クライアント未起動時の最大保留メッセージ数を入力します。0～10の間で入力します。

この値を変更すると，Agent Serverで現在保留しているメッセージはすべて破棄されます。

ReserveMessage LifeTime 1-7 day(s)[現在の値]

クライアント未起動時の保留メッセージ生存期間を入力します。1～7の間で入力します。

この値を変更すると，Agent Serverで現在保留しているメッセージはすべて破棄されます。

指定したら，「OK?(y/n[default]):」の後に「y」を入力します。

指定例を次に示します。

5.6.2　定義情報の上限値を参照・更新する

Agent Serverでは，環境への負荷を考えて，登録できるエージェントの数や接続できるPPサーバの数を制限することができます。運用しているエージェントシステムが，ここで設定した値を超えた場合は，イベントログに表示されるエラー情報によってそのことを確認できます。

この設定は，デフォルトで使用することをお勧めします。

メインメニューの「Command:」の後に「2」を入力します。
システム情報を参照・更新するためのメニューが表示されます。

「Setup:」の後に「2」を入力します。
次の内容が表示されます。

Max Agent/Definition count

登録できるエージェント数が表示されます。

Max PPServer count

接続できるPPサーバ数が表示されます。

Max LoginUser count

同時にログインできるユーザ数が表示されます。

Max ConnectUser count

同時に接続できるユーザ数が表示されます。

No Communication watch time(seconds)

Agent Serverとクライアントの間の通信がなくなってから，TCPコネクションを切断するまでの時間(秒)が表示されます。

2.の内容を変更する場合は，「Change?(y/n[default]):」の後に「y」を入力します。変更しない場合は「n」を入力します。
変更を指定した場合は，次の内容が表示されます。

Max Agent/Definition count 32-3000[現在の値]

登録するエージェント数を32から3,000の間で入力します。ただし，登録されているエージェントがある場合は，現在の値より小さい値には変更できません。

現在の値より小さくする場合は，システム情報を初期化してください。システム情報を初期化すると，登録されているエージェントはすべて削除されます。デフォルトでは1,000が設定されています。

Max PPServer count 1-64[現在の値]

接続するPPサーバ数を1から64の間で入力します。なお，Agent Server Mail Optionもこの数に含まれます。デフォルトでは8が設定されています。

Max LoginUser count 1-1000[現在の値]

同時にログインできるユーザ数を1から1,000の間で入力します。デフォルトでは64が設定されています。

Max ConnectUser count 1-[Max LoginUser countの値][現在の値]

同時に接続できるユーザ数を1から「Max LoginUser count」で指定した値（ただし最大256）の間で入力します。デフォルトでは16が設定されています。

No Communication watch time 10-300 seconds[現在の値]

Agent Serverとクライアントの間の通信がなくなってから，TCPコネクションを切断するまでの時間(秒)を10から300の間で入力します。ただし，Max LoginUser countの値がMax ConnectUser countの値よりも大きい場合にこの設定値を大きくすると，Agent Serverに接続しにくくなります。デフォルトでは10が設定されています。

指定したら，「OK?(y/n[default]):」の後に「y」を入力します。

指定例を次に示します。

5.6.3　フォルダ（ディレクトリ）情報を参照・更新する

Groupmax Agentを使用している環境に応じて，幾つかのフォルダ（ディレクトリ）を別の場所に格納できます。

メインメニューの「Command:」の後に「2」を入力します。
システム情報を参照・更新するためのメニューが表示されます。

「Setup:」の後に「3」を入力します。
次の内容が表示されます。

User template file path

クライアントがエージェント生成で使用するテンプレートを格納するフォルダ（ユーザカスタマイズファイル用フォルダ）名が表示されます。

User file transfer path

クライアント－サーバ間ファイル転送用ファイルを格納するフォルダ（ディレクトリ）名が表示されます。

Definition file path

クライアントが生成して，Agent Serverに登録されているエージェントの情報を格納するフォルダ（ディレクトリ）名が表示されます。

Logging file path

活動ログを格納するフォルダ（ディレクトリ）名が表示されます。

Memory file path

永続メモリを格納するフォルダ（ディレクトリ）名が表示されます。永続メモリとは，各エージェントの情報を格納しておくメモリのことです。

2.の内容を変更する場合は，「Change?(y/n[default]):」の後に「y」を入力します。変更しない場合は「n」を入力します。
変更を指定した場合は，次の内容について指定できます。

User template file path[現在のパス]

クライアントがエージェント生成で使用するテンプレートを格納するフォルダ（ユーザカスタマイズファイル用フォルダ）名を指定できます。

User file transfer path[現在のパス]

クライアント－サーバ間ファイル転送用ディレクトリ名を指定できます。

Definition file path[現在のパス]

クライアントが生成して，Agent Serverに登録されているエージェントの情報を格納するフォルダ（ディレクトリ）名を指定できます。

Logging file path[現在のパス]

活動ログを格納するフォルダ（ディレクトリ）名を指定できます。

Memory file path[現在のパス]

永続メモリを格納するフォルダ（ディレクトリ）を指定できます。

変更したいフォルダ（ディレクトリ）を絶対パスで指定します。存在するフォルダ（ディレクトリ）を指定してください。指定したら，「OK?(y/n[default]):」の後にyを入力します。

指定例を次に示します。

5.6.4　メールに関する情報を参照・更新する

Groupmax Agentでは，Groupmax Mail又はE-mail（SMTP）でメールを送信するエージェントを作成できます。ここでは，メールサーバと連携するための設定を説明します。

情報を更新した場合は，Agent Serverを再起動する必要があります。

メインメニューの「Command:」の後に「2」を入力します。
システム情報を参照・更新するためのメニューが表示されます。

「Setup:」の後に「4」を入力します。
次の内容が表示されます。

E-mail

E-mailを使用するかどうかを指定します。使用する場合は「Use」，使用しない場合は「Not use」が表示されます。

E-mail Server host name

E-mailサーバのホスト名又はIPアドレスが表示されます。

Mail sender name

E-mailの送信者名称が表示されます。この場合の送信者とは，メールを送信するエージェントを動作させた場合のメールの送付元です。

Groupmax Mail

Groupmax Mailを使用するかどうかが表示されます。使用する場合は「Use」，使用しない場合は「Not use」が表示されます。

Mail Server host name

Groupmax Mailサーバのホスト名又はIPアドレスが表示されます。

UserID

Agent ServerがGroupmax MailにログインするためのUserIDが表示されます。

2.の内容を変更する場合は，「Change?(y/n[default]):」の後に「y」を入力します。
次の内容が表示されます。

E-mail use? y/n[現在の状態]

E-mailを使用するかどうかを指定します。使用する場合は「y」，使用しない場合は「n」を入力します。

E-mail Server host name[現在の情報]

E-mailサーバのホスト名又はIPアドレスを入力します。

Mail sender name[現在の名称]

E-mailの送信者名称を入力します。この場合の送信者とは，メールを送信するエージェントを動作させた場合のメールの送付元E-Mailアドレスです。

test01@hitachi.co.jpのように通常のE-Mailアドレス形式で入力してください。

Groupmax Mail use? y/n[現在の状態]

Groupmax Mailを使用するかどうかを指定します。使用する場合は「y」，使用しない場合は「n」を入力します。

Mail Server host name[現在の情報]

Groupmax Mailサーバのホスト名又はIPアドレスを入力します。

UserID[現在のユーザID]

Agent ServerがGmax MailにログインするためのユーザIDを入力します。

Groupmax MailにログインするためのユーザIDは，そのユーザIDの送受信トレーのメールがすべて削除されるため，エージェント用のIDを指定します。

指定したら，「OK?(y/n[default]):」の後に「y」を入力します。

指定例を次に示します。

5.6.5　システム情報を初期化する

次の場合に，システム情報を初期化します。初期化するとAgentの定義を削除します。

初めてAgent Serverを運用する場合

ディスク破壊などによってシステムファイルが壊れ，バックアップファイルからリストアできない場合

エージェントの動作環境を再設定したい場合

Agent Serverが起動中の場合は終了します。

メインメニューの「Command:」の後に「2」を入力します。
システム情報を参照・更新するためのメニューが表示されます。

「Setup:」の後に「5」を入力します。
「Groupmax AgentServer initialize OK? y/n(default):」と表示されます。

「Groupmax AgentServer initialize OK? y/n(default):」の後に「y」を入力します。
システム情報が初期化されます。

指定例を次に示します。

注意事項

システム情報を初期化すると，既に登録されているエージェントはすべて削除されます。その場合，初期化した後で再登録する必要がありますので注意してください。

5.7　ダンプファイルの出力

ここでは，メインメニューで「(3) Dump」を選択してダンプファイルを出力する場合について説明します。

バックアップの対象となるファイルについて，ダンプファイルを出力できます。

Agent Serverが起動中の場合は終了します。

メインメニューの「Command:」の後に「3」を入力します。
ダンプ出力に関するメニューが表示されます。

「Command:」の後に「1」を入力します。
「Directory name:」と表示されます。

「Directory name:」の後にダンプファイルを出力するフォルダ（ディレクトリ）名を入力します。
「Total file size[ファイルの合計サイズ] Dump output OK? y/n(default):」と表示されます。

出力してもよければ「y」を入力します。
指定したフォルダ（ディレクトリ）にダンプファイルが出力されます。

指定例を次に示します。

5.8　バックアップとリストア

ここでは，メインメニューで「(4) Backup/Restore」を選択して，バックアップ及びリストアをする場合について説明します。

Windows NTのバックアップ機能を使用すると，バックアップを自動化したり，Groupmaxの他サーバと同期を取ってバッアップしたりできます。このため，バックアップ及びリストアをする場合は，Windows NTのバックアップ機能を使用することをお勧めします。

＜この節の構成＞

5.8.1　バックアップ

5.8.2　リストア

5.8.1　バックアップ

障害が発生して環境を再構築する場合のために，バックアップを取得することをお勧めします。

＜この項の構成＞

(1)　Windows NTのバックアップ機能を使用する場合

(2)　Agent Server管理ツールを使用する場合

(1)　Windows NTのバックアップ機能を使用する場合

Agent Serverが起動中の場合は終了します。

Windows NTの機能を使用して，次に示すAgent Serverのファイル及びローカルレジストリ情報のバックアップを取得します。
このとき，Agent Serverの情報とPPサーバ側の情報との同期を取るために，PPサーバ側のバックアップも同時に取得することをお勧めします。
PPサーバ側では，Agent - Applicationのエージェント定義に関する情報をAgent Serverから取得してエージェントを処理します。Agent Serverに定義されている情報とPPサーバ側で取得している定義情報が一致していないエージェントは動作しません。
Workflow Agentのバックアップについては，「6.9　バックアップとリストア」を，Mail Agentのバックアップについては「7.6　バックアップとリストア」を，Document Manager Agentのバックアップについては，「8.6　バックアップとリストア」をそれぞれ参照してください。
ファイル

インストールディレクトリ¥GroupmaxAgent¥SVqueのファイル（キューファイル）

インストールディレクトリ¥GroupmaxAgent¥SVlogのファイル（活動ログファイル）

インストールディレクトリ¥GroupmaxAgent¥SVdefのファイル（クライアントが定義したエージェント情報の格納ファイル）

インストールディレクトリ¥GroupmaxAgent¥SVmemのファイル（永続メモリファイル）

インストールディレクトリ¥GroupmaxAgent¥SVmonのファイル（統計情報の格納ファイル）

インストールディレクトリ¥GroupmaxAgent¥SVtmp¥agentのファイル（ユーザエージェント管理ファイル）

レジストリ
「HKEY_LOCAL_MACHINE¥SOFTWARE¥HITACHI¥GroupmaxAgent以下の情報」
ただし，ローカルレジストリファイル全体のバックアップを取得しておくことをお勧めします。
なお，上記の情報のバックアップだけを取得する場合は，Windows NTのレジストリエディタを使用します。レジストリエディタについては，Windows NTのマニュアルのレジストリエディタの説明を参照してください。

Agent Serverを起動します。

注意事項

Agent Serverを削除してから再インストールした後で，バックアップしたファイルをリストアする場合，Agent Serverがバックアップ取得時と同じ設定でないと，正常にリストアできない可能性があります。管理者は，「5.6　システム情報の参照・更新・初期化」で説明している次の設定について，常に最新の設定情報を把握している必要があります。
・Agent Serverのスケジューラに関する情報
・定義情報の上限値
・フォルダ（ディレクトリ）情報
・メールに関する情報

ローカルレジストリファイルはシステム内で共有するため，破損しないよう注意して扱ってください。ローカルレジストリファイルについては，Windows NTのマニュアルのシステム構成の説明を参照してください。

(2)　Agent Server管理ツールを使用する場合

Agent Serverが起動中の場合は終了します。

メインメニューの「Command:」の後に「4」を入力します。
バックアップとリストアのメニューが表示されます。

「Command:」の後に「1」を入力します。

「Directory name:」と表示されます。

「Directory name:」の後にバックアップを格納するフォルダ（ディレクトリ）を入力します。

「Total file size[バックアップするファイルの合計] Backup OK?y/n(default):」と表示されます。

「Total file size[バックアップするファイルの合計] Backup OK?y/n(default):」の後に「y」を入力します。
指定したフォルダ（ディレクトリ）にバックアップが格納されます。

指定したフォルダにファイルが格納されたのを確認したら，Agent Serverを起動します。

この操作によってバックアップを取得できるファイルは，Windows NTで操作する場合に指定するファイルと同じです。指定例を次に示します。

5.8.2　リストア

バックアップ情報はリストアすることによって回復できます。リストアの場合も，バックアップと同様に，Windows NTの機能を使用することをお勧めします。

＜この項の構成＞

(1)　Windows NTのリストア機能を使用する場合

(2)　Agent Server管理ツールを使用する場合

(1)　Windows NTのリストア機能を使用する場合

Agent Serverが起動中の場合は終了します。

Windows NTの機能を使って，バックアップファイルをリストアします。

Workflow Agentの場合，エージェント情報を管理ツールを使用して削除します。
この操作以外に，エージェント情報を削除しないで，リストア後，Agent ServerとPPサーバの情報を比較して，一致していないエージェントを運用コマンドで活動状態にしたり削除して運用を再開することもできます。Agent Serverに登録されていないがPPサーバ側にはエージェント情報があるといったような場合，そのエージェントは動作しません。
また，Agent ServerとPPサーバ間のエージェント情報を一致させる場合に，整合性の確保コマンドを使用することもできます。整合性の確保については，「9.3.2　サーバ間の情報の一致」を参照してください。

Agent Serverを起動します。

Agent Serverに登録されているエージェントをすべて停止状態にします。

停止させたエージェントのうち，使用するエージェントを活動状態にします。
活動させたエージェントを使用できます。

注意事項

Agent Serverを削除してから再インストールした後でリストアした場合，Agent Serverがバックアップ取得時と同じ設定でないと，正常にリストアできない可能性があります。管理者は，「5.6　システム情報の参照・更新・初期化」で説明している次の設定について，常に最新の設定情報を把握している必要があります。

Agent Serverのスケジューラに関する情報

定義情報の上限値

フォルダ（ディレクトリ）情報

メールに関する情報

(2)　Agent Server管理ツールを使用する場合

なお，Agent Serverの管理ツールを使用する場合は，次の操作をします。

Agent Serverが起動中の場合は終了します。

メインメニューの「Command:」の後に「4」を入力します。
バックアップとリストアのメニューが表示されます。

「Command:」の後に「2」を入力します。

「Directory name:」と表示されます。

「Directory name:」の後にリストアするデータが格納されているフォルダ（ディレクトリ）を入力します。

「Restore OK?y/n(default):」と表示されます。

「Restore OK?y/n(default):」の後に「y」を入力します。
指定したフォルダ（ディレクトリ）のデータがリストアされます。

各ファイルがリストアされたのを確認したら，Agent Serverを起動します。

登録されているエージェントの状態を確認します。PPサーバ側と状態が一致していない場合は一致させてください。
Agent ServerとPPサーバ側の状態を一致させる方法については，「9.2　サーバ環境で確認する項目」及び「9.3.2　サーバ間の情報の一致」を参照してください。

指定例を次に示します。

5.9　操作結果の出力先の指定

ここでは，管理ツールの各メニューで「(o)output control」又は「(x)editor control」を選択して，出力先を指定する場合について説明します。

＜この節の構成＞

5.9.1　操作結果の出力先を指定する

5.9.2　操作結果をエディタ出力する

5.9.1　操作結果の出力先を指定する

登録エージェントや登録ユーザなどを参照した結果は，コンソール上だけでなく，ファイル形式かcsv形式で出力できます。なお，デフォルトではコンソール上に出力します。指定方法を次に示します。

「(o) output control」が表示されているメニューで，「Command:」の後に「o」を入力します。
「Output[現在の出力先] c(console)/f(filename)/v(csvfilename):」と表示されます。

「Output[現在の出力先] c(console)/f(filename)/v(csvfilename):」の後に，コンソール上に出力する場合は「c」，.txtのファイル形式で出力する場合は「f」，csv形式で出力する場合は「v」を入力します。
「f」又は「v」を指定した場合は，「Output file name[現在の出力先ファイル名]:」と表示されます。

「Output file name[現在の出力先ファイル名]:」の後に，出力先ファイル名をフルパスで指定します。
「Output file name[指定したファイル名]」と表示されて，出力先の指定が終わります。

指定例を次に示します。

5.9.2　操作結果をエディタ出力する

操作結果をエディタに出力できます。エディタを使用することによって，出力された情報量が多い場合でも，画面をスクロールしながら結果を確認できます。エディタを使用するよう指定した場合は，御使用のマシンに設定されているデフォルトのエディタが開きます。

なお，Agent Serverでは，デフォルトではエディタを使用しない設定になっています。

「(x)editor control」が表示されているメニューで，「Command:」の後に「x」を入力します。
「Output editor[現在のエディタ表示の状態] u(Use)/n(NoUse):」と表示されます。

「Output editor[現在のエディタ表示の状態] u(Use)/n(NoUse):」の後に，「u」と入力します。
エディタを使用できる状態になります。この後登録エージェントを参照するような操作をすると，結果がエディタに出力されます。

指定例を次に示します。

注意事項

エディタを使うように指定した場合は，「5.9.1　操作結果の出力先を指定する」で指定した出力先は無効になります。

5.10　エージェントおよびユーザ情報参照

ここでは，一般ユーザが生成したエージェント定義や，誰が何個のエージェントを登録しているかなどのユーザ情報を参照する場合，管理ツールagmgrによる情報の取得について説明します。

本機能では，この管理ツールagmgrのうち，エージェント定義やユーザ情報の表示をコマンドから行う事ができます。

形式

agshow  /l
agshow  /a
agshow  /s  ユーザID
agshow  /n  エージェント番号
agshow  /d  エージェント番号
agshow  /d  all

機能

運用コマンドagshowを使用して，当該Agent Serverに登録してあるエージェントの情報を表示します。表示する内容は，運用コマンドagmgrの該当するメニューの表示内容と同じです。運用コマンドagmgrの詳細については，「5.2　Agent Serverの運用コマンド」～「5.4　エージェント情報の参照」を参照してください。

オプション

/l

エージェントを登録しているユーザを一覧表示します。管理ツールagmgrのUserID listメニューに対応しています。

/a

登録されている全エージェントを一覧表示します。管理ツールagmgrのAgent listメニューに対応しています。

/s ユーザID

指定したユーザの登録したエージェントを一覧表示します。管理ツールagmgrのUserID showメニューに対応しています。

/n エージェント番号

指定したエージェントのエージェント名と状態を表示します。管理ツールagmgrのAgentNum listメニューに対応しています。

/d エージェント番号

指定したエージェントの詳細情報を表示します。管理ツールagmgrのAgent detailメニューに対応しています。

/d all

すべてのエージェントの詳細情報を表示します。管理ツールagmgrのAgent detailメニューに対応しています。

注意事項

このコマンドを実行できるのは，Administrator権限を持つユーザだけです。

5.11　ユーザ単位のエージェント削除

ここでは，ユーザIDを指定して，そのユーザが保有しているエージェントをすべて削除する場合について説明します。

形式

agusrdel  /s  ユーザID

機能

運用コマンドagusrdelでユーザIDを指定し，指定したユーザが保有しているエージェントをすべて削除します。Groupmax Address Serverからユーザを削除するとき，このコマンドを利用して当該ユーザが保持しているエージェントを削除することにより，「削除されたユーザのエージェントが残っている」ということがなくなります。

オプション

/s ユーザID

エージェントをすべて削除するユーザのユーザIDを指定します。

注意事項

このコマンドを実行できるのは，Administrator権限をもつユーザだけです。

このコマンドは，AgentServerのサービスが起動中のときだけ実行できます。

活動状態のエージェントは，エージェントを停止させたあと削除します。

このコマンド実行時は，PPサーバのサービスも起動している必要があります。停止している場合は，PPサーバ側の情報が削除されません。

使用例

ユーザID s875391が持っているエージェント一覧を削除する場合

6.　Workflow Agentの運用

この章では，Workflow Agentの起動や終了の操作，及び管理者がWorkflow Agent運用時に使用する運用コマンドや管理ツールの操作について説明します。

＜この章の構成＞

6.1　Workflow Agentの起動と終了

6.2　Workflow Agentの運用コマンド

6.3　Workflow Agent管理ツールに関する基礎知識

6.4　システム情報の参照・更新・初期化

6.5　タイマ情報の参照・更新

6.6　監視エージェント情報の参照・更新

6.7　ダンプファイルの出力

6.8　操作結果のエディタ出力

6.9　バックアップとリストア

6.10　ユーザトレー内案件の一括新着監視エージェントによるメール宛先BCC化

6.1　Workflow Agentの起動と終了

この節ではWorkflow Agentの起動と終了の方法について説明します。

＜この節の構成＞

6.1.1　Workflow Agentの起動

6.1.2　Workflow Agentの終了

6.1.1　Workflow Agentの起動

Workflow AgentはWindows NTの［サービス］ダイアログから起動します。

Administratorの権限でWorkflow Agentをインストールしたマシンにログオンします。

管理ツールの「サービス」を開いて［サービス］ダイアログを表示します。

「サービス」の欄から「Workflow Agent」を選択して［開始］ボタンをクリックします。
「状態」の欄に「開始」と表示され，Workflow Agentが起動します。

6.1.2　Workflow Agentの終了

Administratorの権限でWorkflow Agentをインストールしたマシンにログオンします。

管理ツールの「サービス」を開いて［サービス］ダイアログを表示します。

［サービス］ダイアログから「Workflow Agent」を選択して［停止］ボタンをクリックします。

停止してもよいか問い合わせるダイアログが表示されますので，［はい］ボタンをクリックします。
「状態」の欄が空白となり，Workflow Agentが終了します。

6.2　Workflow Agentの運用コマンド

Workflow Agentでは，システム管理者向けに運用コマンドを提供しています。この節では，運用コマンドの概要と各コマンドの使用方法について説明します。

＜この節の構成＞

6.2.1　運用コマンドの概要

6.2.2　ユーザID一覧ファイルの作成と参照（waulist）

6.2.3　ユーザID・E-mailアドレス対応ファイルの作成と参照（waemtbl）

6.2.4　Workflow Agent管理ツールの起動（wamgr）

6.2.5　Agent Serverのホスト名一覧表示・Agent Serverとの整合性の確保(wamatch)

6.2.6　Workflow Agentのトレースの参照（watrc）

6.2.7　Workflow Agentのバージョンの移行（waconv）

6.2.8　Workflow Agentのファイルの回復(warecvry)

6.2.1　運用コマンドの概要

ここでは，どのような場合に運用コマンドを使用するかについて説明します。また，運用コマンドの記述形式や使用方法についても説明します。

＜この項の構成＞

(1)　どのような場合に運用コマンドを使用するか

(2)　運用コマンドの実行

(3)　運用コマンドの記述形式

(4)　運用コマンドの説明で使用する記号

(1)　どのような場合に運用コマンドを使用するか

ユーザID一覧ファイルの作成と参照(waulist)

ユーザID一覧ファイルを作成，参照する場合に使用します。ユーザID一覧ファイルとは，Workflow Agentの次のエージェントで，監視対象となるユーザをユーザIDで指定する場合に必要なファイルのことです。

ユーザトレー内案件の新着を一括監視するエージェント

ユーザトレー内案件の処理期限を一括監視するエージェント

ユーザID・E-mailアドレス対応ファイルの作成と参照(waemtbl)

ユーザID・E-mailアドレスの対応ファイルを作成，参照する場合に使用します。ユーザID・E-mailアドレス対応ファイルとは，Workflow Agentの次のエージェントで，結果をE-mail（SMTP）で通知する場合に必要なファイルのことです。

ユーザトレー内案件の新着を一括監視するエージェント

業務ロールトレー内案件の着信を監視するエージェント

ユーザトレー内案件の処理期限を一括監視するエージェント

Workflow Agent管理ツールの起動(wamgr)

エージェントの運用・管理やトラブルシュートを支援するWorkflow Agent管理ツールを起動する場合に使用します。なお，Workflow Agent管理ツールの詳細については，6.3節以降で説明しています。

Agent Serverのホスト名一覧表示・Agent Serverとの整合性の確保(wamatch)

Workflow Agentのエージェント情報をAgent Serverのエージェント情報と一致させ，両者の整合性を確保する場合に使用します。Workflow Agentがダウンした場合や，エージェント情報が失われた場合，このコマンドで整合性を確保することによって回復できます。

Workflow Agentのトレースの参照(watrc)

Workflow Agentが提供する内部関数のトレースを参照したい場合に使用します。内部関数のトレースは障害時の保守情報として使用します。

Workflow Agentのバージョンの移行(waconv)

Workflow Agentをバージョンアップした場合に使用します。このコマンドを使用すると，旧バージョンで使用してきた動作環境を新バージョンでそのまま使用できます。なお，Workflow Agentのバージョン移行に必要な操作及び注意事項については「3.1　バージョンの移行・混在に関する注意」を参照してください。

Workflow Agentのファイルの回復(warecvry)

マシンダウンなどでWorkflow Agentが異常終了し，システムファイルが破壊された場合に使用します。このコマンドによって，Workflow Agentのシステムファイルを回復できます。

(2)　運用コマンドの実行

Workflow Agentの運用コマンドを実行できるのは，Administrator権限を持つユーザだけです。次の手順で実行してください。

コマンドプロンプト画面を表示します。

次のディレクトリ（フォルダ）に移動します。

<WorkflowAgentインストール先>¥WorkflowAgent¥SVbin

運用コマンドを入力します。

(3)　運用コマンドの記述形式

形式

コマンド名称　[オプション．．．]

機能

コマンドの機能を説明しています。

オプション

スラント記号（/）で始まる文字列です。オプションによっては引数が必要な場合があります。

(4)　運用コマンドの説明で使用する記号

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

記号
意味

[　　]
この記号で囲まれているオペランドは省略できることを示す。
（例）ABC [/D ] [/E ]
この場合，次の指定が可能となる。

ABC

ABC　/Ｄ

ABC　/Ｅ

ABC　/Ｄ　/E

6.2.2　ユーザID一覧ファイルの作成と参照（waulist）

ユーザID一覧ファイルを作成する場合と参照する場合についてそれぞれ説明します。

＜この項の構成＞

(1)　ユーザID一覧ファイルを作成する

(2)　ユーザID一覧ファイルを参照する

(1)　ユーザID一覧ファイルを作成する

形式

waulist  /e ユーザ作成ファイル名  /o ユーザID一覧出力先ファイル名
       [/u ユーザID格納列番号]

機能

ユーザID一覧ファイルとは，Workflow Agentの次に示すエージェントで監視対象となるユーザをユーザIDで指定する場合に必要なファイルです。

ユーザトレー内案件の新着を一括監視するエージェント

ユーザトレー内案件の処理期限を一括監視するエージェント

ユーザID一覧が格納されているCSV形式のユーザ作成ファイルから，必要なユーザID一覧ファイルを作成します。ユーザID一覧が格納されているCSV形式のユーザ作成ファイルの例を示します。

ユーザ作成ファイルは次のどちらかの方法で作成してください。

Excelなどを使用してユーザIDをファイルに設定します。次に，そのファイルをCSV形式で格納します。

Groupmax Address Server 一括登録ユティリティを使用して，ユーザID一覧が格納されているユーザ作成ファイルを作成します。Groupmax Address Server 一括登録ユティリティに関しては，マニュアル「Groupmax Address/Mail Version 7システム管理者ガイド　ユティリティ編」を参照してください。

オプション

/e　ユーザ作成ファイル名

指定したユーザ作成ファイルからユーザID一覧ファイルを作成します。

/o　ユーザID一覧出力先ファイル名

指定したファイル名でユーザID一覧ファイルを作成します。

/u　ユーザID格納列番号

ユーザ作成ファイルに格納したユーザIDの列番号で指定します。省略した場合は，１列目にユーザIDが格納されているものとみなします。

注意事項

ユーザ作成ファイルの１列目，又は/uオプションで指定した列以外は無視します。

指定した列に何も設定されていない場合は，その列の指定を無視します。

ユーザ作成ファイルの行頭文字がシャープ（#）の場合，その行は無視します。

作成したユーザID一覧ファイルは，使用するWorkflow Agentサーバマシン上に格納してください。

このコマンドを実行できるのはAdministrator権限を持つユーザだけです。

(2)　ユーザID一覧ファイルを参照する

形式

waulist  /s ユーザID一覧ファイル名　[/o実行結果出力先ファイル名]

機能

作成したユーザID一覧ファイル名の内容を出力します。

オプション

/s　ユーザID一覧ファイル名

作成したユーザID一覧ファイル名を指定します。

/o　実行結果出力先ファイル名

ユーザID一覧を出力するファイル名を指定します。省略した場合は標準出力に出力します。

注意事項

このコマンドを実行できるのはAdministrator権限を持つユーザだけです。

6.2.3　ユーザID・E-mailアドレス対応ファイルの作成と参照（waemtbl）

ユーザID・E-mailアドレス対応ファイルを作成する場合と参照する場合についてそれぞれ説明します。

＜この項の構成＞

(1)　ユーザID・E-mailアドレス対応ファイルを作成する

(2)　ユーザID・E-mailアドレス対応ファイルを参照する

(1)　ユーザID・E-mailアドレス対応ファイルを作成する

形式

waemtbl   /e ユーザ作成ファイル名
         /o ユーザID・E-mailアドレス対応表出力先ファイル名
         [/u ユーザID格納列番号]  [/a E-mailアドレス格納列番号]

機能

ユーザID・E-mailアドレス対応ファイルとは，Workflow Agentの次に示すエージェントで，結果をＥ-mailで通知する場合に必要なファイルです。

ユーザトレー内案件の新着を一括監視するエージェント

業務ロールトレー内案件の着信を監視するエージェント

ユーザトレー内案件の処理期限を一括監視するエージェント

ユーザIDとE-mailアドレスが格納されているCSV形式のユーザ作成ファイルから，アクション処理でＥ-mail送信する場合に必要なユーザID・Ｅ-mailアドレス対応ファイルを作成します。ユーザIDとE-mailアドレスが格納されているCSV形式のユーザ作成ファイルの例を示します。

ユーザ作成ファイルは次のどちらかの方法で作成してください。

Excelなどを使用してユーザIDをファイルに設定します。次に，そのファイルをCSV形式で格納します。

Groupmax Address Server 一括登録ユティリティを使用して，ユーザID一覧が格納されているユーザ作成ファイルを作成します。Groupmax Address Server 一括登録ユティリティに関しては，マニュアル「Groupmax Address/Mail Version 7システム管理者ガイド　ユティリティ編」を参照してください。

オプション

/e ユーザ作成ファイル名

指定したユーザ作成ファイルからユーザID・E-mailアドレス対応ファイルを作成します。

/o ユーザID・E-mailアドレス対応表出力先ファイル名

指定したファイル名でユーザID・E-mail対応ファイルを作成します。

/u ユーザID格納列番号

ユーザ作成ファイルに格納したユーザIDの列番号を指定してください。省略した場合は，１列目にユーザIDが格納してあるとみなします。

/a E-mailアドレス格納列番号

ユーザ作成ファイルに格納したE-mailアドレスの列番号を指定してください。省略した場合は，２列目にE-mailアドレスが格納してあるとみなします。

注意事項

ユーザ作成ファイルの１列目，又は/uオプションで指定した列と２列目，又は/aオプションで指定した列以外は無視します。

指定した列に何も設定されていない場合は，その列の指定を無視します。

ユーザ作成ファイルの行頭文字がシャープ（#）の場合，その行は無視します。

作成したユーザID・E-mailアドレス対応ファイルは，使用するWorkflow Agentサーバマシンに格納してください。

このコマンドを実行できるのはAdministrator権限を持つユーザだけです。

(2)　ユーザID・E-mailアドレス対応ファイルを参照する

形式

waemtbl  /s ユーザID・E-mailアドレス対応ファイル名
        [/o 実行結果出力先ファイル名]

機能

作成したユーザID・E-mailアドレス対応ファイルの内容を出力します。

オプション

/sユーザID・E-mailアドレス対応ファイル名

作成したユーザID・E-mailアドレス対応ファイル名を指定してください。指定したファイルの内容を出力します。

/o実行結果出力先ファイル名

出力先となるファイル名を指定します。省略した場合は標準出力に出力します。

注意事項

このコマンドを実行できるのはAdministrator権限を持つユーザだけです。

6.2.4　Workflow Agent管理ツールの起動（wamgr）

形式

wamgr

機能

Workflow Agentでは，エージェントの運用・管理やトラブルシュート用に管理ツールを提供しています。本コマンドでは，この管理ツールを起動してメインメニューを表示します。管理ツールはメインメニューから対話形式で使用できます。

なお，Workflow Agent管理ツールの使用方法については，6.3節以降で説明しています。

オプション

なし

注意事項

このコマンドを実行できるのはAdministrator権限を持つユーザだけです。

6.2.5　Agent Serverのホスト名一覧表示・Agent Serverとの整合性の確保(wamatch)

＜この項の構成＞

(1)　Agent Serverのホスト名の一覧表示

(2)　Agent Serverとの整合性の確保

(1)　Agent Serverのホスト名の一覧表示

形式

wamatch  /l  [/o  ホスト名一覧出力先ファイル名]

機能

整合性を確保する対象となるAgent Serverのホスト名を一覧表示できます。

オプション

/l

Workflow Agentと接続中のAgent Serverのホスト名を一覧表示できます。表示されるのは，Workflow Agentのマシンで認識しているホスト名で，DNS又はhostsファイルに設定されているものです。なお，一覧は，名称順ではソートされません。

/o ホスト名一覧出力先ファイル名

ホスト名一覧を出力するファイル名を指定します。フルパスで指定しない場合は，カレントディレクトリに出力されます。指定したファイル名が既にある場合は，上書きされます。

本オプションを省略した場合は，標準出力に出力されます。

注意事項

このコマンドを実行できるのは，Administrator権限を持つユーザだけです。

このコマンドは，Workflow Agentサービスが起動している場合に実行できます。

(2)　Agent Serverとの整合性の確保

形式

wamatch  [/s  Agent Serverのホスト名又はIPアドレス]  [/t  タイマ値(分)]

機能

Workflow Agentのエージェント情報をAgent Serverのエージェント情報と一致させ，両者の整合性を確保します。

オプション

/s Agent Serverのホスト名又はIPアドレス

整合性確保の対象となるAgent Serverのホスト名又はIPアドレスを指定します。ホスト名を指定する場合は，DNS又はhostsファイルに設定されている名称で指定してください。IPアドレスを指定する場合は，「***.***.***.***」の形式で指定してください。

本オプションを省略した場合は，Workflow Agentで認識しているすべてのAgent Serverと整合性を確保します。

/t タイマ値(分)

整合性確保の状態合わせに要する待ち時間を1から60までの数字で指定します。単位は分，デフォルトは15です。

注意事項

このコマンドを実行できるのは，対象となるAgent Serverのバージョンが03-10以降の場合です。

このコマンドを実行できるのは，Administrator権限を持つユーザだけです。

このコマンドは，Workflow Agentサービスが起動している場合に実行できます。

6.2.6　Workflow Agentのトレースの参照（watrc）

形式

watrc  [>障害情報出力先ファイル名]  [/C]

機能

Workflow Agentが提供する内部関数のトレースを参照する場合に使用します。内部関数のトレースは障害時の保守情報として使用します。

オプション

>障害情報出力先ファイル名

トレースを出力するファイル名を指定します。省略した場合は標準出力に出力します。

/C

Workflow Agentが持つトレース情報を初期化する場合に指定します。トレース情報を初期化すると，過去のトレースデータは消去されます。

注意事項

このコマンドを実行できるのは，Administrator権限を持つユーザだけです。

このコマンドで表示できるのは，トレース種別ごとに4,000～400,000エントリまでです。エントリ数は，トレースの拡張コマンド（agtrcex）によって変更できます。

6.2.7　Workflow Agentのバージョンの移行（waconv）

形式

waconv

機能

Workflow Agentを03-00より前のバージョンからバージョンアップした時に，今まで使用していたエージェントの動作環境を，そのままバージョンアップした環境で使用できるように移行します。

オプション

なし

注意事項

このコマンドを実行できるのは，Administrator権限を持つユーザだけです。

6.2.8　Workflow Agentのファイルの回復(warecvry)

形式

warecvry

機能

マシンダウンなどでWorkflow Agentが異常終了し，システムファイルが破壊された場合に，Workflow Agentのシステムファイルを回復します。

Workflow Agentが起動できない，又は不正な動作をするなどの現象が起こった場合に，原因を調べ，状況に応じてこのコマンドを実行します。

オプション

なし

注意事項

このコマンドを実行できるのは，Administrator権限を持つユーザだけです。

システムファイルの回復は，エージェント定義情報及びエージェント状態ファイルを基に実施されるため，これらが破壊されている場合は回復できません。

このコマンドを実行できるのは，Workflow Agentが終了している場合です。

6.3　Workflow Agent管理ツールに関する基礎知識

Workflow Agentが独自に持つ環境に関する操作ではWorkflow Agent管理ツールを使用します。この節では，Workflow Agent管理ツールを使ってどのような情報に関する操作をするのかについて説明します。

＜この節の構成＞

6.3.1　管理ツールで操作する情報

6.3.2　管理ツールの操作

6.3.1　管理ツールで操作する情報

＜この項の構成＞

(1)　システム情報に関する操作

(2)　タイマ情報に関する操作

(3)　監視エージェント情報に関する操作

(1)　システム情報に関する操作

Workflow Agentのシステム情報には，Workflow Agentがインストールされているディレクトリ（フォルダ）やバージョン情報のほかに，登録できるエージェントの上限値や現在登録されているエージェント数などがあります。Workflow Agent管理ツールでは，これらの情報の参照，更新ができます。

(2)　タイマ情報に関する操作

タイマ情報とは，処理期限監視及び案件着信監視エージェントで何時からユーザトレーを監視するか，何時間ごとにユーザトレーを監視するかといった情報です。Workflow Agent管理ツールでは，これらの情報の参照，更新ができます。

(3)　監視エージェント情報に関する操作

監視エージェント情報とは，処理期限監視及び案件着信監視エージェントに関する定義情報です。Workflow Agent管理ツールでは，エージェントに障害が発生した場合に監視エージェント情報の更新，再登録ができます。

なお，バックアップ及びリストアは，Windows NTの提供するバックアップ，リストア機能を使用します。

6.3.2　管理ツールの操作

Workflow Agent管理ツールもAgent Server管理ツールと同様に，メニューによる対話形式で操作できます。Workflow Agent管理ツールの基本的な操作方法について説明します。

＜この項の構成＞

(1)　管理ツールの起動

(2)　管理ツールのメインメニューとコマンドの入力方法

(3)　エージェントキーとシーケンス番号について

(1)　管理ツールの起動

Workflow Agent管理ツールを起動する手順を次に示します。

Administratorの権限でWindows NTにログオンします。

コマンドプロンプト画面を開きます。

次のディレクトリ（フォルダ）に移動します。

<Workflow Agentインストール先>¥WorkflowAgent¥SVbin

管理ツールを起動するための運用コマンド「wamgr」を入力してリターンキーを押します。
管理ツールのメインメニューが表示されます。

(2)　管理ツールのメインメニューとコマンドの入力方法

管理ツールのメニューコマンドの一覧を表6-1に示します。

管理ツールにはWorkflow Agentを終了している場合にだけ使用できるコマンドがあります。

表6-1　Workflow Agent管理ツールのメインメニュー

メインメニューのコマンド | メインメニューのコマンド選択時に開くメニューのコマンド | (2)Agent operation選択時に開くメニューのコマンド | 機能 | 説明している箇所 | Workflow Agentの状態と使用できるコマンド
起動時 | 終了時
(1)System | (1)System information change | － | システム情報の参照 | 6.4.1 | ○ | ○
システム情報の更新 | × | ○
(2)System file initialize | － | システム情報の初期化 | 6.4.2 | × | ○
(e)end | － | メインメニューに戻る | － | ○ | ○
(q)quit | － | 終了 | － | ○ | ○
(2)Timer | (1)Timer information change | － | タイマ情報の参照・更新 | 6.5 | ○ | ○
(e)end | － | メインメニューに戻る | － | ○ | ○
(q)quit | － | 終了 | － | ○ | ○
(3)Agent | (1)Agent Information | － | 監視エージェント情報の参照 | 6.6.1 | ○ | ○
(2)Agent operation | (1)Event watch（Agent entry） | 監視エージェント情報の登録 | 6.6.2 | ○ | ○
(2)Event cancel（Agent delete） | 監視エージェント情報の削除 | 6.6.3 | ○ | ○
(e)end | (2)Agent operationに戻る | － | ○ | ○
(q)quit | 終了 | － | ○ | ○
(x)edit control | － | 結果出力エディタの表示・非表示 | 6.8 | ○ | ○
(e)end | － | メインメニューに戻る | － | ○ | ○
(q)quit | － | 終了 | － | ○ | ○
(4)Dump | (1)Dump | － | ダンプファイルの出力 | 6.7 | × | ○
(e)end | － | メインメニューに戻る | － | ○ | ○
(q)quit | － | 終了 | － | ○ | ○
(q)quit | － | － | 終了 | － | ○ | ○

（凡例）－：該当しないことを表します。

　　　　○：使用できることを表します。

　　　　×：使用できないことを表します。

なお，コマンドの入力方法は，Agent Server管理ツールと同様に，「Command:」の後に番号を入力して，コマンドを選択します。前の画面に戻る場合は「e」を，管理ツールを終了する場合は「q」を入力します。

(3)　エージェントキーとシーケンス番号について

エージェントキー及びシーケンス番号は，登録された監視エージェントにAgent Serverが割り当てる番号のことです。監視エージェントはそれぞれ固有のエージェントキー及びシーケンス番号を持ちます。

Workflow Agent管理ツールで，監視エージェント情報を参照，更新する場合，エージェントキー及びシーケンス番号を指定します。エージェントキー及びシーケンス番号を参照する方法については，「6.6.1　監視エージェント情報を表示する」で説明します。

6.4　システム情報の参照・更新・初期化

ここでは，メインメニューで「(1) System」を選択して，システム情報の参照・更新・初期化をする場合について説明します。なお，情報を更新・初期化する場合はWorkflow Agentを終了してください。

＜この節の構成＞

6.4.1　システム情報を参照・更新する

6.4.2　システム情報を初期化する

6.4.1　システム情報を参照・更新する

システム情報を参照する場合は，Workflow Agentのインストール先ディレクトリや，実際に登録されているエージェント数などを参照できます。

また，登録できる処理期限監視，案件着信監視及び業務プログラム起動エージェントの上限に関する情報は更新できます。

情報を更新する場合は，Workflow Agentを停止します。

メインメニューの「Command:」の後に「1」を入力します。
次の情報が表示されます。

Version

Workflow Agentのバージョンが表示されます。

Service start time

Workflow Agentの起動時刻が表示されます。

Install directory

Workflow Agentのインストール先ディレクトリが表示されます。

Service status

Workflow Agentが起動しているか終了しているかが表示されます。

Max Agent server count

接続できるAgent Serverの数が表示されます。

Max Agent entry count

登録できるエージェント数の上限が表示されます。

Agent entry count

登録されているエージェント数が表示されます。

また，上記の内容の後に，システム情報の更新・初期化に関するメニューが表示されます。

システム情報を更新する場合は，さらに，ここで「Command:」の後に「1」を入力します。
次の内容を指定します。

Max Agent server count[現在の値]

接続するAgent Serverの数を1から64の間で指定します。デフォルトでは8が指定されています。

Max Agent entry count[現在の値]

登録できるエージェント数の上限を1から3,000の間で指定します。デフォルトでは1,000が指定されています。

指定したら，「OK?[Yes:y/No:n(default)]:」の後に「y」を入力します。

指定例を次に示します。

6.4.2　システム情報を初期化する

環境を再構築するような場合に，システム情報を初期化します。初期化すると活動中のAgentの情報を削除します。

Workflow Agentが起動中の場合は終了します。

メインメニューの「Command:」の後に「1」を入力します。
Workflow Agentのシステム情報及びシステム情報の更新・初期化に関するメニューが表示されます。

「Command:」の後に「2」を入力します。
「Agent - Workflow Server system file initialize OK?[Yes:y/No:n(default)]:」と表示されます。

初期化してよければ，「y」を入力します。
「Initializing...」と表示され，初期化が開始します。
初期化処理が終了すると「Initialize end. press any key」と表示されます。

任意のキーを押します。
初期化の操作が終了します。

指定例を次に示します。

注意事項

システム情報を初期化しても，更新したシステム情報は初期化されません。更新したシステム情報（最大接続Agent Server数や最大登録エージェント数）以外の情報がインストール時の状態になります。

6.5　タイマ情報の参照・更新

ここでは，メインメニューで「(2) Timer」を選択して，タイマ情報の参照・更新をする場合について説明します。

メインメニューの「Command:」の後に「2」を入力します。
タイマ情報が必要なエージェントの種類が一覧表示され，エージェントの種類別に次のタイマ情報が表示されます。

Agent Type

エージェントの種類が表示されます。

１：ユーザトレー内案件の処理期限を監視するエージェント

２：ユーザトレー内案件の着信を監視するエージェント

３：ユーザトレー内案件の新着を一括監視するエージェント

４：業務ロールトレー内案件の着信を監視するエージェント

５：ユーザトレー内案件の処理期限を一括監視するエージェント

Starting point time

エージェントがユーザトレー又はロールトレーを監視する場合の起点時間が表示されます。ここで設定されている時間を起点として「Event watch interval」で指定した時間間隔で監視します。

Event watch interval hour

指定されたユーザトレー又はロールトレーを何時間間隔で監視するかが表示されます。

Event watch interval minute

指定されたユーザトレー又はロールトレーを何分間隔で監視するかが表示されます。

Next watch time

指定されたユーザトレー又はロールトレーの次回の監視時刻が表示されます。

起点時間や監視時間間隔などの設定を変更する場合は，さらに，ここで「Command:」の後に「1」を入力します。
「Agent Type No.:」と表示されます。

「Agent Type No.:」の後に，タイマ情報を変更するエージェントの種類の番号を入力します。
エージェントの種類別に起点時間と監視間隔を組み合わせて指定します。

Starting point time[現在の値]

ユーザトレー又はロールトレーを監視する場合の起点時間を指定します。hh:mm形式で分単位に0:00から23:59までの間で指定します。

Event watch interval hour[現在の値]

ユーザトレー又はロールトレーの監視間隔を時間単位で指定します。何時間間隔で監視するかを0から24までの整数で指定できます。

Event watch interval minute[現在の値]

ユーザトレー又はロールトレーの監視間隔を分単位で指定します。何分間隔で監視するかを0から59までの整数で指定します。

分単位で指定できる値は，Event watch interval hourで指定した時間単位の値によって異なります。

Event watch interval hourで
指定した値（時間）
Event watch interval minuteで
指定できる値（分）

0
10から59

1から23
1から59

24
0

指定したら，「OK?[Yes:y/No:n(default)]:」の後に「y」を入力します。

指定例を次に示します。

注意事項

起点時間，監視間隔は組み合わせて指定します。例えば，起点時間を8時にして，監視間隔を7時間にした場合，Workflow Agentが監視する時刻は，「8時，15時，22時，5時，8時，15時・・・」となります。起点時間には必ず監視するため，5時の次は8時に監視します。

監視間隔は，時間単位の監視間隔と分単位の監視間隔を加えたものとなります。例えば，時間単位の監視間隔に「1」を指定し，分単位の監視間隔に「25」を指定した場合，監視間隔は「1時間25分」になります。

監視間隔は10分から24時間までの範囲で指定できます。

アクションの実行中に監視時刻になった場合は，その時刻の監視は行いません。監視間隔の間にアクションの実行が終了しない場合は，監視間隔を設定値よりも長くするようにしてください。

起点時間，監視間隔はエージェントの種類ごとに指定します。各種類のデフォルトを次に示します。

エージェントの種類 | 起点時間 | 監視間隔
ユーザトレー内案件の処理期限を監視するエージェント | 08:00 | 24(Hour)
ユーザトレー内案件の着信を監視するエージェント | 09:00 | 4(Hour)
ユーザトレー内案件の新着を一括監視するエージェント | 07:00 | 4(Hour)
業務ロールトレー内案件の着信を監視するエージェント | 10:00 | 6(Hour)
ユーザトレー内案件の処理期限を一括監視するエージェント | 06:00 | 24(Hour)

6.6　監視エージェント情報の参照・更新

ここでは，メインメニューで「(3) Agent」を選択して監視エージェント情報の参照・更新をする場合について説明します。

＜この節の構成＞

6.6.1　監視エージェント情報を表示する

6.6.2　監視エージェント情報を登録する

6.6.3　監視エージェント情報を削除する

6.6.1　監視エージェント情報を表示する

監視エージェント情報を削除したり，その情報を再登録する操作では，エージェントキーやシーケンス番号などの情報を指定します。したがって，監視エージェント情報を登録・削除する前には，次の操作で，エージェントに関する情報を参照します。

なお，ここで参照する情報はファイルに保存できます。情報をファイルに保存しておくことによって，ファイルの内容を一括して登録，削除できます。

メインメニューの「Command:」の後に「3」を入力します。
監視エージェント情報の参照・更新に関するメニューが表示されます。

「Command:」の後に「1」を入力します。
「UserID(Null=All user):」と表示されます。

参照したいユーザのユーザＩＤを入力してリターンキーを押します。すべてのユーザについて参照する場合は，何も入力しないでリターンキーを押します。
「Output file name(Null=Console):」と表示されます。

監視エージェント情報をファイル出力したい場合は，「Output file name(Null=Console):」に出力先のファイル名称をフルパスで入力してリターンキーを押します。ファイル出力しない場合は，何も入力しないでリターンキーを押します。
次の内容が表示され，ファイル出力を指定した場合はファイル出力されます。

Host-name

接続されているAgent Serverのホスト名称が表示されます。

Agent-Key

エージェントキーが表示されます。

Sequence-number

シーケンス番号が表示されます。

User-ID

エージェントを登録したユーザのユーザＩＤが表示されます。

指定例を次に示します。

6.6.2　監視エージェント情報を登録する

障害時に削除した監視エージェント情報を再登録できます。この操作をした場合，トレーの監視時刻でなくても，指定したエージェントキーに対応する監視エージェントのトリガが発生します。ただし，整合性確保の処理中であるエージェントの情報は登録できません。

メインメニューの「Command:」の後に「3」を入力します。
監視エージェント情報の参照・更新に関するメニューが表示されます。

「Command:」の後に「2」を入力します。
監視エージェント情報の登録・削除に関するメニューが表示されます。

「Command:」の後に「1」を入力します。

次の内容を指定します。

File name(Null=Ones)

ファイルの内容を登録する場合はファイル名をフルパスで入力します。エージェントを個別に登録する場合は空白にします。

Agent Key

ファイル名を指定しないでエージェントを個別に登録する場合は，登録するエージェントのエージェントキーを入力します。

Sequence number

ファイル名を指定しないでエージェントを個別に登録する場合は，登録するエージェントのシーケンス番号を入力します。

Agent server host name

登録するエージェントが格納されているAgent Serverのホスト名又はIPアドレスを入力します。

指定したら，「OK?[Yes:y/No:n(default)]:」の後に「y」を入力します。

指定例を次に示します。

6.6.3　監視エージェント情報を削除する

障害が発生した場合などは，監視エージェント情報を削除します。ただし，整合性確保の処理中であるエージェントの情報は削除できません。

なお，監視エージェント情報を削除する場合は，再登録する場合のために，あらかじめ監視エージェント情報をファイルに出力しておくことをお勧めします。

メインメニューの「Command:」の後に「3」を入力します。
監視エージェント情報の参照・更新に関するメニューが表示されます。

「Command:」の後に「2」を入力します。
監視エージェント情報の登録・削除に関するメニューが表示されます。

「Command:」の後に「2」を入力します。

次の内容を指定します。

File name(Null=Ones)

削除するファイル名をフルパスで入力します。エージェント情報ファイルのファイル名を指定すると，ファイル内のエージェントを一括して削除できます。エージェントを個別に削除する場合は空白にします。

Agent Key

ファイル名を指定しないでエージェントを個別に削除する場合は，削除するエージェントのエージェントキーを入力します。

Sequence number

ファイル名を指定しないでエージェントを個別に削除する場合は，削除するエージェントのシーケンス番号を入力します。

Agent server host name

削除するエージェントが格納されているAgent Serverのホスト名又はIPアドレスを入力します。

指定したら，「OK?[Yes:y/No:n(default)]:」の後に「y」を入力します。

指定例を次に示します。

6.7　ダンプファイルの出力

ここでは，メインメニューで「(4) Dump」を選択してダンプファイルを出力する場合について説明します。

バックアップの対象となるファイルについて，ダンプファイルを出力できます。

Workflow Agentが起動中の場合は終了します。

メインメニューの「Command:」の後に「4」を入力します。
ダンプ出力に関するメニューが表示されます。

「Command:」の後に「1」を入力します。
「Directory name:」と表示されます。

「Directory name:」の後にダンプファイルを出力するフォルダ（ディレクトリ）名を入力してリターンキーを押します。
「Total file size[管理ファイルの合計サイズ] Dump output OK? [Yes:y/No:n(default)]:」と表示されます。

出力してもよければ「y」を入力します。
指定したフォルダ（ディレクトリ）にダンプファイルが出力されます。

指定例を次に示します。

6.8　操作結果のエディタ出力

Workflow Agentでも，Agent Serverと同様に，操作結果をエディタに出力できます。エディタを使用することによって，出力された情報量が多い場合でも，画面をスクロールしながら結果を確認できます。エディタを使用するよう指定した場合は，御使用のマシンに設定されているデフォルトのエディタが開きます。

なお，デフォルトではエディタを使用しない設定になっています。

監視エージェント情報を参照・更新するメニューで，「Command:」の後に「x」を入力します。
「Output editor[現在のエディタ表示の状態] u(Use)/n(NoUse):」と表示されます。

「Output editor[現在のエディタ表示の状態] u(Use)/n(NoUse):」の後に，「u」を入力します。
エディタを使用できる状態になります。この後，監視エージェント情報を参照する操作をすると，結果がエディタに出力されます。

指定例を次に示します。

注意事項

エディタを使うように指定した場合は，管理ツールで監視エージェント情報をファイルに出力する指定はできません。この場合，エディタの持つ保存機能でファイル出力してください。

6.9　バックアップとリストア

障害が発生して，環境を再構築する場合のために，バックアップを取得することをお勧めします。バックアップ情報はリストアすることによって回復できます。

バックアップ及びリストアは，Windows NTのバックアップ機能を使用します。

＜この節の構成＞

6.9.1　バックアップ

6.9.2　リストア

6.9.1　バックアップ

Workflow Agentが起動中の場合は終了します。

Windows NTの機能を使用して，次に示すWorkflow Agentのファイル及びローカルレジストリ情報のバックアップを取得します。
このとき，Agent Serverの情報とWorkflow Agentの情報との同期をとるために，Agent Serverのバックアップも同時に取得することをお勧めします。Workflow Agentは，各処理期限監視及び案件着信監視エージェントの定義内容に関する情報（監視エージェント情報）をAgent Serverから取得してエージェントを処理します。各処理期限監視及び案件着信監視エージェントについて，Agent Serverに定義されている情報とWorkflow Agentが取得している情報が一致していないエージェントは動作しません。
ファイル

インストールディレクトリ¥WorkflowAgent¥SVcomのファイル（Workflow Agentの管理テーブルのファイル）

インストールディレクトリ¥WorkflowAgent¥SVdefのファイル（監視エージェント情報のファイル）

インストールディレクトリ¥WorkflowAgent¥SVqueのファイル（キューファイル）

インストールディレクトリ¥WorkflowAgent¥SVadfのファイル（Workflow Agent定義情報ファイル）

インストールディレクトリ¥WorkflowAgent¥SVdstのファイル（Workflow Agentメール送信先情報ファイル）

インストールディレクトリ¥WorkflowAgent¥SVtrcのファイル（Workflow Agentトレース情報出力ファイル）

レジストリ
「HKEY_LOCAL_MACHINE¥SOFTWARE¥HITACHI¥WorkflowAgent以下の情報」
ただし，ローカルレジストリファイル全体のバックアップを取得しておくことをお勧めします。
なお，上記の情報のバックアップだけを取得する場合は，Windows NTのレジストリエディタを使用します。レジストリエディタについては，Windows NTのマニュアルのレジストリエディタの説明を参照してください。

Workflow Agentを起動します。

注意事項

ローカルレジストリファイルはシステム内で共有するため，破損しないよう注意して扱ってください。ローカルレジストリファイルについては，Windows NTのマニュアルのシステム構成の説明を参照してください。

6.9.2　リストア

Workflow Agentが起動中の場合は終了します。

Windows NTの機能を使って，バックアップファイルをリストアします。

Workflow Agentの管理ツールで，監視エージェント情報をファイルに保存します。
ここで保存した情報は，リストア後，ファイルに保存した情報がWorkflow Agentに格納されているかを参照したり，各処理期限監視及び案件着信監視エージェントがどのマシンのAgent Serverに定義されているかを参照する場合に使用します。

Workflow Agentのシステム環境を初期化します。

Workflow Agentを起動します。

Agent Serverの管理ツールで，登録されている処理期限監視及び案件着信監視エージェントを停止させます。
このとき，停止させるエージェントがどのマシンのAgent Serverに定義されているかを確認する場合は，3.で保存した監視エージェント情報のファイルを参照します。監視エージェント情報に表示されるエージェントキー（「Agent-Key=・・・」の形式で表示されます）の上位8けたの数字が，そのエージェントが定義されているマシンのIPアドレスになります。

Agent Serverの管理ツールで，使用する処理期限監視及び案件着信監視エージェントを活動させます。
このとき，活動させた処理期限監視及び案件着信監視エージェントの情報がWorkflow Agentに渡されるため，3.で保存したエージェントが使用できます。

6.10　ユーザトレー内案件の一括新着監視エージェントによるメール宛先BCC化

Workflowエージェントの「ユーザトレー内案件の一括新着監視（管理者用）」エージェントの通知は，案件を持つユーザの宛先の属性 "TO" としてメール送信しています。このため，案件を持つユーザが複数の場合，メールの受信者が同報者のメール宛先を確認することができます。メールの受信者に同報者のメール宛先を知られたくない場合は，この「ユーザトレー内案件の一括新着監視エージェントによるメールの宛先BCC化」オプションを設定することにより，メールの宛先の属性を“BCC”に変更することができます。

機能

ユーザトレー内案件の一括新着監視エージェントによるメールの宛先BCC化は，システム環境変数で設定します。

(1) オプションが未指定の場合

「ユーザトレー内案件の一括新着監視」エージェントの監視結果をメールにより通知する場合，メールの宛先の属性を "TO" とします。メールの受信者は，同報者の宛先を確認できます。

(2) オプションを指定した場合

「ユーザトレー内案件の一括新着監視」エージェントの監視結果をメールにより通知する場合，メールの宛先の属性を“BCC”とします。メールの受信者には，同報者の宛先が見えません。

オプションを有効にする場合，Workflow AgentをインストールしてあるPCに，以下のシステム環境変数を設定します。

環境変数名 | 値
WA_MAIL_ADDR_BLIND | ON

注意事項

システム環境変数の設定を有効にするには，コンピュータの再起動が必要です。

本オプションを設定したWorkflow Agentから送信したメールだけ，宛先の属性が“BCC”になります。複数のWorkflow Agentを使用している場合は，すべてのWorkflow Agentに設定が必要です。

7.　Mail Agentの運用

この章では，Mail Agentの起動や終了の操作，及び管理者がMail Agent運用時に使用する運用コマンドや管理ツールの操作について説明します。

＜この章の構成＞

7.1　Mail Agentの起動と終了

7.2　Mail Agentの運用コマンド

7.3　Mail Agent管理ツールに関する基礎知識

7.4　システム情報の参照・更新・初期化

7.5　ダンプファイルの出力

7.6　バックアップとリストア

7.7　Mail Agentのアクション抑止機能

7.8　自動転送エージェントにおけるASCIIオプション

7.9　自動転送時の返信先変更機能

7.1　Mail Agentの起動と終了

この節ではMail Agentの起動と終了の方法について説明します。

＜この節の構成＞

7.1.1　Mail Agentの起動

7.1.2　Mail Agentの終了

7.1.1　Mail Agentの起動

Mail Agent本体とMail Agent実行エンジンをそれぞれ別に起動します。

＜この項の構成＞

(1)　Mail Agent本体を起動する

(2)　Mail Agent実行エンジンを起動する

(1)　Mail Agent本体を起動する

Mail Agent本体はWindows NTの［サービス］ダイアログから起動します。

Administratorの権限でMail Agent本体をインストールしたマシンにログオンします。

管理ツールの「サービス」を開いて［サービス］ダイアログを表示します。

「サービス」の欄から「Mail Agent」を選択して［開始］ボタンをクリックします。
「状態」の欄に「開始」と表示され，Mail Agent本体が起動します。

(2)　Mail Agent実行エンジンを起動する

Mail Agent実行エンジンはWindows NTの［サービス］ダイアログから起動します。

Administratorの権限でMail Agent実行エンジンをインストールしたマシンにログオンします。

管理ツールの「サービス」を開いて［サービス］ダイアログを表示します。

「サービス」の欄から「Mail Agent Function」を選択して［開始］ボタンをクリックします。
「状態」の欄に「開始」と表示され，Mail Agent実行エンジンが起動します。

7.1.2　Mail Agentの終了

終了する場合も，Mail Agent本体とMail Agent実行エンジンをそれぞれ別に終了します。

＜この項の構成＞

(1)　Mail Agent本体を終了する

(2)　Mail Agent実行エンジンを終了する

(1)　Mail Agent本体を終了する

Administratorの権限でMail Agent本体をインストールしたマシンにログオンします。

管理ツールの「サービス」を開いて［サービス］ダイアログを表示します。

［サービス］ダイアログから「Mail Agent」を選択して［停止］ボタンをクリックします。

停止してもよいか問い合わせるダイアログが表示されますので，［はい］ボタンをクリックします。
「状態」の欄が空白となり，Mail Agent本体が終了します。

(2)　Mail Agent実行エンジンを終了する

Administratorの権限でMail Agent実行エンジンをインストールしたマシンにログオンします。

管理ツールの「サービス」を開いて［サービス］ダイアログを表示します。

［サービス］ダイアログから「Mail Agent Function」を選択して［停止］ボタンをクリックします。

停止してもよいか問い合わせるダイアログが表示されますので，［はい］ボタンをクリックします。
「状態」の欄が空白となり，Mail Agent実行エンジンが終了します。

7.2　Mail Agentの運用コマンド

Mail Agentでは，システム管理者向けに運用コマンドを提供しています。この節では，運用コマンドの概要と各コマンドの使用方法について説明します。

＜この節の構成＞

7.2.1　運用コマンドの概要

7.2.2　Mail Agent本体管理ツールの起動（mamgr）

7.2.3　Mail Agent実行エンジン管理ツールの起動（mafmgr）

7.2.4　Agent Serverのホスト名一覧表示・Agent Serverとの整合性の確保(mamatch)

7.2.5　Mail Agent本体のトレースの参照（matrc）

7.2.6　Mail Agent実行エンジンのトレースの参照（maftrc）

7.2.7　メールリカバリ送信機能

7.2.8　リトライ状態解除機能

7.2.1　運用コマンドの概要

ここでは，どのような場合に運用コマンドを使用するかについて説明します。また，運用コマンドの記述形式や使用方法についても説明します。

＜この項の構成＞

(1)　どのような場合に運用コマンドを使用するか

(2)　運用コマンドの実行

(3)　運用コマンドの記述形式

(4)　運用コマンドの説明で使用する記号

(1)　どのような場合に運用コマンドを使用するか

Mail Agent本体管理ツールの起動(mamgr)

エージェントの管理・運用やトラブルシュートを支援するMail Agent本体管理ツールを起動する場合に使用します。なお，Mail Agent管理ツールの詳細については，7.3節以降で説明しています。

Mail Agent実行エンジン管理ツールの起動(mafmgr)

エージェントの管理・運用やトラブルシュートを支援するMail Agent実行エンジン管理ツールを起動する場合に使用します。なお，Mail Agent管理ツールの詳細については，7.3節以降で説明しています。

Agent Serverのホスト名一覧表示・Agent Serverとの整合性の確保(mamatch)

Mail Agentのエージェント情報をAgent Serverのエージェント情報と一致させ，両者の整合性を確保する場合に使用します。Mail Agentがダウンした場合や，エージェント情報が失われた場合，このコマンドで整合性を確保することによって回復できます。

Mail Agent本体のトレースの参照(matrc)

Mail Agent本体の内部関数のトレースを参照したい場合に使用します。内部関数のトレースは障害時の保守情報として使用します。

Mail Agent実行エンジンのトレースの参照(maftrc)

Mail Agent実行エンジンの内部関数のトレースを参照したい場合に使用します。内部関数のトレースは障害時の保守情報として使用します。

(2)　運用コマンドの実行

Mail Agentの運用コマンドを実行できるのは，Administrator権限を持つユーザだけです。次の手順で実行してください。Mail Agent本体の運用コマンドを実行する場合とMail Agent実行エンジンの運用コマンドを実行する場合とで操作が異なります。

Mail Agent本体の運用コマンドを実行する場合

コマンドプロンプト画面を表示します。

次のディレクトリ（フォルダ）に移動します。

<Mail Agent本体のインストール先>¥MailAgent¥SVbin

運用コマンドを入力します。

Mail Agent実行エンジンの運用コマンドを実行する場合

コマンドプロンプト画面を表示します。

次のディレクトリ（フォルダ）に移動します。

<Mail Agent実行エンジンのインストール先>¥MailAgentFunction¥SVbin

運用コマンドを入力します。

(3)　運用コマンドの記述形式

形式

コマンド名称　[オプション．．．]

機能

コマンドの機能を説明しています。

オプション

スラント記号（/）で始まる文字列です。オプションによっては引数が必要な場合があります。

(4)　運用コマンドの説明で使用する記号

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

記号
意味

[　　]
この記号で囲まれているオペランドは省略できることを示す。
（例）ABC [/D ] [/E ]
この場合，次の指定が可能となる。

ABC

ABC　/D

ABC　/E

ABC　/D　/E

7.2.2　Mail Agent本体管理ツールの起動（mamgr）

形式

mamgr

機能

Mail Agent本体では，エージェントの運用・管理やトラブルシュート用に管理ツールを提供しています。本コマンドでは，この管理ツールを起動してメインメニューを表示します。管理ツールはメインメニューから対話形式で使用できます。

なお，Mail Agent管理ツールの使用方法については，7.3節以降で説明しています。

オプション

なし

注意事項

このコマンドを実行できるのはAdministrator権限を持つユーザだけです。

7.2.3　Mail Agent実行エンジン管理ツールの起動（mafmgr）

形式

mafmgr

機能

Mail Agent実行エンジンでは，エージェントの運用・管理やトラブルシュート用に管理ツールを提供しています。本コマンドでは，この管理ツールを起動してメインメニューを表示します。管理ツールはメインメニューから対話形式で使用できます。

なお，Mail Agent管理ツールの使用方法については，7.3節以降で説明しています。

オプション

なし

注意事項

このコマンドを実行できるのはAdministrator権限を持つユーザだけです。

7.2.4　Agent Serverのホスト名一覧表示・Agent Serverとの整合性の確保(mamatch)

＜この項の構成＞

(1)　Agent Serverのホスト名の一覧表示

(2)　Agent Serverとの整合性の確保

(1)　Agent Serverのホスト名の一覧表示

形式

mamatch  /l  [/o  ホスト名一覧出力先ファイル名]

機能

整合性を確保する対象となるAgent Serverのホスト名を一覧表示できます。

オプション

/l

Mail Agentと接続中のAgent Serverのホスト名を一覧表示できます。表示されるのは，Mail Agentのマシンで認識しているホスト名で，DNS又はhostsファイルに設定されているものです。

/o ホスト名一覧出力先ファイル名

ホスト名一覧を出力するファイル名を指定します。フルパスで指定しない場合は，カレントディレクトリに出力されます。指定したファイル名が既にある場合は，上書きされます。

本オプションを省略した場合は，標準出力に出力されます。

注意事項

このコマンドを実行できるのは，Administrator権限を持つユーザだけです。

このコマンドは，Mail Agentサービスが起動している場合に実行できます。

(2)　Agent Serverとの整合性の確保

形式

mamatch  [/s  Agent Serverのホスト名又はIPアドレス]  [/t  タイマ値(分)]

機能

Mail Agentのエージェント情報をAgent Serverのエージェント情報と一致させ，両者の整合性を確保します。

オプション

/s Agent Serverのホスト名又はIPアドレス

整合性確保の対象となるAgent Serverのホスト名又はIPアドレスを指定します。ホスト名を指定する場合は，DNS又はhostsファイルに設定されている名称で指定してください。IPアドレスを指定する場合は，「***.***.***.***」の形式で指定してください。

本オプションを省略した場合は，Mail Agentで認識しているすべてのAgent Serverと整合性を確保します。

/t タイマ値(分)

整合性確保の状態合わせに要する待ち時間を1から60までの数字で指定します。単位は分，デフォルトは15です。

注意事項

このコマンドを実行できるのは，対象となるAgent Serverのバージョンが03-10以降の場合です。

このコマンドを実行できるのは，Administrator権限を持つユーザだけです。

このコマンドは，Mail Agentサービスが起動している場合に実行できます。

7.2.5　Mail Agent本体のトレースの参照（matrc）

形式

matrc  [>出力先ファイル名]  [/C]

機能

Mail Agent本体が提供する内部関数のトレースを参照する場合に使用します。内部関数のトレースは障害時の保守情報として使用します。

オプション

>出力先ファイル名

トレースを出力するファイル名を指定します。省略した場合は標準出力に出力されます。

/C

Mail Agent本体が持つトレース情報を初期化する場合に指定します。トレース情報を初期化すると，過去のトレースデータは消去されます。

注意事項

このコマンドを実行できるのは，Administrator権限を持つユーザだけです。

このコマンドで表示できるのは，トレース種別ごとに4,000～400,000エントリまでです。エントリ数は，トレースの拡張コマンド（agtrcex）によって変更できます。

7.2.6　Mail Agent実行エンジンのトレースの参照（maftrc）

形式

maftrc  [>出力先ファイル名]  [/C]

機能

Mail Agent実行エンジンが提供する内部関数のトレースを参照する場合に使用します。内部関数のトレースは障害時の保守情報として使用します。

オプション

>出力先ファイル名

トレースを出力するファイル名を指定します。省略した場合は標準出力に出力されます。

/C

Mail Agent実行エンジンが持つトレース情報を初期化する場合に指定します。トレース情報を初期化すると，過去のトレースデータは消去されます。

注意事項

このコマンドを実行できるのは，Administrator権限を持つユーザだけです。

このコマンドで表示できるのは，トレース種別ごとに4,000～400,000エントリまでです。エントリ数は，トレースの拡張コマンド（agtrcex）によって変更できます。

7.2.7　メールリカバリ送信機能

Agent - Mail Serverがメールの自動転送や自動返信などのアクションを実行中に異常終了した場合，異常終了したアクションおよび実行待ちのアクションは実行されません。メールリカバリ送信機能は，Agent - Mail Serverのアクション処理時の異常終了などに伴い，まだ実行されないアクション（未実行アクション）を実行します。また，「活動(作業中)」のまま実行しないエージェント（異常終了アクション）の回復も行います。

＜この項の構成＞

(1)　本機能を利用するための設定

(2)　Agent - Mail Server異常終了発生時の本機能実行準備

(3)　本機能の利用

(4)　メッセージ，現象からの要因・対処

(5)　実行例

(1)　本機能を利用するための設定

本機能を利用するためには，次の設定をしておく必要があります。

システム環境変数の設定

次のシステム環境変数をAgent - Mail Serverのサービス（サービス名: MailAgent）を起動するマシンに設定しておく必要があります。

環境変数名 | 値
MA_AGENT_RECOVERY | ON

設定がない，または値が“ON”以外の場合は，異常終了時に回復するための情報が出力されないため，本機能を利用できません。システム環境変数の設定を有効にするためには，マシンの再起動が必要です。

servicesファイルの設定

<Windowsのシステムフォルダ>¥system32¥drivers¥etc下にあるservicesファイルに以下を追加します。

gmaxmarcvy    20084/tcp

例外リストの登録（Windowsファイアウォールを利用している場合）

Windowsファイアウォールを利用している場合は，例外リスト登録を行う必要があります。例外リストの登録は，Administrator権限を持つユーザでコマンドプロンプトを起動し，以下のnetshコマンドにより行います。

（netshコマンド）

Windows 2008またはWindows 2012をご使用の場合には「4.5.1 (2)　ファイアウォールの設定についての制限事項」を参照してください。

(2)　Agent - Mail Server異常終了発生時の本機能実行準備

(a)　MAaction.queおよびMAcuract.datファイルのバックアップ

Agent - Mail Serverの実行中に異常終了が発生したとき，次のファイルを任意のフォルダにバックアップします。

<Agent - Mail Serverインストールフォルダ>¥MailAgent¥SVque¥MAaction.que

<Agent - Mail Serverインストールフォルダ>¥MailAgent¥SVque¥MAcuract.dat

ファイルのバックアップをする前にAgent - Mail Serverのサービスを起動しないでください。起動した場合，本機能によるリカバリーが行えなくなります。

(b)　前提サービスの異常状態の回復

本機能を利用する前に前提となる次のサービスが起動されていることを確認します。

Agent Server

Agent - Mail Function

Mail Server

なお，Agent - Mail Serverが起動していないことも確認します。特に，サーバ機の異常等で異常終了の状態となった場合には，上記の前提サービスが正常に起動されてから，本機能をお使いください。サービスが起動されていない場合には正しく実行されません。

(3)　本機能の利用

本機能は，メールリカバリ送信コマンドmarecvryにより実行できます。コマンドは，次のフォルダにインストールされます。

<Agent - Mail Serverインストールフォルダ>¥MailAgent¥Svbin

marecvryコマンドには，次の三つの機能があります

アクション一覧の状態表示（/lオプション指定）
異常終了時のアクションの一覧を表示します。未実行アクションおよび異常終了アクションが表示できます。

未実行アクションの実行（/eオプション指定）
まだ実行されないアクションを実行します。未実行のアクションの実行は，全部または種別（「個人メールの自動転送」，「個人メールの自動返信」，「ユーザプログラム起動」）ごとに実行可能です。

異常終了アクションの回復（/rオプション指定）
異常終了したエージェントを回復します。異常終了したエージェントとは，状態が「活動(作業中)」のままとなったエージェントです。本コマンドを実行することによりエージェントの状態を「活動(作業中)」から「活動(待機中)」に変更します。ただし，回復したエージェントが異常終了時に実行していたアクションは実行されません。

以下に，本コマンドの形式を示します。

形式

Marecvry  [/d  ＜フォルダ名＞]  [/l]  [/e  [/t  {AR  |  AF  |  UP}]  [/r]

オプション

/d ＜フォルダ名＞

バックアップしたMAaction.queおよびMAcuract.datのあるフォルダを指定します。240バイト以下で，ドライブ名からのフルパスで指定します。

本オプションを省略した場合は，コマンドを実行したフォルダを仮定します。

本オプションでは<Agent - Mail Serverインストールフォルダ>¥MailAgent¥SVqueを指定しないでください。marecvryコマンドは，実行時にMAaction.queおよびMAcuract.datの更新を行います。指定した場合，MailAgentサービスの動作は保証できません。

/l

アクション一覧の状態を表示します。なお，/l，/e，/rを指定しない場合は，/lを仮定します。

表示例を次に示します。

（状態の表示例）

それぞれの表示項目を次に示します。

#
説明

(1)
アクションの状態を表す文字列
ERR-NOREC：異常終了したアクションの回復未実行，または回復失敗※1。エージェントの状態は活動(作業中)。
ERR-RECOV：異常終了したアクションの回復成功。エージェントの状態は活動(待機中)。
ACT-NOEXE：未実行アクションを実行していない，または実行失敗※2。
ACT-EXEC：未実行アクションの実行が正常終了した。
ACT-ERROR：未実行アクションの実行が異常終了した。

※1

回復失敗とは回復を行おうとしたが，回復を実行する前の処理で異常となった場合，この状態となります。この場合，異常となった原因を回復したあとに，再度コマンドを実行することにより回復できます。

※2

未実行のアクションを実行しようとしたが，アクションを実行する前の処理で失敗した場合，この状態となります。この場合，異常となった原因を回復したあとに，再度コマンドを実行することにより実行できます。

(2)
エージェントが登録されているAgentServerのホスト名

(3)
エージェントキー

(4)
エージェント種別
メールの自動転送：AF
メールの自動返信：AR
ユーザプログラムの自動起動：UP

(5)
エージェント生成者のユーザID

(6)
OR名ID

(7)
メールID

(8)
アクション実行のきっかけとなったメールの主題

/e

未実行のアクションをすべて実行します。種別の指定（/t）がある場合，対象とする種別のアクションだけ実行します。種別の指定は1個だけ指定できます。メールの自動転送の場合は「AF」，メールの自動返信の場合は「AR」，ユーザプログラムの自動起動の場合は「UP」を指定します。

実行結果は，実行したアクションごとに，実行前のアクションの状態，アクション実行時の活動ログ，および終了メッセージがコンソールに表示されます。ただし，エラーの詳細情報は，イベントログに表示します。なお，ここで出力される活動ログはAgent Serverの活動ログには出力されません。

（実行時の表示例）

/r

異常終了により「活動(作業中)」の状態になっているエージェントを「活動(待機中)」に変更します。実行結果は，アクション一覧の形式でコンソールに表示します。

（回復エージェントの表示例）

なお，アクション一覧の表示（/l）にてERR-NOREC（またはERR-RECOV）が表示されないまま「活動(作業中)」となっているエージェントは回復されません。

(4)　メッセージ，現象からの要因・対処

項番
内容

1

現象

MAcuract.datがSVqueの下に作成されていない。

要因

環境変数MA_AGENT_RECOVERYにONが設定された状態でAgent - Mail Serverのサービスが起動されていません。

対処

システム環境変数MA_AGENT_RECOVERYにONが正しく設定されているかを確認してください。「(1)　本機能を利用するための設定」を参照してください。また，正常に設定されていることを確認するために，Agent - Mail Serverのサービス起動後に<Agent - Mail Serverインストールフォルダ>¥MailAgent¥SVque¥MAcuract.datが作成されているか確認することを推奨します。

2

現象

コンソールにSyntax:marecvry [/l] [/e [/t {AR|AF|UP}] ] [/r] [/d <directory name>]が表示される。

要因

コマンドの引数を正しくありません。

対処

コマンドを正しく指定してください。

3

現象

コマンドを実行するとコンソールにAgent Server Error. error code = 77826 detail=AG_initがコンソールに出力されてコマンドが終了する。

要因

servicesファイルにgmaxmarcvyのエントリーがないか，正しく記述されていません。

対処

servicesにgmaxmarcvyのエントリーが正しく記述されているか確認してください。詳細は，「(1)　本機能を利用するための設定」を参照してください。

4

現象

一覧を表示，未実行アクションの実行や異常終了アクションの回復を実行したとき，状態の一覧表示のエージェント種別，およびエージェント生成者のユーザIDが?????の表示となる。

要因

このエラーが発生するのは，次の場合が考えられます。

Agent Serverのサービスが起動されていない。

Agent ServerとAgent - Mail Serverとの間で通信できない状態となっている。

エージェントが削除されている。

対処

Agent Serverのサービスが起動されていない場合は起動してください。また，pingコマンドなどでネットワーク通信が正常に行われているか，該当するエージェントが存在するかご確認ください。

5

現象

コマンドを実行すると「Service of Agent - Mail Server is active」が表示される。

要因

Agent - Mail Serverのサービスが起動された状態となっています。

対処

コマンド実行前にAgent - Mail Serverのサービスが終了していることを確認してください。

6

現象

未実行アクション実行時，File（xxxx¥¥MAcuract.dat）not found.がコンソールに出力される。

要因

MAcuract.datが /dで指定されたフォルダまたは，カレントフォルダにありません。

対処

MAcuract.datを /dで指定したフォルダにコピーしてください。

7

現象

異常終了アクション回復時，File（xxxx¥¥MAaction.que）not found.がコンソールに出力される。

要因

MAaction.que が /dで指定されたフォルダまたは，カレントフォルダにありません。

対処

MAaction.que を /dで指定したフォルダにコピーしてください。

8

現象

未実行アクションの実行時，活動ログの内容に，「エージェント定義データの取得に失敗しました。メールの転送/返信/ユーザプログラム起動処理を中断します。」が出力される。

要因

Agent Serverのサービスが起動されていません。

対処

Agent Serverのサービスの起動を確認後，再度，未実行アクションの実行を行ってください。

9

現象

異常終了アクションの回復時，コンソールに「Agent Server error. error code = 15 detail = AG_actlogwrite」が表示され処理が終了する。

要因

Agent Serverのサービスが起動されていません。

対処

Agent Serverのサービスの起動を確認後，再度，異常終了アクションの回復を行ってください。

10

現象

アクション一覧の表示，または異常終了アクションの回復時，コンソールに「Mail Server error. error code = xx detail = Mail not found」が表示される。

要因

対象となったメールまたはユーザがすでにMail Serverから削除されています。

対処

該当のユーザ/メールがMail Serverに存在しているかを確認してください。該当のユーザ/メールがMail Serverに存在していない場合，メールの主題は表示されません。また，異常終了アクションの回復には影響しません。

11

現象

未実行アクションの実行時，コンソールに「Mail Server error. error code = xx detail = Mail not found」が表示されていた。

要因

対象となったメールまたはユーザがすでにMail Serverから削除されています。

対処

該当のユーザ/メールがMail Serverに存在しているかを確認してください。該当のユーザ/メールがMail Serverに存在していない場合，未実行アクションの実行はできません。なお，ユーザが存在しないために本エラーが出力された場合に，コンソールに表示される活動ログに「エージェントを作成したユーザまたはメールアドレスの情報が見つかりません。エージェントを停止します」と表示されますが該当のエージェントは停止しません。その場合には該当のエージェントを削除することを推奨します。

注意事項

このコマンドを実行できるのは，Administrator権限を持つユーザだけです。

このコマンドは，Agent Server，Agent - Mail Function，およびMail Serverのサービスが起動している場合に実行できます。

このコマンドは，Agent - Mail Serverのサービスが停止している場合に実行できます。

Agent - Mail Serverの異常終了発生後，このコマンドを実行する前にAgent - Mail Serverのサービスを起動した場合には，異常終了したアクションおよび実行待ちのアクションは実行されません。このコマンドでバックアップしたファイルを指定することにより実行待ちアクションを実行できます。

/l（アクション一覧の表示），/e（未実行アクションの実行），/r（異常終了アクションの回復）は，同時に指定できます。同時に指定した場合は，オプションの指定順序に関係なく/l（アクション一覧の表示），/e（未実行アクションの実行），/r（異常終了アクションの回復）の順に処理します。

異常終了したエージェントの生成者に新着メールがあると，/r（異常終了アクションの回復）を実行後に「PPサーバ未起動」のエラーになることがあります。

システム環境変数の設定を有効にするためには，マシンの再起動が必要です。

/lにてERR-NOREC（またはERR-RECOV）が表示されないまま「活動(作業中)」となっているエージェントは，異常終了アクションの回復では回復できません。そのような場合には，該当のエージェントを一度停止状態にし，再度，活動状態にしてください。

marecvryコマンドは実行時にMAaction.queおよびMAcuract.datファイルの更新を行います。つきましては，marecvryコマンドで使用するMAaction.queおよびMAcuract.datファイルに，<Agent - Mail Serverインストールフォルダ>¥MailAgent¥SVqueのファイルを指定しないでください。また，カレントフォルダを<Agent - Mail Serverインストールフォルダ>¥MailAgent¥SVqueにしてmarecvryコマンドの実行を行わないでください。指定して実行した場合，MailAgentサービスの動作は保証しません。

(5)　実行例

marecvryコマンドの実行例を以下に示します。

(a)～(d)：格納先(/d)の指定を省略（バックアップしたファイルのあるフォルダで実行）

(e)～(g)：格納先(/d)を指定した実行例

(a)　アクション一覧表示

(b)　未実行アクションの実行（メールの自動返信だけ）

(c)　アクション一覧表示（メールの自動返信実行後）

(d)　異常終了アクションの回復

(e)　アクション一覧表示（バックアップがD:¥MailAgent_Backup¥1219にある場合）

(f)　未実行アクションの実行（バックアップがD:¥MailAgent_Backup¥1219にある場合）

(g)　アクション一覧表示（バックアップがD:¥MailAgent_Backup¥1219にある場合）

7.2.8　リトライ状態解除機能

Agent - Mail Serverによって，イベントログに「KDMA02008-E トリガ発生の通知中に通信で障害が発生しました。1時間後にリトライを行います。」というエラーが出力された場合に，1時間のリトライ待ちとなったエージェントの状態を解除し，そのエージェントをすぐに実行します。

本機能は，リトライ状態解除コマンドmatrgrtyにより実行できます。コマンドは，次のフォルダにインストールされます。

<Agent - Mail Serverインストールフォルダ>¥MailAgent¥Svbin

matrgrtyコマンドには，次の二つの機能があります。

監視エージェントの一覧表示（/lオプション指定）
監視エージェントの一覧を表示します。リトライ待ちとなっているエージェントだけの一覧も表示できます。

リトライ待ちのエージェントの再実行（オプション指定なし）
リトライ待ちとなっているエージェントをすべて再実行します。

以下に，本コマンドの形式を示します。

形式

matrgrty  [/l  [/r]]

オプション

/l　[/r] (l：小文字のエル)

監視エージェントの一覧を表示します。/rを同時に指定するとリトライ待ちのエージェントだけ表示します。

次の項目を表示します。

#
説明

(1)
リトライ状態を表す文字列
ACTIVE：監視中
RETRY ：リトライ待ち

(2)
エージェントが登録されているAgentServerのホスト名

(3)
エージェントキー

(4)
エージェント生成者のユーザID

(5)
監視ユーザのOR名ID

オプション指定なし

オプションを指定しない場合は，リトライ待ちのエージェントを再実行します。KDMA02008-Eのエラー要因が解消されていないまま再実行（本コマンドの実行）を行うとKDMA02008-Eのエラーとなり，再度リトライ待ちとなります。

注意事項

このコマンドを実行できるのは，Administrator権限を持つユーザだけです。

このコマンドは，Agent Server，Agent - Mail Function，Agent - Mail Server，およびMail Serverのサービスが起動している場合に正常に実行できます。

＜この項の構成＞

(1)　メッセージ，現象からの要因・対処

(2)　実行例

(1)　メッセージ，現象からの要因・対処

項番
内容

1

現象

リトライ待ちの再実行を行ったが，イベントログに再度KDMA02008-Eのエラーが出力されていた。

要因

このエラーが発生するのは，次の場合が考えられます。

Agent - Mail Functionのサービスが起動されていない。

Agent - Mail FunctionとAgent - Mail Serverとの間で通信できない状態となっている。

対処

Agent - Mail Functionのサービスが起動されていない場合は起動してください。また，pingコマンド等でネットワーク通信が正常に行われているかご確認ください。

2

現象

コマンド実行すると，コンソールに「Service of Agent - Mail Server is not active」が表示される。

要因

Agent - Mail Serverのサービスが起動されていません。

対処

Agent - Mail Serverのサービスを起動してください。

(2)　実行例

(a)　一覧表示

(b)　一覧表示(リトライ待ちのエージェントだけ表示)

(c)　リトライの実行

7.3　Mail Agent管理ツールに関する基礎知識

Mail Agentが独自に持つ環境に関する操作ではMail Agent管理ツールを使用します。

この節では，Mail Agent管理ツールを使ってどのような情報に関する操作をするのかについて説明します。

＜この節の構成＞

7.3.1　管理ツールで操作する情報

7.3.2　管理ツールの操作

7.3.1　管理ツールで操作する情報

＜この項の構成＞

(1)　Mail Agent本体のシステム環境に関する操作

(2)　Mail Agent実行エンジンのシステム環境に関する操作

(1)　Mail Agent本体のシステム環境に関する操作

Mail Agent本体が持つシステム環境には，接続するエージェントサーバを幾つにするか，メールボックスを何分おきに監視するかといった情報があります。Mail Agent本体管理ツールでは，これらの情報の参照，更新ができます。

なお，バックアップ及びリストアは，Windows NTの提供するバックアップ，リストア機能を使用します。

(2)　Mail Agent実行エンジンのシステム環境に関する操作

Mail Agent実行エンジンが持つシステム環境には，接続するメールサーバを幾つにするか，自動返信や自動転送エージェントを幾つ登録できるかといった情報があります。Mail Agent実行エンジン管理ツールでは，これらの情報の参照，更新ができます。

なお，バックアップ及びリストアは，Windows NTの提供するバックアップ，リストア機能を使用します。

7.3.2　管理ツールの操作

Mail Agent管理ツールもAgent Server管理ツールと同様に，メニューによる対話形式で操作できます。Mail Agent管理ツールの基本的な操作方法について説明します。

＜この項の構成＞

(1)　管理ツールの起動

(2)　管理ツールのメインメニューとコマンドの入力方法

(1)　管理ツールの起動

Mail Agent管理ツールを起動する手順を次に示します。Mail Agent本体管理ツールを起動する場合とMail Agent実行エンジン管理ツールを起動する場合とで操作が異なります。

Mail Agent本体管理ツールを起動する場合

Administratorの権限でWindows NTにログオンします。

コマンドプロンプト画面を表示します。

次のフォルダ（ディレクトリ）に移動します。
<Mail Agent本体のインストール先>¥MailAgent¥SVbin

管理ツールを起動する次のコマンド「mamgr」を入力してリターンキーを押します。
管理ツールのメインメニューが開きます。

Mail Agent実行エンジン管理ツールを起動する場合

Administratorの権限でWindows NTにログオンします。

コマンドプロンプト画面を表示します。

次のフォルダ（ディレクトリ）に移動します。
<Mail Agent実行エンジンのインストール先>¥MailAgentFunction¥SVbin

管理ツールを起動する次のコマンド「mafmgr」を入力してリターンキーを押します。
管理ツールのメインメニューが開きます。

(2)　管理ツールのメインメニューとコマンドの入力方法

管理ツールのメニューコマンドの一覧を表7-1に示します。

管理ツールにはMail Agentを終了している場合にだけ使用できるコマンドがあります。

表7-1　Mail Agent管理ツールのメニューコマンド

メインメニューのコマンド | メインメニューのコマンド選択時に開くメニューのコマンド | 機能 | 説明している箇所 | Mail Agentの状態と使用できるコマンド
起動時 | 終了時
(1)System | (1)System Information Change | システム情報の参照 | 7.4.1 | ○ | ○
システム情報の更新 | × | ○
(2)System file initialize | システム情報の初期化 | 7.4.2 | × | ○
(e)end | メインメニューに戻る | － | ○ | ○
(q)quit | 終了 | － | ○ | ○
(2)Dump | (1)Dump | ダンプファイルの出力 | 7.5 | × | ○
(e)end | メインメニューに戻る | － | ○ | ○
(q)quit | 終了 | － | ○ | ○
(q)quit | － | 終了 | － | ○ | ○

（凡例）－：該当しないことを表します。

　　　　○：使用できることを表します。

　　　　×：使用できないことを表します。

なお，コマンドの入力方法は，Agent Server管理ツールと同様に，「Command:」の後に番号を入力して，コマンドを選択します。前の画面に戻る場合は「e」を，管理ツールを終了する場合は「q」を入力します。

7.4　システム情報の参照・更新・初期化

ここでは，メインメニューで「(1) System」を選択して，システム情報の参照・更新・初期化をする場合について説明します。なお，情報を更新・初期化する場合はMail Agent本体およびMailAgent実行エンジンを終了してください。

＜この節の構成＞

7.4.1　システム情報を参照・更新する

7.4.2　システム情報を初期化する

7.4.1　システム情報を参照・更新する

システム情報の参照・更新について，Mail Agent本体とMail Agent実行エンジンのそれぞれについて説明します。

＜この項の構成＞

(1)　Mail Agent本体のシステム情報を参照・更新する

(2)　Mail Agent実行エンジンのシステム情報を参照・更新する

(1)　Mail Agent本体のシステム情報を参照・更新する

システム情報を参照する場合は，Mail Agent本体のインストール先ディレクトリや，実際に登録されているエージェント数，エージェントの監視間隔などを参照できます。

また，更新する場合は，登録できるエージェント数の上限，エージェントの監視間隔などを指定できます。

情報を更新する場合は，Mail Agentを停止します。

メインメニューの「Command:」の後に「1」を入力します。
次の情報が表示されます。

Version

Mail Agentのバージョンが表示されます。

Service start time

Mail Agentの起動時刻が表示されます。

Install directory

Mail Agentのインストール先ディレクトリが表示されます。

Service status

Mail Agent が起動しているか終了しているかが表示されます。

Max Agent server count

接続できるAgent Serverの数が表示されます。

Event watch interval time

エージェントを何分間隔で監視するかが表示されます。

Remove Alert

起動時に停止中の着信通知情報を削除するかどうかが表示されます。

また，上記の内容の後に，システム情報の更新・初期化に関するメニューが表示されます。

監視間隔などの設定を変更する場合は，さらに，ここで「Command:」の後に「1」を入力します。
次の内容を指定します。

Max Agent server count[現在の値]

1～64の範囲で指定します。デフォルトでは8が指定されています。

Event watch interval time[現在の値]

1～1440の範囲で指定します。デフォルトでは30が指定されています。

Remove Alert[現在の値]

0か1を指定します。デフォルトでは0が指定されています。

0=サービス停止中に発生した着信通知情報をサービス起動時に削除しない。

1=サービス停止中に発生した着信通知情報をサービス起動時に削除する。

指定したら，「OK?[Yes:y/No:n(default)]:」の後に「y」を入力します。

指定例を次に示します。

(2)　Mail Agent実行エンジンのシステム情報を参照・更新する

システム情報を参照する場合は，Mail Agent実行エンジンのインストール先ディレクトリや，接続できるMail Serverの数などを参照できます。

また，更新する場合は，接続できるMail Serverの数などを指定できます。

情報を更新する場合は，Mail Agent実行エンジンを停止します。

メインメニューの「Command:」の後に「1」を入力します。
次の情報が表示されます。

Version

Mail Agent実行エンジンのバージョンが表示されます。

Service start time

Mail Agent実行エンジンの起動時刻が表示されます。

Install directory

Mail Agent実行エンジンのインストール先ディレクトリが表示されます。

Service status

Mail Agent実行エンジンが起動しているか終了しているかが表示されます。

Max Mail server count

接続できるGroupmax Mail Serverの数が表示されます。

Max Agent entry count

登録できる自動返信エージェント及び自動転送エージェント数の上限が表示されます。

Max Reply count

自動返信のメールがループした場合において，自動返信，自動転送，UP起動のエージェントを動作させる上限が表示されます。

メールの主題に含まれる「AR:」の数が上限数以上の場合，自動返信，自動転送，UP起動のエージェントは動作しません。

Max Forward count

自動転送のメールがループした場合において，自動返信，自動転送，UP起動のエージェントを動作させる上限が表示されます。

メールの主題に含まれる「AF:」の数が上限数以上の場合，自動返信，自動転送，UP起動のエージェントは動作しません。

また，上記の内容の後に，システム情報の更新・初期化に関するメニューが表示されます。

接続できるGroupmax Mail Server数などの設定を変更する場合は，さらに，ここで「Command:」の後に「1」を入力します。
次の内容を指定します。

Max Mail server count[現在の値]

1～64の範囲で指定します。デフォルトでは8が指定されています。

Max Agent entry count[現在の値]

1～3,000の範囲で指定します。デフォルトでは1,000が指定されています。

Max Reply count[現在の値]

1～16の範囲で指定します。デフォルトでは1が指定されています。

Max Forward count[現在の値]

1～16の範囲で指定します。デフォルトでは5が指定されています。

指定したら，「OK?[Yes:y/No:n(default)]:」の後に「y」を入力します。

指定例を次に示します。

注意事項

登録できるエージェントの上限を1,000から200のように少なくするよう変更する場合，少なくなった分の領域を解放するには，変更後，Mail Agent本体およびMail Agent実行エンジンを初期化する必要があります。

また，初期化後には整合性を確保する必要があります。複数サーバ構成の場合は，「4.2　サーバ間の情報の一致」を参照してください。

7.4.2　システム情報を初期化する

環境を再構築するような場合に，システム情報を初期化します。初期化すると活動中のAgentの情報を削除します。システム情報を初期化する手順について，Mail Agent本体とMail Agent実行エンジンのそれぞれについて説明します。

＜この項の構成＞

(1)　Mail Agent本体を初期化する場合

(2)　Mail Agent実行エンジンを初期化する場合

(1)　Mail Agent本体を初期化する場合

MailAgent本体が起動中の場合は終了します。

メインメニューの「Command:」の後に「1」を入力します。
MailAgent本体のシステム情報及びシステム情報の更新・初期化に関するメニューが表示されます。

「Command:」の後に「2」を入力します。
「Agent - Mail Server system file initialize OK?[Yes:y/No:n(default)]:y」と表示されます。

初期化してよければ，「y」を入力します。
「Initializing...」と表示され，初期化が開始します。
初期化処理が終了すると「Initialize end. press any key」と表示されます。

任意のキーを押します。
初期化の操作が終了します。

指定例を次に示します。

(2)　Mail Agent実行エンジンを初期化する場合

MailAgent実行エンジンが起動中の場合は終了します。

メインメニューの「Command:」の後に「1」を入力します。
MailAgent実行エンジンのシステム情報及びシステム情報の更新・初期化に関するメニューが表示されます。

「Command:」の後に「2」を入力します。
「Agent - Mail Function system file initialize OK?[Yes:y/No:n(default)]:y」と表示されます。

初期化してよければ，「y」を入力します。
「Initializing...」と表示され，初期化が開始します。
初期化処理が終了すると「Initialize end. press any key」と表示されます。

任意のキーを押します。
初期化の操作が終了します。

指定例を次に示します。

注意事項

システム情報を初期化しても，更新した情報は初期化されません。

7.5　ダンプファイルの出力

ここでは，メインメニューで「(2) Dump」を選択してダンプファイルを出力する場合について説明します。ダンプファイルの出力の手順は，Mail Agent本体の場合もMail Agent実行エンジンの場合も同じです。

バックアップの対象となるファイルについて，ダンプファイルを出力できます。

Mail Agentが起動中の場合は終了します。

メインメニューの「Command:」の後に「2」を入力します。
ダンプ出力に関するメニューが表示されます。

「Command:」の後に「1」を入力します。
「Directory name:」と表示されます。

「Directory name:」の後にダンプファイルを出力するフォルダ（ディレクトリ）名を入力してリターンキーを押します。
「Total file size[管理ファイルの合計サイズ] Dump output OK? [Yes:y/No:n(default)]:」と表示されます。

出力してもよければ「y」を入力します。
指定したフォルダ（ディレクトリ）にダンプファイルが出力されます。

指定例を次に示します。

Mail Agent本体の場合

Mail Agent実行エンジンの場合

7.6　バックアップとリストア

障害が発生して，環境を再構築する場合のために，バックアップを取得することをお勧めします。バックアップ情報はリストアすることによって回復できます。

バックアップ及びリストアは，Windows NTのバックアップ機能を使用します。

＜この節の構成＞

7.6.1　バックアップ

7.6.2　リストア

7.6.1　バックアップ

バックアップの手順は，Mail Agent本体の場合もMail Agent実行エンジンの場合も同じです。

Mail Agentが起動中の場合は終了します。

Windows NTの機能を使用して，次に示すMail Agentのファイル及びローカルレジストリ情報のバックアップを取得します。
このとき，Agent Serverの情報とMail Agentの情報との同期をとるために，Agent Serverのバックアップも同時に取得することをお勧めします。Mail Agentは，各エージェントの定義内容に関する情報をAgent Serverから取得してエージェントを処理します。各エージェントについて，Agent Serverに定義されている情報とMail Agentが取得している情報が一致していないエージェントは動作しません。
ファイル

インストールディレクトリ¥MailAgent¥SVcomのファイル（Mail Agentの管理テーブルのファイル）

インストールディレクトリ¥MailAgent¥SVqueのファイル（キューファイル）

レジストリ
「HKEY_LOCAL_MACHINE¥SOFTWARE¥HITACHI¥MailAgent以下の情報」
ただし，ローカルレジストリファイル全体のバックアップを取得しておくことをお勧めします。
なお，上記の情報のバックアップだけを取得する場合は，Windows NTのレジストリエディタを使用します。レジストリエディタについては，Windows NTのマニュアルのレジストリエディタの説明を参照してください。

Mail Agentを起動します。

注意事項

ローカルレジストリファイルはシステム内で共有するため，破損しないよう注意して扱ってください。ローカルレジストリファイルについては，Windows NTのマニュアルのシステム構成の説明を参照してください。

7.6.2　リストア

リストアの手順は，Mail Agent本体の場合もMail Agent実行エンジンの場合も同じです。

Mail Agentが起動中の場合は終了します。

Windows NTの機能を使って，バックアップファイルをリストアします。

Mail Agentを起動します。

7.7　Mail Agentのアクション抑止機能

＜この節の構成＞

(1)　機能

(2)　対象エージェント

(3)　アクション抑止ファイルの設定方法

(4)　注意事項

(5)　動作例

(1)　機能

Agent - Mail Functionに，アクションを抑止するメール（対象はE-mailだけ）の条件をファイルに設定し，その条件に合うメールのアクション（メールの自動返信／自動転送／UP起動）を行わないようにします。Agent - Mail Functionを使用するすべてのユーザのメールエージェントに対して有効になります。

(2)　対象エージェント

アクションを抑止するエージェントは以下の三つです。また，アクション抑止対象メールはE-mailだけです。

個人メールの自動返信エージェント

個人メールの自動転送エージェント

個人メール監視によるユーザプログラムの自動起動エージェント

(3)　アクション抑止ファイルの設定方法

アクション抑止ファイルは，アクションを抑止するメールの条件を設定するファイルです。システムインストール時には作成されませんので，本機能を使用するときは，新規に作成する必要があります。

アクション抑止ファイルには，抑止するメールの主題を指定する送信者主題指定ファイル（title.txt）とメールの送信者を指定する送信者名指定ファイル（sender.txt）があります。両方のファイルの指定内容に合うメールがアクション抑止の対象（AND条件）です。

アクション抑止ファイルは，＜Agent - Mail Functionインストールディレクトリ＞¥SVusrフォルダ（システム提供フォルダ）の下に格納します。システムは，本フォルダにアクション抑止ファイルがある場合，指定内容に従いメールエージェントのアクションを抑止します。

アクション抑止ファイルの指定内容を以下に説明します。

(a)　送信者名指定ファイル：sender.txt

アクションを抑止する新着メールの送信者名を指定します。

1行に一つの送信者名を指定します。

送信者名は，完全なE-mailアドレス，またはE-mailアドレスのローカルパート部分が指定できます。

＜設定例＞

完全なE-mailアドレス（ローカルパート@ドメイン名）を指定した場合：

「abc@xyz」：本ファイルでの指定した内容

「abc@xyz」：受信したメールの送信者名

「abc@xyz」と「abc@xyz」を文字列比較する。

E-mailアドレスのローカルパート部分（ローカルパート）を指定した場合：

「abc」：本ファイルでの指定した内容

「abc@xyz」：受信したメールの送信者名

「abc」と「abc」を文字列比較する。

送信者名の前後にスペース（半角／全角）が指定された場合，スペースを読み飛ばしません。

設定ファイルの条件に空行や二重に登録されたものがあった場合は無視します。

送信者名の最大長（256バイト）を超えた送信者名がある場合，該当する送信者名を無視します。

登録できる送信者名の上限は100です。ただし，無視した内容は含みません。

＜比較方法＞

指定された送信者名とメールの送信者は完全一致比較です。

送信者名を複数指定した場合，指定したすべての送信者名が抑止対象となります（OR条件です）。

文字列の比較は，大文字／小文字を意識した比較を行います。

＜設定例＞

MAILER-DAEMON@abc.co.jp¥n：アクションを抑止する新着メールの送信者その1（完全一致）

postmaster@xyz.ne.jp¥n：アクションを抑止する新着メールの送信者その2（完全一致）

system¥n：アクションを抑止する新着メールのローカルパート（完全一致）

　　　・

　　　・

（上限：100個）

(b)　主題指定ファイル：title.txt

アクションを抑止する新着メールの主題を指定します。

1行に一つの主題を指定します。

設定ファイルの条件に空行や二重に登録されたものがあった場合は無視します。

主題の最大長（80バイト）を超えた主題名がある場合，該当する主題を無視します。

登録できる主題名の上限は100です。ただし，無視した内容は含みません。

＜比較方法＞

指定された主題名とメールの主題は部分一致比較です。

主題名を複数指定した場合，指定したすべての主題名が抑止対象となります（OR条件です）。

＜設定例＞

エラーメール¥n：アクションを抑止する新着メールの主題その1（部分一致）

ERROR !!¥n：アクションを抑止する新着メールの主題その2（部分一致）

　　　・

　　　・

（上限：100個）

(c)　補足事項

送信者名指定ファイル（sender.txt）または主題指定ファイル（title.txt）のいずれか一つのファイルしか設定されていない場合，存在しないファイルは条件に加えません（設定したファイルの内容だけが有効になります）。また，中身のないファイル，およびすべての指定を無視したファイルについても，存在しないファイルとして扱います。

(4)　注意事項

アクション抑止ファイルの作成／更新した場合，MailAgentFunctionサービスの再起動が必要です。

アクションを抑止したメールは削除しません。抑止したメールはINBOXで確認できます。

個々のエージェントの設定は，変更不要です。

上限を超えた条件(送信者名，主題名)があった場合は，イベントログメッセージ（KDMA03010-W，KDMA03011-W）を出力します。

(5)　動作例

パターン1

［設定］

sender.txtの内容

----------
postmaster@hitachi.co.jp
----------

title.txtの内容

----------
（改行のみ）
----------

［返信されて来たメール］

主題：タイトル

送信者：postmaster@hitachi.co.jp

→　抑止する

パターン2

［設定］

sender.txt

----------
（改行のみ）
----------

title.txt

----------
Unknown
----------

［返信されて来たメール］

主題：UserUnknown

送信者：postmaster@xyz.co.jp

→　抑止する

パターン3

［設定］

sender.txt

----------
postmaster@hitachi.co.jp
postmaster@abc.co.jp
----------

title.txt

----------
HostUnknown
UserUnknown
----------

［返信されて来たメール］

　(i)

主題：HostUnknown

送信者：postmaster@xyz.co.jp

→　抑止しない

　(ii)

主題：Not

送信者：postmaster@hitachi.co.jp

→　抑止しない

　(iii)

主題：UserUnknown

送信者：postmaster@hitachi.co.jp

→　抑止する

パターン4（ローカルパートだけの場合）

［設定］

sender.txt

----------
postmaster
----------

title.txt

----------
HostUnknown
UserUnknown
----------

［返信されて来たメール］

　(i)

主題：HostUnknown

送信者：postmaster@xyz.co.jp

→　抑止する

　(ii)

主題：Not

送信者：postmaster@hitachi.co.jp

→　抑止しない

　(iii)

主題：UserUnknown

送信者：postmaster@hitachi.co.jp

→　抑止する

7.8　自動転送エージェントにおけるASCIIオプション

「個人メールの自動転送エージェント」が転送記号を付加するメールを海外などに送信すると，転送記号の文字列が日本語のため文字化けが発生します。また，同報受信者，送信者が日本語名の場合にも文字化けが発生します。日本語を挿入しないオプション（ASCIIオプション）を使用することにより，「個人メールの自動転送エージェント」が付加する日本語のために発生する文字化けを防ぐことができます。

機能

ASCIIオプションを指定すると，「個人メールの自動転送エージェント」の送信するメールの転送記号文字に日本語を挿入しません。オプション設定時の動作を以下に示します。

転送時の本文挿入文字（受信者）の削除
転送記号文字の受信者（「TO：ユーザA」部分など）を挿入しません。

転送時の本文挿入文字（送信者）の削除
転送記号文字の送信者（「送信者：ユーザA」部分）を挿入しません。

転送時の本文挿入文字の英語化
次のように転送記号列を，英語で表示します。

日本語文字列            英語文字列
------------            ----------
主題 ：                 Subject:
受信日 ：               Received Date:
属性 ：                 Attribute:
至急                    Urgent
親展                    Confidential
返信要求有り            Request Reply
なし                    No

オプションを有効にする場合，以下のシステム環境変数を設定します。

環境変数名 | 値
MA_FW_ASCII | ON

注意事項

本オプションを有効にしても，転送の対象とする受信メールの主題および本文にASCIIコード以外の文字列がある場合，ASCIIコード以外の文字コードを含んだメールを送信します。受信メールの「主題」，「本文」の文字コードにASCIIコード以外があるかどうかのチェックは行いません。

7.9　自動転送時の返信先変更機能

＜この節の構成＞

(1)　機能

(2)　利用方法

(3)　転送時の返信先例示

(1)　機能

本機能は，自動転送したメールを返信する際のあて先を変更する機能です。

本機能を利用しない場合，自動転送したメールは，自動転送したユーザへ返信されます。（図 7-1）

本機能を利用する場合，自動転送時に本来の送信者をメールの返信先として設定してから転送します。これにより自動転送したメールは，本来のメール送信者へ返信されます。（図 7-2）

なお，本機能の利用の有無に関わらず，本来のメールに返信先が指定されていた場合は，その返信先を引き継ぎます。（図 7-3）

図7-1　本機能を使わず，返信先指定をせず，自動転送した場合

図7-2　本機能を使い，返信先指定をせず，自動転送した場合

図7-3　返信先指定をし，自動転送した場合

(2)　利用方法

次のシステム環境変数をMail Agentのサービス（サービス名: MailAgent）を起動するマシンに設定してください。ON以外を指定した場合，また環境変数を設定しなかった場合，本機能を利用しません。

環境変数名：MA_FW_REPLYTO

値：ON

表7-2　MA_FW_REPLYTOの指定と動作

# | 環境変数の値 | Mail Agentの動作
1 | ON | 自動転送時に本来の送信者を返信先に指定する。
2 | ON以外 | 自動転送時に返信先を指定しない。
3 | 指定なし

(3)　転送時の返信先例示

送信者がユーザAまたはユーザB，宛先がユーザB，ユーザBの転送先がユーザCとした場合の返信先を，つぎの表 7-3に示します。ハイフン（－）の記載は，メール送信時に送信者自身を返信先として指定することができないためありえないことを示します。

表7-3　MA_FW_REPLYTOの指定と動作

送信者 | MA_FW_REPLYTO | 返信先指定
なし | A | B | D
A | OFF | なし=B※1 | － | なし=B※2 | D
B | なし=B | A | － | D
A | ON | A※3 | － | なし=B※5 | D※6
B | なし=B※4 | A | － | D

注※1

デフォルトでは，転送したユーザが，転送先の返信先になる。

注※2

送信者と返信先が一致するため，返信先の指定を解除する。

注※3

MA_FW_REPLYTOが指定されているので，転送時に送信者を返信先として設定する。

注※4

送信者と転送者が一致するため，転送時に返信先を設定しない。

注※5

送信時の返信先指定を優先するが，送信者と転送者が一致するため，返信先の指定を解除。

注※6

送信時の返信先指定はMA_FW_REPLYTOの設定よりも優先する。

図7-4　MA_FW_REPRYTOの挙動

8.　Document Manager Agentの運用

この章では，Document Manager Agentの起動や終了の操作，及び管理者がDocument Manager Agent運用時に使用する運用コマンドや管理ツールの操作について説明します。

＜この章の構成＞

8.1　Document Manager Agentの起動と終了

8.2　Document Manager Agentの運用コマンド

8.3　Document Manager Agent管理ツールに関する基礎知識

8.4　システム情報の参照・更新・初期化

8.5　ダンプファイルの出力

8.6　バックアップとリストア

8.1　Document Manager Agentの起動と終了

この節ではDocument Manager Agentの起動と終了の方法について説明します。

＜この節の構成＞

8.1.1　Document Manager Agentの起動

8.1.2　Document Manager Agentの終了

8.1.1　Document Manager Agentの起動

Document Manager AgentはWindows NTの［サービス］ダイアログから起動します。

Administratorの権限でDocument Manager Agentをインストールしたマシンにログオンします。

管理ツールの「サービス」を開いて［サービス］ダイアログを表示します。

「サービス」の欄から「Document Manager Agent」を選択して［開始］ボタンをクリックします。
「状態」の欄に「開始」と表示され，Document Manager Agentが起動します。

8.1.2　Document Manager Agentの終了

Administratorの権限でDocument Manager Agentをインストールしたマシンにログオンします。

管理ツールの「サービス」を開いて［サービス］ダイアログを表示します。

［サービス］ダイアログから「Document Manager Agent」を選択して［停止］ボタンをクリックします。

停止してもよいか問い合わせるダイアログが表示されますので，［はい］ボタンをクリックします。
「状態」の欄が空白となり，Document Manager Agentが終了します。

8.2　Document Manager Agentの運用コマンド

Document Manager Agentでは，システム管理者向けに運用コマンドを提供しています。この節では，運用コマンドの概要と各コマンドの使用方法について説明します。

＜この節の構成＞

8.2.1　運用コマンドの概要

8.2.2　Document Manager Agent管理ツールの起動（damgr）

8.2.3　Agent Serverのホスト名一覧表示・Agent Serverとの整合性の確保(damatch)

8.2.4　Document Manager Agentのトレースの参照（datrc）

8.2.5　フォーム文書データベース検索オプション

8.2.1　運用コマンドの概要

ここでは，どのような場合に運用コマンドを使用するかについて説明します。また，運用コマンドの記述形式や使用方法についても説明します。

＜この項の構成＞

(1)　どのような場合に運用コマンドを使用するか

(2)　運用コマンドの実行

(3)　運用コマンドの記述形式

(4)　運用コマンドの説明で使用する記号

(1)　どのような場合に運用コマンドを使用するか

Document Manager Agent管理ツールの起動(damgr)

エージェントの運用・管理やトラブルシュートを支援するDocument Manager Agent管理ツールを起動する場合に使用します。なお，Document Manager Agent管理ツールの詳細については，8.3節以降で説明しています。

Agent Serverのホスト名一覧表示・Agent Serverとの整合性の確保(damatch)

Document Manager Agentのエージェント情報をAgent Serverのエージェント情報と一致させ，両者の整合性を確保する場合に使用します。Document Manager Agentがダウンした場合や，エージェント情報が失われた場合，このコマンドで整合性を確保することによって回復できます。

Document Manager Agentのトレースの参照(datrc)

内部関数のトレースを参照したい場合に使用します。内部関数のトレースは障害時の保守情報として使用します。

(2)　運用コマンドの実行

Document Manager Agentの運用コマンドを実行できるのは，Administrator権限を持つユーザだけです。次の手順で実行してください。

コマンドプロンプト画面を表示します。

次のディレクトリ（フォルダ）に移動します。

<Document Manager Agentインストール先>¥DocumentManagerAgent¥SVbin

運用コマンドを入力します。

(3)　運用コマンドの記述形式

形式

コマンド名称　[オプション．．．]

機能

コマンドの機能を説明しています。

オプション

スラント記号（/）で始まる文字列です。オプションによっては引数が必要な場合があります。

(4)　運用コマンドの説明で使用する記号

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

記号
意味

[　　]
この記号で囲まれているオペランドは省略できることを示す。
（例）ABC [/D ] [/E ]
この場合，次の指定が可能となる。

ABC

ABC　/Ｄ

ABC　/Ｅ

ABC　/Ｄ　/E

8.2.2　Document Manager Agent管理ツールの起動（damgr）

形式

damgr

機能

Document Manager Agentでは，エージェントの運用・管理やトラブルシュート用に管理ツールを提供しています。本コマンドでは，この管理ツールを起動してメインメニューを表示します。管理ツールはメインメニューから対話形式で使用できます。

なお，Document Manager Agent管理ツールの使用方法については，8.3節以降で説明しています。

オプション

なし

注意事項

このコマンドを実行できるのはAdministrator権限を持つユーザだけです。

8.2.3　Agent Serverのホスト名一覧表示・Agent Serverとの整合性の確保(damatch)

＜この項の構成＞

(1)　Agent Serverのホスト名の一覧表示

(2)　Agent Serverとの整合性の確保

(1)　Agent Serverのホスト名の一覧表示

形式

damatch  /l  [/o  ホスト名一覧出力先ファイル名]

機能

整合性を確保する対象となるAgent Serverのホスト名を一覧表示できます。

オプション

/l

Document Manager Agentと接続中のAgent Serverのホスト名を一覧表示できます。表示されるのは，Document Manager Agentのマシンで認識しているホスト名で，DNS又はhostsファイルに設定されているものです。

/o ホスト名一覧出力先ファイル名

ホスト名一覧を出力するファイル名を指定します。フルパスで指定しない場合は，カレントディレクトリに出力されます。指定したファイル名が既にある場合は，上書きされます。

本オプションを省略した場合は，標準出力に出力されます。

注意事項

このコマンドを実行できるのは，Administrator権限を持つユーザだけです。

このコマンドは，Document Manager Agentサービスが起動している場合に実行できます。

(2)　Agent Serverとの整合性の確保

形式

damatch  [/s  Agent Serverのホスト名又はIPアドレス]  [/t  タイマ値(分)]

機能

Document Manager Agentのエージェント情報をAgent Serverのエージェント情報と一致させ，両者の整合性を確保します。

オプション

/s Agent Serverのホスト名又はIPアドレス

整合性確保の対象となるAgent Serverのホスト名又はIPアドレスを指定します。ホスト名を指定する場合は，DNS又はhostsファイルに設定されている名称で指定してください。IPアドレスを指定する場合は，「***.***.***.***」の形式で指定してください。

本オプションを省略した場合は，Document Manager Agentで認識しているすべてのAgent Serverと整合性を確保します。

/t タイマ値(分)

整合性確保の状態合わせに要する待ち時間を1から60までの数字で指定します。単位は分，デフォルトは15です。

注意事項

このコマンドを実行できるのは，対象となるAgent Serverのバージョンが03-10以降の場合です。

このコマンドを実行できるのは，Administrator権限を持つユーザだけです。

このコマンドは，Document Manager Agentサービスが起動している場合に実行できます。

8.2.4　Document Manager Agentのトレースの参照（datrc）

形式

datrc [>出力先ファイル名] [/C]

機能

Document Manager Agentが提供する内部関数のトレースを参照する場合に使用します。内部関数のトレースは障害時の保守情報として使用します。

オプション

>出力先ファイル名

トレースを出力するファイル名を指定します。省略した場合は標準出力に出力されます。

/C

Document Manager Agentが持つトレース情報を初期化する場合に指定します。トレース情報を初期化すると，過去のトレースデータは消去されます。

注意事項

このコマンドを実行できるのは，Administrator権限を持つユーザだけです。

このコマンドで表示できるのは，トレース種別ごとに4,000エントリまでです。

8.2.5　フォーム文書データベース検索オプション

フォーム文書データベース検索オプションでは，「条件付きフォーム文書の自動削除」，および「フォーム文書監視による業務プログラムの自動起動」エージェントにフォーム文書データベース名を指定した場合に，監視対象となるフォーム文書データベースの検索方法について，前方一致で検索されたフォーム文書データベースにするか，または完全一致で検索されたフォーム文書データベースを監視対象にするかを選択できます。

機能

フォーム文書データベース検索オプションはシステム環境変数で設定します。

(1) オプションが未指定の場合

「条件付きフォーム文書の自動削除」および「フォーム文書監視による業務プログラムの自動起動」エージェントで指定したフォーム文書データベース名と，最初に前方一致するフォーム文書データベースをエージェントの監視対象にします

(2) オプションを指定した場合

「条件付きフォーム文書の自動削除」および「フォーム文書監視による業務プログラムの自動起動」エージェントで指定したフォーム文書データベース名と完全一致するフォーム文書データベースをエージェントの監視対象にします。

オプションを有効にする場合，以下のシステム環境変数を設定します。

環境変数名 | 値
DA_GET_FORMDB | ON

注意事項

システム環境変数の設定を有効にするには，コンピュータの再起動が必要です。

8.3　Document Manager Agent管理ツールに関する基礎知識

Document Manager Agentが独自に持つ環境に関する操作ではDocument Manager Agent管理ツールを使用します。

この節では，Document Manager Agent管理ツールを使ってどのような情報に関する操作をするのかについて説明します。

＜この節の構成＞

8.3.1　管理ツールで操作する情報

8.3.2　管理ツールの操作

8.3.1　管理ツールで操作する情報

＜この項の構成＞

(1)　Document Manager Agentのシステム環境に関する操作

(1)　Document Manager Agentのシステム環境に関する操作

Document Manager Agentが持つシステム環境には，文書属性の監視を何時から開始するか，エージェントを幾つ登録できるかといった情報があります。

Document Manager Agent管理ツールでは，これらの情報を参照，更新できます。

なお，バックアップ及びリストアは，Windows NTの提供するバックアップ，リストア機能を使用します。

8.3.2　管理ツールの操作

Document Manager Agent管理ツールもAgent Server管理ツールと同様に，メニューによる対話形式で操作できます。Document Manager Agent管理ツールの基本的な操作方法について説明します。

＜この項の構成＞

(1)　管理ツールの起動

(2)　管理ツールのメインメニュー

(1)　管理ツールの起動

Document Manager Agent管理ツールを起動する手順を次に示します。

Administratorの権限でWindows NTにログオンします。

コマンドプロンプト画面を表示します。

次のディレクトリ（フォルダ）に移動します。

<Document Manager Agentインストール先>¥DocumentManagerAgent¥SVbin

管理ツールを起動するためのコマンド「damgr」を入力してリターンキーを押します。
管理ツールのメインメニューが開きます。

(2)　管理ツールのメインメニュー

管理ツールのメニューコマンドの一覧を表8-1に示します。

管理ツールにはDocument Manager Agentを終了している場合にだけ使用できるコマンドがあります。

表8-1　Document Manager Agent管理ツールのメニューコマンド

メインメニューのコマンド | メインメニューのコマンド選択時に開くメニューのコマンド | 機能 | 説明している箇所 | Document Manager Agentの状態と使用できるコマンド
起動時 | 終了時
(1)System | (1)System Information Change | システム情報の参照・更新 | 8.4.1 | ○ | ○
システム情報の更新 | × | ○
(2)System file initialize | システム情報の初期化 | 8.4.2 | × | ○
(e)end | メインメニューに戻る | － | ○ | ○
(q)quit | 終了 | － | ○ | ○
(2)Dump | (1)Dump | ダンプファイルの出力 | 8.5 | × | ○
(e)end | メインメニューに戻る | － | ○ | ○
(q)quit | 終了 | － | ○ | ○
(q)quit | － | 終了 | － | ○ | ○

（凡例）－：該当しないことを表します。

　　　　○：使用できることを表します。

　　　　×：使用できないことを表します。

なお，コマンドの入力方法は，Agent Server管理ツールと同様に，「Command:」の後に番号を入力して，コマンドを選択します。前の画面に戻る場合は「e」を，管理ツールを終了する場合は「q」を入力します。

8.4　システム情報の参照・更新・初期化

ここでは，メインメニューで「(1) System」を選択して，システム情報の参照・更新・初期化をする場合について説明します。なお，情報を更新・初期化する場合はDocument Manager Agent を終了してください。

＜この節の構成＞

8.4.1　システム情報を参照・更新する

8.4.2　システム情報を初期化する

8.4.1　システム情報を参照・更新する

システム情報を参照する場合は，Document Manager Agentのインストール先ディレクトリや，実際に登録されているエージェント数などを参照できます。

また，更新する場合は，登録できるエージェントの上限などを指定できます。

情報を更新する場合は，Document Manager Agentを停止します。

メインメニューの「Command:」の後に「1」を入力します。
次の情報が表示されます。

Version

Document Manager Agentのバージョンが表示されます。

Service start time

Document Manager Agentの起動時刻が表示されます。

Install directory

Document Manager Agentのインストール先ディレクトリが表示されます。

Service status

Document Manager Agentが起動しているか終了しているかが表示されます。

Max Agent server count

接続できるGroupmax Agent Serverの数が表示されます。

Max Folder watch agent count

登録監視エージェントの最大登録数が表示されます。

Max Document count

登録監視エージェントが通知可能な文書数が表示できます。この数値は，個々の登録監視エージェントが通知できる文書数の総数です。したがって，例えば100の登録監視エージェントがそれぞれ100文書の通知を行う場合，Max Document countには10,000以上の値を設定する必要があります。

また，通知する文書の数がMax Document countの値を超えた場合，文書の登録を通知しないエージェントが発生します。このとき，活動ログには「指定されたフォルダに登録文書はありませんでした。」と表示され，イベントログには「KDDA04009-W文書の登録監視エージェントにおいて，通知可能な文書数の上限を超えました。エージェントキー：［エラーが発生したエージェントキー］」が設定されます。

また，上記の内容の後に，システム情報の更新・初期化に関するメニューが表示されます。

設定を変更する場合は，さらに，ここで「Command:」の後に「1」を入力します。
次の内容を指定します。

Max Agent server count[現在の値]

接続するAgent Server数の上限を，1～64の範囲で指定します。デフォルトでは8が指定されています。

Max Folder watch agent count[現在の値]

使用できる登録監視エージェントの数の上限を，3,000までの範囲で指定します。変更する時点で登録監視を行っている登録監視エージェントの数より小さい値は設定できません。デフォルトでは64が指定されています。

Max Document count[現在の値]

登録監視エージェントが通知可能な文書数の上限を，30,000までの範囲で指定します。現在の値より大きい値だけを指定できます。

現在の値より小さい値を設定したい場合は，Document Manager Agentを初期化してください。デフォルトでは1,024が指定されています。

指定したら，「OK?[Yes:y/No:n(default)]:」の後に「y」を入力します。

指定例を次に示します。

8.4.2　システム情報を初期化する

環境を再構築するような場合に，システム情報を初期化します。初期化すると活動中のAgentの情報を削除します。

Document Manager Agent が起動中の場合は終了します。

メインメニューの「Command:」の後に「1」を入力します。
Document Manager Agentのシステム情報及びシステム情報の更新・初期化に関するメニューが表示されます。

「Command:」の後に「2」を入力します。
「Agent - Document Manager Server system file initialize OK?[Yes:y/No:n(default)]:」と表示されます。

初期化してよければ，「y」を入力します。
「Initializing...」と表示され，初期化が開始します。
初期化処理が終了すると「Initialize end. press any key」と表示されます。

任意のキーを押します。
初期化の操作が終了します。

指定例を次に示します。

注意事項

システム情報を初期化しても，更新したシステム情報は初期化されません。更新した情報（最大接続Agent Server数）以外の情報がインストール時の状態になります。

8.5　ダンプファイルの出力

ここでは，メインメニューで「(2) Dump」を選択してダンプファイルを出力する場合について説明します。

バックアップの対象となるファイルについて，ダンプファイルを出力できます。

Document Manager Agentが起動中の場合は終了します。

メインメニューの「Command:」の後に「2」を入力します。
ダンプ出力に関するメニューが表示されます。

「Command:」の後に「1」を入力します。
「Directory name:」と表示されます。

「Directory name:」の後にダンプファイルを出力するフォルダ（ディレクトリ）名を入力してリターンキーを押します。
「Total file size[管理ファイルの合計サイズ] Dump output OK? [Yes:y/No:n(default)]:」と表示されます。

出力してもよければ「y」を入力します。
指定したフォルダ（ディレクトリ）にダンプファイルが出力されます。

指定例を次に示します。

8.6　バックアップとリストア

障害が発生して，環境を再構築する場合のために，バックアップを取得することをお勧めします。バックアップ情報はリストアすることによって回復できます。

バックアップ及びリストアは，Windows NTのバックアップ機能を使用します。

＜この節の構成＞

8.6.1　バックアップ

8.6.2　リストア

8.6.1　バックアップ

Document Manager Agentが起動中の場合は終了します。

Windows NTの機能を使用して，次に示すDocument Manager Agentのファイル及びローカルレジストリ情報のバックアップを取得します。
このとき，Agent Serverの情報とDocument Manager Agentの情報との同期をとるために，Agent Serverのバックアップも同時に取得することをお勧めします。Document Manager Agentは，各エージェントの定義内容に関する情報をAgent Serverから取得してエージェントを処理します。各エージェントについて，Agent Serverに定義されている情報とDocument Manager Agentが取得している情報が一致していないエージェントは動作しません。
ファイル

インストールディレクトリ¥Document ManagerAgent¥SVcomのファイル（Document Manager Agentの管理テーブルのファイル）

インストールディレクトリ¥DocumentManagerAgent¥SVqueのファイル（キューファイル）

レジストリ
「HKEY_LOCAL_MACHINE¥SOFTWARE¥HITACHI¥Document ManagerAgent以下の情報」
ただし，ローカルレジストリファイル全体のバックアップを取得しておくことをお勧めします。
なお，上記の情報のバックアップだけを取得する場合は，Windows NTのレジストリエディタを使用します。レジストリエディタについては，Windows NTのマニュアルのレジストリエディタの説明を参照してください。

Document Manager Agentを起動します。

注意事項

ローカルレジストリファイルはシステム内で共有するため，破損しないよう注意して扱ってください。ローカルレジストリファイルについては，Windows NTのマニュアルのシステム構成の説明を参照してください。

8.6.2　リストア

Document Manager Agentが起動中の場合は終了します。

Windows NTの機能を使って，バックアップファイルをリストアします。

Document Manager Agentを起動します。

9.　障害対策

この章では，障害が起こった場合の対処方法について説明します。Groupmax Agentでは，活動ログやイベントログの内容を基に障害の原因を特定して回復します。

＜この章の構成＞

9.1　障害回復の流れ

9.2　サーバ環境で確認する項目

9.3　情報の回復

9.4　保守情報の採取

9.1　障害回復の流れ

Groupmax Agentの障害には，サーバが正常でもエージェントの動作に異常がある場合と，サーバが異常終了する場合があります。ここでは，それぞれについて，障害の発生から回復までの流れを説明します。

＜この節の構成＞

9.1.1　エージェントの動作に異常がある場合

9.1.2　サーバが異常終了した場合

9.1.1　エージェントの動作に異常がある場合

＜この項の構成＞

(1)　回復までの流れ

(2)　活動ログとイベントログの参照

(3)　障害要因の特定

(1)　回復までの流れ

Agent Serverの運用を例にして，エージェントの動作に異常がある場合の回復までの流れを図9-1に示します。

図9-1　障害の発生から回復までの流れ(エージェントの動作に異常がある場合)

図9-1に示したように，障害が発生した場合は，まず活動ログ及びイベントログを参照します。次に，状況に応じてシステム環境の設定を参照します。

(2)　活動ログとイベントログの参照

障害発生時に参照する活動ログ及びイベントログについて説明します。

活動ログやイベントログにエラーコードが出力された場合，その内容については，「付録D　活動ログ及びイベントログのエラーコード」を参照してください。

(a)　活動ログ

個々のエージェントに関するエラーや警告を表示します。エラーの場合は，どのような障害が起こったかを表示します。クライアント側では，Groupmax Agentが提供しているサーバエージェントマネージャから，又はIntegrated Desktopの画面から活動ログを参照できます。クライアント側から参照できない場合は，Agent Serverの管理ツールから参照できます。

(b)　イベントログ

主に，システム全体に関わるエラーや警告などを表示します。イベントログの［イベントの詳細］ダイアログでは次の情報が表示されます。

[説明] ：障害を知らせるメッセージ

[データ]：障害元

例えば，Agent ServerがPPサーバ（Agent Serverと連携する製品のサーバ）と接続できなかった場合は，その旨のメッセージと接続できなかったPPサーバ名が表示されます。この場合，Agent ServerでのPPサーバに関連する設定や，PPサーバ自体の設定を修正することになります。

イベントログに出力される内容の詳細については，「付録E　イベントログメッセージの一覧」を参照してください。

(3)　障害要因の特定

Groupmax Agentの障害は，クライアント側の設定に問題がある場合とサーバ側の設定に問題がある場合があります。

(a)　クライアント側での処理

まず，活動ログを表示して，クライアント側で生成したエージェントに関してどのようなエラーが発生しているかを確認してください。次に，活動ログに表示されているエラー情報を基に，エラーになっているエージェントの設定を修正します。

(b)　サーバ側での処理

クライアント側で障害要因を特定できない場合は，Agent ServerやAgent - Applicationの管理ツールを使用したり，Windows NTのイベントログを参照して障害要因を特定してください。

9.1.2　サーバが異常終了した場合

OSのダウンなどによってAgent ServerやWorkflow Agentが異常終了した後，サービスを再起動できなかったり，エージェントが正常に動作しなかったりすることがあります。サーバが異常終了した場合の回復までの流れを図9-2から図9-6に示します。

図9-2　障害の発生から回復までの流れ(Agent Serverが異常終了した場合)

図9-3　障害の発生から回復までの流れ(Workflow Agentが異常終了した場合)

図9-4　障害の発生から回復までの流れ(Mail Agentが異常終了した場合)

図9-5　障害の発生から回復までの流れ(Mail Agent Functionが異常終了した場合)

図9-6　障害の発生から回復までの流れ(Document Manager Agentが異常終了した場合)

図9-2から図9-6に示したように，サーバが異常終了した場合は，バックアップファイルを基にリストア，ファイル回復コマンドを実行してファイルを回復し，Agent ServerやWorkflow Agentなどを再開させます。

9.2　サーバ環境で確認する項目

エラーの発生するエージェントが数多くある場合や，イベントログにエラーが表示された場合などは，サーバ側での設定に問題があるためにエラーが広範囲に及んでいる可能性があります。ここでは，サーバ環境で見直す必要がある項目を説明します。

＜この節の構成＞

9.2.1　Agent Serverで確認する項目

9.2.2　Workflow Agentで確認する項目

9.2.3　Mail Agentで確認する項目

9.2.4　Document Manager Agentで確認する項目

9.2.1　Agent Serverで確認する項目

＜この項の構成＞

(1)　エラーになったエージェントの詳細情報の確認

(2)　PPサーバの設定の確認

(3)　Agent Serverのシステム環境の確認

(1)　エラーになったエージェントの詳細情報の確認

エラーが発生した場合は，エラーが発生したエージェントの詳細情報を確認します。エージェントの詳細情報を確認することによって，そのエージェントが関係しているPPサーバ名，生存期間，動作しているプログラムの定義パラメタなどの情報を確認できるため，見直す項目を絞り込めます。

(2)　PPサーバの設定の確認

複数のエージェントで，特定のPPサーバ（Agent Serverと連携している製品のサーバ）に関係している障害が発生している場合は，PPサーバに関する設定に問題がある可能性があります。各PPサーバでの設定を確認してください。

例えば，複数のエージェントでメール送信時にエラーが発生している場合は，Agent Server側でのGroupmax Mail Serverに関する設定に問題がある可能性があります。メール環境に関する設定を参照するには，Agent Server管理ツールを使用します。参照した情報に問題がある場合は設定し直してください。Agent Server管理ツールを使用したメール環境の設定については，「5.6.4　メールに関する情報を参照・更新する」を参照してください。

また，Agent Server側のエージェント情報とPPサーバ側のエージェント情報が一致していない場合エージェントは正しく動作しません。Agent ServerとPPサーバ間のエージェント情報を一致させる必要があります。Agent Serverでは，サーバ間の情報の整合性を確保するためコマンドを提供しています。サーバ間の整合性の確保については，「9.3.2　サーバ間の情報の一致」を参照してください。

(3)　Agent Serverのシステム環境の確認

Agent Serverでは，登録できるエージェントの上限を設定したり，各情報を保管するフォルダ（ディレクトリ）の格納先を指定できます。Agent Serverのシステム環境全体に障害がある場合は，これらのシステム環境の設定に原因がある可能性があります。Agent Server管理ツールの管理コマンドを使用してこれらのシステム環境の設定を確認してください。Agent Serverのシステム環境の設定については「5.6　システム情報の参照・更新・初期化」を参照してください。

9.2.2　Workflow Agentで確認する項目

＜この項の構成＞

(1)　処理結果の確認

(2)　Agent Serverの定義情報と一致しているかどうかの確認

(3)　Workflow Agentのシステム環境の確認

(4)　Groupmax Workflow Serverについての確認

(1)　処理結果の確認

Workflow Agentの処理結果を運用モニタ(Groupmax Workflow Monitor Version 6)で確認できます。運用モニタの使用方法は，マニュアル「Groupmax Workflow Version 6 ビジュアル定義・シミュレータ・運用モニタ　ユーザーズガイド」を参照してください。

確認できる内容を次に示します。

(a)　エージェント定義不正時の確認

エージェント定義不正でエラーになった場合に，運用モニタで確認できる情報を表9-1に示します。

表9-1　エージェント定義不正時の確認内容

エージェント定義の内容
エラーの内容
確認できる情報

エージェント登録者
権限不正
エージェント登録者のユーザ権限(ユーザ情報から確認する)。

ユーザトレー
ユーザトレーなし
ユーザ情報にユーザが存在するかどうか。

ロールトレー
ロールトレーなし

ロール情報にロールが存在するかどうか。

種別は業務ロールか。

ロールは配布済みか。また，配布処理は成功しているか。

ロール内にユーザなし

ロール登録ユーザが存在するかどうか(ロール情報から確認する)。

ロール登録サーバと同一のサーバをホームサーバとしているユーザか。

案件受付状態が受付許可になっているか。

ビジネスプロセス
ビジネスプロセスなし

ビジネスプロセス情報にビジネスプロセスが存在するかどうか。

運用状態が投入許可になっているか。

ビジネスプロセスは配布済みか。また，配布処理は成功しているか。

役職
役職なし
役職を持つユーザが存在するかどうか(ユーザ情報から確認する)。

(b)　案件情報の確認

運用モニタでは，案件の有無や案件の経路を確認できます。これによって，案件の着信通知を受けたが対象となる案件が見当たらない場合などに，Workflow Agentの通知結果が正しいかどうかを確認できます。

(2)　Agent Serverの定義情報と一致しているかどうかの確認

Workflow Agentは，エージェントの定義内容に関する情報（監視エージェント情報）をAgent Serverから取得してエージェントを処理します。各エージェントについて，Agent Serverに定義されている情報とWorkflow Agentが取得している情報が一致していない場合，エージェントは正しく動作しません。

Groupmax Agentでは，Agent Server側のエージェント情報とPPサーバ側のエージェント情報との整合性を確保するためのコマンドを提供しています。このコマンドを使用した整合性確保の方法については「9.3.2　サーバ間の情報の一致」を参照してください。

整合性確保コマンドを使用しない場合は，次の項目を確認して，Agent ServerとWorkflow Agentの情報を一致させてください。

(a)　Agent Server及びWorkflow Agentの両方にある情報が一致していない

Agent Server及びWorkflow Agentの両方に情報があるがそのエージェントが動作しない場合には，それぞれの状態が一致してない可能性があります。

Agent Serverの管理ツールでいったん停止状態にした後，再度活動状態にしてください。停止状態にした時点でWorkflow Agentからは監視エージェント情報が削除され，活動させた時点で，情報がWorkflow Agentに渡されます。

(b)　Agent Serverに登録されていないがWorkflow Agentに情報がある

Workflow Agentの管理ツールで，Workflow Agentにある情報を削除します。再び使用する場合は，クライアント側から再度エージェント生成します。

(c)　Agent Serverに登録されているがWorkflow Agentに情報がない

このような状態のエージェントを使用する場合は，Agent Serverの管理ツールでそのエージェントを活動状態にします。既に活動状態であれば，一度停止状態にしてから再度活動状態にします。

また，そのエージェントを使用しないのであれば，Agent Serverの管理ツールで削除します。

(3)　Workflow Agentのシステム環境の確認

Workflow Agentが提供するエージェントが正常に動作しない場合は，Workflow Agentのシステム環境に問題がある場合があります。

Workflow Agentでは，登録できるエージェント数を制限したり，接続するAgent Serverの数を制限できます。Workflow Agent管理ツールの管理コマンド

を使用してこれらのシステム環境の設定を確認してください。Workflow Agentのシステム環境の設定については「6.4　システム情報の参照・更新・初期化」を参照してください。

(4)　Groupmax Workflow Serverについての確認

Workflow Agentの設定が正しくても，Groupmax Workflow Serverが起動していなかったり，前提バージョンより古いバージョンの場合は，Workflow Agentが提供するエージェントが正しく動作しません。

次の項目を確認してください。

(a)　Groupmax Workflow Serverの稼働状況の確認

Workflow AgentはGroupmax Workflow Serverに対して情報を問い合わせます。そのため，Workflow Agentが提供するエージェントが活動する場合，システムを構築しているGroupmax Workflow Serverがすべて起動している必要があります。

Workfkow Agentが情報を問い合わせた先のGroupmax Workflow Serverが起動していない場合は，活動ログにその旨メッセージが出力され，エージェントの監視処理が終了します。その場合，稼働状況を確認し，未起動のGroupmax Workflow Serverを起動してください。

(b)　Groupmax Workflow Serverのバージョンの確認

Workflow AgentがGroupmax Workflow Serverに情報を問い合わせるときにはGroupmax Workflow Serverが提供するAPIを使用しています。その場合，エージェントの種類ごとに使用するAPIのバージョンが異なります。エージェントの種類とGroupmax Workflow Serverが提供するAPIの前提バージョンを次に示します。

項番
エージェントの種類
Groupmax Workflow Server
が提供するAPIの
前提バージョン

1
ユーザトレー内案件の着信監視
02-31以降

2
サーバ上の業務プログラムの自動起動

3
ユーザトレー内案件の処理期限監視（一般ユーザ用）

4
ユーザトレー内案件の処理期限監視（管理者用）

5
ユーザトレー内案件の一括新着監視
03-00以降

6
業務ロールトレー内案件の着信監視

７
ユーザトレー内案件の一括処理期限監視

問い合わせた先のGroupmax Workflow Serverのバージョンが前提バージョンよりも古い場合は，活動ログにその旨メッセージが出力され，エージェントの監視処理が終了します。Groupmax Workflow Serverのバージョンを確認してください。

さらに，複数のGroupmax Workflow Serverを使用していて，個々のGroupmax Workflow Serverのバージョンが異なる場合には，エージェントの種類によって前提となるGroupmax Workflow Serverのバージョンに制限があります。「3.1.2　Workflow Agentのバージョン移行」を参照して複数のGroupmax Workflow Serverを使用する場合のバージョンについて確認し，必要に応じてGroupmax Workflow Serverをバージョンアップしてください。

9.2.3　Mail Agentで確認する項目

＜この項の構成＞

(1)　Agent Serverの定義情報と一致しているかどうかの確認

(2)　Mail Agentのシステム環境の確認

(3)　Groupmax Mail Serverの稼働状況の確認

(1)　Agent Serverの定義情報と一致しているかどうかの確認

Mail Agentは，エージェントの定義内容に関する情報をAgent Serverから取得してエージェントを処理します。各エージェントについて，Agent Serverに定義されている情報とMail Agentが取得している情報が一致していない場合，エージェントは正しく動作しません。

Groupmax Agentでは，Agent Server側のエージェント情報とPPサーバ側のエージェント情報との整合性を確保するためのコマンドを提供しています。このコマンドを使用した整合性確保の方法については「9.3.2　サーバ間の情報の一致」を参照してください。

(2)　Mail Agentのシステム環境の確認

Mail Agentが提供するエージェントが正常に動作しない場合は，Mail Agentのシステム環境に問題がある場合があります。

Mail Agentでは，登録できるエージェント数を制限したり，接続するAgent Serverの数を制限したりできます。Mail Agent管理ツールの管理コマンドを使用してこれらのシステム環境の設定を確認してください。Mail Agentのシステム環境の設定については「7.4　システム情報の参照・更新・初期化」を参照してください。

(3)　Groupmax Mail Serverの稼働状況の確認

Mail AgentはGroupmax Mail Serverに対して情報を問い合わせます。そのため，Mail Agentが提供するエージェントが活動する場合，システムを構築しているGroupmax Mail Serverがすべて起動している必要があります。

Groupmax Mail Serverが起動していない場合は，活動ログにその旨メッセージが出力され，エージェントの処理が終了します。その場合，稼働状況を確認し，未起動のGroupmax Mail Serverを起動してください。

9.2.4　Document Manager Agentで確認する項目

＜この項の構成＞

(1)　Agent Serverの定義情報と一致しているかどうかの確認

(2)　Document Manager Agentのシステム環境の確認

(3)　Groupmax Document Managerの稼働状況の確認

(1)　Agent Serverの定義情報と一致しているかどうかの確認

Document Manager Agentは，エージェントの定義内容に関する情報をAgent Serverから取得してエージェントを処理します。各エージェントについて，Agent Serverに定義されている情報とDocument Manager Agentが取得している情報が一致していない場合，エージェントは正しく動作しません。

Groupmax Agentでは，Agent Server側のエージェント情報とPPサーバ側のエージェント情報との整合性を確保するためのコマンドを提供しています。このコマンドを使用した整合性確保の方法については「9.3.2　サーバ間の情報の一致」を参照してください。

(2)　Document Manager Agentのシステム環境の確認

Document Manager Agentが提供するエージェントが正常に動作しない場合は，Document Manager Agentのシステム環境に問題がある場合があります。

Document Manager Agentでは，接続するAgent Serverの数を制限できます。Document Manager Agent管理ツールの管理コマンドを使用してこれらのシステム環境の設定を確認してください。Document Manager Agentのシステム環境の設定については「8.4　システム情報の参照・更新・初期化」を参照してください。

(3)　Groupmax Document Managerの稼働状況の確認

Document Manager AgentはGroupmax Document Managerに対して情報を問い合わせます。そのため，Document Manager Agentが提供するエージェントが活動する場合，システムを構築しているGroupmax Document Managerがすべて起動している必要があります。

Groupmax Document Managerが起動していない場合は，活動ログにその旨メッセージが出力され，エージェントの処理が終了します。その場合，稼働状況を確認し，未起動のGroupmax Document Manager を起動してください。

9.3　情報の回復

障害の内容によっては，障害が発生した時点の情報を基にファイルを回復したり，連携しているサーバ間の情報を合わせる必要があります。ここでは，ファイルの回復及び情報の一致についてそれぞれ説明します。

＜この節の構成＞

9.3.1　システムファイルの回復

9.3.2　サーバ間の情報の一致

9.3.1　システムファイルの回復

OSのダウンなどによってサーバが異常終了した後，サービスを再起動できなかったり，エージェントが正常に動作しなかったりすることがあります。このときは，バックアップファイルを基にリストアしたり，ファイル回復コマンドを実行してファイルを回復し，サーバを再開させます。

Agent Server及びWorkflow Agentでは，ファイル回復コマンドを提供しています。それぞれについて説明します。

＜この項の構成＞

(1)　Agent Serverのファイル回復コマンドの実行

(2)　Workflow Agentのファイル回復コマンドの実行

(1)　Agent Serverのファイル回復コマンドの実行

Agent Serverの運用中にOSのダウンなどによってAgent Serverが正常に終了しなかった場合，このコマンドを実行して，Agent Serverのシステムファイルを回復します。また，Agent Serverのファイルが破壊された場合にも，このコマンドを実行して，ファイルを回復します。

Administrator権限でログオンします。

コマンドプロンプト画面を表示します。

次のフォルダ（ディレクトリ）に移動します。
インストール先フォルダ（ディレクトリ）¥GroupmaxAgent¥SVbin

次のコマンドを入力します。
agrecvry

注意事項

agrecvryコマンドによる回復は，エージェント定義情報とエージェント状態ファイル（エージェントがクライアント又はagmgrコマンドによって正常に停止されたかどうかの情報を格納しているファイル）を基に行います。このため，これらのファイルが壊れている場合には回復できません。

このコマンドを実行すると，活動ログ及び永続メモリの情報が初期化されます。また，Agent Serverで保留していたクライアントへのダイアログ表示要求がすべて破棄されます。

このコマンドでシステムファイルを回復した後は，Agent Serverを起動し，agmatchコマンドですべてのPPサーバとの整合性を確保する必要があります。整合性の確保が完了していないエージェントは動作しません。ただし，このコマンドの実行後に，agmgrコマンド又はクライアントでエージェントの停止及び再起動を実行したエージェントは動作します。

(2)　Workflow Agentのファイル回復コマンドの実行

Workflow Agent Serverの運用中にOSのダウンなどによってWorkflow Agentが正常に終了しなかった場合，このコマンドを実行して，Workflow Agentのファイルを回復します。

Administrator権限でログオンします。

コマンドプロンプト画面を表示します。

次のフォルダ（ディレクトリ）に移動します。
インストール先フォルダ（ディレクトリ）¥WorkflowAgent¥SVbin

次のコマンドを入力します。
warecvry

注意事項

このコマンドを実行すると，Workflow Agentに登録されているエージェントは初回に登録したときの状態に戻ります。このため，エージェントは次のように動作します。

ユーザトレー内案件の処理期限監視エージェント

「再通知なし」を指定している場合，復旧後１回目の監視では前回通知した案件の情報が再度通知されます。

ユーザトレー内案件の着信監視エージェント

「再通知なし」を指定している場合，復旧後１回目の監視では前回通知した案件の情報が再度通知されます。

サーバ上の業務プログラムの自動起動エージェント

復旧前と同じ動作をします。

ユーザトレー内案件の一括新着監視エージェント

ユーザトレーに未処理の案件がある場合，復旧後1回目の監視では必ず通知されます。

ユーザトレー内案件の一括処理期限監視エージェント

「再通知なし」を指定している場合，復旧後１回目の監視では前回通知した案件の情報が再度通知されます。

業務ロールトレー内案件の着信監視

「再通知なし」を指定している場合，復旧後１回目の監視では前回通知した案件の情報が再度通知されます。

9.3.2　サーバ間の情報の一致

Groupmax Agentシステムでは，Agent ServerとPPサーバとの間で連携処理をしています。そのため，通信障害やサーバの異常終了などの障害が発生した場合，連携しているサーバ間でエージェント情報が一致しなくなってしまうことがあります。サーバ間の情報が一致しないとエージェントは正常に動作しません。

このような場合には，Groupmax Agentが提供する整合性確保コマンドを実行することによって，サーバ間の情報を一致させることができます。

サーバ間の整合性確保の例を図9-7に示します。

図9-7　整合性確保の例

クライアント側で生成した各エージェントの定義情報は，Agent Serverで管理しています。そのため，PPサーバ側でエージェント情報が失われてしまった場合でも，Agent Server側の定義情報を利用すれば復元できます。

注意事項

Agent Server側でエージェント情報が失われた場合は，バックアップした情報からAgent Serverのエージェント情報を回復した後で，整合性の確保を実施してください。

＜この項の構成＞

(1)　整合性確保コマンドの実行

(2)　整合性確保の対象となるサーバの情報を取得する

(3)　取得したサーバ情報を基に整合性を確保する

(1)　整合性確保コマンドの実行

整合性確保コマンドは，Agent Server及びAgent - Applicationのコンポーネントそれぞれにあります。このため，障害が発生したサーバ上でコマンドを実行できます。

ただし，図9-8に示すように，整合性確保の処理中のサーバに対しては，コマンドは実行できません。この場合は，処理が終了してからコマンドを実行してください。

図9-8　整合性確保コマンドを実行できない例

整合性確保コマンドは次の手順で実行します。

整合性確保の対象となるPPサーバ又はAgent Serverの情報を取得する

取得したPPサーバ又はAgent Serverの情報を基に整合性を確保する

それぞれについて(2)及び(3)で説明します。

(2)　整合性確保の対象となるサーバの情報を取得する

(a)　Agent Serverの整合性確保コマンドの実行

Agent Serverの整合性確保の対象となるすべてのPPサーバの「PPサーバ種別」と「PPサーバ識別情報」を一覧表示します。

Administrator権限でログオンします。

コマンドプロンプト画面を表示します。

次のフォルダ（ディレクトリ）に移動します。
インストール先フォルダ（ディレクトリ）¥AgentServer¥SVbin

次のコマンドを入力します。
agmatch /l [/o PPサーバ情報出力先ファイル名]
出力先ファイル名を省略した場合は，標準出力に出力されます。

(b)　Agent - Applicationの整合性確保コマンドの実行

特定のPPサーバと接続しているAgent Serverのホスト名を一覧表示します。

Administrator権限でログオンします。

コマンドプロンプト画面を表示します。

次のフォルダ（ディレクトリ）に移動します。

Workflow Agentの場合

インストール先フォルダ（ディレクトリ）¥WorkflowAgent¥SVbin

Mail Agentの場合

インストール先フォルダ（ディレクトリ）¥MailAgent¥SVbin

Document Manager Agentの場合

インストール先フォルダ（ディレクトリ）¥DocumentManagerAgent¥SVbin

次のコマンドを入力します。

Workflow Agentの場合

wamatch /l [/o ホスト名一覧出力先ファイル名]

Mail Agentの場合

mamatch /l [/o ホスト名一覧出力先ファイル名]

Document Manager Agentの場合

damatch /l [/o ホスト名一覧出力先ファイル名]

出力先ファイル名を省略した場合は，標準出力に出力されます。

(3)　取得したサーバ情報を基に整合性を確保する

(a)　Agent Serverの整合性確保コマンドの実行

接続しているPPサーバのエージェント情報をAgent Serverのエージェント情報と一致させ，両者の整合性を確保します。

オプションを省略した場合は，整合性確保の対象となるすべてのPPサーバと整合性を確保します。オプションの指定によって，特定のPPサーバだけと整合性を確保することができます。

Administrator権限でログオンします。

コマンドプロンプト画面を表示します。

次のフォルダ（ディレクトリ）に移動します。
インストール先フォルダ（ディレクトリ）¥AgentServer¥SVbin

次のコマンドを入力します。
agmatch [/p PP種別 /s サーバ識別情報] [/t タイマ値(分)]
「PPサーバ種別」を指定した場合は，「PPサーバ識別情報」も同時に指定します。

注意事項

Agent Server側でエージェント情報が失われた場合は，バックアップした情報からAgent Serverのエージェント情報を回復した後で，整合性の確保を実施してください。

整合性処理中にエラーが発生した場合，エラー発生の旨だけが画面上に表示されます。エラーの内容についてはイベントログを参照してください。

すべてのPPサーバとの整合性処理中に一つのPPサーバでエラーが発生した場合，エラー発生後もほかのPPサーバとの整合性処理は続行します。エラーの発生したPPサーバについては，イベントログでエラーの原因を確認して対策してください。その後，このコマンドを再度実行して整合性を確保してください。

このコマンドを実行できるのは，対象となるPPサーバのバージョンが03-00以降の場合です。

Agent Server及び対象となるPPサーバのバージョンが共に03-10以降の場合は，PPサーバ上でトリガ監視をしないでアクションの実行だけをするエージェント(時間を監視するエージェント)も整合性処理の対象となります。

Agent Server又は各PPサーバの実行エンジンがバージョン03-00の場合，整合性確保の対象となるPPサーバのサービスが起動していることを確認してからこのコマンドを実行してください。サービスが未起動でもこのコマンドは正常終了しますが，実際には整合性は確保されていません。

(b)　Agent - Applicationの整合性確保コマンドの実行

PPサーバのエージェント情報を，接続しているAgent Serverのエージェント情報と一致させ，両者の整合性を確保します。

オプションを省略した場合は，接続しているすべてのAgent Serverを整合性確保の対象とします。オプションの指定によって，特定のAgent Serverだけと整合性を確保することができます。

Administrator権限でログオンします。

コマンドプロンプト画面を表示します。

次のフォルダ（ディレクトリ）に移動します。

Workflow Agentの場合

インストール先フォルダ（ディレクトリ）¥WorkflowAgent¥SVbin

Mail Agentの場合

インストール先フォルダ（ディレクトリ）¥MailAgent¥SVbin

Document Manager Agentの場合

インストール先フォルダ（ディレクトリ）¥DocumentManagerAgent¥SVbin

次のコマンドを入力します。

Workflow Agentの場合

wamatch [/s Agent Serverのホスト名又はIPアドレス] [/t タイマ値(分)]

Mail Agentの場合

mamatch [/s Agent Serverのホスト名又はIPアドレス] [/t タイマ値(分)]

Document Manager Agentの場合

damatch [/s Agent Serverのホスト名又はIPアドレス] [/t タイマ値(分)]

注意事項

整合性処理中にエラーが発生した場合，エラー発生の旨だけが画面上に表示されます。エラーの内容についてはイベントログを参照してください。

すべてのAgent Serverとの整合性処理中に一つのAgent Serverでエラーが発生した場合，エラー発生後もほかのAgent Serverとの整合性処理は続行します。エラーの発生したAgent Serverについては，イベントログでエラーの原因を確認して対策してください。その後，このコマンドを再度実行して整合性を確保してください。

このコマンドを実行できるのは，対象となるPPサーバのバージョンが03-10以降の場合です。

9.4　保守情報の採取

回復できないような障害が発生した場合は，次に示す操作で保守情報を採取してください。

＜この節の構成＞

9.4.1　Agent Serverで障害が発生した場合

9.4.2　Agent Server Mail Optionで障害が発生した場合

9.4.3　Workflow Agentで障害が発生した場合

9.4.4　Mail Agentで障害が発生した場合

9.4.5　Document Manager Agentで障害が発生した場合

9.4.1　Agent Serverで障害が発生した場合

Administrator権限でログオンします。

コマンドプロンプト画面を表示します。

次のフォルダ（ディレクトリ）に移動します。
インストール先フォルダ（ディレクトリ）¥GroupmaxAgent¥SVbin

次のコマンドを入力します。
aglog　/a　8　[>既存フォルダ（ディレクトリ）¥出力ファイル名]
agtrace　[>既存フォルダ（ディレクトリ）¥出力ファイル名]
agshow　/d　all（05-20以降で実行可能）

9.4.2　Agent Server Mail Optionで障害が発生した場合

Administrator権限でログオンします。

コマンドプロンプト画面を表示します。

次のフォルダ（ディレクトリ）に移動します。
インストール先フォルダ（ディレクトリ）¥GroupmaxAgent¥SVbin

次のコマンドを入力します。
agtrace　[>既存フォルダ（ディレクトリ）¥出力ファイル名]

9.4.3　Workflow Agentで障害が発生した場合

Administrator権限でログオンします。

コマンドプロンプト画面を表示します。

次のフォルダ（ディレクトリ）に移動します。
インストール先フォルダ（ディレクトリ）¥WorkflowAgent¥SVbin

次のコマンドを入力します。
watrc　[>既存フォルダ（ディレクトリ）¥出力ファイル名]

9.4.4　Mail Agentで障害が発生した場合

Mail Agent本体で障害が発生した場合

Administrator権限でログオンします。

コマンドプロンプト画面を表示します。

次のフォルダ（ディレクトリ）に移動します。
インストール先フォルダ（ディレクトリ）¥MailAgent¥SVbin

次のコマンドを入力します。
matrc　[>既存フォルダ（ディレクトリ）¥出力ファイル名]
バージョンが06-54-/A以降の場合は次のコマンドも入力します。
MAipstat [>既存フォルダ（ディレクトリ）¥出力ファイル名]

Mail Agent実行エンジンで障害が発生した場合

Administrator権限でログオンします。

コマンドプロンプト画面を表示します。

次のフォルダ（ディレクトリ）に移動します。
インストール先フォルダ（ディレクトリ）¥MailAgentFunction¥SVbin

次のコマンドを入力します。
maftrc　[>既存フォルダ（ディレクトリ）¥出力ファイル名]

9.4.5　Document Manager Agentで障害が発生した場合

Administrator権限でログオンします。

コマンドプロンプト画面を表示します。

次のフォルダ（ディレクトリ）に移動します。
インストール先フォルダ（ディレクトリ）¥DocumentManagerAgent¥SVbin

次のコマンドを入力します。
datrc　[>既存フォルダ（ディレクトリ）¥出力ファイル名]

付録

＜この付録の構成＞

付録A　用語解説

付録B　プログラムを削除する方法

付録C　管理ツールのメニューコマンド一覧

付録D　活動ログ及びイベントログのエラーコード

付録E　イベントログメッセージの一覧

付録F　フォルダ（ディレクトリ）構成

付録G　Windows Server 2008使用時の注意事項

付録H　Windows Server 2012使用時の注意事項

付録A　用語解説

(英字)

Agent - Application

Groupmax Workflow，Groupmax Mail，Groupmax Document Managerと連携して活動するエージェントを提供しています。次の三つから成ります。

Workflow Agent

Mail Agent

Document Manager Agent

それぞれPPサーバ側にインストールする本体部分と，Agent Server側にインストールする実行エンジン部分があります。

Agent Server

エージェントを活動させるため必要なGroupmax Agentの基本プログラムです。Agent Serverでは，エージェントを開発するためのAPIや，エージェントが活動する環境などを提供しています。また，システム管理者用にエージェントを管理する機能を提供しています。

Agentメール送信ライブラリ（Agent Server Mail Option）

独自に開発されたエージェントやWorkflowエージェントの実行結果などをGroupmax Mailを使ってメール送信する場合に，Agent ServerとGroupmax Mail Serverを連携させるための機能です。Agent ServerとGroupmax Mail Serverを別々のマシンにインストールする場合，Groupmax Mail Server側のマシンにこのライブラリをインストールする必要があります。

Document Manager Agent

Groupmax Document Managerと連携して活動するエージェントを提供しています。Groupmax Document Manager 側にインストールする本体部分とAgent Server側にインストールする実行エンジン部分があります。

Document Manager Agent本体（Agent - Document Manager Server）

Document Manager Agent実行エンジン（Agent - Document Manager Function）

Mail Agent

Groupmax Mailと連携して活動するエージェントを提供しています。Groupmax Mail Server側にインストールする本体部分とAgent Server側にインストールする実行エンジン部分があります。

Mail Agent本体（Agent - Mail Server）

Mail Agent実行エンジン（Agent - Mail Function）

PPサーバ

エージェント機能をサポートしているPPのサーバのことです。Groupmax製品では，Groupmax Mail ServerやWorkflow Serverなどがこれにあたります。PPサーバは，Agent Serverが提供するライブラリによってAgent Serverと連携した処理をします。

Workflow Agent

Groupmax Workflowと連携して活動するエージェントを提供しています。Groupmax Workflow Server側にインストールする本体部分とAgent Server側にインストールする実行エンジン部分があります。

Workflow Agent本体（Agent - Workflow Server）

Workflow Agent実行エンジン（Agent - Workflow Function）

(ア行)

一般ユーザ

Agent - Applicationが提供する一般用のエージェントや，エージェント開発者が独自に開発したエージェントを利用する方です。

永続メモリ

エージェントの生存期間，又は一つのトリガ発生からアクションの実行までの間保持される記憶領域です。ユーザプログラム間での情報の引き継ぎをする場合に，永続メモリのデータを参照・更新します。

エージェント開発者

エージェントの活動内容を定義するユーザプログラムを作成したり，ユーザインタフェースを作成したりして，独自のエージェントを開発する方です。開発したエージェントプログラムは，目的に応じてシステム管理者や一般ユーザが使用します。

エージェントキー

エージェントを実行する場合に，Agent Serverがエージェントを識別するために割り当てるキーです。Workflow Agentの管理ツールで処理期限監視及び案件着信監視エージェントの定義情報に関する操作をする場合にエージェントキーを指定します。

エージェント番号

Agent Serverが，登録されたエージェントを識別するために割り当てる番号のことです。Agent Serverの管理ツールでエージェントに関する情報を参照するときは，多くの場合，エージェント番号を指定して参照します。

(カ行)

監視エージェント情報

Workflow AgentがAgent Serverから取得する，処理期限監視エージェント及び案件着信監視エージェントの定義に関する情報です。

管理ツール

システム管理者がシステム情報やエージェント情報を管理するために使用するツールです。Groupmax Agentでは，Agent Server，Workflow Agent，Mail Agent，Document Manager Agentにそれぞれ管理ツールを提供しています。Agent Server管理ツールでは，障害時に各エージェントの活動ログも参照できます。

(サ行)

サーバエージェントマネージャ

サーバマシンに格納されているエージェントの生成や削除などを，一般ユーザがクライアントマシンから実行するためのツールです。サーバエージェントマネージャの使用方法については，マニュアル「Groupmax Integrated Desktop Version 7　ユーザーズガイド」を参照してください。

シーケンス番号

Workflow Agentが，登録されたエージェントを識別するために割り当てる番号のことです。Workflow Agentの管理ツールで処理期限監視及び案件着信監視エージェントの定義情報に関する操作をする場合にシーケンス番号を指定します。

実行エンジン

Agent - Applicationには，PPサーバ側の本体部分とAgent Server側の実行エンジン部分があります。実行エンジン部分は，Agent ServerとPPサーバの間で情報の受け渡しをします。例えば，Agent Serverからのトリガ監視やアクション実行要求をPPサーバ上にあるAgent - Applicationの本体部分に通知します。

生存期間

クライアントがエージェントを生成するときに，そのエージェントの活動がいつまで有効になるかを指定する期間のことです。

(タ行)

トリガ

エージェントが動作するきっかけのことです。

付録B　プログラムを削除する方法

Agent Server，Agentメール送信ライブラリ，及びAgent - Applicationの各コンポーネントを削除する方法を説明します。

＜この節の構成＞

付録B.1　Agent Serverを削除する

付録B.2　Workflow Agentを削除する

付録B.3　Mail Agentを削除する

付録B.4　Document Manager Agentを削除する

付録B.1　Agent Serverを削除する

Agent Server，Agentメール送信ライブラリを削除する方法を説明します。

＜この項の構成＞

(1)　Agent Serverを削除する

(2)　Agentメール送信ライブラリ（Agent Server Mail Option）を削除する

(1)　Agent Serverを削除する

Agent Serverを削除する操作を次に示します。

AgentServerサービスを停止してから操作してください。

Administratorの権限でWindows NTにログオンします。

日立総合インストーラのインストールプログラム（HCD_INST.EXE）を起動します。

インストールプログラムの画面に従って作業を進め，インストール方法で「カスタム」を選択します。

アプリケーションを選択するためのダイアログが表示されたら，「Groupmax Agent Server Version 5」を選択して実行します。
会社名と個人名を入力するためのダイアログが表示されます。

［開始］ボタンをクリックします。
プログラムをインストールするか削除するかを問い合わせるダイアログが表示されます。

「プログラムの削除」をチェックして，［ＯＫ］ボタンをクリックします。
削除してもよいか問い合わせるダイアログが表示されます。

［はい］ボタンをクリックします。
プログラムの削除が開始されます。プログラムの削除が終了すると，その旨のメッセージが表示されます。

［ＯＫ］ボタンをクリックします。
これでAgent Serverが削除されます。

注意事項

Agent Serverを削除しても，ユーザが開発したカスタマイズプログラムが格納されているフォルダ（ディレクトリ）及び「5.6　システム情報の参照・更新・初期化」で説明しているシステム環境に関する設定は削除されません。これらを削除する場合は，次に示すフォルダ（ディレクトリ）及びレジストリを削除してください。

フォルダ（ディレクトリ）

インストールフォルダ（ディレクトリ）¥GroupmaxAgent¥SVcst

レジストリ

HKEY_LOCAL_MACHINE¥SOFTWARE¥HITACHI¥GroupmaxAgent

(2)　Agentメール送信ライブラリ（Agent Server Mail Option）を削除する

Groupmax Mail ServerがインストールされているマシンにインストールしたAgentメール送信ライブラリ（Agent Server Mail Option）は，次の手順で削除します。なお，削除するときには，必ずAgent Server Mail Optionサービスを停止してから操作してください。

Administratorの権限でWindows NTにログオンします。

日立総合インストーラのインストールプログラム（HCD_INST.EXE）を起動します。

インストールプログラムの画面に従って作業を進め，インストール方法で「カスタム」を選択します。

アプリケーションを選択するためのダイアログが表示されたら，「Groupmax Agent Server Mail Option Version 5」を選択して実行します。
会社名及び個人名を入力するダイアログが表示されます。

［開始］ボタンをクリックします。
プログラムをインストールするか削除するかを問い合わせるダイアログが表示されます。

「プログラムの削除」をチェックして，［ＯＫ］ボタンをクリックします。
削除してもよいか問い合わせるダイアログが表示されます。

［はい］ボタンをクリックします。
プログラムの削除が開始されます。プログラムの削除が終了すると，その旨のメッセージが表示されます。

［ＯＫ］ボタンをクリックします。
これでAgentメール送信ライブラリが削除されます。

付録B.2　Workflow Agentを削除する

＜この項の構成＞

(1)　Workflow Agent本体（Agent - Workflow Server ）を削除する

(2)　Workflow Agent実行エンジン（Agent - Workflow Function）を削除する

(1)　Workflow Agent本体（Agent - Workflow Server ）を削除する

Workflow Agent本体を削除する手順を次に示します。

WorkflowAgentサービスを停止してから操作してください。

Administratorの権限でWindows NTにログオンします。

日立総合インストーラのインストールプログラム（HCD_INST.EXE）を起動します。

インストールプログラムの画面に従って作業を進め，インストール方法で「カスタム」を選択します。

アプリケーションを選択するためのダイアログが表示されたら，「Groupmax Agent - Workflow Server Version 5」を選択して実行します。
会社名及び個人名を入力するダイアログが表示されます。

［開始］ボタンをクリックします。
プログラムをインストールするか削除するかを問い合わせるダイアログが表示されます。

「プログラムの削除」をチェックして，［ＯＫ］ボタンをクリックします。
削除してもよいか問い合わせるダイアログが表示されます。

［はい］ボタンをクリックします。
プログラムの削除が開始されます。プログラムの削除が終了すると，その旨のメッセージが表示されます。

［ＯＫ］ボタンをクリックします。
これでWorkflow Agentが削除されます。

注意事項

Workflow Agentを削除しても，「6.4　システム情報の参照・更新・初期化」で説明しているシステム環境に関する設定は削除されません。これらを削除する場合は，次に示すレジストリを削除します。

HKEY_LOCAL_MACHINE¥SOFTWARE¥HITACHI¥WorkflowAgent

(2)　Workflow Agent実行エンジン（Agent - Workflow Function）を削除する

Workflow Agent実行エンジンを削除する手順を次に示します。

AgentServerサービスを停止してから操作してください。

Administratorの権限でWindows NTにログオンします。

日立総合インストーラのインストールプログラム（HCD_INST.EXE）を起動します。

インストールプログラムの画面に従って作業を進め，インストール方法で「カスタム」を選択します。

アプリケーションを選択するためのダイアログが表示されたら，「Groupmax Agent - Workflow Function Version 5」を選択して実行します。
会社名及び個人名を入力するダイアログが表示されます。

［開始］ボタンをクリックします。
プログラムをインストールするか削除するかを問い合わせるダイアログが表示されます。

「プログラムの削除」をチェックして，［ＯＫ］ボタンをクリックします。
削除してもよいか問い合わせるダイアログが表示されます。

［はい］ボタンをクリックします。
プログラムの削除が開始されます。プログラムの削除が終了すると，その旨のメッセージが表示されます。

［ＯＫ］ボタンをクリックします。
これで実行エンジンが削除されます。

付録B.3　Mail Agentを削除する

＜この項の構成＞

(1)　Mail Agent本体（Agent - Mail Server）を削除する

(2)　Mail Agent実行エンジン（Agent - Mail Function）を削除する

(1)　Mail Agent本体（Agent - Mail Server）を削除する

Mail Agent本体は，Groupmax Mail Serverと同じマシンにインストールしてあります。Workflow Agent本体と同様の手順で，インストールしたマシンから削除してください。なお，削除するときには，必ずMailAgentサービスを停止してから操作してください。

(2)　Mail Agent実行エンジン（Agent - Mail Function）を削除する

Mail Agent実行エンジンは，Agent Serverと同じマシンにインストールしてあります。Workflow Agent実行エンジンと同様の手順で，インストールしたマシンから削除してください。なお，削除するときには，必ずMailAgentFunctionサービス，MailAgentサービス，およびAgentServerサービスを停止してから操作してください。

付録B.4　Document Manager Agentを削除する

＜この項の構成＞

(1)　Document Manager Agent本体（Agent - Document Manager Server）を削除する

(2)　Document Manager Agent実行エンジン（Agent - Document Manager Function）を削除する

(1)　Document Manager Agent本体（Agent - Document Manager Server）を削除する

Document Manager Agent本体は，Groupmax Document Managerと同じマシンにインストールしてあります。Workflow Agent本体と同様の手順で，インストールしたマシンから削除してください。なお，削除するときには，必ずDocument Manager AgentサービスおよびDocument Managerサービスを停止してから操作してください。

また，Document Manager Agentが動作するようにインストールされている状態で，Document Manager Agentだけを削除した場合，文書管理サーバ(Document Manager)が起動しなくなります。文書管理サーバを起動できるようにするために，削除の前に次のどちらかの設定をしてください。

「文書管理 管理ツール」の「環境設定」ダイアログで，イベント通知機能の値を「nouse」に設定する

イベント通知リストファイルから，Document Manager Agentに関連するイベント種別を削除する

(2)　Document Manager Agent実行エンジン（Agent - Document Manager Function）を削除する

Document Manager Agent実行エンジンは，Agent Serverと同じマシンにインストールしてあります。Workflow Agent実行エンジンと同様の手順で，インストールしたマシンから削除してください。

AgentServerサービスを停止してから操作してください。

付録C　管理ツールのメニューコマンド一覧

管理ツールで使用できるコマンドを次に示します。

＜この節の構成＞

(1)　Agent Server管理ツール

(2)　Workflow Agent管理ツール

(3)　Mail Agent管理ツール(本体側，実行エンジン側)

(4)　Document Manager Agent管理ツール

(1)　Agent Server管理ツール

メインメニューのコマンド | メインメニューのコマンド選択時に開くメニューのコマンド | 機能 | 説明している箇所
(1)UserShow,AgentShow/Change,ActiveLog | (1)UserID show | 特定ユーザの登録したエージェントの一覧表示 | 5.4.1
(2)UserID list | エージェントを登録しているユーザの一覧表示 | 5.4.2
(3)Agent list | 登録されている全エージェントの一覧表示 | 5.4.3
(4)AgentNum list | 特定のエージェントのエージェント名，エージェント番号を表示 | 5.4.4
(5)Agent detail | 特定のエージェントの詳細情報を表示 | 5.4.5
(6)Agent active | エージェントを活動させる | 5.5.1
(7)Agent inactive | エージェントを停止させる | 5.5.2
(8)Agent delete | エージェントを削除する | 5.5.3
(9)UserID ActLog | 特定ユーザの登録したエージェントの活動ログ表示 | 5.5.4
(a)Agent ActLog | 登録されている全エージェントの活動ログ表示 | 5.5.5
(b)AgentNum ActLog | 特定のエージェントの活動ログ表示 | 5.5.6
(o)output control | 結果出力先の指定 | 5.9.1
(x)editor control | 出力結果エディタの表示・非表示 | 5.9.2
(e)end | メインメニューに戻る | －
(q)quit | 終了 | －
(2)System Information | (1)AgentScheduler | Agent Serverのスケジューラ情報の参照・更新 | 5.6.1
(2)Definition | 定義情報の上限値の参照・更新 | 5.6.2
(3)Output path | フォルダ（ディレクトリ）情報の参照・更新 | 5.6.3
(4)Mail | メール情報の参照・更新 | 5.6.4
(5)Initialize | システム情報の初期化 | 5.6.5
(e)end | メインメニューに戻る | －
(q)quit | 終了 | －
(3)Dump | (1)Dump | ダンプファイルの出力 | 5.7
(e)end | メインメニューに戻る | －
(q)quit | 終了 | －
(4)Backup/Restore | (1)Backup | バックアップ | 5.8.1
(2)Restore | リストア | 5.8.2
(e)end | メインメニューに戻る | －
(q)quit | 終了 | －
(o)output control | － | 結果出力先の変更 | 5.9.1
(q)quit | － | 終了 | －

（凡例）－：該当しないことを表します。

(2)　Workflow Agent管理ツール

メインメニューのコマンド | メインメニューのコマンド選択時に開くメニューのコマンド | (2)Agent operation選択時に開くメニューのコマンド | 機能 | 説明している箇所
(1)System | (1)System information change | － | システム情報の参照・更新 | 6.4.1
(2)System file initialize | － | システム情報の初期化 | 6.4.2
(e)end | － | メインメニューに戻る | －
(q)quit | － | 終了 | －
(2)Timer | (1)Timer information change | － | タイマ情報の参照・更新 | 6.5
(e)end | － | メインメニューに戻る | －
(q)quit | － | 終了 | －
(3)Agent | (1)Agent Information | － | 監視エージェント情報の参照 | 6.6.1
(2)Agent operation | (1)Event watch(Agent entry) | 監視エージェント情報の登録 | 6.6.2
(2)Event cancel(Agent delete) | 監視エージェント情報の削除 | 6.6.3
(e)end | (2)Agent operationに戻る | －
(q)quit | 終了 | －
(x)edit control | － | 出力結果エディタの表示・非表示 | 6.8
(e)end | － | メインメニューに戻る | －
(q)quit | － | 終了 | －
(4)Dump | (1)Dump | － | ダンプファイルの出力 | 6.7
(e)end | － | メインメニューに戻る | －
(q)quit | － | 終了 | －
(q)quit | － | － | 終了 | －

（凡例）－：該当しないことを表します。

(3)　Mail Agent管理ツール(本体側，実行エンジン側)

メインメニューのコマンド | メインメニューのコマンド選択時に開くメニューのコマンド | 機能 | 説明している箇所
(1)System | (1)System Information Change | システム情報の変更 | 7.4.1
(2)System file initialize | システム情報の初期化 | 7.4.2
(e)end | メインメニューに戻る | －
(q)quit | 終了 | －
(2)Dump | (1)Dump | ダンプファイルの出力 | 7.5
(e)end | メインメニューに戻る | －
(q)quit | 終了 | －
(q)quit | － | 終了 | －

(4)　Document Manager Agent管理ツール

メインメニューのコマンド | メインメニューのコマンド選択時に開くメニューのコマンド | 機能 | 説明している箇所
(1)System | (1)System Information Change | システム情報の変更 | 8.4.1
(2)System file initialize | システム情報の初期化 | 8.4.2
(e)end | メインメニューに戻る | －
(q)quit | 終了 | －
(2)Dump | (1)Dump | ダンプファイルの出力 | 8.5
(e)end | メインメニューに戻る | －
(q)quit | 終了 | －
(q)quit | － | 終了 | －

付録D　活動ログ及びイベントログのエラーコード

活動ログ及びイベントログに出力されるエラーコードの一覧を表D-1に示します。

表D-1　エラーコードの一覧

エラーコ－ド | 意味
異常 | 0x00010000​ | AG_NG | 異常
0x00010001​ | AGERR_INVDEF | 入力定義フォーマット不正
0x00010002​ | AGERR_NOAGCB | エージェント登録数オーバー
0x00010003​ | AGERR_INVARG | 引数不正
0x00010004​ | AGERR_NOINACT | エージェントが停止状態でない
0x00010005​ | AGERR_NOTMTRG | タイマトリガでないためエージェントを強制実行できない
0x00010006​ | AGERR_NOACT | 活動状態でないためエージェントを強制実行できない
0x00010007​ | AGERR_NOMEM | メモリ容量が不足している
0x00010008​ | AGERR_NOENT | 情報なし
0x00010009​ | AGERR_OVERSIZE | サイズをオーバした
0x0001000​a | AGERR_NOTSUPPORT | 通知種別又は定義内容に未サポートの要求が指定された
0x0001000​b | AGERR_SOCK | ソケット関数エラー
0x0001000​c | AGERR_REFS | 接続拒否
0x0001000​d | AGERR_DISCON | 送受信中切断
0x0001000​e | AGERR_NTWRT | ファイルのWRITE権限なし
0x0001000​f | AGERR_NTRD | ファイルのREAD権限なし
0x00010010​ | AGERR_DSKFLL | ディスクフル
0x00010011​ | AGERR_NTFL | 転送するファイルがない
0x00010012​ | AGERR_NOMOREOPN | これ以上オープンできない
0x00010013​ | AGERR_NOMORECON | これ以上接続できない
0x00010014​ | AGERR_TIMEOUT | タイムアウトした
0x00010015​ | AGERR_NORSV | これ以上メッセージを保留できない
0x00010016​ | AGERR_DOPNER | 定義エントリファイルのオープン失敗
0x00010020​ | AGERR_DLLLOAD | 共用ライブラリのローディングに失敗
0x00010021​ | AGERR_HOSTNFOUND | ホストがみつからない
0x00010022​ | AGERR_SRVNOTINST | エージェントサーバ本体がみつからない
0x00010030​ | AGERR_VMISSMATCH | バージョン不一致
0x00010040​ | AGERR_INMATCH | 他PPサーバとの整合性処理中
0x00010041​ | AGERR_NOTMATCH | 整合性処理を開始していない
0x00010101​ | AGERR_INVMSERV | メールサーバ障害
0x00010102​ | AGERR_INVTO | あて先不正
0x00010103​ | AGERR_INVFROM | 送信者不正
0x00010104​ | AGERR_INVFILE | メール本文のファイル名不正
0x00010105​ | AGERR_INVSVINF | メールサーバ情報の設定誤り
0x00010106​ | AGERR_INVDOMAIN | メールサーバサービス使用不可
0x00010107​ | AGERR_INVUID | ログインユーザID不正
入出力エラー | 0x00011001​ | AGERR_FOPEN | オープンエラー
0x00011002​ | AGERR_FREAD | リードエラー
0x00011003​ | AGERR_FCLOSE | クローズエラー
0x00011004​ | AGERR_FWRITE | ライトエラー
0x00011005​ | AGERR_FACCES | アクセス不可
0x00011006​ | AGERR_FTMPNM | 一時ファイル名の取得失敗
メモリエラー | 0x00012001​ | AGERR_MEM | メモリエラー
通信エラー | 0x00013001​ | AGERR_INVIPADDR | IPアドレス不正
0x00013002​ | AGERR_INVPORT | サービス名／ポート番号不正
0x00013003​ | AGERR_COMLOAD | 通信プロセスのロード失敗
0x00013004​ | AGERR_COMDIR | 通信プロセス用ディレクトリアクセス失敗
0x00013005​ | AGERR_SMTPSOCK | SMTPサーバ接続時のsocket()失敗
0x00013006​ | AGERR_SMTPCONN | SMTPサーバ接続時のconnect()失敗
0x00013007​ | AGERR_SMTPSEND | SMTPサーバ接続時のsend()失敗
0x00013008​ | AGERR_SMTPRECV | SMTPサーバ接続時のrcev()失敗
0x00013009​ | AGERR_SMTPSLCT | SMTPサーバ接続時のselect()失敗
0x0001300​a | AGERR_SMTPTO | SMTPサーバから応答なし
パラメタエラー | 0x00014101​ | AGERR_CFGINV | 環境設定パラメタ不正
0x00014102​ | AGERR_CFGDUP | 環境設定パラメタ重複
0x00014103​ | AGERR_CFGLACK | 環境設定パラメタ不足
0x00014104​ | AGERR_NOENV | 環境変数が無い
0x00014105​ | AGERR_CFGSYNTAX | 環境設定パラメタ構文エラー
0x00014201​ | AGERR_ENGNOFILE | 実行エンジン情報ファイルが無い
0x00014202​ | AGERR_ENGINVINFO | 実行エンジン情報ファイルの情報不正
0x00014203​ | AGERR_ENGINVVER | 実行エンジン情報ファイルのバージョン不正
システムリソース不足 | 0x00015001​ | AGERR_EMPMSGQ | メッセージキューリソース不足
0x00015002​ | AGERR_EMPSEM | セマフォリソース不足
0x00015003​ | AGERR_EMPSHM | 共用メモリリソース不足

付録E　イベントログメッセージの一覧

Windows NTのイベントログに出力されるメッセージと対処方法を示します。メッセージの [ ] 内にはエラーの詳細を示す可変情報が表示されます。

＜この節の構成＞

付録E.1　Agent Serverのイベントログメッセージ

付録E.2　Workflow Agentのイベントログメッセージ

付録E.3　Mail Agentのイベントログメッセージ

付録E.4　Document Manager Agentのイベントログメッセージ

付録E.1　Agent Serverのイベントログメッセージ

KDAS00100-E

エージェントサーバ内でエラーが発生しました。
Function=[内部機能コード]
Reason=[内部理由コード]

種別：障害
イベントID：100
説明：無視して処理を続行する。
対処：・「9.4　保守情報の採取」を参照して保守情報を採取してください。
　　　・保守員に連絡してください。

KDAS00101-E

ファイルI/Oエラーが発生しました。
Function=[内部機能コード]
Detail=[内部理由コード]

種別：障害
イベントID：101
説明：エージェントサーバのAPIをエラーリターンさせ，その後の処理を実
　　　行する。
対処：・「9.4　保守情報の採取」を参照して保守情報を採取してください。
　　　・保守員に連絡してください。

KDAS00102-W

最大登録可能エージェント数を超えるエージェントを生成しようとしました。

種別：警告
イベントID：102
説明：エージェント登録処理を中止する。
対処：・不要なエージェントを削除してください。
　　　・エージェントサーバ停止後，agmgrコマンドで最大登録可能エー
　　　　ジェント数を大きくしてください。なお，最大登録可能エージェン
　　　　ト数は3,000個です。

KDAS00103-I

定義情報の検索に失敗しました。すでに削除済みのエージェントキーを指定したか，不正なエージェントキーを指定した可能性があります。
Function=[内部機能コード]

種別：情報
イベントID：103
説明：エージェントの検索を中止する。
対処：・削除済みのエージェントを再度削除しようとしていないか見直して
　　　ください。
　　　・不正なエージェントキーを指定していないか見直してください。

KDAS00104-W

エージェント定義情報が最大長の32,768バイトを超えています。
Function=[内部機能コード]
Reason=[内部理由コード]

種別：警告
イベントID：104
説明：エージェントの登録処理を中止する。
対処：定義情報の合計が32,768バイトを超えていないか見直してください。

KDAS00106-E

ユーザIDに対応したエージェント数取得処理に失敗しました。

種別：障害
イベントID：106
説明：処理を中断する。
対処：・「9.4　保守情報の採取」を参照して保守情報を採取してください。
　　　・保守員に連絡してください。

KDAS00107-E

エージェント定義情報の「サイズ取得，読み取り又は削除」処理に失敗しました。

種別：障害
イベントID：107
説明：処理を中断する。
対処：・「9.4　保守情報の採取」を参照して保守情報を採取してください。
　　　・保守員に連絡してください。

KDAS00108-E

エージェント定義情報の「読み取り(共通部)，読み取り(トリガ部)，読み取り(アクション選択部)，読み取り(アクション実行部)又はパラメタ変換」処理に失敗しました。

種別：障害
イベントID：108
説明：処理を中断する。
対処：・「9.4　保守情報の採取」を参照して保守情報を採取してください。
　　　・保守員に連絡してください。

KDAS00109-E

エージェント定義用のレジストリアクセス処理に失敗しました。

種別：障害
イベントID：109
説明：処理を中断する。
対処：・「9.4　保守情報の採取」を参照して保守情報を採取してください。
　　　・保守員に連絡してください。

KDAS00110-E

エージェント定義ファイルのロックに失敗しました。
ロックID=‘[ロックID]’

種別：障害
イベントID：110
説明：エージェント登録処理を中止する。
対処：・「9.4　保守情報の採取」を参照して保守情報を採取してください。
　　　・保守員に連絡してください。

KDAS00120-E

エージェント定義情報中のパラメータの長さフィールドに不正な文字が指定されています。
定義情報の行番号：[番号]

種別：障害
イベントID：120
説明：エージェント登録処理を中止する。
対処：定義情報の行番号で示した行の長さフィールドを見直してください。

KDAS00121-E

エージェント定義情報中のパラメータの長さが，最大長の4,095バイトを超えています。
定義情報の行番号：[番号]

種別：障害
イベントID：121
説明：エージェント登録処理を中止する。
対処：定義情報の行番号で示した行のパラメータの長さを4,095バイト以内
　　にしてください。

KDAS00122-E

エージェント定義情報中のパラメータ長が，定義された内容の合計と等しくありません。
定義情報の行番号：[番号]

種別：障害
イベントID：122
説明：エージェント登録処理を中止する。
対処：定義情報の行番号で示した行のパラメータ長と，パラメータの内容を
　　　一致させてください。

KDAS00123-E

エージェント定義解析中に，処理例外が発生しました。無視して処理を続行します。
定義情報の行番号：[番号]

種別：障害
イベントID：123
説明：処理を続行する。
対処：・「9.4　保守情報の採取」を参照して保守情報を採取してください。
　　　・保守員に連絡してください。

KDAS00124-E

エージェント定義解析中に，不当なキーワードを検出しました。
不正なキーワード：[キーワード]

種別：障害
イベントID：124
説明：エージェントの登録処理を中止する。
対処：不正なキーワードを修正してください。

KDAS00125-E

エージェント定義情報中のパラメータ長がパラメータ固有の最大長を超えています。
定義情報中のパラメータ：[パラメータ]

種別：障害
イベントID：125
説明：エージェントの登録処理を中止する。
対処：パラメータ長を修正してください。

KDAS00126-E

エージェント定義情報中のtrigger-countで指定したトリガ数と，指定されたトリガ定義が一致していません。

種別：障害
イベントID：126
説明：エージェントの登録処理を中止する。
対処：trigger-countとトリガ定義を同じにしてください。

KDAS00127-E

エージェント定義情報中のaction-countで指定したアクション数と，指定されたアクション定義が一致していません。

種別：障害
イベントID：127
説明：エージェントの登録処理を中止する。
対処：action-countとアクション定義を同じにしてください。

KDAS00128-E

エージェント定義情報中のactcnd-countで指定したアクション条件数と，指定されたアクション条件定義が一致していません。

種別：障害
イベントID：128
説明：エージェントの登録処理を中止する。
対処：actcnd-countとアクション条件定義を同じにしてください。

KDAS00142-I

内部トレース採取用ファイルのロックに失敗したため，内部トレース採取を中止しました。

種別：情報
イベントID：142
説明：内部トレース採取は中止するが，処理は続行する。
対処：・「9.4　保守情報の採取」を参照して保守情報を採取してください。
　　　・保守員に連絡してください。

KDAS00200-E

エージェントサーバ内でエラーが発生しました。
内部コード=[内部コード]
理由コード=[内部理由コード]

種別：障害
イベントID：200
説明：エージェントサーバのサービス起動又は停止処理中は，エージェント
　　　サーバを停止する。エージェントサーバのサービスが起動済みの場
　　　合は，処理を続行する。
対処：・「9.4　保守情報の採取」を参照して保守情報を採取してください。
　　　・保守員に連絡してください。

KDAS00201-E

エージェントサーバ内のスケジューラが障害を検出したため，強制停止しました。

種別：障害
イベントID：201
説明：エージェントサーバを停止する。
対処：・「9.4　保守情報の採取」を参照して保守情報を採取してください。
　　　・保守員に連絡してください。

KDAS00202-E

エージェント定義内のエージェント起動スケジュールの指定が不正なため，エージェントを停止しました。
エージェントキー上位=[エージェントキー上位]
エージェントキー下位=[エージェントキー下位]

種別：障害
イベントID：202
説明：エージェントキーで示すエージェントを停止する。
対処：・エージェント定義を見直してください。
　　・エージェントを一度削除した後，正しいエージェント定義に変更し，
　　　　再度登録してください。

KDAS00203-W

エージェントの生存期間に達したため，エージェントを削除しました。
エージェントキー上位=[エージェントキー上位]
エージェントキー下位=[エージェントキー下位]

種別：警告
イベントID：203
説明：エージェントキーで示すエージェントを削除する。
対処：業務に必要なエージェントであれば，エージェントを再度登録してく
　　　ださい。

KDAS00206-E

エージェントサーバ内のエージェントスケジューラがビジー状態です。

種別：障害
イベントID：206
説明：無視して処理を続行する。
対処：・エージェントサーバの処理能力以上の要求が発生しています。
　　　　エージェント数を少なくしてください。
　　　・「9.4　保守情報の採取」を参照して保守情報を採取してください。
　　　・保守員に連絡してください。

KDAS00209-I

保留期限を経過したメッセージを削除しました。
MDLNAME=[メッセージ要求識別名称]
MSGID=[メッセージ要求元ID]

種別：情報
イベントID：209
説明：保留メッセージをすべて削除する。
対処：なし。

KDAS00210-E

ファイルI/Oエラーが発生したため，保留メッセージをすべて削除しました。
内部コード=[内部コード]
理由コード=[内部理由コード]

種別：障害
イベントID：210
説明：保留メッセージをすべて削除する。
対処：・「9.4　保守情報の採取」を参照して保守情報を採取してください。
　　　・保守員に連絡してください。

KDAS00211-E

PPサーバ情報の「ファイルマップ，登録，削除又はファイルの拡張」処理に失敗しました。
内部コード=[内部コード]

種別：障害
イベントID：211
説明：無視して処理を続行する。
対処：・「9.4　保守情報の採取」を参照して保守情報を採取してください。
　　　・保守員に連絡してください。

KDAS00250-I

エージェントサーバのサービスが起動されました。

種別：情報
イベントID：250
説明：エージェントサーバが使用可能である。
対処：なし。

KDAS00251-I

エージェントサーバのサービスが停止されました。

種別：情報
イベントID：251
説明：エージェントサーバが停止した。
対処：再度使用する場合は，エージェントサーバのサービスを起動してくだ
　　　さい。

KDAS00252-E

エージェントサーバのサービス起動に失敗しました。
Function=[内部機能コード]

種別：障害
イベントID：252
説明：エージェントサーバのサービス起動を中断する。
対処：・「9.4　保守情報の採取」を参照して保守情報を採取してください。
　　　・保守員に連絡してください。

KDAS00253-E

エージェントサーバのサービス停止に失敗しました。強制停止します。
Function=[内部機能コード]

種別：障害
イベントID：253
説明：エージェントサーバを強制的に停止する。
対処：・「9.4　保守情報の採取」を参照して保守情報を採取してください。
　　　・保守員に連絡してください。

KDAS00254-E

エージェントサーバのシステムプロセスが終了したため，エージェントサーバを停止します。
Function=[内部機能コード]

種別：障害
イベントID：254
説明：エージェントサーバを強制的に停止する。
対処：・「9.4　保守情報の採取」を参照して保守情報を採取してください。
　　　・保守員に連絡してください。

KDAS00255-E

エージェントサーバのシステムファイルが存在しません。agmgrコマンドで初期化していない可能性があります。
Path=[パス名称]

種別：障害
イベントID：255
説明：エージェントサーバを停止する。
対処：・agmgrコマンドで初期化した後，再度エージェントサーバのサービ
　　　　スを起動してください。
　　　・「9.4　保守情報の採取」を参照して保守情報を採取してください。
　　　・保守員に連絡してください。

KDAS00275-E

エージェントサーバとエージェントサーバのシステムファイルのバージョンが一致していません。agconvコマンドでエージェントサーバのシステムファイルを変換していない可能性があります。
ファイル名称=[ファイル名称]

種別：障害
イベントID：275
説明：処理を中止する。
対処：・agconvコマンドで旧バージョンのエージェントサーバのシステム
　　　　ファイルを変換していない場合は，agconvコマンドで旧バージョ
　　　　ンのエージェントサーバのシステムファイルを変換してください。
　　　・「9.4　保守情報の採取」を参照して保守情報を採取してください。
　　　・保守員に連絡してください。

KDAS00276-W

前回エージェントサーバが正常に終了していません。エージェントサーバの開始処理は続行します。

種別：警告
イベントID：276
説明：エージェントサーバの起動処理を続行する。
対処：エージェントサーバが異常終了するなど不正な動作をした場合には，
　　 リストア，又はagrecvryコマンド及びagmatchコマンドでエージェン
　　 トサーバの環境を回復してください。

KDAS00277-W

agrecvryコマンドにより，エージェントサーバのシステムファイルが回復しています。agmatchコマンドにより，PPサーバとの整合性を確保してください。

種別：警告
イベントID：277
説明：エージェントサーバ起動処理を続行する。
対処：agmatchコマンド(オプション指定なし)を使って，全PPサーバとの整
　　 合性を確保してください。

KDAS00278-W

agrecvryコマンドにより，エージェントサーバのシステムファイルが回復しています。agmatchコマンドにより，PPサーバとの整合性を確保してください。
PP種別=[PP種別]
サーバ識別情報=[サーバ識別情報]

種別：警告
イベントID：278
説明：エージェントサーバ起動処理を続行する。
対処：agmatchコマンドを使って，PPサーバとの整合性を確保してください。

KDAS00350-E

最大接続可能PPサーバ数以上のPPサーバと接続しようとしたため，接続に失敗しました。
接続識別名称=[接続識別名称]
サーバ識別情報=[サーバ識別情報]

種別：障害
イベントID：350
説明：PPサーバとの接続処理を中止する。
対処：・agmgrコマンドで最大接続可能PPサーバ数を確認してください。
　　　・エージェントサーバを停止した後で，agmgrコマンドで最大接続可
　　　　能PPサーバ数を大きくしてください。なお，最大接続可能PPサー
　　　　バ数の上限値は64です。

KDAS00351-E

ポート番号の取得に失敗しました。servicesファイルにポート番号が設定されていない可能性があります。
Service Name=[サービス名称]

種別：障害
イベントID：351
説明：エージェントサーバのサービス起動を中止する。
対処：サービスファイルにポート番号を設定した後で，再度エージェントサ
　　　ーバのサービスを起動してください。

KDAS00353-E

接続を試みたPPサーバはこれ以上のエージェントサーバと接続できないため接続が拒否されました。
接続識別名称=[接続識別名称]
サーバ識別情報=[サーバ識別情報]

種別：障害
イベントID：353
説明：PPサーバとの接続処理を中止する。
対処：・PPサーバの管理ツールで最大接続可能エージェントサーバ数を確
　　　　認してください。
　　　・PPサーバを停止した後で，PPサーバの管理ツールで最大接続可能
　　　　エージェントサーバ数を大きくしてください。

KDAS00354-E

最大接続可能PPサーバ数を超えるためPPサーバからの接続要求を拒否しました。
接続識別名称=[接続識別名称]※
サーバ識別情報=[サーバ識別情報]※
(注※ 接続要求のあったPPサーバをAgent Serverが認識できた場合に表示されます。)

種別：障害
イベントID：354
説明：PPサーバとの接続処理を中止する。
対処：・agmgrコマンドで最大接続可能PPサーバ数を確認してください。
　　　・エージェントサーバを停止した後で，agmgrコマンドで最大接続可
　　　　能PPサーバ数を大きくしてください。なお，最大接続可能PPサ
　　　　ーバ数の上限値は64です。

KDAS00401-E

メール送信処理に必要な作業領域が確保できませんでした。

種別：障害
イベントID：401
説明：メール送信は失敗する。
対処：・「9.4　保守情報の採取」を参照して保守情報を採取してください。
　　　・保守員に連絡してください。

KDAS00402-E

メール送信時サーバ間の接続又はデータの送受信に失敗しました。
ERROR CODE=[エラーコード]

種別：障害
イベントID：402
説明：メール送信は失敗する。
対処：・「9.4　保守情報の採取」を参照して保守情報を採取してください。
　　　・保守員に連絡してください。

KDAS00403-E

SMTPサーバへのメール送信が失敗しました。
ERROR CODE=[エラーコード]

種別：障害
イベントID：403
説明：メール送信は失敗する。
対処：・「9.4　保守情報の採取」を参照して保守情報を採取してください。
　　　・保守員に連絡してください。

KDAS00404-I

エージェントサーバメールオプションのサービスが起動されました。

種別：情報
イベントID：404
説明：エージェントサーバメールオプションが使用可能である。
対処：なし。

KDAS00405-I

エージェントサーバメールオプションが停止されました。

種別：情報
イベントID：405
説明：エージェントサーバメールオプションが停止した。
対処：再度使用する場合は，エージェントサーバメールオプションのサービ
　　　スを起動してください。

KDAS00406-E

エージェントサーバメールオプションのサービス起動に失敗しました。
Function=[内部機能コード]

種別：障害
イベントID：406
説明：エージェントサーバメールオプションのサービス起動を中断する。
対処：・「9.4　保守情報の採取」を参照して保守情報を採取してください。
　　　・保守員に連絡してください。

KDAS00407-E

エージェントサーバメールオプションのサービス停止に失敗しました。強制停止します。
Function=[内部機能コード]

種別：障害
イベントID：407
説明：エージェントサーバメールオプションを強制的に停止する。
対処：・「9.4　保守情報の採取」を参照して保守情報を採取してください。
　　　・保守員に連絡してください。

KDAS00408-E

エージェントサーバメールオプションのシステムプロセスが終了しました。エージェントサーバメールオプションを停止します。
Function=[内部機能コード]

種別：障害
イベントID：408
説明：エージェントサーバメールオプションを強制的に停止する。
対処：・「9.4　保守情報の採取」を参照して保守情報を採取してください。
　　　・保守員に連絡してください。

KDAS00409-E

Groupmax Mail/Address Serverの環境変数の設定に失敗しました。
code=[Set_GM_ENV関数の戻り値]

種別：障害
イベントID：409
説明：エージェントサーバ又はエージェントサーバメールオプションのサー
　 　ビス起動を中断する。
対処：保守員に連絡してください。

KDAS00518-E

整合性処理中に障害が発生しました。
内部コード=[内部コード]
PP種別=[PP種別]
サーバ識別情報=[サーバ識別情報]

種別：障害
イベントID：518
説明：PP種別とサーバ識別情報で示すサーバとの整合性処理を中断する。
　　　他のPPサーバとの整合性処理は続行する。
対処：・内部コードの値を
　　　　「付録D　活動ログ及びイベントログのエラーコード」で調べ，障
　　　　害を取り除いてください。
　　　・「9.4　保守情報の採取」を参照して保守情報を採取してください。
　　　・保守員に連絡してください。

KDAS00519-I

整合性処理を開始しました。
PP種別=[PP種別]
サーバ識別情報=[サーバ識別情報]

種別：情報
イベントID：519
説明：PP種別とサーバ識別情報で示すサーバとの整合性処理を開始した。
対処：なし

KDAS00520-I

整合性処理を完了しました。
PP種別=[PP種別]
サーバ識別情報=[サーバ識別情報]

種別：情報
イベントID：520
説明：PP種別とサーバ識別情報で示すサーバとの整合性処理を完了した。
対処：なし

KDAS00523-E

整合性処理中にPPサーバから障害発生通知を受信しました。
メッセージ="[PPサーバ通知メッセージ]"
PP種別=[PP種別]
サーバ識別情報=[サーバ識別情報]

種別：障害
イベントID：523
説明：PP種別とサーバ識別情報で示すサーバとの整合性処理を中断する。
　　　他のPPサーバとの整合性処理は継続する。
対処：[PPサーバ通知メッセージ]の内容に従い，対処してください。

KDAS00524-E

整合性処理中にエージェントサーバでタイムアウトを検出しました。
タイマ監視間隔(分)=[タイマ監視間隔]
PP種別=[PP種別]
サーバ識別情報=[サーバ識別情報]

種別：障害
イベントID：524
説明：PP種別とサーバ識別情報で示すサーバとの整合性処理を中断する。
　　　他のPPサーバとの整合性処理は継続する。
対処：整合性コマンドでタイマ監視間隔に，現状よりも大きい値を指定し，
　　　PP種別とサーバ識別子に示されているサーバと再度整合性コマンド
　　　を実行してください。

KDAS00525-E

PPサーバ未起動のため，整合性処理を開始できませんでした。
PP種別=[PP種別]
サーバ識別情報=[サーバ識別情報]

種別：障害
イベントID：525
説明：PP種別とサーバ識別情報で示すサーバとの整合性処理を中断する。
　　　他のPPサーバとの整合性処理は継続する。
対処：PP種別とサーバ識別子に示されているPPサーバのサービスを起動
　　　した後，再度整合性コマンドを実行してください。

KDAS00526-E

整合性処理の開始に失敗しました。
コード=[エラーコード]
PP種別=[PP種別]
サーバ識別情報=[サーバ識別情報]

種別：障害
イベントID：526
説明：PP種別とサーバ識別情報で示すサーバとの整合性処理を中断する。
　　　他のPPサーバとの整合性処理は継続する。
対処：[エラーコード]には，各PPの実行エンジンのエラーコードが表示さ
　　　れます。エラーコードの内容に従い，対処してください。

KDAS00527-I

PPサーバ情報の重複を検出しました。以下のPPサーバに対して一括で整合性処理を行います。
PP種別=[PP種別]
サーバ識別情報=[サーバ識別情報]
　　　　　　　　　　：
サーバ識別情報=[サーバ識別情報]

種別：情報
イベントID：527
説明：サーバ識別情報で示す複数のPPサーバが同一サーバであることを検
　　　出したため，一括して整合性処理を行う。整合性処理の開始・完了・
　　　障害イベントログには，先頭のサーバ識別情報だけが出力される。
対処：なし

KDAS00528-I

エージェントサーバを初期化しました。

種別：情報
イベントID：528
説明：エージェントサーバを初期化しました。
対処：なし

KDAS00900-E

システム関数でエラーが発生しました。
Function=[内部機能コード]
Error=[内部エラーコード]

種別：障害
イベントID：900
説明：エージェントサーバの起動時に発生した場合は，起動処理を中止する。
　　　エージェントサーバの起動完了後に発生した場合は，無視して処理を
　　　続行する。
対処：・「9.4　保守情報の採取」を参照して保守情報を採取してください。
　　　・保守員に連絡してください。

KDAS00901-E

エージェントサーバAPIでエラーが発生しました。
Function=[内部機能コード]
Error=[内部エラーコード]

種別：障害
イベントID：901
説明：エージェントサーバの起動時に発生した場合は，起動処理を中止する。
　　　エージェントサーバの起動完了後に発生した場合は，無視して処理を
　　　続行する。
対処：・本メッセージが出力される以前にエラー要因となるメッセージが出
　　　力されていないか確認してください。
　　　・「9.4　保守情報の採取」を参照して保守情報を採取してください。
　　　・保守員に連絡してください。

付録E.2　Workflow Agentのイベントログメッセージ

＜この項の構成＞

(1)　Workflow Agentのイベントログメッセージ

(2)　Workflow Agentの詳細メッセージ一覧

(1)　Workflow Agentのイベントログメッセージ

「詳細メッセージ」が表示された場合は，「 (2) Workflow Agentの詳細メッセージ一覧」を参照して対処してください。

KDWA00100-I

Groupmax Agent - Workflow Serverのサービスが起動されました。

種別：情報
イベントID：100
説明：Workflow Agentのサービスが開始した。
対処：なし。

KDWA00101-I

Groupmax Agent - Workflow Serverのサービスが停止されました。

種別：情報
イベントID：101
説明：Workflow Agentのサービスが停止した。
対処：なし。

KDWA00102-E

Groupmax Agent - Workflow Serverのサービス管理が障害を検知しました。
[詳細メッセージ]

種別：障害
イベントID：102
説明：Workflow Agentのサービスが起動中にWindows NTのサービス管理
　　　が障害を検知し，サービス起動を停止した。
詳細メッセージ：エラー原因の詳細
対処：「(2) Workflow Agentの詳細メッセージ一覧」を参照してください。

KDWA00103-E

Groupmax Agent Serverから不正な要求を受け取りました。

種別：障害
イベントID：103
説明：Agent Serverから不正な要求を受け付けた。要求は無視される。
対処：クライアントとAgent ServerとWorkflow Agent実行エンジンと
　　　Workflow Agentのバージョンを見直してください。

KDWA00104-E

イベントの監視に失敗しました。
[詳細メッセージ]

種別：障害
イベントID：104
説明：何らかの原因により，イベントの監視に失敗した。詳細な要因は
詳細メッセージに出力される。
詳細メッセージ：エラー原因の詳細
対処：「(2) Workflow Agentの詳細メッセージ一覧」を参照してください。

KDWA00105-E

イベント監視の停止が失敗しました。
[詳細メッセージ]

種別：障害
イベントID：105
説明：何らかの原因により，イベント監視の停止に失敗した。詳細な要因は
　　　詳細メッセージに出力される。
詳細メッセージ：エラー原因の詳細
対処：「(2) Workflow Agentの詳細メッセージ一覧」を参照してください。

KDWA00106-E

アクションの実行に失敗しました。
[詳細メッセージ]

種別：障害
イベントID：106
説明：何らかの原因により，アクションの実行に失敗した。詳細な要因は
　　　詳細メッセージに出力される。
詳細メッセージ：エラー原因の詳細
対処：「(2) Workflow Agentの詳細メッセージ一覧」を参照してください。

KDWA00107-E

Groupmax Agent Serverへの通知が失敗しました。
失敗した通知＝ [Agent Serverへの通知種別]

種別：障害
イベントID：107
説明：Agent Serverに対する要求が受け付けられなかった。
Agent Serverへの通知種別：イベント発生，アクション実行完了
対処：データの値を「付録D　活動ログ及びイベントログのエラーコード」
　　　で調べ，障害を取り除いてください。

KDWA00108-E

Groupmax Agent - Workflow Serverのサービスの起動に失敗しました。
[詳細メッセージ]

種別：障害
イベントID：108
説明：何らかの原因により，Workflow Agentのサービスに失敗した。失敗
　　　の原因は詳細メッセージに出力される。
詳細メッセージ：エラー原因の詳細
対処：「(2) Workflow Agentの詳細メッセージ一覧」を参照してください。

KDWA00109-E

エージェントの登録に失敗しました。
[詳細メッセージ]

種別：障害
イベントID：109
説明：何らかの原因により，エージェントの登録に失敗した。詳細な要因は
　　　詳細メッセージに出力される。
詳細メッセージ：エラー原因の詳細
対処：「(2) Workflow Agentの詳細メッセージ一覧」を参照してください。

KDWA00110-W

エージェントの監視時刻ですが，前回の監視がまだ終了していないため，この時間の監視は行いません。

種別：警告
イベントID：110
説明：前回のエージェントの監視がまだ終了していないので，今回の監視が
　　　できない。
対処：なし。

KDWA00111-E

イベントの監視を実行できません。

種別：障害
イベントID：111
説明：イベントの監視を実行しようとしたが失敗した。
対処：保守員に連絡してください。

KDWA00112-E

Groupmax Agent - Workflow Serverのシステムファイルとバージョンが一致しません。

種別：障害
イベントID：112
説明：Workflow Agentのシステムファイルとプログラムのバージョンが一
　　　致しないため，Workflow Agentの起動に失敗した。
対処：Workflow Agentをインストールし直してください。

KDWA00128-E

Groupmax Agent - Workflow Serverのシステムファイルが更新されていません。

種別：障害
イベントID：128
説明：Agent - Workflow Serverのシステムファイルのバージョンがプログ
　　　ラムのバージョンよりも古いため，Agent - Workflow Serverを起動
　　　できない。
対処：バージョン移行のコマンド(waconv.exe)を実行してシステムファイル
　　　を更新した後で再起動してください。

KDWA00129-W

以下のファイル内のあて先者に対して，メールの送信が失敗しました。
ファイル名＝ACT***.log

種別：警告
イベントID：129
説明：メールのあて先を複数指定したときに，一部のあて先に対して，メー
　　　ルの送信が失敗した。ファイル名の***には重複しない値が入る。
対処：送信に失敗したあて先を見直してください。

KDWA00130-W

以下のファイル内のあて先者が，ユーザID・E-mailアドレス対応表に登録されていません。
ファイル名＝elist****.log

種別：警告
イベントID：130
説明：E-mail送信のあて先が，ユーザID・E-mailアドレス対応表にすべて
　　　登録されていない。ファイル名の***には重複しない値が入る。
対処：あて先をユーザID・E-mailアドレス対応表に登録してください。

KDWA00131-W

以下のファイルの作成に失敗しました。
ファイル名＝****.log

種別：警告
イベントID：131
説明：ACT****.log又はelist****.logファイルの作成に失敗した。****には
　　　重複しない値が入る。
対処：保守員に連絡してください。

KDWA00132-E

システムエラーが発生しました。保守員に連絡してください。

種別：障害
イベントID：132
説明：システムエラーが発生した。
対処：保守員に連絡してください。

KDWA00133-E

以下のファイルのOpen処理に失敗しました。
ファイル名＝[ファイル名]

種別：障害
イベントID：133
説明：ファイル名で示すファイルのオープンに失敗した。
対処：保守員に連絡してください。

KDWA00134-E

以下のファイルのマッピング処理に失敗しました。
ファイル名＝[ファイル名]

種別：障害
イベントID：134
説明：ファイル名で示すファイルのマッピングに失敗した。
対処：保守員に連絡してください。

KDWA00135-E

以下のファイルの内容が不正です。
ファイル名＝[ファイル名]

種別：障害
イベントID：135
説明：ファイル名で示すファイルの内容が不正である。
対処：保守員に連絡してください。

KDWA00136-W

Groupmax Agent - Workflow Serverは前回，正常に終了していません。サービスの開始処理は続行します。

種別：警告
イベントID：136
説明：Agent - Workflowのサービス起動時に前回のサービスが適切に終了
　　　していないことを検知した。サービスの開始処理は続行する。
対処：Agent - Workflowが正常に動作しないなどの弊害がある場合は，サ
　　　ービスを停止して，バックアップファイルからのリストア，又はファ
　　　イル復旧コマンド，整合性コマンドを使って復旧作業をしてください。

KDWA00200-E

Groupmax Agent - Workflow Serverへの要求送信処理を中断しました。

種別：障害
イベントID：200
説明：障害により実行エンジンの処理を中断した。
対処：一つ前の障害イベントログの対処を行ってください。又はメモリ
　　　量を見直してください。

KDWA00210-E

エージェント定義が未サポートのバージョンによりGroupmax Agent - Workflow Serverへの要求送信処理を中断しました。
未サポートバージョン＝[*****]

種別：障害
イベントID：210
説明：エージェント定義のバージョンが実行エンジンのバージョンより新し
　　　い。
未サポートバージョン：*****には，未サポートバージョンを示す文字列が
　　　　　　　　　　　表示される。
対処：クライアントとAgent ServerとWorkflow Agent実行エンジンのバ
　　　ージョンを見直してください。

KDWA00211-E

次のエージェント定義情報の不正によりGroupmax Agent - Workflow Serverへの要求送信処理を中断しました。
[定義情報名称]

種別：障害
イベントID：211
説明：エージェント定義情報が不正だった。
定義情報名称：共通情報，トリガ情報又はアクション情報が表示される。
対処：保守員に連絡してください。

KDWA00212-E

エージェント定義情報の取得失敗によりGroupmax Agent - Workflow Serverへの要求送信処理を中断しました。

種別：障害
イベントID：212
説明：エージェント定義情報の取得に失敗した。
対処：先頭4バイトのデータの値を
　　　「付録D　活動ログ及びイベントログのエラーコード」で調べ，障害
　　　を取り除いてください。

KDWA00230-E

Groupmax Agent - Workflow Serverが未起動です。

種別：障害
イベントID：230
説明：Workflow Agentサーバが未起動である。
対処：Workflow Agentのサービスを起動してください。

KDWA00231-E

Groupmax Agent - Workflow Serverとの間で通信エラーが発生しました。

種別：障害
イベントID：231
説明：通信支援による通信でエラーが発生した。
対処：先頭4バイトのデータの値を
　　　「付録D　活動ログ及びイベントログのエラーコード」で調べ，障害
　　　を取り除いてください。

KDWA00232-E

データ送信用バッファの確保失敗によりGroupmax Agent - Workflow Serverへの要求送信処理を中断しました。

種別：障害
イベントID：232
説明：通信支援のデータ送信用バッファの確保に失敗した。
対処：保守員に連絡してください。

KDWA00250-E

不正な内容のデータの入力によりGroupmax Agent - Workflow Serverへの要求送信処理を中断しました。

種別：障害
イベントID：250
説明：Agent Serverからの入力情報が不正である。
対処：保守員に連絡してください。

KDWA00290-E

メモリの確保に失敗しました。

種別：障害
イベントID：290
説明：メモリの確保に失敗した。
対処：メモリ量を見直してください。

KDWA00291-E

次のWin32 API関数のエラーが発生しました。
[関数名称]

種別：障害
イベントID：291
説明：Win32 API関数のエラーが発生した。
関数名称：Win32 APIの関数名称が表示される。
対処：データの値を調べ，障害を取り除いてください。

KDWA00410-E

次の理由によりGroupmax Agent - Workflow Serverでデータの受信に失敗しました。
[詳細メッセージ]

種別：障害
イベントID：410
説明：何らかの原因により，データの受信に失敗した。詳細な要因は
　　　詳細メッセージに出力される。
詳細メッセージ：エラー原因の詳細
対処：「(2) Workflow Agentの詳細メッセージ一覧」を参照してください。

KDWA00500-I

次のGroupmax Agent Serverと整合性処理を開始しました。
Groupmax Agent Server ホスト名称＝********

種別：情報
イベントID：500
説明：Agent Serverからの整合性処理開始要求，又はWorkflow Agentの
　　　整合性コマンドによる整合性処理を開始した。********には，Agent
　　　Serverのホスト名が入る。
対処：なし。

KDWA00501-I

以下のGroupmax Agent Serverと整合性処理が完了しました。
Groupmax Agent Server ホスト名称＝********

種別：情報
イベントID：501
説明：Agent Serverからの整合性処理開始要求，又はWorkflow Agentの
　　　整合性コマンドによる整合性処理が完了した。********には，Agent
　　　Serverのホスト名が入る。
対処：なし。

KDWA00502-I

以下のGroupmax Agent Serverは同一であるため一括して整合性処理を行います。
Groupmax Agent Server ホスト名称＝********
　　　　　　　　　　　　　　　　　　：
Groupmax Agent Server ホスト名称＝*********

種別：情報
イベントID：502
説明：複数のIPアドレスを持つ同一のAgent Serverの整合性処理を一括し
　　 て行う。********には，Agent Serverのホスト名が入る。
対処：なし。

KDWA00510-E

次の理由により整合性処理でエラーが発生し，整合性処理を中断しました。
[詳細メッセージ]
Groupmax Agent Server ホスト名称＝********

種別：障害
イベントID：510
説明：何らかの原因により，整合性処理でエラーが発生した。詳細な要因は
　　　詳細メッセージに出力される。
詳細メッセージ：エラー原因の詳細
********には，Agent Serverのホスト名が入る。
対処：「(2) Workflow Agentの詳細メッセージ一覧」を参照してください。

KDWA00511-E

次の理由により整合性処理を開始できませんでした。
[詳細メッセージ]

種別：障害
イベントID：511
説明：何らかの原因により，整合性処理でエラーが発生した。詳細な要因は
　　　詳細メッセージに出力される。
詳細メッセージ：エラー原因の詳細
　　　　　　　　Agent Serverのホスト名が判別できる場合は，ホスト名
　　　　　　　　も出力される。
対処：「(2) Workflow Agentの詳細メッセージ一覧」を参照してください。

KDWA00512-I

Groupmax Agent - Workflow Serverを初期化しました。
[詳細メッセージ]

種別：情報
イベントID：512
説明：Groupmax Agent - Workflow Serverを初期化しました。
対処：なし。

(2)　Workflow Agentの詳細メッセージ一覧

Workflow Agentのイベントログメッセージでは，状況に応じて「詳細メッセージ」の部分に次のようなメッセージが表示されます。次に示す詳細メッセージ一覧でメッセージの内容と対処を確認して障害を回復してください。

項番
詳細メッセージ
内容
対処

1
サービス制御マネージャとの接続に失敗しました。
エージェントサービスプロセスのメインスレッドとサービス制御マネージャの接続に失敗した。
保守員に連絡してください。

2
サービス制御マネージャへの登録が失敗しました。
サービス制御ハンドラ登録に失敗した。
保守員に連絡してください。

3
サービス制御マネージャに状態を通知できませんでした。
サービス状態通知に失敗した。
保守員に連絡してください。

4
サービス停止用のイベントオブジェクトの作成に失敗しました。
停止イベント作成に失敗した。
保守員に連絡してください。

5
Groupmax Agent - Workflow Serverのメインスレッドが生成できません。
スレッド生成に失敗した。
保守員に連絡してください。

6
Groupmax Agent - Workflow Serverのサービスの停止処理が失敗しました。
停止イベント設定に失敗した。
保守員に連絡してください。

7
不正な要求を受け付けました
エージェントスケジューラが不正な要求を受け取った。
クライアントとAgent ServerとWorkflow Agent実行エンジンとWorkflow Agent本体のバージョンを見直してください。

8
オブジェクトのロックが確保できませんでした。
オブジェクトのロック確保に失敗した。
保守員に連絡してください。

9
共有メモリが確保できませんでした。
メモリマップトファイルの確保に失敗した。
ディスクの空き容量を見直してください。

10
定義情報が採取できませんでした。
定義情報の採取に失敗した。
Agent Serverが起動されているか確認してください。または，Agent ServerとWorkflow Agentでエージェントの状態を確認してください。

11
不正なエージェントを受け付けました。
イベント種別が例外である。
クライアントとAgent ServerとWorkflow Agent実行エンジンとWorkflow Agent本体のバージョンを見直してください。

12
エージェントの登録ができませでした。
ハッシュ登録に失敗した。
保守員に連絡してください。

13
エージェントの削除ができませんでした。
ハッシュ削除に失敗した。
保守員に連絡してください。

14
該当するエージェントキーは存在しません。
該当するエージェントキーが存在しない。
保守員に連絡してください。

15
受け付けられないエージェントです。
該当する監視種別のイベントが存在しない。
クライアントとAgent ServerとWorkflow Agent実行エンジンとWorkflow Agent本体のバージョンを見直してください。

16
メモリの確保失敗したか，又は領域が不足しています。
メモリ確保に失敗した。又は領域不足である。
メモリ量を見直してください。

17
Groupmax Workflow Serverに接続できません。
Workflow Serverとの接続に失敗した。
保守員に連絡してください。

18
Groupmax Workflow Serverが起動していません。
Workflow Serverが起動していない。
Workflow Serverを起動してください。

20
Groupmax Workflow Serverからエラー通知を受けました。
WF/API又はIS/APIからエラーが発生した。
保守員に連絡してください。

21
ケース情報の一覧リストの作成ができませんでした。
ケース情報の一覧リストの作成に失敗した。
保守員に連絡してください。

22
ケース情報が取得できませんでした。
ケース情報の取得に失敗した。
保守員に連絡してください。

23
Wadtrecv.dllがみつかりません。
通信管理のDLLが存在しない。
Workflow Agentをインストールし直してください。

24
Wadtrecv.dllに関数が見つかりません。
通信管理の関数が存在しない。
Workflow Agentをインストールし直してください。

25
エージェントは最大登録数まで登録されています。
エージェントを登録できない(空きなし)。
登録可能エージェント数を見直してください。最大数で設定している場合は登録済みエージェントの内容を見直してください。

26
エージェント定義の形式が不正です。
定義の形式が不正である。
保守員に連絡してください。

27
Wacom.dllが見つかりません。
共通制御のDLLが存在しない。
Workflow Agentをインストールし直してください。

28
Wacom.dllに関数が見つかりません。
共通制御の関数が存在しない。
Workflow Agentをインストールし直してください。

29
該当するエージェントが見つかりません。
Workflow Agentがエージェント機能を実行するために作成するテーブルが，イベントキューに存在しない。
保守員に連絡してください。

30
定義情報の削除が行なえませんでした。
定義情報の削除に失敗した。
保守員に連絡してください。

31
Groupmax Agent - Workflow Serverのファイルの読み出し又は書き込みに失敗しました。
Workflow Agentのファイルの読書きに失敗した。
保守員に連絡してください。

32
エージェントで指定したユーザは存在しません。
エージェントで指定したユーザは存在しない。
障害となったエージェントを見直してください。

33
アクション部の定義情報が取得できませんでした。
定義情報の取得に失敗した(提供関数の不正)。
Agent Serverが起動されているか確認してください。または，Agent ServerとWorkflow Agentでエージェントの状態を確認してください。

34
アクション部の定義情報が不正です。
定義情報が不正である。
クライアントとAgent ServerとWorkflow Agent実行エンジンとWorkflow Agent本体のバージョンを見直してください。

35
永続メモリ情報が取得できませんでした。
永続メモリの取得に失敗した(提供関数の不正)。
Agent Serverが起動されているか確認してください。または，Agent ServerとWorkflow Agentでエージェントの状態を確認してください。

36
永続メモリ情報が不正です。
永続メモリ情報が不正である。
クライアントとAgent Serverと Workflow Agent実行エンジンとWorkflow Agent本体のバージョンを見直してください。

37
結果のメール送信に失敗しました。
メール送信に失敗した（提供関数の不正）。
先頭4バイトのデータの値を「付録D　活動ログ及びイベントログのエラーコード」で調べ，障害を取り除いてください。

38
ダイアログ出力に失敗しました。
ダイアログ出力に失敗した(提供関数の不正)。
先頭4バイトのデータの値を「付録D　活動ログ及びイベントログのエラーコード」で調べ，障害を取り除いてください。

39
トレーの検索ができませんでした。
Groupmax WorkflowのAPIでエラーが発生した。
保守員に連絡してください。

40
業務プログラムの起動ができませんでした。
CreateProcess()が失敗した。
先頭4バイトのデータの値をWin32 APIのエラーコードで調べ，障害を取り除いてください。

41
メモリの確保に失敗しました。
メモリの確保に失敗した。
メモリ量を見直してください。

42
Groupmax Agent Serverのホスト名が取得できませんでした。
Waaghost.queファイルからホスト名の取得に失敗した。
保守員に連絡してください。

43
イベント監視結果の情報が取得できませんでした。
イベント監視結果情報ファイルから情報の取得に失敗した。
保守員に連絡してください。

44
トレー所有者が見つかりませんでした。
ユーザが存在しない。
エージェント定義を見直してください。

45
受信データがありません。
受信データがない。
クライアントとAgent ServerとWorkflow Agent実行エンジンとWorkflow Agent本体のバージョンを見直してください。

46
スレッドの作成に失敗しました。データはエラーコードとエージェントキーです。
スレッドの作成に失敗した。
保守員に連絡してください。

47
受信データをデータ受信キューに設定できませんでした。
データはエージェントキーです。
受信データをデータ受信キューに設定できない。
保守員に連絡してください。

48
Groupmax Agent Serverのホスト名を登録できませんでした。データはエージェントキーです。
Agent Serverのホスト名を登録できない。
保守員に連絡してください。

49
メモリの確保に失敗しました。データはエージェントキーです。
メモリの確保に失敗した。
保守員に連絡してください。

50
受信データを変換できませんでした。データはエラーコードとエージェントキーです。
受信データを変換できない。
保守員に連絡してください。

51
Groupmax Agent - Workflow Server通信管理の初期化に失敗しました。
Workflow Agent通信管理の初期化に失敗した。
保守員に連絡してください。

52
定義ファイルの初期化に失敗しました。
定義ファイルの初期化に失敗した。
保守員に連絡してください。

53
イベント監視ワークファイルの初期化に失敗ました。
イベント監視ワークファイルの初期化に失敗した。
保守員に連絡してください。

54
監視結果ファイルの初期化に失敗しました。
監視結果ファイルの初期化に失敗した。
保守員に連絡してください。

55
ソケットの開始に失敗しました。
ソケットの開始に失敗した。
保守員に連絡してください。

56
Groupmax Agent Serverの通信管理の初期化に失敗ました。
Groupmax Agent Serverの通信管理の初期化に失敗した。
保守員に連絡してください。

57
Groupmax Agent Serverの通信管理が開始できませんでした。
通信管理の開始に失敗した。
保守員に連絡してください。

58
定義登録に必要な領域が確保できませんでした。
領域の確保に失敗した。
保守員に連絡してください。

59
定義情報の削除に失敗しました。
定義情報の削除に失敗した。
保守員に連絡してください。

60
イベント監視ワーク情報の削除に失敗しました。
イベント監視ワーク情報の削除に失敗した。
保守員に連絡してください。

61
監視結果情報の削除に失敗しました。
監視結果情報の削除に失敗した。
保守員に連絡してください。

62
定義ファイルからの定義情報採取に失敗しました。
定義ファイルからの定義情報の採取に失敗した。
保守員に連絡してください。

63
イベント監視ワークファイルからの情報採取に失敗しました。
イベント監視ワークファイルからの情報の採取に失敗した。
保守員に連絡してください。

64
ユーザ情報の一覧リストが作成できませんでした。
ユーザ情報一覧リストの作成に失敗した。
保守員に連絡してください。

65
ユーザ一覧リストからのユーザ情報の採取に失敗しました。
ユーザ一覧リストからのユーザ情報の採取に失敗した。
保守員に連絡してください。

66
ケース一覧リストからの情報絞り込みに失敗しました。
ケース一覧リストからの情報の絞り込みに失敗した。
保守員に連絡してください。

67
作成した一覧リストの削除ができません。
一覧リストの削除に失敗した。
保守員に連絡してください。

68
監視結果を格納するファイルの領域が確保できませんでした。
領域の確保に失敗した。
ディスクの空き容量を見直してください。

69
イベント監視ワークファイルの領域が確保できませんでした。
領域の確保に失敗した。
ディスクの空き容量を見直してください。

70
Groupmax Agent Server を特定することができません。
Groupmax Agent Serverの特定に失敗した。
保守員に連絡してください。

71
永続メモリを確保することができませんでした。
永続メモリの確保に失敗した。
保守員に連絡してください。

72
永続メモリに値を設定することができません。
永続メモリへの値の設定に失敗した。
保守員に連絡してください。

73
Groupmax Agent Serverへのイベント通知に失敗しました。
イベントの通知に失敗した。
保守員に連絡してください。

74
ユーザ情報が採取できませんでした。
ユーザ情報の採取に失敗した。
保守員に連絡してください。

75
Groupmax Workflow Serverを特定することができません。
Workflow Serverの特定に失敗した。
保守員に連絡してください。

76
Groupmax Workflow Serverの管理サーバとの接続に失敗しました。
Workflow Serverの管理サーバとの接続に失敗した。
保守員に連絡してください。

77
ユーザ権限の取得に失敗しました。
ユーザ権限の取得に失敗した。
保守員に連絡してください。

78
Groupmax Workflow Serverとの切断に失敗しました。
Workflow Serverとの切断に失敗した。
保守員に連絡してください。

79
受信データがありません。
受信データなし。
保守員に連絡してください。

80
スレッドの作成に失敗しました。
スレッドの作成に失敗した。
保守員に連絡してください。

81
受信データをキューに設定できませんでした。
受信データをキューに設定できない。
保守員に連絡してください。

82
Groupmax Agent Serverのホスト名を登録できませんでした。
Groupmax Agent Serverのホスト名の取得に失敗した。
保守員に連絡してください。

83
メモリの確保に失敗しました。
メモリの確保に失敗した。
メモリ量を見直してください。

84
受信データを変換できませんでした。
受信データの変換に失敗した。
保守員に連絡してください。

85
イベント監視の状態を初期化できませんでした。
イベント監視結果取得関数に失敗した。
保守員に連絡してください。

86
servicesファイルにサービス名称 "gmaxwasrv" の設定がされていない可能性があります。
servicesファイルの設定に誤りがある。
servicesファイルを見直してください。

87
Groupmax Agent Serverが未起動です。
整合性確保コマンドで指定又は接続中のAgent Serverが停止している。又は， Agent Serverのホスト名が誤っている。
整合性確保対象であるAgent Serverを起動してください。又は，整合性確保対象であるAgent Serverのホスト名を見直してください。

88
Groupmax Agent Serverのホスト名称が不正です。
整合性確保コマンドで指定したAgent Serverのホスト名が誤っている。
整合性確保対象であるAgent Serverのホスト名を見直してください。

89
整合性未サポートバージョンのGroupmax Agent Serverです。
整合性処理相手のAgent Serverのバージョンが古い。
整合性確保対象であるAgent Serverのバージョンを見直してください。

90
既にGroupmax Agent Serverは整合性処理中のため，要求が受け付けられませんでした。
整合性処理相手のAgent Serverが既に別PPサーバと整合性処理を行っている。
整合性確保対象であるAgent Serverでの整合性確保処理完了後に，再度実行してください。

91
Groupmax Agent Serverへの整合性処理開始要求が失敗しました。
整合性処理開始要求が異常終了した。
保守員に連絡してください。

92
Groupmax Agent Serverへの整合性処理完了通知が失敗しました。
整合性処理完了通知が異常終了した。
保守員に連絡してください。

93
Groupmax Agent Serverとの整合性確保処理中に通信タイムアウトが発生しました。
通信タイムアウトが発生した。
Agent Serverが起動しているかどうか確認してください。又は，Agent Server及びWorkflow Agentが高負荷状態でないか確認してください。

94
送信メールの本文の作成に失敗しました。
送信メールの本文の作成に失敗した。
ディスクの空き容量を見直してください。

95
メールの送信先がありません。
業務ロールにユーザが登録されていない。
監視対象の業務ロールを見直してください。

96
起点時間が時間値として正しくない値です。
起点時間が不正。
保守員に連絡してください。

97
監視間隔が許されている範囲を超えています。
監視間隔が不正。
保守員に連絡してください。

98
次の監視時間を求めることができません。
次の監視時間取得に失敗した。
保守員に連絡してください。

99
ロール一覧リストからの情報絞り込みに失敗しました。
ロール一覧リストからの情報の絞り込みに失敗した。
保守員に連絡してください。

100
ロール情報が取得できませんでした。
ロール情報の取得に失敗した。
保守員に連絡してください。

101
ビジネスプロセス一覧リストからの情報絞り込みに失敗しました。
ビジネスプロセス一覧リストからの情報の絞り込みに失敗した。
保守員に連絡してください。

102
ケース情報が取得できませんでした。
ケース情報の取得に失敗した。
保守員に連絡してください。

103
ロール登録サーバ情報の採取に失敗しました。
ロール登録サーバ情報の採取に失敗した。
保守員に連絡してください。

104
ロール登録サーバとの接続に失敗しました。
ロール登録サーバとの接続に失敗した。
保守員に連絡してください。

105
ロール登録サーバとの切断に失敗しました。
ロール登録サーバとの切断に失敗した。
保守員に連絡してください。

106
リストからの情報取得に失敗しました。
リストからの情報取得に失敗した。
保守員に連絡してください。

107
ロール内ユーザの一覧取得に失敗しました。
ロール内ユーザの一覧取得に失敗した。
保守員に連絡してください。

108
ユーザID一覧情報の取得に失敗しました。
ユーザID一覧情報の取得に失敗した。
保守員に連絡してください。

109
エラー情報出力ファイルの作成に失敗しました。
エラー情報出力ファイルの作成に失敗した。
保守員に連絡してください。

110
エラー情報出力ファイルの書き込みに失敗しました。
エラー情報出力ファイルの書き込みに失敗した。
保守員に連絡してください。

111
Groupmax Agent Serverへのサーバ識別情報取得通知が失敗しました。
整合性処理のサーバ識別情報取得通知が異常終了した。
保守員に連絡してください。

112
Groupmax Agent Serverへの整合性処理準備完了通知が失敗しました。
整合性処理準備完了通知が異常終了した。
保守員に連絡してください。

113
Groupmax Agent Serverへの整合性処理途中経過通知が失敗しました。
整合性処理途中経過通知が異常終了した。
保守員に連絡してください。

114
要求の取り出しに失敗しました。
整合性要求受信キューからの取り出しに失敗した。
保守員に連絡してください。

115
同一Groupmax Agent Serverから整合性処理開始要求を受け付けました。
整合性処理開始要求を連続して受け付けた。
整合性対象のGroupmax Agentで，整合性処理中に障害が発生していないかを見直してください。

116
整合性処理開始要求の設定に失敗しました。
整合性要求受信キューへの設定に失敗した。
保守員に連絡してください。

117
既に整合性処理実行中です。
整合性中に整合性要求を受け付けた。
整合性対象のGroupmax Agentで，整合性処理中に障害が発生していないかを見直してください。

118
シーケンス番号が不正です。
受信した要求のシーケンス番号が不正。
整合性対象のGroupmax Agentで，整合性処理中に障害が発生していないかを見直してください。

119
コマンドへのメッセージ出力に失敗しました。
整合性コマンドへのパイプでの書き込みに失敗した。
保守員に連絡してください。

120
イベントの作成に失敗しました。
整合性のイベント作成に失敗した。
保守員に連絡してください。

121
イベントの設定に失敗しました。
整合性のイベント設定に失敗した。
保守員に連絡してください。

122
整合性処理中断要求を受け付けました。
整合性処理中断要求を受け付けた。
整合性対象のGroupmax Agentで，整合性処理中に障害が発生していないかを見直してください。

付録E.3　Mail Agentのイベントログメッセージ

KDAA01001-E

内部矛盾を検出しました。

種別：障害
イベントID：1001
説明：処理を中断する。
　　　ただし，Groupmax Agent Server 03-10以降から，03-00のPPサー
　　　バに対して整合性を行ったときは，03-00のPPサーバ側で受信した
　　　サーバ識別情報取得要求に対して，本メッセージが出力されることが
　　　ある。
　　　この場合，処理は継続して実行し，動作に問題はない。
対処：資料を採取して，保守員に連絡してください。

KDAA01002-E

システムプロセスが終了しました。サービスを停止します。

種別：障害
イベントID：1002
説明：エージェントシステム内で障害が発生しているため，サービスを停止
　　　する。
対処：資料を採取して，保守員に連絡してください。

KDAA01003-E

メモリ不足が発生しました。

種別：障害
イベントID：1003
説明：処理を中断する。
対処：メモリ所要量を見直してください。

KDAA01004-E

ディスクがいっぱいです。

種別：障害
イベントID：1004
説明：処理を中断する。
対処：ディスク所要量を見直してください。

KDAA01005-E

レジストリの情報が不正です。

種別：障害
イベントID：1005
説明：インストールに失敗している，又はレジストリが壊れているため，
　　　処理を中断する。
対処：該当するシステムを再インストールしてください。

KDAA01006-E

Win32APIでエラーが発生しました。
関数名称=[エラーの発生したWin32APIの関数名称]

種別：障害
イベントID：1006
説明：処理を中断する。
対処：Win32API仕様書を参照し，障害の要因を取り除いてください。

KDAA01007-E

Groupmax Agent Serverでエラーが発生しました。
関数名称：[エラーの発生したGroupmax Agent Serverの関数名称]
詳細：[エラー発生原因の詳細内容]

種別：障害
イベントID：1007
説明：処理を中断する。
対処：資料を採取して，保守員に連絡してください。

KDAA01008-E

Groupmax Agent Serverから不正な要求を受け取りました。

種別：障害
イベントID：1008
説明：処理を中断する。
対処：クライアント，Groupmax Agent，Mail Agent及びDocument
　　　Manager Agentのバージョンを見直してください。

KDAA01009-E

エージェントの登録に失敗しました。
詳細メッセージ：[エラー原因の詳細]

種別：障害
イベントID：1009
説明：エージェントの登録処理を中断する。
対処：保守員に連絡し，エラーの要因を取り除いてください。

KDAA01010-E

エージェント定義が未サポートのバージョンのため，処理を中断しました。
未サポートバージョン：[エージェント定義データのバージョン値]

種別：障害
イベントID：1010
説明：エージェントサーバで対応していないエージェント定義データが指定
　　　されため，処理を中断する。
対処：サーバ，クライアントのバージョンが一致しているかを確認してくだ
　　　さい。

KDAA01011-E

次のエージェント定義情報が不正なため処理を中断しました。
定義情報名・[不正な値が指定された名称]

種別：障害
イベントID：1011
説明：エージェント定義情報の値に不正な内容が指定されため，処理を中断
　　　する。
対処：エージェント定義内容を見直し，エラーの要因を取り除いてください。

KDAA01012-E

Groupmax Agent Serverへの通知が失敗しました。
失敗した通知：通知種別

種別：障害
イベントID：1012
説明：Groupmax Agentに対する要求が受け付けられなかった。再度通知を
　　　行う。
対処：データの値をGroupmax Agent提供ヘッダのAGmgrapi.hで調べ，
　　　障害の要因を取り除いてください。

KDAA01013-E

活動ログの出力に失敗しました。
エージェントキー：[エラーが発生したエージェントキー。エージェントキーが不明なときは0。]

種別：障害
イベントID：1013
説明：エージェントキーに対するエージェントの活動ログの出力に失敗した。
　　　出力処理を中断する。
対処：直前に出力されたメッセージの要因を取り除いてください。

KDAA01014-I

Groupmax Agent Serverへの通知のリトライ処理が成功しました。

種別：情報
イベントID：1014
説明：なし。
対処：なし。

KDAA01015-E

Groupmax Agent Serverへの通知のリトライ処理を中断しました。

種別：障害
イベントID：1015
説明：Groupmax Agent Serverへの通知のリトライ処理中にエラーを検出
　　　したため，リトライ処理を中断する。
対処：直前に出力されたメッセージの要因を取り除いてください。

KDAA01016-E

通信環境の設定が不正です。

種別：障害
イベントID：1016
説明：通信環境（サービス名・ポート番号・IPアドレス）が未設定，又は
　　　通信環境の設定に誤りがある。処理を中断する。
　　　対処：サービス名・ポート番号・IPアドレスの設定を見直してくだ
　　　さい。

KDAA01017-E

通信中にタイムアウトが発生しました。

種別：障害
イベントID：1017
説明：通信中に接続タイムアウトが発生しため，処理を中断する。
　　　ネットワークに負荷がかかっている，又は，サーバに負荷がかかって
　　　いると考えられる。
対処：通信環境を見直し，エラー要因を取り除いてください。又は，保守員
　　　に連絡してください。

KDAA01018-E

Groupmax Agent Serverが起動されていません。

種別：障害
イベントID：1018
説明：処理を中断する。
対処：Groupmax Agent Serverを起動してください。

KDAA01019-W

サービスは前回，正常に終了していません。サービスの開始処理は続行します。
サービス名：[サービス名称]

種別：警告
イベントID：1019
説明：サービスの起動時に前回のサービスが適切に終了していないことを検
　　　知した。サービスの開始処理は続行する。
対処：サービスが正常に動作しないなどの弊害がある場合は，サービスを停
　　　止して，バックアップファイルからのリストア，又は整合性確保コマ
　　　ンドを使って復旧作業をしてください。

KDAA01101-I

次のGroupmax Agent Serverと整合性処理を開始しました。
Groupmax Agent Serverホスト名称=********
サービス名：[サービス名称]

種別：情報
イベントID：1101
説明：Groupmax Agent Serverからの整合性処理開始要求，又はPPサー
　　　バの整合性確保コマンドによる整合性処理を開始した。
　　　********には，Groupmax Agent Serverのホスト名が入る。
対処：なし。

KDAA01102-I

以下のGroupmax Agent Serverと整合性処理が完了しました。
Groupmax Agent Server ホスト名称=********
サービス名：[サービス名称]

種別：情報
イベントID：1102
説明：Groupmax Agent Serverからの整合性処理開始要求，又はPPサー
　　　バの整合性確保コマンドによる整合性処理を完了した。
　　　********には，Groupmax Agent Serverのホスト名が入る。
対処：なし。

KDAA01103-E

Groupmax Agent Server(ホスト名：[Groupmax Agent Serverホスト名称])が停止しているため，整合性処理を中断します。
サービス名：[サービス名称]

イベントID：1103
説明：処理を中断する。
対処：Groupmax Agent Serverを起動してください。

KDAA01104-E

Groupmax Agent Server(ホスト名：[Groupmax Agent Serverホスト名称])が他PPとの整合性中であるため，整合性処理を中断します。
サービス名：[サービス名称]

種別：障害
イベントID：1104
説明：処理を中断する。
対処：Groupmax Agent Serverが他PPとの整合性確保を完了した後に，
　　　整合性確保を行ってください。

KDAA01105-E

Groupmax Agent Server(ホスト名：[Groupmax Agent Serverホスト名称])がタイムアウトなどの要因により整合性処理を中断したため，整合性確保処理を継続できません。整合性処理を中断します。
サービス名：[サービス名称]

種別：障害
イベントID：1105
説明：処理を中断する。
対処：タイムアウト値を設定，又は見直してください。

KDAA01106-E

Groupmax Agent Server(ホスト名：[Groupmax Agent Serverホスト名称])がＰＰからの整合性確保機能をサポートしていません。整合性処理を中断します。
サービス名：[サービス名称]

種別：障害
イベントID：1106
説明：処理を中断する。
対処：Groupmax Agent Serverからの整合性確保を行うか，又はGroupmax
　　　Agent Serverのバージョンをあげてください。

KDAA01107-E

Groupmax Agent Server(ホスト名：[Groupmax Agent Serverホスト名称])のホスト名が見つかりません。整合性処理を中断します。
サービス名：[サービス名称]

種別：障害
イベントID：1107
説明：処理を中断する。
対処：ホスト名を見直してください。

KDAA01108-E

Groupmax Agent Server(ホスト名：[Groupmax Agent Serverホスト名称])がインストールされていません。整合性処理を中断します。
サービス名：[サービス名称]

種別：障害
イベントID：1108
説明：処理を中断する。
対処：なし。

KDAA01109-E

Groupmax Agent Server(ホスト名：[Groupmax Agent Serverホスト名称])との整合性確保処理中にタイムアウトが発生しました。整合性処理を中断します。
サービス名：[サービス名称]

種別：障害
イベントID：1109
説明：処理を中断する。
対処：Groupmax Agent Serverを起動してください。

KDAA01110-E

整合性処理中断要求をGroupmax Agent Server(ホスト名：[Groupmax Agent Serverホスト名称])より受けたため，整合性処理を中断します。
サービス名：[サービス名称]

種別：障害
イベントID：1110
説明：処理を中断する。
対処：Groupmax Agent Serverを起動してください。

KDAA01111-E

Groupmax Agent Server(ホスト名：[Groupmax Agent Serverホスト名称])との整合性処理中にシステムで障害が発生しました。整合性処理を中断します。
サービス名：[サービス名称]

種別：障害
イベントID：1111
説明：処理を中断する。
対処：資料を採取して，保守員に連絡してください。

KDAA01112-I

以下のGroupmax Agent Serverは同一であるため一括して整合性処理を行います。
Groupmax Agent Server ホスト名称＝********
　　　　　　　　　　　　　　　　　　：
Groupmax Agent Server ホスト名称＝*********

種別：情報
イベントID：1112
説明：複数のIPアドレスを持つ同一のAgent Serverの整合性処理を一括し
　　 て行う。********には，Agent Serverのホスト名が入る。
対処：なし。

KDMA02001-I

Groupmax Mail Agentが起動されました。

種別：情報
イベントID：2001
説明：なし。
対処：なし。

KDMA02002-I

Groupmax Mail Agentが停止されました。

種別：情報
イベントID：2002
説明：なし。
対処：なし。

KDMA02003-E

Groupmax Mail Agentの起動に失敗しました。

種別：障害
イベントID：2003
説明：Groupmax Mail Agentの起動中にエラーが発生しました。サービス
　　　の起動を中断する。
対処：資料を採取して，保守員に連絡してください。

KDMA02004-E

Groupmax MailAgentの停止に失敗しました。強制停止します。

種別：障害
イベントID：2004
説明：Groupmax MailAgentの停止中にエラーが発生したため，強制停止
　　　する。
　　　サーバに負荷がかかっているなどで，接続タイムアウトが発生してい
　　　ると考えられる。
対処：Groupmax MailAgentの起動時に問題が発生する場合，保守員に連
　　　絡してください。

KDMA02005-E

Groupmax Mail/Address Serverでエラーが発生しました。
関数名称：[エラーの発生したGroupmax Mail/Address Serverの関数名称]
詳細：[エラー発生原因の詳細内容]

種別：障害
イベントID：2005
説明：Groupmax Mail/Address Serverでエラーが発生したため，処理を中
　　　断する。
対処：資料を採取して，保守員に連絡してください。

KDMA02006-E

Groupmax MailAgentが起動されていません。

種別：障害
イベントID：2006
説明：なし。
対処：Groupmax MailAgentを起動してください。

KDMA02007-E

Groupmax MailAgentのためのMail Serverの環境設定が不正です。

種別：障害
イベントID：2007
説明：Mail Serverの環境設定（環境変数等）が不正なため，サービスが起
　　　動できない。
対処：「3.4.2　Mail Agentの環境設定」を参照し，障害の要因を取り除い
　　　てください。

KDMA02008-E

トリガ発生の通知中に通信で障害が発生しました。（アドレス：[通信障害が発生したエージェントサーバのアドレス]）１時間後にリトライを行います。

種別：障害
イベントID：2008
説明：Groupmax MailAgent Functionとの通信でエラーが発生した。一時
　　　間後にリトライする。
対処：直前に出力されたメッセージの要因を取り除いてください。

KDMA02012-I

Groupmax MailAgentを初期化しました。

種別：情報
イベントID：2012
説明：Groupmax MailAgentを初期化しました。
対処：なし。

KDMA03001-I

Groupmax MailAgent Functionが起動されました。

種別：情報
イベントID：3001
説明：なし。
対処：なし。

KDMA03002-I

Groupmax MailAgent Functionが停止されました。

種別：情報
イベントID：3002
説明：なし。
対処：なし。

KDMA03003-E

Groupmax MailAgentFunctionの起動に失敗しました。

種別：障害
イベントID：3003
説明：Groupmax MailAgentFunctionの起動中にエラーが発生した。サー
　　　ビスの起動を中断する。
対処：資料を採取して，保守員に連絡してください。

KDMA03004-E

Groupmax Mail Agent Functionの停止に失敗しました。強制停止します。

種別：障害
イベントID：3004
説明：Groupmax Mail Agent Functionの停止中にエラーが発生した。サー
　　　ビスを強制停止する。
　　　サーバに負荷がかかっているなどで，接続タイムアウトが発生してい
　　　ると考えられる。
対処：Groupmax Mail Agent Functionの起動時に問題が発生する場合，保
　　　守員に連絡してください。

KDMA03005-E

Groupmax MailAgentFunctionが起動されていません。

種別：障害
イベントID：3005
説明：なし。
対処：Groupmax MailAgent Functionを起動してください。

KDMA03006-W

サイトが起動されていない可能性があります。

種別：警告
イベントID：3006
説明：サイトが起動されていないため，メールの新着監視ができない。
対処：サイトを起動してください。

KDAA03007-I

Groupmax Mail Agentへの通知のリトライ処理が成功しました。

種別：情報
イベントID：3007
説明：なし。
対処：なし。

KDAA03008-E

Groupmax Mail Agentへの通知のリトライ処理を中断しました。

種別：障害
イベントID：3008
説明：Groupmax Mail Agentへの通知のリトライ処理中にエラーを検出し
　　　たため，リトライ処理を中断する。
対処：直前に出力されたメッセージの要因を取り除いてください。

KDMA03010-W

送信者名設定ファイル(sender.txt)には設定できる最大数を超える送信者名が指定されています。
最大数を超えた送信者名は無視します。

種別：警告
イベントID：3010

説明：送信者名設定ファイルで指定された送信者名が上限を超えました。

上限を超えた送信者名は，アクション実行抑止の対象にはなりません。上限を超えた場合，無視する内容であっても本メッセージを出力し，ファイルの読み込みを中断します。

対処：送信者名設定ファイルで指定する送信者名を上限以内にしてください。

KDMA03011-W

主題名設定ファイル(title.txt)には設定できる最大数を超える主題名が指定されています。最大数を超えた主題名は無視します。

種別：警告
イベントID：3011

説明：主題名設定ファイルで指定された主題名が上限を超えました。

上限を超えた主題名はアクション実行抑止の対象にはなりません。

対処：主題名設定ファイルで指定する主題名を上限以内にしてください。

KDMA03012-I

Groupmax MailAgentFunctionを初期化しました。

種別：情報
イベントID：3012
説明：Groupmax MailAgentFunctionを初期化しました。
対処：なし。

付録E.4　Document Manager Agentのイベントログメッセージ

エラーコード「KDAAXXXX(XXXXはコード番号)」の内容については，「付録E.3　Mail Agentのイベントログメッセージ」を参照してください。

KDDA04001-I

Groupmax DocumentManagerAgentが起動されました。

種別：情報
イベントID：4001
説明：なし。
対処：なし。

KDDA04002-I

Groupmax DocumentManagerAgentが停止されました。

種別：情報
イベントID：4002
説明：なし。
対処：なし。

KDDA04003-E

Groupmax Document Manager Agentの起動に失敗しました。

種別：障害
イベントID：4003
説明：Groupmax Document Manager Agentの起動中にエラーが発生した。
　　　サービスの起動を中断する。
対処：資料を採取して，保守員に連絡してください。

KDDA04004-E

Groupmax Document Manager Agentの停止に失敗しました。強制停止します。

種別：障害
イベントID：4004
説明：Groupmax Document Manager Agentの停止中にエラーが発生した
　　　ため，サービスを強制終了する。
　　　サーバに負荷がかかっているなどで，接続タイムアウトが発生してい
　　　ると考えられる。
対処：Groupmax Document Manager Agentの起動時に問題が発生する場
　　　合，保守員に連絡してください。

KDDA04005-E

Groupmax Document Managerでエラーが発生しました。
関数名称：[エラーの発生したGroupmax Document Managerの関数名称]
詳細：[エラー発生原因の詳細内容]

種別：障害
イベントID：4005
説明：Groupmax Document Managerでエラーが発生した。処理を中断す
　　　る。
対処：資料を採取して，保守員に連絡してください。

KDDA04006-E

Groupmax DocumentManagerAgentのためのDocument Managerの環境設定が不正です。

種別：障害
イベントID：4006
説明：Document Manager Agentの環境設定が不正。処理を中断する。
対処：資料を採取して，保守員に連絡してください。

KDDA04007-E

Groupmax Document Managerが起動されていません。

種別：障害
イベントID：4007
説明：なし。
対処：Groupmax Document Managerを起動してください。

KDDA04008-W

文書の登録監視エージェントの最大登録数を超えました。

イベントID：4008
説明：文書の登録監視エージェントの最大登録数を超えたので，フォルダ
　　　を監視できない。
対処：不要なエージェントを削除してください。又は，運用コマンドに
　　　よって，登録監視エージェントの最大登録数を変更してください。

KDDA04009-W

文書の登録監視エージェントにおいて，通知可能な文書数の上限を超えました。
エージェントキー：［エラーが発生したエージェントキー］

イベントID：4009
説明：文書の登録監視エージェントで，通知可能な文書数の上限を超えた
　　　ので，文書の登録を通知できない。
対処：不要なエージェントを削除してください。又は，運用コマンドに
　　　よって，通知可能な文書数の上限を変更してください。

KDDA04012-I

Groupmax DocumentManagerAgentを初期化しました。

種別：情報
イベントID：4012
説明：Groupmax DocumentManagerAgentを初期化しました。
対処：なし。

付録F　フォルダ（ディレクトリ）構成

＜この節の構成＞

付録F.1　Agent Server

付録F.2　Workflow Agent

付録F.3　Mail Agent

付録F.4　Document Manager Agent

付録F.1　Agent Server

＜この項の構成＞

(1)　Agent Server

(2)　Agentメール送信ライブラリ（Agent Server Mail Option）

(1)　Agent Server

Agent Serverのフォルダ（ディレクトリ）構成を示します。

図F-1　Agent Serverのフォルダ（ディレクトリ）構成

(2)　Agentメール送信ライブラリ（Agent Server Mail Option）

Agentメール送信ライブラリインストール後のフォルダ（ディレクトリ）構成を示します。

図F-2　Agentメール送信ライブラリのフォルダ（ディレクトリ）構成

付録F.2　Workflow Agent

＜この項の構成＞

(1)　Workflow Agent本体（Agent - Workflow Server）

(2)　Workflow Agent実行エンジン（Agent - Workflow Function）

(1)　Workflow Agent本体（Agent - Workflow Server）

Workflow Agentのフォルダ（ディレクトリ）構成を示します。

図F-3　Workflow Agent本体のフォルダ（ディレクトリ）構成

(2)　Workflow Agent実行エンジン（Agent - Workflow Function）

Workflow Agent実行エンジンのフォルダ（ディレクトリ）構成を示します。

図F-4　Workflow Agent実行エンジンのフォルダ（ディレクトリ）構成

付録F.3　Mail Agent

＜この項の構成＞

(1)　Mail Agent本体（Agent - Mail Server）

(2)　Mail Agent実行エンジン（Agent - Mail Function）

(1)　Mail Agent本体（Agent - Mail Server）

Mail Agent本体のフォルダ（ディレクトリ）構成を示します。

図F-5　Mail Agent本体のフォルダ（ディレクトリ）構成

(2)　Mail Agent実行エンジン（Agent - Mail Function）

Mail Agent実行エンジンのフォルダ（ディレクトリ）構成を示します。

図F-6　Mail Agent実行エンジンのフォルダ（ディレクトリ）構成

付録F.4　Document Manager Agent

＜この項の構成＞

(1)　Document Manager Agent本体（Agent - Document Manager Server）

(2)　Document Manager Agent実行エンジン（Agent - Document Manager Function）

(1)　Document Manager Agent本体（Agent - Document Manager Server）

Document Manager Agent本体のフォルダ（ディレクトリ）構成を示します。

図F-7　Document Manager Agent本体のフォルダ（ディレクトリ）構成

(2)　Document Manager Agent実行エンジン（Agent - Document Manager Function）

Document Manager Agent実行エンジンのフォルダ（ディレクトリ）構成を示します。

図F-8　Document Manager Agent実行エンジンのフォルダ（ディレクトリ）構成

付録G　Windows Server 2008使用時の注意事項

Windows Server 2008で使用する場合の注意事項について説明します。

＜この節の構成＞

付録G.1　ファイアウォール

付録G.2　ユーザアカウント制御

付録G.3　非サポート製品

付録G.1　ファイアウォール

Windows 2008ではOS標準のファイアウォール機能がデフォルトで有効になります。OS標準のファイアウォールを使用する場合は，ファイアウォールにポート番号を設定する必要があります。ファイアウォールの設定については「4.5.1 (2)　ファイアウォールの設定についての制限事項」を参照してください。

付録G.2　ユーザアカウント制御

Windows 2008ではユーザアカウント制御が有効になっていると，コマンド実行時にユーザアカウント制御ダイアログが出力されることがあります。コマンドは管理者権限で実行する必要があるため，ユーザアカウント制御ダイアログの[続行]ボタンを押してコマンドを実行します。なお，コマンドの処理状況やコマンド実行結果がコマンドプロンプトに表示される場合，コマンドの実行終了と共にコマンドプロンプトが終了しメッセージが確認できない場合があります。このため，コマンド実行時にはコマンドプロンプトを管理者として起動してから実行してください。

付録G.3　非サポート製品

Windows 2008では以下の製品を使用できません。

Agent - Development Kit

Agent - Document Manager Server

Agent - Mail Web Option

付録H　Windows Server 2012使用時の注意事項

Windows Server 2012で使用する場合の注意事項について説明します。

＜この節の構成＞

付録H.1　ファイアウォール

付録H.2　ユーザアカウント制御

付録H.3　非サポート製品

付録H.1　ファイアウォール

Windows 2012ではOS標準のファイアウォール機能がデフォルトで有効になります。OS標準のファイアウォールを使用する場合は，ファイアウォールにポート番号を設定する必要があります。ファイアウォールの設定については「4.5.1 (2)　ファイアウォールの設定についての制限事項」を参照してください。

付録H.2　ユーザアカウント制御

Windows 2012ではユーザアカウント制御が有効になっていると，コマンド実行時にユーザアカウント制御ダイアログが出力されることがあります。コマンドは管理者権限で実行する必要があるため，ユーザアカウント制御ダイアログの[続行]ボタンを押してコマンドを実行します。なお，コマンドの処理状況やコマンド実行結果がコマンドプロンプトに表示される場合，コマンドの実行終了と共にコマンドプロンプトが終了しメッセージが確認できない場合があります。このため，コマンド実行時にはコマンドプロンプトを管理者として起動してから実行してください。

付録H.3　非サポート製品

Windows 2012では以下の製品を使用できません。

Agent - Development Kit

Agent - Document Manager Function

Agent - Document Manager Server

Agent - Mail Web Option

索引

[Ａ][Ｄ][Ｇ][Ｉ][Ｍ][Ｏ][Ｐ][Ｓ][Ｖ][Ｗ]
[ア行][カ行][サ行][タ行][ハ行][マ行][ヤ行][ラ行]

(英字)

(Ａ)

Agent - Mail Server異常終了発生時の本機能実行準備

Agent - Application

Agent - Application

Agent Client

Agent Server

Agent Server

Agent Server

Agent Server

Agent Server Mail Option

Agent Server Mail Optionで障害が発生した場合

Agent Server Mail Optionの起動

Agent Server Mail Optionの終了

Agent Server及びWorkflow Agentの両方にある情報が一致していない

Agent Server管理ツールに関する基礎知識

Agent Server管理ツールの起動（agmgr）

Agent Serverで確認する項目

Agent Serverで障害が発生した場合

Agent Serverとの整合性の確保

Agent Serverとの整合性の確保

Agent Serverに登録されていないがWorkflow Agentに情報がある

Agent Serverに登録されているがWorkflow Agentに情報がない

Agent ServerのIPアドレスを変更する場合

Agent Serverのインストール

Agent Serverのインストールと環境設定

Agent Serverの運用コマンド

Agent Serverのエージェントのログの参照（aglog）

Agent Serverの環境設定

Agent Serverの起動

Agent Serverの起動

Agent Serverの起動と終了

Agent Serverのシステム環境の確認

Agent Serverのシステムファイルの回復（agrecvry）

Agent Serverのシステムファイルの変換

Agent Serverの終了

Agent Serverの終了

Agent Serverの定義情報と一致しているかどうかの確認

Agent Serverの定義情報と一致しているかどうかの確認

Agent Serverの定義情報と一致しているかどうかの確認

Agent Serverのトレースの拡張（agtrcex）

Agent Serverのトレースの参照（agtrace）

Agent Serverのバージョン移行

Agent Serverのバージョンの移行（agconv）

Agent Serverのバージョンの表示（agver）

Agent Serverのホスト名一覧表示・Agent Serverとの整合性の確保(damatch)

Agent Serverのホスト名一覧表示・Agent Serverとの整合性の確保(mamatch)

Agent Serverのホスト名一覧表示・Agent Serverとの整合性の確保(wamatch)

Agent Serverを削除する

Agentメール送信ライブラリ

Agentメール送信ライブラリ（Agent Server Mail Option）

(Ｄ)

Document Manager Agent

Document Manager Agent

Document Manager Agent

Document Manager Agent管理ツールに関する基礎知識

Document Manager Agent管理ツールの起動（damgr）

Document Manager Agent実行エンジン（Agent - Document Manager Function）からAgent Serverへのファイルの登録

Document Manager Agent実行エンジン（Agent - Document Manager Function）をインストールする

Document Manager Agentで確認する項目

Document Manager Agentで障害が発生した場合

Document Manager Agentのイベントログメッセージ

Document Manager Agentのインストール

Document Manager Agentのインストールと環境設定

Document Manager Agentの運用コマンド

Document Manager Agentの環境設定

Document Manager Agentの起動

Document Manager Agentの起動と終了

Document Manager Agentのシステム環境に関する操作

Document Manager Agentのシステム環境の確認

Document Manager Agentの終了

Document Manager Agentのトレースの参照（datrc）

Document Manager Agent本体（Agent - Document Manager Server）をインストールする

Document Manager Agent本体のIPアドレスを変更する場合

Document Manager Agentを削除する

(Ｇ)

Groupmax Address

Groupmax Agentの概要

Groupmax Agentの機能

Groupmax Agentのプログラム構成

Groupmax Agentのプログラムの連携

Groupmax Document Manager

Groupmax Document Managerと連携したエージェント

Groupmax Document Managerの稼働状況の確認

Groupmax Mail

Groupmax Mail Serverの稼働状況の確認

Groupmax Mailと連携したエージェント

Groupmax Workflow

Groupmax Workflow Serverについての確認

Groupmax Workflow Serverの稼働状況の確認

Groupmax Workflow Serverのバージョンの確認

Groupmax Workflowと連携したエージェント

(Ｉ)

IPアドレス及びホスト名の変更

IPアドレスの扱いについて

(Ｍ)

Mail Agent

Mail Agent

Mail Agent

Mail Agent管理ツールに関する基礎知識

Mail Agent実行エンジン（Agent - Mail Function）からAgent Serverへのファイルの登録

Mail Agent実行エンジン（Agent - Mail Function）をインストールする

Mail Agent実行エンジン管理ツールの起動（mafmgr）

Mail Agent実行エンジンのシステム環境に関する操作

Mail Agent実行エンジンのシステム情報を参照・更新する

Mail Agent実行エンジンのトレースの参照（maftrc）

Mail Agent実行エンジンを起動する

Mail Agent実行エンジンを終了する

Mail Agent実行エンジンを初期化する場合

Mail Agentで確認する項目

Mail Agentで障害が発生した場合

Mail Agentのアクション抑止機能

Mail Agentのイベントログメッセージ

Mail Agentのインストール

Mail Agentのインストールと環境設定

Mail Agentの運用コマンド

Mail Agentの環境設定

Mail Agentの起動

Mail Agentの起動と終了

Mail Agentのシステム環境の確認

Mail Agentの終了

Mail Agent本体（Agent - Mail Server）をインストールする

Mail Agent本体管理ツールの起動（mamgr）

Mail Agent本体のIPアドレスを変更する場合

Mail Agent本体のシステム環境に関する操作

Mail Agent本体のシステム情報を参照・更新する

Mail Agent本体のトレースの参照（matrc）

Mail Agent本体を起動する

Mail Agent本体を終了する

Mail Agent本体を初期化する場合

Mail Agentを削除する

(Ｏ)

Object Serverの環境設定

Object Serverの環境設定

(Ｐ)

PPサーバ

PPサーバ

PPサーバ情報の一覧表示

PPサーバ情報の一覧表示・PPサーバとの整合性の確保（agmatch）

PPサーバとの整合性の確保

PPサーバの設定の確認

(Ｓ)

servicesファイルの設定

servicesファイルの設定

servicesファイルの設定

servicesファイルの設定

(Ｖ)

V2クライアントを使用する場合

V3クライアント以降を使用する場合

(Ｗ)

Windows NTのバックアップ機能を使用する場合

Windows NTのリストア機能を使用する場合

Windows Server 2008使用時の注意事項

Windows Server 2012使用時の注意事項

Workflow Agent

Workflow Agent

Workflow Agent

Workflow Agent管理ツールに関する基礎知識

Workflow Agent管理ツールの起動（wamgr）

Workflow Agent実行エンジン（Agent - Workflow Function）からAgent Serverへのファイルの登録

Workflow Agent実行エンジン（Agent - Workflow Function）をインストールする

Workflow Agent実行エンジンのバージョンアップ

Workflow Agentで確認する項目

Workflow Agentで障害が発生した場合

Workflow Agentのイベントログメッセージ

Workflow Agentのインストール

Workflow Agentのインストールと環境設定

Workflow Agentの運用コマンド

Workflow Agentのエージェント定義情報の変換

Workflow Agentの環境設定

Workflow Agentの起動

Workflow Agentの起動と終了

Workflow Agentのシステム環境の確認

Workflow Agentの終了

Workflow Agentの詳細メッセージ一覧

Workflow Agentのトレースの参照（watrc）

Workflow Agentのバージョン移行

Workflow Agentのバージョンの移行（waconv）

Workflow Agentのファイルの回復(warecvry)

Workflow Agent本体（Agent - Workflow Server）をインストールする

Workflow Agent本体のIPアドレスを変更する場合

Workflow Agentを削除する

(ア行)

(あ)

アクション

(い)

一般ユーザ

イベントログ

(う)

運用コマンドの概要

運用コマンドの概要

運用コマンドの概要

運用コマンドの概要

運用コマンドの記述形式

運用コマンドの記述形式

運用コマンドの記述形式

運用コマンドの記述形式

運用コマンドの実行

運用コマンドの実行

運用コマンドの実行

運用コマンドの実行手順

運用コマンドの説明で使用する記号

運用コマンドの説明で使用する記号

運用コマンドの説明で使用する記号

運用コマンドの説明で使用する記号

運用上の制限事項

(え)

永続メモリ

エージェント

エージェントおよびユーザ情報参照

エージェント開発者

エージェントキー

エージェントキーとシーケンス番号について

エージェント情報の参照

エージェント定義画面からWorkflowサーバのIPアドレスを指定しないエージェント

エージェント定義画面からWorkflowサーバのIPアドレスを指定するエージェント

エージェント定義の変換

エージェントの活動に関する操作

エージェントの種類とGroupmax Workflow Serverの前提バージョンについて

エージェントの動作に異常がある場合

エージェントの名称や状態を表示する

エージェント番号

エージェント番号

エージェント番号について

エージェントやユーザに関する情報の参照と更新

エラーコードの一覧

エラーになったエージェントの詳細情報の確認

(カ行)

(か)

各サーバの起動と終了の関係

活動ログ

活動ログとイベントログの参照

活動ログの参照

監視エージェント情報

監視エージェント情報に関する操作

監視エージェント情報の参照・更新

監視エージェント情報を削除する

監視エージェント情報を登録する

監視エージェント情報を表示する

管理ツール

管理ツールで操作する情報

管理ツールで操作する情報

管理ツールで操作する情報

管理ツールで操作する情報

管理ツールの起動

管理ツールの起動

管理ツールの起動

管理ツールの起動

管理ツールの操作

管理ツールの操作

管理ツールの操作

管理ツールの操作

管理ツールのメインメニュー

管理ツールのメインメニューとコマンドの入力方法

管理ツールのメインメニューとコマンドの入力方法

管理ツールのメニューコマンド

管理ツールのメニューコマンド一覧

(く)

クライアント－サーバ間でバージョンが異なる場合の接続

クライアント側での処理

クライアントの環境設定

クラスタシステムを使用する場合の注意事項

(こ)

コマンドの入力例

(サ行)

(さ)

サーバ－サーバ間でバージョンが異なる場合の接続

サーバエージェントマネージャ

サーバが異常終了した場合

サーバ側での処理

サーバ環境で確認する項目

サーバ間の情報の一致

サーバのトレースの参照（agpptrc

サービスの依存関係

サービスの起動・終了順番

サービスの起動及び終了

(し)

シーケンス番号

システム環境の設定

システム環境変数の設定

システム情報に関する操作

システム情報の参照・更新・初期化

システム情報の参照・更新・初期化

システム情報の参照・更新・初期化

システム情報の参照・更新・初期化

システム情報の初期化

システム情報の初期化

システム情報の初期化

システム情報を参照・更新する

システム情報を参照・更新する

システム情報を参照・更新する

システム情報を初期化する

システム情報を初期化する

システム情報を初期化する

システム情報を初期化する

システムに関する情報の参照と更新

システムファイルの回復

実行エンジン

実行エンジン

実行例

実行例

自動転送エージェントにおけるASCIIオプション

取得したサーバ情報を基に整合性を確保する

障害回復の流れ

障害要因の特定

詳細ダイアログDLLファイルの登録

詳細ダイアログDLLファイルの登録

詳細ダイアログDLLファイルの登録

詳細ダイアログDLLファイルの登録

詳細ダイアログのDLLファイルのコピー

使用するプログラムと起動するサービスの対応

情報の回復

情報の出力について

処理結果の確認

(す)

スケジューラに関する情報を参照・更新する

(せ)

整合性確保コマンドの実行

整合性確保の対象となるサーバの情報を取得する

生存期間

全エージェントの活動ログを一覧表示する

全体の運用

(そ)

操作結果のエディタ出力

操作結果の出力先の指定

操作結果の出力先を指定する

操作結果をエディタ出力する

(タ行)

(た)

タイマ情報，登録可能エージェント上限値の設定について

タイマ情報に関する操作

タイマ情報の参照・更新

ダンプファイルの出力

ダンプファイルの出力

ダンプファイルの出力

ダンプファイルの出力

(て)

定義情報の上限値を参照・更新する

ディスク容量

電子メール環境の設定

テンプレート定義データの登録

テンプレート定義データの登録

テンプレート定義データの登録

テンプレート定義データの登録

テンプレート定義ファイルのコピー

(と)

登録されている全エージェントを一覧表示する

登録ユーザに関する情報を表示する

特定のエージェントに関する情報を表示する

特定のエージェントの活動ログを一覧表示する

特定のエージェントを活動させる

特定のエージェントを削除する

特定のエージェントを停止させる

特定のユーザが登録したエージェント情報を表示する

特定ユーザの登録したエージェントの活動ログを一覧表示する

どのような場合に運用コマンドを使用するか

どのような場合に運用コマンドを使用するか

どのような場合に運用コマンドを使用するか

どのような場合に運用コマンドを使用するか

トリガ

トリガ

(ハ行)

(は)

バージョン移行時の注意事項

バージョンごとにサポートしているエージェントの一覧

バージョンの移行・混在に関する注意

バックアップ

バックアップ

バックアップ

バックアップ

バックアップ・リストア

バックアップとリストア

バックアップとリストア

バックアップとリストア

バックアップとリストア

(ふ)

フォーム文書データベース検索オプション

フォルダ（ディレクトリ）情報を参照・更新する

プラットフォーム及びバージョンごとにサポートしているエージェントの一覧

プログラムを削除する方法

文書管理サーバ（Document Manager）での設定

(へ)

ヘルプファイルの登録

ヘルプファイルの登録

ヘルプファイルの登録

ヘルプファイルの登録

(ほ)

保守情報の採取

ホスト名の扱いについて

本機能の利用

本機能を利用するための設定

(マ行)

(め)

メールに関する情報を参照・更新する

メールリカバリ送信機能

メッセージ，現象からの要因・対処

メッセージ，現象からの要因・対処

メモリ容量

(ヤ行)

(ゆ)

ユーザID・E-mailアドレス対応ファイルの作成

ユーザID・E-mailアドレス対応ファイルの作成と参照（waemtbl）

ユーザID・E-mailアドレス対応ファイルを作成する

ユーザID・E-mailアドレス対応ファイルを参照する

ユーザID一覧ファイルの作成

ユーザID一覧ファイルの作成と参照（waulist）

ユーザID一覧ファイルを作成する

ユーザID一覧ファイルを参照する

ユーザ単位のエージェント削除

ユーザトレー内案件の一括新着監視エージェントによるメール宛先BCC化

ユーザプログラムのリコンパイル

(ラ行)

(り)

リストア

リストア

リストア

リストア

リトライ状態解除機能

■ 商標類

Microsoft, Windows, Windows ServerおよびWindows NTは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Microsoft OfficeおよびExcelは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
OracleとJavaは，Oracle Corporation 及びその子会社，関連会社の米国及びその他の国における登録商標です。
UNIXは，The Open Groupの米国ならびに他の国における登録商標です。
その他記載の会社名，製品名は，それぞれの会社の商標もしくは登録商標です。