cscpidelete（プロセスインスタンスの実行履歴の削除）

Cosminexus V9 BPM/ESB基盤サービスプラットフォームリファレンス

-h

コマンドの使用方法が表示されます。このオプションを指定している場合は，ほかのオプションを指定しても無視されます。

-user <ログインユーザID>　～＜半角英数字およびアンダーバー（_）＞ ((1－16文字))

HCSC-Managerログイン時に使用するユーザIDを指定します。

-pass <ログインパスワード>　～＜半角英数字およびアンダーバー（_）＞ ((1－16文字))

HCSC-Managerログイン時に使用するパスワードを指定します。

-csc <HCSCサーバ名>　～＜半角英数字およびアンダーバー（_）＞ ((1－8文字))

SQLを実行するHCSCサーバ名を指定します。

-where <where句>　～ ((1文字以上))

削除対象となるプロセスインスタンスのプロセス概要情報を検索するためのwhere句を指定します。where句に記載できる内容については，使用しているデータベースのSQLリファレンスマニュアルを参照してください。

なお，where句には，テーブル名の指定およびコメント行の追加はできません。where句の設定で，誤った例と正しい例を次に示します。

設定例1

　誤った例：テーブル名を指定している
　          P.Status='Completed'
　正しい例：テーブル名を指定していない
　          Status='Completed'

設定例2

　誤った例：コメント行を追加している
　          Status='Completed' AND
　          # ProcessDefinitionName like 'BP%'
　正しい例：：コメント行を追加していない
　          Status='Completed' AND
　          ProcessDefinitionName like 'BP%'

-idlist <プロセスインスタンスの識別子のリストが記載されたファイル名>　～ ((1－200バイト))

プロセスインスタンスの識別子のリストが記載されたファイル名を指定します。プロセスインスタンスの識別子のリストは，改行区切り（「\r\n」または「\n」）で記載します。ファイルパスは，絶対パス，または相対パスで指定します。1つの改行の先頭と終端の空白文字は削除します。設定例を次に示します。

設定例

ProcessIDが「11111」，「44444」，「77777」のビジネスプロセスを削除する場合（改行コードは「\n」で表示しています）。

11111\n
44444\n
77777\n

-wherefile <where句が記載されたファイル名>　～((1－200バイト))

where句が記載されたファイル名を絶対パス，または相対パスで指定します。指定されたファイル内容に改行コードをスペースに置き換えて，プロセス概要情報を検索し，該当するプロセスインスタンスの実行履歴を削除します。

-processname <ビジネスプロセス定義名>　～((1文字以上))

指定したビジネスプロセス定義名のプロセスインスタンスを削除します。

-date [<照会開始日時>],<照会終了日時>　～＜半角数字＞

指定した照会開始日時から照会終了日時までの間に開始したプロセスインスタンスを削除します。照会開始日時を省略した場合，照会終了日時より前に開始したプロセスインスタンスを削除します。照会開始日時と照会終了日時の間のコンマ（,）の前後に余分なスペースを指定しないでください。

なお，照会開始日時と照会終了日時は次の形式で指定します。日時の指定にはデフォルトタイムゾーンを使用してください。

YYYYMMDDhhmmss: YYYY：西暦年（1970≦YYYY）; MM：月（01≦MM≦12）; DD：日（01≦DD≦31）; hh：時（00≦hh≦23）; mm：分（00≦mm≦59）; ss：秒（00≦ss≦59）

-status {executing｜completed｜faulted｜error｜all}　～<<completed>>

指定した状態のプロセスインスタンスを削除します。-whereオプション，-idlistオプション，-wherefileオプション，-statusオプション，および-forceオプションをすべて省略した場合，このオプションのcompletedが有効になります。

executing
状態が「実行中」のプロセスインスタンスの履歴情報を削除します。
completed
状態が「完了」のプロセスインスタンスの履歴情報を削除します。
faulted
状態が「フォルト終了」のプロセスインスタンスの履歴情報を削除します。
error
状態が「エラー発生」のプロセスインスタンスの履歴情報を削除します。
all
全状態のプロセスインスタンスの履歴情報を削除します。

-force

データベース内の全プロセスインスタンスの情報を削除します。

-encoding <エンコーディング名>　～((1文字以上)) <<JavaVMのデフォルトエンコーディング>>

-wherefileオプションや-idlistオプションで指定した入力ファイルのエンコーディング名を指定します。次のエンコーディング名を指定できます。

UTF-8
US-ASCII
ISO-8859-1
JavaVMがサポートしているエンコーディング名

-canceltimer <中断時間>　～((0－86400)) <<0>>

特定の時間を経過しても処理が終了しない場合，処理を中断できます。処理中断までの時間を秒数で指定します。

0以外の秒数を指定した場合
指定された時間を経過すると，条件に合致するレコードが残っていても処理を中断し，資源を解放します。コマンドは戻り値10で正常終了します。その際，メッセージログとコンソールに警告メッセージが出力されます。
0を指定した場合
条件に合致するすべてのレコードの処理が終わるまで，処理は中断されません。

(1)全情報を削除する場合

 
cscpidelete -user admin -pass admin -csc HCSC -force

(2)ステータスが「完了」のプロセスをすべて削除する場合

 
cscpidelete -user admin -pass admin -where "State='Completed'"

(3)ProcessIDが「11111」，「22222」，および「33333」のプロセスを削除する場合

where句が記載されたファイルで指定する場合
cscpidelete -user admin -pass admin -wherefile delete_where.txt -csc HCSC
　delete_where.txtの中身
　　ProcessID='11111' OR ProcessID='22222' OR ProcessID='33333'
プロセスインスタンスの識別子のリストを改行区切りで作成したファイルで指定する場合
cscpidelete -user admin -pass admin -idlist idlist.txt -csc HCSC
　idlist.txtの中身
　　11111
　　22222
　　33333

(4)ステータス「完了」のプロセスをすべて削除する場合。ただし，300秒を経過しても削除処理が終わらないときは，残りの削除処理を中止する

 
cscpiselect -user admin -pass admin -where "State = 'Completed'" -canceltimer 300

戻り値	意味
0	正常終了しました。
1	コマンドが異常終了しました。
2	通信タイムアウトが発生しました。
3	排他エラーが発生しました。
9	実行権限のチェックエラーが発生しました。
10	指定された中断時間を超過したため，処理を中断しました。