開発者リファレンス : プラットフォーム管理 : Distributed Tuning Objects (DTO) Guide : DTO を使用した Zen サーバーの設定 : DtoServices オブジェクト
  
このページをシェアする                  
DtoServices オブジェクト
このオブジェクトは DtoService オブジェクトのコレクションです。これはサーバーで起動している Zen サービスを表します。
プロパティ
Status
サービスの状態を返します。状態を取得する以下のサービスを渡す必要があります。
dtoServiceTransactional
dtoServiceRelational
dtoServiceIDS
StatusString
現在の状態を表す文字列を返します。
メソッド
RestartAllServices メソッド
StartRelational メソッド
StartTransactional メソッド
StopRelational メソッド
StopTransactional メソッド
StartDXAgent メソッド
StartDXReplication メソッド
StopDXAgent メソッド
StopDXReplication メソッド
備考
DtoServices のメソッドは、DtoSession オブジェクトを使って接続するコンピューターで起動している Zen エンジンのサービスを制御します。これらのメソッドはすべて DtoResult 列挙を返します。
このオブジェクトによって、Windows プラットフォームで起動している Zen エンジンのサービスを開始および停止することができます。 また、Status または StatusString プロパティを使って Zen サービスの現在の状態を照会することができます。
DtoServices オブジェクトに関するセキュリティ情報
このオブジェクトは、DtoSession オブジェクトと同じユーザー名とパスワードを使って Windows サーバーに接続することができます。
Microsoft の Internet Information Service(IIS)によってホストされる Web アプリケーションからこのオブジェクトのメソッドを使用する場合は、IIS によって DTO が IIS サービスと同じプロセス内で実行できるようにするために、DTO の Web アプリケーションがあるディレクトリ上でプロパティを設定する必要があります。これを行わない場合、IIS サービスの現在の状態は取得できますが、Startxx メソッドや Stopxx メソッドを使用したときに DTO エラー 431(アクセス拒否)が返されます。DtoServices オブジェクトのメソッドに必要な IIS フォルダー プロパティを設定するには、DTO Web アプリケーションが置かれているフォルダー上で以下の手順を実行してください。IIS の設定の詳細については、Microsoft IIS のドキュメントを参照してください。
DTO の Web アプリケーションからサービスを開始/停止できるように IIS を構成するには
1 スタート]メニューから[設定]を選択し、[コントロール パネル]をポイントします。
2 管理ツール]をダブルクリックします。
3 インターネット サービス マネージャー]をダブルクリックします。
4 DTO の ASP アプリケーションがあるフォルダーを参照します。
5 左ペインのフォルダーを右クリックして[プロパティ]を選択します。
6 ディレクトリ]タブをクリックします。
7 1 で示すように、[アプリケーション保護]フィールドで "低(IIS プロセス)" を指定します。
図 1 DtoServices メソッドで必要な IIS のディレクトリ プロパティ
'この例では、サーバーに接続し、
'Zen サービスを再開する
 
Dim my_session as new DtoSession
Dim my_services as DtoServices
Dim result as DtoResult
 
result = my_session.Connect("myserver", "username", "password")
Set my_services = my_session.Services
result = my_services.RestartAllServices
 
'この例では、サーバーに接続し、
'DataExchange (DX) エージェント サービスと DX レプリケーション
'サービスを再開する
 
Dim my_session as new DtoSession
Dim my_services as DtoServices
Dim result1 as DtoResult
Dim result2 as DtoResult
 
result = my_session.Connect("myserver", "username", "password")
Set my_services = my_session.Services
result1 = my_services.StartDXReplication
result2 = my_services.StartDXAgent
関連項目
DtoSession オブジェクト
DtoSetting オブジェクト
メソッドの詳細
RestartAllServices メソッド
トランザクショナル サービス、リレーショナル サービス、DataExchange(DX)エージェントおよび DX レプリケーション サービスを停止して再開始します。
構文
result = Services.RestartAllServices
引数
Services
DtoServices オブジェクト
戻り値
result
メソッド呼び出しの結果を示す DtoResult(Long 型の値)。DtoSession オブジェクトの Error プロパティを使って結果の説明を取得します。
StartRelational メソッド
リレーショナル サービスを開始します。Zen v14 現在、これは StartTransactional メソッドと同じです。
構文
result = Services.StartRelational
引数
Services
DtoServices オブジェクト
戻り値
result
メソッド呼び出しの結果を示す DtoResult(Long 型の値)。DtoSession オブジェクトの Error プロパティを使って結果の説明を取得します。
StartTransactional メソッド
Btrieve トランザクショナル サービスを開始します。Zen v14 現在、これは StartRelational メソッドと同じです。
構文
result = Services.StartTransactional
引数
Services
DtoServices オブジェクト
戻り値
result
メソッド呼び出しの結果を示す DtoResult(Long 型の値)。DtoSession オブジェクトの Error プロパティを使って結果の説明を取得します。
StopRelational メソッド
リレーショナル エンジン サービスを停止します。Zen v14 現在、これは StopTransactional メソッドと同じです。
構文
result = Services.StopRelational
引数
Services
DtoServices オブジェクト
戻り値
result
メソッド呼び出しの結果を示す DtoResult(Long 型の値)。DtoSession オブジェクトの Error プロパティを使って結果の説明を取得します。
StopTransactional メソッド
Btrieve トランザクショナル エンジン サービスを停止します。Zen v14 現在、これは StopRelational メソッドと同じです。
構文
result = Services.StopTransactional
引数
Services
DtoServices オブジェクト
戻り値
result
メソッド呼び出しの結果を示す DtoResult(Long 型の値)。DtoSession オブジェクトの Error プロパティを使って結果の説明を取得します。
StartDXAgent メソッド
DataExchange(DX)エージェント サービスを開始します。DX エージェントは、レプリケーションでの重大な障害を検出し、管理者に電子メールで通知するコンポーネントです。詳細については、DataExchange ドキュメントを参照してください。
DX エージェント サービスは、DX レプリケーション サービスを開始する前でも開始することができますが、その場合はレプリケーション サービスが停止していることを通知するメッセージがエージェントから返されます。レプリケーション サービスがまだ実行していないため、これは正常な動作です。
構文
result = Services.StartDXAgent
引数
Services
DtoServices オブジェクト
戻り値
result
メソッド呼び出しの結果を示す DtoResult(Long 型の値)。DtoSession オブジェクトの Error プロパティを使って結果の説明を取得します。
StartDXReplication メソッド
DataExchange(DX)レプリケーション サービス(レプリケーション エンジン)を開始します。レプリケーション エンジンでは、DataExchange レプリケーション ネットワーク内で、どれか 1 つの Zen データベースの変更を捕捉し、それをほかのデータベースと共有することができます。詳細については、DataExchange ドキュメントを参照してください。
レプリケーション サービスを開始すると、トランザクショナル サービスやリレーショナル サービスも開始します。
構文
result = Services.StartDXReplication
引数
Services
DtoServices オブジェクト
戻り値
result
メソッド呼び出しの結果を示す DtoResult(Long 型の値)。DtoSession オブジェクトの Error プロパティを使って結果の説明を取得します。
StopDXAgent メソッド
DataExchange(DX)エージェント サービスを停止します。DX エージェントは、レプリケーションでの重大な障害を検出し、管理者に電子メールで通知するコンポーネントです。詳細については、DataExchange ドキュメントを参照してください。
構文
result = Services.StopDXAgent
引数
Services
DtoServices オブジェクト
戻り値
result
メソッド呼び出しの結果を示す DtoResult(Long 型の値)。DtoSession オブジェクトの Error プロパティを使って結果の説明を取得します。
StopDXReplication メソッド
DataExchange(DX)レプリケーション エンジンを停止します。レプリケーション エンジンでは、DataExchange レプリケーション ネットワーク内で、どれか 1 つの Zen データベースの変更を捕捉し、それをほかのデータベースと共有することができます。詳細については、DataExchange ドキュメントを参照してください。
構文
result = Services.StopDXReplication
引数
Services
DtoServices オブジェクト
戻り値
result
メソッド呼び出しの結果を示す DtoResult(Long 型の値)。DtoSession オブジェクトの Error プロパティを使って結果の説明を取得します。