案件データの履歴情報をCSVファイルで出力します。コマンドの実行中に処理を中止すると，中止する直前までの履歴情報を出力します。

このコマンドの実行中は，JP1/Service Support - DB Serverが起動している必要があります。

jssitemhistory -o 案件履歴情報ファイル名
               -r 開始年月日-終了年月日
              [-b プロセスワークボードID ｜ -i 関連案件通し番号]
              [-e]
              [-f]

Administrators権限

IM-SSパス\bin\

-o 案件履歴情報ファイル名

案件管理DBの案件データの履歴情報を出力する案件履歴情報ファイル名を255バイト以内で指定します。ファイル名は絶対パス，または相対パスで指定できますが，相対パスで指定した場合も，絶対パスに変換したあとの文字列が255バイト以下になるように指定してください。また，ファイル名に「‐」で始まる文字列は指定できません。

-r 開始年月日-終了年月日

特定の期間内に更新された案件を出力するために，更新日の範囲をYYYY/MM/DD形式の文字列で指定します。開始年月日と終了年月日の間には「-」を挿入します。

開始年月日，および終了年月日には1970/01/02〜2036/12/31の値を指定できます。開始年月日には，終了年月日より前の値を指定してください。

開始年月日，および終了年月日について次に説明します。

開始年月日

この値で指定した日付以降に更新された案件を出力します。指定範囲内の値で存在しない日付が指定された場合は，実際に存在する日付まで進め，それ以降に更新された案件を出力します。例えば，開始日に2006/04/31を指定した場合は，2006/05/01以降に更新された案件を出力します。

終了年月日

この値で指定した日付以前に更新された案件を出力します。指定範囲内の値で存在しない日付が指定された場合は，実際に存在する日付まで戻り，それ以前に更新された案件を出力します。例えば，終了日に2006/06/31を指定した場合は，2006/06/30以前に更新された案件を出力します。

-b プロセスワークボードID

案件履歴情報を出力するプロセスワークボードを特定したい場合，対象となるプロセスワークボードのIDを64バイト以下の半角英数字で指定します。-bオプションと-iオプションの両方を省略すると，案件管理DB内のすべての案件を出力します。

-i 関連案件通し番号

案件履歴情報を出力する案件を特定したい場合，対象となる案件の関連案件通し番号を16バイトの10進数文字で指定します。-bオプションと-iオプションの両方を省略すると，案件管理DB内のすべての案件を出力します。関連案件通し番号については，「2.3.4　関連案件の表示」を参照してください。

-e

このオプションを指定すると，出力対象にユーザーがカスタマイズした項目が含まれます（JP1/IM - Service Supportのバージョン08-50以降の形式）。このオプションを省略すると，出力対象にはユーザーがカスタマイズした項目が含まれません（JP1/IM - Service Supportのバージョン08-50より以前の形式）。

-f

ファイルを上書きする場合に指定します。

戻り値	意味
0	正常終了
1	異常終了

案件履歴情報ファイルには次のような形式でデータが出力されます。登録されていないデータがある場合は，「"（ダブルクォーテーション）」が二つ出力されます。

出力される内容について説明します。

ヘッダー部

出力順	項目の内容	出力する値
1	製品名	JP1/IM-Service Support
2	出力されるファイルのバージョン	出力されるファイルのバージョンを6けたの文字列で表す
3	案件履歴情報ファイルの文字コード	MS932
4	出力データの種別	拡張項目がない場合 ITEMHISTORY 拡張項目がある場合 ITEMHISTORY△拡張項目あり （注　△は半角スペースを示す）

ボディ部

出力順	項目の内容
1	対象システムのシステムID
2	対象システムのシステム名
3	プロセスワークボードID
4	プロセス名
5	関連案件通し番号
6	エスカレーション番号
7	バージョン番号
8	プロセスワークボード内通し番号
9	エスカレーション先システム名
10	エスカレーション先プロセス名
11	タイトル
12	重大度
13	影響度
14	優先度
15	案件種別
16	問題分野
17	ステータス
18	作業状況
19	結果
20	更新日時
21	編集者※1
22	登録者のユーザー名
23	登録者のID
24	発生日時
25	登録日時
26	開始日時
27	担当者の種別「USER」または「ROLE」
28	担当者のユーザー名，またはロール名
29	担当者のID，またはロールID
30	作業期限
31	回答責任者の種別「USER」または「ROLE」
32	回答責任者のユーザー名
33	回答責任者のID，またはロールID
34	完了日時
35	顧客名
36	問い合わせ者
37	費用（予算）
38	費用（実績）
39	影響業務
40	概要
41	現象種別
42	要因
43	根本原因
44	回避策種別
45	回避策
46	解決区分
47	解決策
48	問題個所とバージョン
49	再発防止のための考察
50	スケジュール，手順概要
51	変更の影響評価
52	変更規模
53	リリースタイプ
54	審議結果
55	フリー記入欄
56	重大度の理由
57	影響度の理由
58	優先度の理由
59	プロダクト名
60	ジョブネット名
61	ジョブ名関連
62	SNMPソース
63	監視ノード名
64	アラーム名
65	イベントDB通し番号
66	JP1/IM - Managerホスト名
67	機器情報の表示名（それぞれの値のあとに「;」を追加して連結する）
68	関連案件ID（それぞれの値のあとに「;」を追加して連結する）
69	関連URLの表示名（それぞれの値のあとに「;」を追加して連結する）
70	拡張テキストデータ1（1〜4,096バイトの制御コード以外の文字列）
71	拡張テキストデータ2（1〜4,096バイトの制御コード以外の文字列）
72	拡張テキストデータ3（1〜4,096バイトの制御コード以外の文字列）
73	拡張テキストデータ4（1〜4,096バイトの制御コード以外の文字列）
74	拡張テキストデータ5（1〜4,096バイトの制御コード以外の文字列）
75	拡張テキストデータ6（1〜2,048バイトの制御コード以外の文字列）
76	拡張テキストデータ7（1〜2,048バイトの制御コード以外の文字列）
77	拡張テキストデータ8（1〜2,048バイトの制御コード以外の文字列）
78	拡張テキストデータ9（1〜2,048バイトの制御コード以外の文字列）
79	拡張テキストデータ10（1〜2,048バイトの制御コード以外の文字列）
80	拡張テキストデータ11（1〜2,048バイトの制御コード以外の文字列）
81	拡張テキストデータ12（1〜2,048バイトの制御コード以外の文字列）
82	拡張テキストデータ13（1〜2,048バイトの制御コード以外の文字列）
83	拡張テキストデータ14（1〜2,048バイトの制御コード以外の文字列）
84	拡張テキストデータ15（1〜2,048バイトの制御コード以外の文字列）
85	拡張テキストデータ16（1〜512バイトの制御コード以外の文字列）
86	拡張テキストデータ17（1〜512バイトの制御コード以外の文字列）
87	拡張テキストデータ18（1〜512バイトの制御コード以外の文字列）
88	拡張テキストデータ19（1〜512バイトの制御コード以外の文字列）
89	拡張テキストデータ20（1〜512バイトの制御コード以外の文字列）
90	拡張時刻データ1（「YYYY/MM/DD hh:mm:ss」形式）
91	拡張時刻データ2（「YYYY/MM/DD hh:mm:ss」形式）
92	拡張時刻データ3（「YYYY/MM/DD hh:mm:ss」形式）
93	拡張時刻データ4（「YYYY/MM/DD hh:mm:ss」形式）
94	拡張時刻データ5（「YYYY/MM/DD hh:mm:ss」形式）
95	拡張コードデータ1
96	拡張コードデータ2
97	拡張コードデータ3
98	拡張コードデータ4
99	拡張コードデータ5
100	拡張数値データ1
101	拡張数値データ2
102	拡張数値データ3
103	拡張数値データ4
104	拡張数値データ5
105	拡張ユーザー情報種別1「USER」，「ROLE」または空白
106	拡張ユーザー情報1
107	拡張ユーザー情報ID1のユーザーID，またはロールID
108	拡張ユーザー情報種別2「USER」，「ROLE」または空白
109	拡張ユーザー情報2
110	拡張ユーザー情報ID2のユーザーID，またはロールID
111	拡張ユーザー情報種別3「USER」，「ROLE」または空白
112	拡張ユーザー情報3
113	拡張ユーザー情報ID3のユーザーID，またはロールID
114	拡張ユーザー情報種別4「USER」，「ROLE」または空白
115	拡張ユーザー情報4
116	拡張ユーザー情報ID4のユーザーID，またはロールID
117	拡張ユーザー情報種別5「USER」，「ROLE」または空白
118	拡張ユーザー情報5
119	拡張ユーザー情報ID5のユーザーID，またはロールID
120	拡張ユーザーリンク1（それぞれの値のあとに「;」を追加して連結する）※2
121	拡張ユーザーリンク2（それぞれの値のあとに「;」を追加して連結する）※2
122	拡張ユーザーリンク3（それぞれの値のあとに「;」を追加して連結する）※2
123	拡張ユーザーリンク4（それぞれの値のあとに「;」を追加して連結する）※2
124	拡張ユーザーリンク5（それぞれの値のあとに「;」を追加して連結する）※2

注※1

-dオプションを指定して，jssitemlistコマンドで出力した場合，「編集者」ではなく，「削除者」になります。

注※2

リンク項目の種別が関連案件の場合は「案件ID」，機器情報の場合は「サーバ名」，「IPアドレス」または「資産番号」，関連情報の場合は「表示名」となります。

• jssitemhistoryコマンドの実行中に次のコマンドを同時実行すると，jssitemhistoryコマンドの実行に失敗するおそれがあるため，同時実行しないでください。
  
  • jssformdefコマンド
  • jssdelrecコマンド
  • jssdbinit.batコマンド
  • jssdbrorg.batコマンド
  • jssdbreclaim.batコマンド
  • jssdbbackup.batコマンド
  • jssdbrecovery.batコマンド
• jssitemhistoryコマンドの実行中に［Ctrl］+［C］キーなどでコマンドの実行を打ち切った場合，案件履歴の出力に失敗するおそれがあります。このため，コマンドの実行中に［Ctrl］+［C］キーなどで実行を打ち切らないでください。もし実行を打ち切った場合は，しばらく時間を置いてからコマンドを再実行してください。
• -fオプションを指定したjssitemhistoryコマンドを複数実行した場合，出力先ファイルのファイル名にはそれぞれ異なるファイル名を指定してください。同じファイル名を指定した場合，案件詳細情報ファイルの内容が不完全になることがあります。
• 出力する案件履歴情報の中に，選択肢コードの値に対応した文字列が存在しない場合，ファイルには選択肢コードの値がそのまま出力されます。
• 案件履歴情報ファイルの「1970/01/01 23:59:59」以前，または「2037/01/01 00:00:00」以降の日時データは正しく出力されない場合があります。

2007年4月1日〜2007年6月30日に更新された案件のうち，プロセスワークボードIDが「honsyasystem」の案件の履歴情報をCSVファイル（c:\anken\ankenhistory.csv）に出力する場合の指定例を次に示します。

jssitemhistory -o c:\anken\ankenhistory.csv -r 2007/04/01-2007/06/30 -b honsyasystem