収容クライアント履歴リスト表示ユーティリティ

(1) 使用方法

utlhubclientloglist -h hostname[:servicename] [-s | -r]
  [-fromdate d1] [-todate d2] [-f fileid] [-host hostname] [-notitle]

utlhubclientloglist -h hostname[:servicename] -o
  [-fromdate d1] [-todate d2] [-service name] [-notitle]

utlhubclientloglist -h hostname[:servicename] -sc
  [-fromdate d1] [-todate d2] [-id schedule] [-notitle]

utlhubclientloglist -h hostname[:servicename] {-t | -rs}
  [-fromdate d1] [-notitle]

utlhubclientloglist -h hostname[:servicename] -sd
  [-fromdate d1] [-notitle]

utlhubclientloglist -h hostname[:servicename] {-js | -jr}
  [-fromdate d1] [-todate d2] [-f fileid] [-host hostname] [-notitle]

(2) パラメータ説明

-h hostname[:servicename]

ホスト名およびサービス名(省略不可)

履歴情報を取得したいクライアントのホスト名およびサービス名を指定します。

サービス名が設定されていないホストを指定する場合、「:」を含むサービス名の指定を省略して、ホスト名のみ指定します。

= 備考 =

サービス名を省略することで、同一ホスト名の複数のホストを対象とすることはできません。

[-s | -r | -o | -sc | -t | -rs | -sd | -js | -jr]

履歴の種類(省略可)

取得する履歴の種類を指定します。

-s

: 配信履歴

-r

: 集信履歴

-o

: 要求受付履歴

-sc

: スケジュール履歴

-t

: 集配信状況

-rs

: 再配信待ち状況

-sd

: 今日のスケジュール

-js

: 配信後ジョブ実行履歴

-jr

: 集信後ジョブ実行履歴

省略した場合は-sが指定されたとみなします。

注意

-sc（スケジュール履歴）と-sd（今日のスケジュール）は、クライアントのホスト種がWindowsの場合に指定可能です。

[-fromdate d1] [-todate d2]

出力対象の日時範囲(省略可)

出力対象となる履歴の日時範囲を指定します。

d1、d2に指定する日時は、14バイトの数字(yyyymmddhhmmss)、または8バイトの数字(yyyymmdd)で指定してください。なお、8バイトの数字で指定した場合、指定した日付のすべての履歴が出力対象に含まれます。

-todateを省略した場合、-fromdateで指定した日時以降のすべての履歴が出力対象になります。

-fromdateを省略した場合、-todateで指定した日時以前のすべての履歴が出力対象になります。

履歴の種類として-t（集配信状況）、-rs（再配信待ち状況）、-sd（今日のスケジュール）を指定した場合、-todateは指定できません。

= 備考 =

• -fromdateと-todateを同時に指定する場合には、「d1 <= d2」となるようにしてください。
• -fromdateと-todateの指定で14バイト/8バイト形式が異なってもかまいません。
  例) -fromdate 20080101 -todate 20080930123000

[-f fileid]

ファイルID(省略可)

出力対象となるファイルIDを指定します。

対象のクライアントがHULFT8の場合は50バイト以内、HULFT8未満の場合は8バイト以内で指定します。

指定した場合、ファイルIDがfileidの履歴だけが対象となります。省略した場合はすべてのファイルIDが対象となります。

このパラメータは、履歴の種類として-s（配信履歴)、-r（集信履歴）、-js（配信後ジョブ実行履歴）、-jr（集信後ジョブ実行履歴）を指定した場合に指定できます。

[-host hostname]

転送相手のホスト名(省略可)

転送相手のホスト名を指定します。

履歴の種類として-s（配信履歴）または-js（配信後ジョブ実行履歴）を指定した場合、集信側がhostnameの履歴だけが対象となります。

履歴の種類として-r（集信履歴）または-jr（集信後ジョブ実行履歴）を指定した場合、配信側がhostnameの履歴だけが対象となります。

履歴の種類が上記以外の場合、-hostは指定できません。

[-service name]

サービス名(省略可)

出力対象となる要求受付のサービス名を指定します。

指定した場合、サービス名がnameと一致する履歴だけが対象となります。省略した場合はすべてのサービス名が対象となります。

このパラメータは、履歴の種類として-o（要求受付履歴）を指定した場合に指定できます。

[-id schedule]

スケジュールID(省略可)

出力対象となるスケジュールIDを指定します。

対象のクライアントがHULFT8の場合は50バイト以内、HULFT8未満の場合は8バイト以内で指定します。

指定した場合、スケジュールIDがscheduleの履歴だけが対象となります。省略した場合はすべてのスケジュールIDが対象となります。

このパラメータは、履歴の種類として-sc（スケジュール履歴）を指定した場合に指定できます。

[-notitle]

ヘッダ行の省略(省略可)

指定すると、CSVのヘッダ行を出力しません。

省略すると、ヘッダ行として項目名が表示されます。項目名については「(6) 表示項目」を参照してください。

(3) 完了コード

0

: 正常に実行されました。

10

: オプションの指定に誤りがあります。

11

: 終了指示を検知しました。

12

: メモリの確保に失敗しました。

13

: システムエラーが発生しました。

40

: 該当のクライアントは管理対象外のため取得は行いませんでした。

41

: 該当のクライアントは指定したID長に対応していません。

60

: 履歴の取得処理でエラーが発生しました。

100

: 該当する収容クライアントが存在しません。

101～

: SQLエラーが発生しました。

(4) ユーティリティ使用上の注意点

ユーティリティを使用する上での動作環境については、「ユーティリティ（コマンド）実行時の注意点」を参照してください。

本ユーティリティでは、以下のことにも注意してください。

• 履歴はシステム動作環境設定の「漢字コード種（KnjCode）」に設定された漢字コードで出力されます。
• ユーティリティを実行するたびにクライアントの要求受付履歴が追加されます。
• １秒間に1000件以上の履歴が出力されている場合には、その時刻の999件目までの履歴が出力され、1000件目以降の履歴はカットされます。
• 配信後ジョブ実行履歴または集信後ジョブ実行履歴を取得する場合、大量にトレースログが出力されます。日時範囲、ファイルID、ホスト名を指定して、履歴を絞り込んで取得してください。
• 配信後ジョブ実行履歴または集信後ジョブ実行履歴を取得する場合、対象クライアントに格納されている履歴の件数によっては、処理に時間がかかることがあります。

(5) 出力例

"ファイルID","配信ホスト名","集信ホスト名","開始日付","開始時刻","終了日付","終
了時刻","配信ファイル名","完了コード","詳細コード","レコード件数","データサイズ"
,"転送レート","接続形態","ボリューム通番","UNIT","連携DBID","圧縮率","IPバージョ
ン","メッセージ0","メッセージ1","メッセージ2","メッセージ3","メッセージ4","メッ
セージ5","メールボックス使用","配信受付日付","配信受付時間","最新処理識別子","開
始処理識別子","転送ブロック長","転送ブロック数","拡張メッセージ0","拡張メッセー
ジ1","暗号化種別","転送識別子","圧縮方式","コード変換側","コメント"
"FILE01","HOST01","HOST02","2013/09/27","20:16:05","2013/09/27","20:16:09","C:\D
ata\testdata\snd\test2.txt","000000","00000","454","37682","9420","LAN","","",""
,"0","IPv4","","","","","","","しない","2013/09/27","20:16:05","8E49C9451CE0BA19
E555C3B14B6D34B861","8E49C9451CE0BA19E555C3B14B6D34B861","32768","1","","","HULF
T","B120F1DA757382A16A543279343248D781000200000000000000000000000000","圧縮なし"
,"配信側","TEST"

"ファイルID","配信ホスト名","集信ホスト名","開始日付","開始時刻","終了日付","終
了時刻","集信ファイル名","完了コード","詳細コード","レコード件数","データサイズ"
,"転送レート","接続形態","ボリューム通番","UNIT","連携DBID","圧縮率","IPバージョ
ン","メッセージ0","メッセージ1","メッセージ2","メッセージ3","メッセージ4","メッ
セージ5","メールボックス使用","配信受付日付","配信受付時間","最新処理識別子","開
始処理識別子","転送ブロック長","転送ブロック数","拡張メッセージ0","拡張メッセー
ジ1","暗号化種別","転送識別子","圧縮方式","コード変換側","コメント"
"FILE02","HOST01","HOST02","2013/09/27","20:16:05","2013/09/27","20:16:09","C:\D
ata\testdata\rcv\moya\rcv02.txt","000000","00000","454","37682","9420","LAN","",
"","","IPv4","","","","","","","しない","","","8E49C9451CE0BA19E555C3B14B6D34B86
1","8E49C9451CE0BA19E555C3B14B6D34B861","","","","","C4S","6D110461DE9F99883DE31
18CD62665DD81000100000000000000000000000000","圧縮なし","","TEST"

"サービス名","ホスト名","依頼ホスト名","依頼受付日","依頼受付時刻","完了コード",
"詳細コード","最新処理識別子","開始処理識別子"
"HULADMIN","HOST01","HUBSVR","2013/11/11","17:26:41","000735","00000","00D5F51D5
9BC9A5726877BD1F006955281","00D5F51D59BC9A5726877BD1F006955281"

"スケジュールID","ホスト名","実行開始日","開始時刻","実行終了日","終了時刻","完
了コード","詳細コード","最新処理識別子","開始処理識別子"
"TEST","HOST01","2013/11/11","22:45:00","2013/11/11","22:45:14","000709","00002"
,"ACD9C7BDC5E0CE76B61182748D357F6041","ACD9C7BDC5E0CE76B61182748D357F6041"

"種別","ファイルID","ホスト名","集配信ホスト名","依頼日","依頼時刻","ステータス"
,"接続形態","サイズ","全体サイズ","最新処理識別子","開始処理識別子","処理番号","
ファイル名","転送識別子"
"配信","FILE01","HOST01","HOST02","2013/09/27","20:16:05","自動再配信待ち","LAN"
,"0","37682","8E49C9451CE0BA19E555C3B14B6D34B861","8E49C9451CE0BA19E555C3B14B6D3
4B861","","C:\Data\testdata\snd\Sample.txt","AA5BE71E7E19EE57E822EE567E479FBE810
00100000000000000000000000000"

"ファイルID","ホスト名","配信ホスト名","日付","時刻","配信ファイル名","完了コー
ド","詳細コード","レコード件数","全レコード件数","データサイズ","全データサイズ"
,"接続形態","ボリューム通番","UNIT","再配信処理番号","メッセージ0","メッセージ1"
,"メッセージ2","メッセージ3","メッセージ4","メッセージ5","最新処理識別子","開始
処理識別子","拡張メッセージ0","拡張メッセージ1"
"FILE03","HOST01","HOST02","2013/08/27","09:42:10","C:\Data\testdata\snd\test2.t
xt","331701","00003","0","0","0","0","LAN","","","","","","","","","","C12AA2F81
EEF3B279E9031378825C41561","C12AA2F81EEF3B279E9031378825C41561","",""

"状態","スケジュールID","ホスト名","実行日","開始時刻","終了時刻","完了コード","
詳細コード"
"実行待ち","TEST","HOST01","2013/11/12","22:45:00","","",""

"ファイルID","配信ホスト名","集信ホスト名","開始日付","開始時刻","終了時刻","ラ
イブラリ名","ジョブ名","メッセージID","重大度","ステータス","最新処理識別子","開
始処理識別子"
"FILE01","HOST01","HOST02","2013/09/27","20:16:09","20:16:12","","C:\tools\batfi
le\set_exitcode.bat 0","","","0","8E49C9451CE0BA19E555C3B14B6D34B861","8E49C9451
CE0BA19E555C3B14B6D34B861"