2.1.4 リモートコマンドの出口情報

Systemwalker Centric Manager APIガイド - UNIX/Windows(R)共通 -

目次索引

第2章機能概要

> 2.1 システム監視のAPI

2.1.4 リモートコマンドの出口情報

リモートコマンドの出口(DLL)をあらかじめ用意することで、以下の項目をカスタマイズすることができます。

実際に発行するコマンド文字列
リモートコマンド発行の可否
確認メッセージの表示の是非

作成したDLLは、DLL名を“mprcmdex.dll”とし、リモートコマンドを実際に発行する運用管理クライアントのパスの通った任意のディレクトリに格納してください。

■呼び出し形式

    
__declspec(dllexport) int __stdcall ChkRcmd(

char *lpCommand,

int iHostCount,

char **lpHostname,

char **lpRuntype,

char *lpReserv,

int iReserv,

struct stRcmdData *returnData)

■パラメタ

char *lpCommand: リモートコマンド画面で入力された入力文字列
int iHostCount: リモートコマンド発行先ホスト数(注1)
char **lpHostname: リモートコマンド発行先ホスト名
char **lpRuntype: リモートコマンド発行先ホストの運用形態名
char *lpReserv: 予約域(注2)
int iReserv: 予約域(注2)
struct stRcmdData *returnData: 実行情報(リモートコマンドを実行できる場合に実行情報を設定してください。) (注3)

注1) リモートコマンド発行先ホスト名とリモートコマンド発行先ホストの運用形態名の数は同じになります。運用形態名のないホストの場合、対応する運用形態名の値にはNULLが設定されています。

注2) 予約域は参照、代入を行わないでください。

注3) 引数の実行情報には、リモートコマンドを実行できる場合に実行情報を設定してください。実行情報は呼び出し元で領域を確保しますので領域取得、開放処理を行わないでください。
また、実行情報のiCommandLengthにコマンド文字列(lpCommand)の領域サイズ(Systemwalkerコンソールで領域確保したサイズ)が設定されています。この値を超えてコマンド文字列の領域を設定しないでください。現在のリモートコマンドでは1024バイトが設定されます。

■構造体の説明

    
struct stRcmdData{

intiCommandLength;//コマンド文字列(lpCommand)の領域サイズ(参照のみ)

char*lpCommand;//実行するコマンド文字列

intiConfMsgflag;//確認ダイアログを表示有無　1:表示する　0:表示しない

intiReservLength;//予約域(lpReserv)の領域サイズ(参照のみ)

char*lpReserv;//予約域コマンド実行否の場合のメッセージ文字列

intiReserv;//予約域

};

以下のパラメタ/構造体を編集すれば、カスタマイズすることができます。

int iCommandLength: コマンド文字列(lpCommand)の領域サイズ(参照のみ)

char *lpCommand: 実際に発行するコマンド文字列; これを編集することで“実際に発行するコマンド文字列”をカスタマイズすることができます。

int iConfMsgflag: 確認メッセージの表示の是非; 以下の値を設定することで確認メッセージの表示を制御できます。; 0: 確認メッセージを表示しない。; 1: 確認メッセージを表示する。

int iReservLength: メッセージ(lpReserv)の領域サイズ(参照のみ)

char *lpReserv: コマンド実行しない場合のメッセージ文字列; これに文字列を指定すると、リモートコマンド実行時にコマンド実行の可否の確認メッセージが表示されます。; 文字列を指定しないと確認メッセージは表示されません。

int iReserv: 予約域; 代入しないでください。

■復帰値

リモートコマンド発行の可否を、関数の復帰値により通知してください。

0:: リモートコマンドを実行する。
0以外:: リモートコマンドを実行しない。

■実行に必要な権限/実行環境

【Windows版】

運用管理サーバ/運用管理クライアントで実行可能です。

【UNIX版】

運用管理クライアントで実行可能です。

◆コンパイル環境

コンパイル環境は以下のとおりです。

【Windowsの場合】

コンパイラ : Microsoft Visual C++ 2005
ランタイムライブラリ : コンパイルオプションとして、“マルチスレッド（DLL）”を使用してください。

■注意事項

作成したDLLを格納する際は、該当の端末の［Systemwalkerコンソール］が起動していない状態で格納してください。
API呼び出し時に渡す引数について、領域はすべて［Systemwalkerコンソール］側で確保しますので、領域の開放処理はしないでください。
DLLは32ビットモジュールとして作成してください。64ビットモジュールは使用できません。
作成したDLLにおいて、不当メモリ参照などでアプリケーションエラーとなった場合、［Systemwalkerコンソール］も異常終了します。
［Systemwalkerコンソール］からDLLをオープンできた場合、関数のアドレス取得処理で失敗した場合は、以下のエラーメッセージを表示します。
```
エラーメッセージ：関数アドレスの取得に失敗しました。
```
本DLLによりコマンドが実行できな場合には、以下のメッセージが表示されます。
```
指定されたコマンドは実行できません。
```
コンソール操作制御運用の処理は、本DLLを呼び出した後に処理されます。
コンソール操作制御運用時、コマンドラインのチェック対象は実際に発行するコマンド(DLLからの復帰値)です。
確認ダイアログの表示の是非について、 [リモートコマンド]画面の [オプション]メニューの[確認ダイアログを表示する]がON/OFFに関わらずDLLの復帰値が優先されます。
Webコンソールからは、本機能は使用できません。
本機能を使用してリモートコマンド実行処理中も、他の機能は使用可能です。
本DLLでコマンドラインを変更した場合、 [リモートコマンド検索]画面には、変更後のコマンドが出力されるため、実際に [リモートコマンド]画面で実行したコマンドについては、 [リモートコマンド]画面を閉じると、後から確認することができません。

■使用例

ヘッダファイルの使用例を以下に示します。

// File Name: mprcmdex.h

// Function :RemoteCommand

//コマンドチェック用の復帰値構造体

struct stRcmdData{

intiCommandLength;//コマンド文字列(lpCommand)の領域サイズ(参照のみ)

char*lpCommand;//コマンド文字列

intiConfMsgflag;//確認ダイアログを表示有無　1:表示する　0:表示しない

intiReservLength;//予約域(lpReserv)の領域サイズ(参照のみ)

char*lpReserv;//予約域

intiReserv;//予約域

};

__declspec(dllexport) int __stdcall ChkRcmd(char *,int,char **, char **, char *, int,struct stRcmdData *);

目次索引