EDMUsrView(文書空間に接続しているユーザ一覧出力)
形式
EDMUsrView {-l directory name
|-v〔directory name〕
〔-c connect pass time〕
〔-t transaction pass time〕
〔-h host name〕
〔-p application name〕
}
機能
文書空間に接続しているユーザのユーザ情報を取得します。このコマンドを実行すると,取得したユーザ情報を保存したり,表示したりできます。
オプション
オプションには,機能オプションと表示オプションがあります。次にそれぞれのオプションについて説明していきます。
機能オプション
機能オプションは,1文字の機能文字で表されます。このコマンドでは,-lオプションおよび-vオプションを指定できます。この機能文字の指定によって,ユーザ情報の保存やユーザ情報の表示を選択できます。
-l directory name
接続中のユーザのユーザ情報をサービスプロセスごとにファイルに出力します。
引数にdirectory nameを指定します。この引数は省略できません。引数であるdirectory nameには,ファイルを出力するディレクトリを絶対パスで,存在するディレクトリを指定してください。ディレクトリが存在しない場合,エラーになります。また,引数に指定するディレクトリにはシステム管理者に対して書き込み権が必要です。書き込み権がない場合はファイルを出力できません。なお,このコマンドの実行者には,引数に指定するディレクトリの読み取り権が必要です。
出力ファイルの形式を次に示します。
"サービスプロセス通番_サービスプロセスID.log"
このファイルは,指定されたディレクトリの下に作成された,usr_YYYYMMDDhhmmssxxxディレクトリ(YYYYMMDDhhmmssxxxはコマンド実行時間)に格納されます。
なお,出力ファイルの内容については,「ユーザ情報の出力形式」を参照してください。
-v 〔directory name〕
接続中のユーザのユーザ情報の表示,またはこのコマンドで作成されたファイルの情報を,指定した表示オプションの内容に従って表示します。引数であるdirectory nameには,-lオプションを指定してこのコマンドを実行することで作成されたディレクトリ(usr_YYYYMMDDhhmmssxxxディレクトリ)を絶対パスで指定します。ディレクトリが存在しない場合,エラーになります。引数を省略した場合,コマンド実行時にFile Sharingサーバに接続しているユーザのユーザ情報を表示します。表示されるユーザ情報は,表示オプションの指定に従います。
表示されるユーザ情報の出力形式については,「ユーザ情報の出力形式」を参照してください。
表示オプション
機能オプションとして-vオプションを指定した場合,有効になります。表示オプションには,-c connect pass time,-t transaction pass time,-h host name,および-p application nameがあります。
-c connect pass time
ユーザ情報を取得した時間とユーザ情報のレコード内容(コネクト開始時間)を比較して,connect pass timeの条件を満たしているユーザ情報を表示します。connect pass timeは,次に示す書式で指定できます。
time1-time2
二つの値であるtime1およびtime2によって時間の範囲を指定します。time1およびtime2の値は,「時:分:秒」の形式で指定してください。なお,省略して指定する場合の例を次に示します。
-t transaction pass time
ユーザ情報を取得した時間とユーザ情報のレコード内容"トランザクション開始時間"を比較し,transaction pass timeに該当しているユーザ情報を表示します。transaction pass timeは,次に示す書式で指定できます。
time1-time2
二つの値であるtime1およびtime2によって時間の範囲を指定します。time1およびtime2の値は,「時:分:秒」の形式で指定してください。なお,省略して指定する場合の例を次に示します。
-h host name
host nameとユーザ情報のレコード内容(ホスト名)が一致するユーザ情報を表示します。
-p application name
application nameとユーザ情報のレコード内容(アプリケーション名)が一致するユーザ情報を表示します。
ユーザ情報の出力形式
ユーザ情報は,1ユーザに対して1レコードがファイルに出力されます。1レコードは,「,」(コンマ)で区切られていて,左から順に次のように出力されます。
"サービスプロセス通番","サービスプロセスID","ホスト名","アプリケーション名","APプロセスID","コネクト開始時間","セッションID(ユーザ名)","トランザクション開始時間","HiRDBクライアントアプリケーションプログラム名(DBコネクション名)"
ユーザ名が特定できない契機では,括弧内には何も出力されません。接続しているユーザがいない場合は,次のように出力されます。
"サービスプロセス通番","サービスプロセスID","(NO USER)"
ユーザ情報が取得できなかった場合は,次のように出力されます。
"サービスプロセス通番","サービスプロセスID","(INFORMATION NOT FOUND)"
実行例
このコマンドの実行例を次に示します。
機能オプションに-lを指定した場合の実行例
EDMUsrView -l C:¥tmp
KMBR03352-I File Sharingに接続しているユーザの一覧を出力します。
出力先ディレクトリ名のプリフィックスはusr_20040503132732886となります。
KMBR03353-I File Sharingに接続しているユーザの一覧を出力しました。
機能オプションに-vを指定した場合の実行例
EDMUsrView -v C:¥tmp¥usr_20040503132732886
KMBR03352-I File Sharingに接続しているユーザの一覧を出力します。
0001,3302,Host1,App1,3304,2005/08/03 13:26:38.403,00000ce63833a9ba0005349a(User1),,
0002,3303,Host2,App2,3305,2005/08/03 13:29:40.312,000070c1387024fe0007e057(User2),,
KMBR03353-I File Sharingに接続しているユーザの一覧を出力しました。
注意事項
機能オプションに-lを指定した場合
機能オプションに-vを指定した場合