cscpidelete(プロセスインスタンスの実行履歴の削除)
形式
cscpidelete [-h]
-user <ログインユーザID>
-pass <ログインパスワード>
-csc <HCSCサーバ名>
{-where <where句>
|-idlist <プロセスインスタンスの識別子のリストが
記載されたファイル名>
|-wherefile <where句が記載されたファイル名>
|-force }
[-encoding <エンコーディング名>]
機能
セットアップ後のHCSCサーバに対して,指定された条件に従ってプロセスインスタンスの実行履歴を削除します。
ログインユーザIDなどの必須オプションは,HCSC-Managerコマンド共通定義ファイルにデフォルト値を設定することで,このコマンドでの指定を省略できます。
引数
-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句の設定で,正しい例と誤った例を次に示します。
正しい例:State='Completed'
誤った例:P.State='Completed'
正しい例:State='Completed' AND
誤った例:State='1' AND
# process.ProcessDefinitionName like 'BP%'
-idlist <プロセスインスタンスの識別子のリストが記載されたファイル名> ~ ((1-200バイト))
プロセスインスタンスの識別子のリストが記載されたファイル名を指定します。プロセスインスタンスの識別子のリストは,改行区切り(「¥r¥n」または「¥n」)で記載します。ファイルパスは,絶対パス,または相対パスで指定します。一つの改行の先頭と終端の空白文字は削除します。設定例を次に示します。
11111¥n
44444¥n
77777¥n
-wherefile <where句が記載されたファイル名> ~ ((1-200バイト))
where句が記載されたファイル名を絶対パス,または相対パスで指定します。指定されたファイル内容に改行コードをスペースに置き換えて,プロセス概要情報を検索し,該当するプロセスインスタンスの実行履歴を削除します。
-force
データベース内の全プロセスインスタンスの情報を削除します。
-encoding <エンコーディング名> ~((1文字以上)) <<JavaVMのデフォルトエンコーディング>>
wherefileオプションやidlistオプションで指定した入力ファイルのエンコーディング名を指定します。次のエンコーディング名を指定できます。
入力例
cscpidelete -user admin -pass admin -csc MyCSC -force
cscpidelete -user admin -pass admin -where "State='Unexecution'"
cscpidelete -user admin -pass admin -wherefile delete_where.txt -csc MyCSC
delete_where.txtの中身
ProcessID='11111' OR ProcessID='22222' OR ProcessID='33333'
cscpidelete -user admin -pass admin -idlist idlist.txt -csc MyCSC
idlist.txtの中身
11111
22222
33333
戻り値
戻り値 | 意味 |
---|---|
0 | 正常終了しました。 |
1 | コマンドが異常終了しました。 |
2 | 通信タイムアウトが発生しました。 |
3 | 排他エラーが発生しました。 |
9 | 実行権限のチェックエラーが発生しました。 |
注意事項