Cosminexus サービスプラットフォーム システム構築・運用ガイド
形式
csmlshistory [<HCSCサーバ名>] [-c <クライアント相関ID>]※ [-m <メッセージ共通ID>]※ [-i <サービスリクエストID>]※ [-t <照会開始日時>,<照会終了日時>]※ [-rs <サービスリクエスタからの入力サービス名>]※ [-s <サービス名>]※ [-jm <JMSメッセージID>]※ [-jc <JMS相関識別子>]※ [-l {new|all}] [-d {nml|ext|msg}] [-ul <電文データ長>] [-r <表示レコード数>] [-k {list|count}] [-u <DBユーザID> [-p <DBパスワード>]]
機能
データベースを使用する構成でHCSCサーバをセットアップした場合,電文の実行履歴の情報を表示します。HCSCサーバが停止している場合でも表示できます。
引数
<HCSCサーバ名> 〜<英数字およびアンダーライン(_)> ((1−8文字))
自HCSCサーバ名を指定します。CSM_SV_NAME環境変数にHCSCサーバ名を設定すると,このオプションの指定を省略できます。
-c <クライアント相関ID> 〜<英数字および記号> ((1−255文字))
クライアント相関IDで検索する場合に指定します。
-m <メッセージ共通ID> 〜<英数字および記号,コロン(:),およびピリオド(.)> ((1−75文字))
メッセージ共通IDで検索する場合に指定します。
-i <サービスリクエストID> 〜<英数字および記号,コロン(:),およびピリオド(.)> ((1−84文字))
サービスリクエストIDで検索する場合に指定します。
-t <照会開始日時>,<照会終了日時> 〜<半角数字>
開始日時,終了日時で検索する場合に指定します。照会開始日時と照会終了日時の間のコンマ(,)の前後に余分なスペースを指定しないでください。なお,利用できる日時の形式は次の形式です。また,日時には存在するものを指定してください。
-rs <サービスリクエスタからの入力サービス名> 〜<XMLスキーマのNCName型の文字列> ((1−64バイト))
サービスリクエスタの入力サービス名で検索する場合に指定します。
-s <サービス名> 〜<XMLスキーマのNCName型の文字列> ((1−64バイト))
呼び出し先のサービス名で検索する場合に指定します。
-jm <JMSメッセージID> 〜<英数字および記号,コロン(:),およびピリオド(.)> ((1−255文字))
JMSヘッダのJMSMessageIDの値で検索する場合に指定します。
-jc <JMS相関識別子> 〜<文字列> ((1−255文字))
JMSヘッダのJMSCorrelationIDの値で検索する場合に指定します。
-l {new|all} 〜<<new>>
実行履歴情報の検索方法を指定します。
-d {nml|ext|msg} 〜<<nml>>
実行履歴の表示方法を指定します。
-ul <電文データ長> 〜 ((0−65535バイト)) <<1024>>
出力する電文データ(ユーザ電文)の上限値を指定します。このオプションは-dオプションにmsgを指定したときだけ有効になります。また,0を指定した場合は上限値がなくなります。
-r <表示レコード数> 〜<整数> ((1−1000)) <<100>>
表示するレコード数を指定します。該当するレコード数が指定値より小さい場合は,該当するレコード数だけ表示します。
-k {list|count} <<list>>
指定した条件を満たす履歴情報について,内容を表示するか,またはエントリ数を表示するかを指定します。
-u <DBユーザID>
HCSCサーバで使用しているデータベースのユーザIDを指定します。HCSCサーバが起動している場合は,このオプションを指定しても無効になります。HCSCサーバが停止している場合は,必ずこのオプションを指定します。ただし,次の条件を満たす場合は,このオプションを省略できます。
また,HCSCサーバが停止している場合でも,データベースの設定で認証が必要ないときは,このオプションを指定しないでください。
-p <DBパスワード>
HCSCサーバで使用しているデータベースのパスワードを指定します。HCSCサーバが起動している場合は,このオプションを指定しても無効になります。HCSCサーバが停止している場合は,必ずこのオプションを指定します。ただし,次の条件を満たす場合は,このオプションを省略できます。
また,HCSCサーバが停止している場合でも,データベースの設定で認証が必要ないときは,このオプションを指定しないでください。
表示形式
EntryCount:エントリ番号 TimeStamp:実行履歴採取時刻 HCSCServerName:受付HCSCサーバ名 ClusterName:サービス部品を呼び出したHCSCサーバのクラスタ名 HistoryDirection:実行履歴採取方向 HCSCCommonID:メッセージ共通ID ServiceRequestID:サービスリクエストID ClientID:クライアント相関ID JMSMessageID:JMSメッセージID JMSCorrelationID:JMS相関識別子 RequestType:サービスリクエスタ種別 RequestProtocolKind:リクエストのプロトコル種別 RequestServiceName:サービスリクエスタからの入力サービス名 ServiceName:呼び出し先のサービス名 ServiceKind:サービスの種別 AdapterName:サービスアダプタまたはビジネスプロセスのサービスID ServiceProtocolKind:サービスアダプタの種類 ServiceOperationName:サービス部品のオペレーション名 ConnectProtocolKind:連携プロトコル種別 RequestUserTelegramType:ユーザ電文の種別 ResponseUserTelegramType:ユーザへの応答電文の種別 BPActivity:ビジネスプロセス用アクティビティ番号 BPProcessID:ビジネスプロセス用プロセスID BPRequestType:ビジネスプロセス用要求タイプ ReplyToQueueName:応答用のキュー名 RouteHistory:経路履歴情報 ErrorCode:エラー情報 Version:実行履歴情報コンテナのバージョン番号 Revision:実行履歴情報コンテナのリビジョン番号 UserTelegram:ユーザ電文 |
注 表示するエントリが複数ある場合,エントリごとに改行で区切ります。
説明
表示項目 | 説明 | -dオプションを設定した場合に表示される情報 | ||
---|---|---|---|---|
基本情報(nmlを指定) | 電文データ以外の情報(extを指定) | 電文データを含むすべての情報(msgを指定) | ||
EntryCount | エントリ番号を示します。 | ○ | ○ | ○ |
TimeStamp | 実行履歴採取時刻を示します。java.text.SimpleDateFormatで定義されているフォーマットに,YYYY/MM/DD hh:mm:ss.SSSの形式で表示されます。
|
○ | ○ | ○ |
HCSCServerName | 受付HCSCサーバ名を示します。 | × | ○ | ○ |
ClusterName | サービス部品を呼び出したHCSCサーバのクラスタ名を示します。 | ○ | ○ | ○ |
HistoryDirection | 実行履歴採取方向を示します。次のどれかが表示されます。
|
○ | ○ | ○ |
HCSCCommonID | メッセージ共通IDを示します。 | ○ | ○ | ○ |
ServiceRequestID | サービスリクエストIDを示します。 | ○ | ○ | ○ |
ClientID | クライアント相関IDを示します。 | × | ○ | ○ |
JMSMessageID | JMSメッセージIDを示します。 | × | ○ | ○ |
JMSCorrelationID | JMS相関識別子を示します。 | × | ○ | ○ |
RequestType | サービスリクエスタ種別を示します。次のどれかが表示されます。
|
× | ○ | ○ |
RequestProtocolKind | リクエストのプロトコル種別を示します。次のどれかが表示されます。
|
× | ○ | ○ |
RequestServiceName | サービスリクエスタからの入力サービス名を示します。 | ○ | ○ | ○ |
ServiceName | 呼び出し先のサービス名を示します。 | ○ | ○ | ○ |
ServiceKind | サービス部品の種別を示します。次のどれかが表示されます。
|
× | ○ | ○ |
AdapterName | サービスアダプタまたはビジネスプロセスのサービスIDを示します。 | × | ○ | ○ |
ServiceProtocolKind | サービスアダプタの種類を示します。次のどれかが表示されます。
|
× | ○ | ○ |
ServiceOperationName | サービス部品のオペレーション名を示します。 | × | ○ | ○ |
ConnectProtocolKind | 連携プロトコル種別を示します。次のどれかが表示されます。
|
× | ○ | ○ |
RequestUserTelegramType | ユーザ電文の種別を示します。次のどれかが表示されます。
|
× | ○ | ○ |
ResponseUserTelegramType | ユーザへの応答電文の種別を示します。次のどれかが表示されます。
|
× | ○ | ○ |
BPActivity | ビジネスプロセス用アクティビティ番号を示します。ビジネスプロセスのアクティビティインスタンスを識別するための番号です。 | × | ○ | ○ |
BPProcessID | ビジネスプロセス用プロセスIDを示します。 | × | ○ | ○ |
BPRequestType | ビジネスプロセス用要求タイプを示します。 | × | ○ | ○ |
ReplyToQueueName | 応答用のキュー名を示します。 | × | ○ | ○ |
RouteHistory | 経路履歴情報を示します。HCSCサーバ名またはサービスアダプタのサービスIDを「->」でつなげた文字列で表示されます。 | × | ○ | ○ |
ErrorCode | エラー情報を示します。HistoryKindDirection=Service Error※の場合,次のどれかのエラー理由とエラーコードが表示されます。
|
○ | ○ | ○ |
Version | 実行履歴情報コンテナのバージョン番号を示します。 | ○ | ○ | ○ |
Revision | 実行履歴情報コンテナのリビジョン番号を示します。 | ○ | ○ | ○ |
UserTelegram | ユーザ電文を示します。 | × | × | ○ |
<?xml version="1.0" encoding="UTF-8"?> <cscmsgerror> <errorcode>エラーコード</errorcode> <errorstring>エラー情報</errorstring> <processinstanceID/> <errordetail> <cscmsgcode>フォルト情報のFaultCode</cscmsgcode> <cscmsgstring>フォルト情報のFaultString</cscmsgstring> <cscmsgactor>フォルト情報のFaultActor</cscmsgactor> <cscmsgdetail>フォルト情報のDetail</cscmsgdetail> <exceptionName>フォルト名(例外名)</exceptionName> </errordetail> </cscmsgerror> |
RecordCount:レコード数 |
説明
表示項目 | 説明 |
---|---|
RecordCount | レコード数を示します。履歴参照条件に該当したレコードの数が表示されます。 |
戻り値
戻り値 | 意味 |
---|---|
0 | 正常終了しました。 |
1 | コマンドが異常終了しました。 |
9 | 実行権限のチェックエラーが発生しました。 |
注意事項
All Rights Reserved. Copyright (C) 2006, 2008, Hitachi, Ltd.