uCosminexus Service Coordinator Interactive Workflow コマンド

3020-3-M84-90

前書き

対象製品

P-2955-CJ34 uCosminexus Business Process Developer 03-11　（適用OS：Windows Server 2016，Windows Server 2019，Windows 10 x64，Windows 11）

P-2943-CG34 uCosminexus Service Coordinator Interactive Workflow 03-11　（適用OS：Windows Server 2016，Windows Server 2019）

P-2955-CG34 uCosminexus Service Coordinator Interactive Workflow 03-11　（適用OS：Windows Server 2016，Windows Server 2019，Windows 10 x64，Windows 11）

P-9W43-CG31 uCosminexus Service Coordinator Interactive Workflow 03-11　（適用OS：Red Hat(R) Enterprise Linux(R) Server 7.1（64-bit x86_64）以降，Red Hat(R) Enterprise Linux(R) Server 8.1（64-bit x86_64）以降）

これらのプログラムプロダクトのほかにもこのマニュアルをご利用になれる場合があります。詳細は「リリースノート」でご確認ください。

本製品では日立ネットワークオブジェクトプラザトレース共通ライブラリをインストールします。

輸出時の注意

本製品を輸出される場合には、外国為替及び外国貿易法の規制並びに米国輸出管理規則など外国の輸出関連法規をご確認の上、必要な手続きをお取りください。

なお、不明な場合は、弊社担当営業にお問い合わせください。

商標類

HITACHI，Cosminexus，HiRDB，uCosminexusおよびWorkCoordinatorは，株式会社 日立製作所の商標または登録商標です。

AIXは，世界の多くの国で登録されたInternational Business Machines Corporationの商標です。

IBMは，世界の多くの国で登録されたInternational Business Machines Corporationの商標です。

Linuxは，Linus Torvalds氏の日本およびその他の国における登録商標または商標です。

Microsoftは，マイクロソフト 企業グループの商標です。

OracleおよびJavaは，オラクルおよびその関連会社の登録商標です。

Red Hat is a registered trademark of Red Hat, Inc. in the United States and other countries.

Red Hatは，米国およびその他の国におけるRed Hat, Inc.の登録商標です。

Red Hat Enterprise Linux is a registered trademark of Red Hat, Inc. in the United States and other countries.

Red Hat Enterprise Linuxは，米国およびその他の国におけるRed Hat, Inc.の登録商標です。

SQL Serverは，マイクロソフト 企業グループの商標です。

UNIXは，The Open Groupの登録商標です。

Windowsは，マイクロソフト 企業グループの商標です。

Windows Serverは，マイクロソフト 企業グループの商標です。

その他記載の会社名，製品名などは，それぞれの会社の商標もしくは登録商標です。

発行

2022年4月

著作権

All Rights Reserved. Copyright (C) 2007, 2022, Hitachi, Ltd.

変更内容

変更内容(3020-3-M84-90)　uCosminexus Service Coordinator Interactive Workflow 03-11

追加・変更内容

変更個所

Windows 11に対応した。

－

対応する製品からOracle Database 18cを削除した。

－

ciwchgapworkコマンドの-listオプションで出力する作業一覧に項目を追加した。

2.1.1，2.1.2

単なる誤字・脱字などはお断りなく訂正しました。

OS，ブラウザ，およびデータベースに関して，新しいバージョンの追加，および古いバージョンの削除については記載していません。サポートしているバージョンの詳細については「リリースノート」でご確認ください。

はじめに

このマニュアルは，uCosminexus Service Coordinator Interactive Workflowの環境構築および運用で使用するコマンドについて説明したものです。

以降，このマニュアルでは，上記のプログラムプロダクトをCSCIWと称します。また，CSCIWを使用した業務システム全体の総称をワーク管理システムとします。

BPMN連携機能を使用する場合の読み替えについて

BPMN連携機能を使用する場合，ビジネスプロセスの設計には，CSCIW-DefinerではなくBPMNエディタを使用します。マニュアル内の「CSCIW-Definer」の表記を「BPMNエディタ」に置き換えてお読みください。

対象読者

このマニュアルは，uCosminexus Service Coordinator Interactive Workflowの環境を構築，または運用される方を対象としています。また，次の知識をお持ちであることを前提にしています。

使用しているOSに関する基本的な知識

CSCIWに関する知識

リレーショナルデータベースの操作（SQL文など）に関する知識

読書手順

このマニュアルは，利用目的に合わせて章を選択して読むことができます。利用目的別に次の流れに従ってお読みいただくことをお勧めします。

このマニュアルで使用する記号

図中で使用する記号

このマニュアルの図中で使用する記号を次のように定義します。

このマニュアルで使用する記号

このマニュアルで使用する記号を次のように定義します。

記号

意味

<　>

可変値を意味します。

コマンドの説明で使用する記号

コマンドの説明で使用する記号を次のように定義します。

記号

意味

<　>

可変値を意味します。

｜（ストローク）

横に並べられた複数の項目に対し，項目間の区切りを示します。

{　}

この記号で囲まれている複数の項目のうちから1つを選択することを意味します。項目が横に並べられ，記号｜で区切られている場合は，そのうちの1つを選択します。

例

{A｜B}は，「Aと指定する」または「Bと指定する」ことを示します。

(　)

この記号で囲まれている複数の項目のうちから1つ以上を選択することを意味します。項目が横に並べられ，記号｜で区切られている場合は，そのうちの1つ以上を選択します。

例

(A｜B)は，「Aと指定する」，「Bと指定する」または「AおよびBと指定する」ことを示します。

[　]

この記号で囲まれている項目は省略してよいことを意味します。

例

[A]は「何も指定しない」か「Aを指定する」ことを示します。

操作の説明で使用する記号

操作の説明で使用する記号を次のように定義します。

記号

意味

［　］

次のどれかを示します。

ボタン

キーボードのキー

画面またはダイアログの名称

画面またはダイアログに表示される項目

［A］+［B］

+の前のキーを押したまま，後ろのキーを押すことを示します。

［AAA］−［BBB］

−の前に示したメニューから，−の後ろのメニューを選択することを示します。

このマニュアルで使用する注記

このマニュアルで使用する注記を次に示します。

重要

操作を完了させるための重要な情報を示します。

メモ

本文に対して強調したい内容または補足事項を示します。

ヒント

操作する上で効果的な情報，指針，提案を示します。

このマニュアルでの表記

このマニュアルで使用している表記と，対応する製品名を次に示します。

表記

製品名

AIX※

IBM AIX V7.1

Chrome

Google Chrome

Cosminexus

uCosminexus Application Server

CSCIW

uCosminexus Service Coordinator Interactive Workflow

Firefox

Mozilla Firefox

HiRDB

HiRDB Server Version 10

Linux※

Red Hat(R) Enterprise Linux(R) Server 7.1（64-bit x86_64）以降

Red Hat(R) Enterprise Linux(R) Server 8.1（64-bit x86_64）以降

ORACLE

Oracle(R) Database 19c

WorkCoordinator Definer

WorkCoordinator Definer Version 6

注※

AIXおよびLinuxの製品名称を特に区別する必要がない場合，UNIXと表記しています。

マイクロソフト製品の表記について

このマニュアルでは，マイクロソフト製品の名称を次のように表記しています。

表記

製品名

SQL Server

SQL Server 2005

Microsoft SQL Server 2005

SQL Server 2008

Microsoft SQL Server 2008

Microsoft SQL Server 2008 R2

SQL ServerのJDBCドライバ

Microsoft SQL Server 2005 JDBC Driver 1.1

Microsoft SQL Server 2005 JDBC Driver 1.2

Microsoft SQL Server JDBC Driver 2.0

Microsoft SQL Server JDBC Driver 3.0

Windows Server

Windows Server 2016

Microsoft Windows Server 2016 Standard 日本語版

Microsoft Windows Server 2016 Datacenter 日本語版

Windows Server 2019

Microsoft Windows Server 2019 Standard 日本語版

Microsoft Windows Server 2019 Datacenter 日本語版

Windows

Windows 10

Windows 10 Pro 日本語版(64ビット版)

Windows 10 Enterprise 日本語版(64ビット版)

Windows 11

Windows 11 Pro 日本語版

Windows 11 Enterprise 日本語版

Windows Server 2016，Windows Server 2019，Windows 10，およびWindows 11を特に区別する必要がない場合，Windowsと表記しています。

このマニュアルで使用している略語

このマニュアルで使用している英略語を次に示します。

英略語

英字での表記

BPMN

Business Process Modeling and Notation

GMT

Greenwich Mean Time

J2EE

Java 2 Platform, Enterprise Edition，およびJ2EE

Java

Java

JavaVM

Java Virtual Machine

JDBC

Java Database Connectivity，およびJDBC

JDK

Java Development Kit，およびJDK

REST

Representational State Transfer

UTF

UCS Transformation Format

このマニュアルで使用するKB（キロバイト）などの単位表記

1KB（キロバイト），1MB（メガバイト），1GB（ギガバイト），1TB（テラバイト）はそれぞれ1,024バイト，1,024²バイト，1,024³バイト，1,024⁴バイトです。

関連マニュアル

このマニュアルの関連マニュアルを次に示します。必要に応じてお読みください。

CSCIW関連

uCosminexus Service Coordinator Interactive Workflow システム構築・運用ガイド（3020-3-M80）

uCosminexus Service Coordinator Interactive Workflow AP開発ガイド（3020-3-M81）

uCosminexus Service Coordinator Interactive Workflow 案件運用操作ガイド（3020-3-M82）

uCosminexus Service Coordinator Interactive Workflow メッセージ（3020-3-M83）

uCosminexus Service Coordinator Interactive Workflow ビジネスプロセス開発ガイド（3020-3-M85）

uCosminexus Service Coordinator Interactive Workflow BPMN連携機能　使用の手引（3020-3-M86）

Cosminexus関連

Cosminexus V11 アプリケーションサーバ システム構築・運用ガイド（3021-3-J02）

Cosminexus V11 アプリケーションサーバ 機能解説 基本・開発編（Webコンテナ）（3021-3-J05）

Cosminexus V11 アプリケーションサーバ 機能解説 基本・開発編（EJBコンテナ）（3021-3-J06）

Cosminexus V11 アプリケーションサーバ 機能解説 基本・開発編（コンテナ共通機能）（3021-3-J07）

Cosminexus V11 アプリケーションサーバ 機能解説 拡張編（3021-3-J08）

Cosminexus V11 アプリケーションサーバ 機能解説 運用／監視／連携編（3021-3-J10）

Cosminexus V11 アプリケーションサーバ 機能解説 保守／移行編（3021-3-J11）

Cosminexus V11 アプリケーションサーバ 機能解説 互換編（3021-3-J12）

Cosminexus V11 アプリケーションサーバ アプリケーション設定操作ガイド（3021-3-J13）

Cosminexus V11 アプリケーションサーバ リファレンス コマンド編（3021-3-J15）

Cosminexus V11 アプリケーションサーバ リファレンス 定義編（サーバ定義）（3021-3-J16）

Cosminexus V11 アプリケーションサーバ リファレンス 定義編（アプリケーション／リソース定義）（3021-3-J17）

Cosminexus V11 アプリケーションサーバ アプリケーション開発ガイド（3021-3-J20）

Cosminexus V11 BPM/ESB基盤 サービスプラットフォーム システム構築・運用ガイド（3021-3-J45）

なお，このマニュアルでは，Cosminexus関連のマニュアルについて，バージョン番号を省略して表記しています。

HiRDB関連

HiRDB Version 10 解説（3020-6-551）

HiRDB Version 10 システム導入・設計ガイド（UNIX(R)用）（3020-6-552）

HiRDB Version 10 システム定義（UNIX(R)用）（3020-6-554）

HiRDB Version 10 システム運用ガイド（UNIX(R)用）（3020-6-556）

HiRDB Version 10 コマンドリファレンス（UNIX(R)用）（3020-6-558）

HiRDB Version 10 システム導入・設計ガイド（Windows(R)用）（3020-6-553）

HiRDB Version 10 システム定義（Windows(R)用）（3020-6-555）

HiRDB Version 10 システム運用ガイド（Windows(R)用）（3020-6-557）

HiRDB Version 10 コマンドリファレンス（Windows(R)用）（3020-6-559）

HiRDB Version 10 UAP開発ガイド（3020-6-560）

HiRDB Version 10 SQLリファレンス（3020-6-561）

HiRDB Version 10 メッセージ（3020-6-562）

なお，このマニュアルでは，HiRDB関連のマニュアルについて，バージョン番号を省略して表記しています。

適用OSの違いによる機能相違点の表記

このマニュアルで説明する機能は，適用OSの種類（UNIXまたはWindows）によって，異なる場合があります。OSによって機能差がある場合，OS名を明記しています。また，OSによってバージョン，リビジョンが異なる場合があります。バージョン，リビジョンによって操作方法などが異なる場合はそれぞれの説明にOS名，バージョン，およびリビジョンを明記しています。

なお，UNIXおよびWindowsの共通の説明部分に使用している「ディレクトリ」という用語は，Windows の場合は，特に断りのないかぎり，「フォルダ」に読み替えてください。また，UNIXのパスの区切り文字として使用している「/」は，Windowsの場合には，特に断りのないかぎり，「¥」に読み替えてください。

1　コマンドの概要

この章では，CSCIWで使用するコマンドの種類，入力形式，文法などの記述形式について説明します。

1.1　コマンドの種類

CSCIWの環境構築および運用で使用するコマンドの一覧を次の表に示します。

表1‒1　CSCIWで使用するコマンドの一覧

コマンド名

機能概要

コマンドの使用可否

既存機能（CSCIW-Definerおよび案件運用操作）の使用時

BPMN連携機能の使用時

ciwchgapwork

アプリケーション呼び出しサービスの作業の一覧を取得または更新します。

○

○

ciwchgdef

ビジネスプロセス定義の条件，生成ルール，および作業アプリケーションの定義の属性を変更します。

○

−

ciwchgenv

システム共通環境情報を変更します。

○

○

ciwcleanup

プロセス情報を正常化します。

○

○

ciwdelpi

案件を削除します。

○

○

ciweditbp

ビジネスプロセス定義を変更します。

○

○

ciwlistsid

システムIDの情報を表示します。

○

○

ciwmngap

アプリケーション呼び出し制御情報の一覧を取得または更新します。

○

○

ciwmngapgrp

アプリケーション呼び出しグループ定義の一覧を取得または更新します。

○

○

ciwmngbp

ビジネスプロセス定義を管理します。

○

○

ciwmngcr

振り分けルール定義を管理します。

○

○

ciwreuseid

IDを再利用します。

○

○

ciwsetenv

実行環境を構築，削除またはバージョンアップします。

○

○

ciwtransbpmn

BPMNビジネスプロセス定義ファイル（.bpmn）を，CSCIWで使用できるビジネスプロセス定義ファイル（.hbx）の形式に変換します。

−

○

（凡例）

○：コマンドを使用できます。

−：コマンドを使用できません。

1.2　コマンドの入力形式

コマンドの入力形式を次に示します。

コマンド名 引数 …

各項目について説明します。

コマンド名

実行するコマンドを指定します。

引数

引数を指定します。引数には，オプションも含まれます。

引数の入力形式には，オプション引数を指定する形式と，オプション引数を指定しない形式があります。

形式1（オプション引数を指定する場合）

cmd -sid SYS1

（凡例）

　cmd：コマンド

　-sid：オプション

　SYS1：オプション引数

形式2（オプション引数を指定しない場合）

cmd -h

（凡例）

　cmd：コマンド

　-h：オプション

オプション引数に値を指定するときの注意事項を次に示します。

●文字列を指定する場合の注意事項

「-」（半角ハイフン）で始まる半角英大文字と半角英小文字だけの文字列を指定するときは，「¥"」（半角円記号，半角ダブルクォーテーション）でオプション引数を囲んでください。

「-BPName」を-bpnオプションに指定する場合の例を次に示します。

例

-bpn ¥"-BPName¥"

オプションの引数の指定は，各OSのシェルの仕様に従ってください。

スペースを含む文字列を指定するときは，文字列を「"」（半角ダブルクォーテーション）で囲んでください。

「C:¥Program Files¥xxx」を-fileオプションに指定するときの例を次に示します。

例

　 -file "C:¥Program Files¥xxx"

「"」（半角ダブルクォーテーション）を含む文字列を指定するときは，「"」の直前に「¥」を挿入してください。

「BPName"001」を-bpnオプションに指定するときの例を次に示します。

例

　 -bpn BPName¥"001

UNIXで，「'」（半角シングルクォーテーション）を含む文字列を指定するときは，次のどちらかを実施してください。

「¥」を使用する場合

「'」（半角シングルクォーテーション）の直前に「¥」を挿入します。

「BPName'001」を-bpnオプションに指定するときの例を次に示します。

例

　 -bpn BPName¥'001

「"」（半角ダブルクォーテーション）を使用する場合

「'」（半角シングルクォーテーション）を含む文字列を「"」（半角ダブルクォーテーション）で囲みます。

「BPName'001」を-bpnオプションに指定するときの例を次に示します。

例

　 -bpn "BPName'001"

UNIXで，「¥」（バックスラッシュ）を含む文字列を指定するときは，次のどちらかを実施してください。

「¥」を使用する場合

「¥」（バックスラッシュ）の直前に¥（バックスラッシュ）を挿入します。

「PIName¥001」を-pinオプションに指定するときの例を次に示します。

例

　 -pin PIName¥¥001

「"」（半角ダブルクォーテーション）を使用する場合

「¥」（バックスラッシュ）を含む文字列を「"」（半角ダブルクォーテーション）で囲みます。

「PIName¥001」を-pinオプションに指定するときの例を次に示します。

例

　 -pin "PIName¥001"

●ファイル名およびディレクトリ名を指定する場合の注意事項

指定するファイル名およびディレクトリ名の規則は，OSの仕様に従ってください。

出力されるファイル名およびディレクトリ名のパスに含まれるディレクトリは，作成済みで，かつ書き込み権限が必要です。ただし，各コマンドのオプションや注意事項に規則が記載されている場合はその規則に従ってください。

1.3　コマンドの文法の記述形式

このマニュアルでは，コマンドの文法を次に示す形式を基本として説明します。なお，各コマンドは，アルファベットの順に説明します。

形式

コマンドの入力形式を示します。

機能

コマンドの機能を説明します。

実行条件

コマンドを実行するための条件を説明します。

引数

コマンドの引数およびオプションを説明します。

戻り値

コマンドの戻り値を説明します。

注意事項

コマンドを実行する上での注意事項を説明します。

注

すべてのコマンドで上記の項目をすべて説明しているわけではありません。また，上記以外に，各コマンドの固有情報を記載している場合があります。

1.4　コマンドの実行権限

ciwtransbpmnコマンド以外のコマンドは，使用するOSがWindowsの場合は管理者特権，UNIXの場合はroot権限で実行してください。

ciwtransbpmnコマンドの実行権限については，「2.14　ciwtransbpmn（BPMNビジネスプロセス定義ファイルのCSCIWのビジネスプロセス定義ファイルへの変換）」の「実行権限」の説明を参照してください。

UNIXでコマンドの実行権限を変更したい場合は，OSのコマンドや機能を使用して，実行権限のグループを変更できます。なお，実行権限のグループを変更する場合は，CSCIWの構築前に，CSCIWインストールディレクトリ以下のディレクトリおよびファイルを変更する必要があります。

コマンドの実行権限の変更方法は，マニュアル「uCosminexus Service Coordinator Interactive Workflow システム構築・運用ガイド」の業務プログラムの実行権限を設定する場合の注意事項について記載されている個所を参照してください。

1.5　コマンド共通のオプション

すべてのコマンドで使用できる共通のオプションについて説明します。

1.5.1　-fileオプション

形式

<コマンド名> -file <option_file_name> [-encoding <character_set>]

機能

コマンドのオプションおよびオプション引数をオプションファイルに記述し，そのオプションファイルを指定することで，コマンドを実行します。

このオプションは，OSでサポートしていない文字コードの文字列をオプション引数に指定する場合などに使用できます。例えば，Windowsのコマンドプロンプトは，UTF-8の文字列を入力できません。このオプションを使用すると，オプション引数に指定する名称などにUTF-8の文字列を入力できます。

引数

-file <option_file_name>

引数を記述したオプションファイル名を指定します。

指定したファイルに記述されたオプションおよびオプション引数に従って，コマンドが動作します。

-encoding <character_set>

-fileオプションで指定したファイルの文字コードを指定します。文字コードには，Javaでサポートされているエンコーディングの正準名を指定してください。

オプションファイルの記述形式

「#」から始まる行はコメントとして扱われます。

オプションまたはオプション引数は，半角スペースまたは改行で区切ります。

オプション引数に次に示す文字がある場合は，該当する文字列を「"」（半角ダブルクォーテーション）で囲んでください。

「"」（半角ダブルクォーテーション）

半角スペース

改行

「-」（ハイフン）から始まり，半角英大文字と半角英小文字だけの文字列

オプション引数に空文字列を指定する場合は，「""」（半角ダブルクォーテーションを2つ）を指定してください。

「"」（半角ダブルクォーテーション）で囲まれた中に，「#」から始まる行が含まれている場合，この行はコメントではなくなります。

「"」（半角ダブルクォーテーション）で囲まれていない，半角スペースまたは改行だけの行は，読み込み対象外となります。

オプションファイルの例

ファイル名：Option.txt

# この行はコメント行
-sid <システムID> -a "半角スペース を含む場合" -b "改行
を含む場合"
-c "二重引用符""を含む場合"
-d "データ部分
#この行はコメント行として扱われない"
-e "-Data"
-f ""

上記のオプションファイルを指定することは，次に示すオプションおよびオプション引数を指定することと同じです。

-sid <システムID>

-a <半角スペース を含む場合>

-b <改行改行コードを含む場合>（改行コードは，ファイルで使用されている改行コード）

-c <二重引用符"を含む場合>

-d <データ部分改行コード#この行はコメント行として扱われない>（改行コードは，ファイルで使用されている改行コード）

-e <-Data>（「-Data」は，-eオプションのオプション引数）

-f <空文字列>

注意事項

オプションファイルに-hオプションは指定できません。

-hオプションを指定した場合，エラー（パラメーター不正）になり，コマンドの形式は標準出力に表示されません。

オプションファイルに-fileオプションは指定できません。

-fileオプションを指定した場合，エラー（パラメーター不正）になり，オプションファイルの内容に従った動作は実行できません。

オプションファイルに記述がない場合，またはコメント行だけが記述されている場合は，コマンドの形式が標準出力に表示されます。

1.5.2　-hオプション

形式

<コマンド名> -h

機能

コマンドの形式を標準出力に表示します。

引数

-h

コマンドの形式を標準出力に表示する場合に指定します。

2　コマンドの詳細

この章では，CSCIWの環境構築および運用で使用するコマンドの形式，機能，実行条件などについて説明します。

2.1　ciwchgapwork（アプリケーション呼び出し作業の状態変更）

2.1.1　BPMN連携機能を使用する場合のciwchgapwork

形式

形式1（作業（タイマーイベントの作業を除く）の一覧を表示する場合）

ciwchgapwork -sid <system_id>
-list {-ope|-msg|-err}
[-ref <ref_identifier>]
[-bpn <process_definition_name>
[-bpv <process_definition_version>]]
[-s <work_item_state>]

形式2（タイマーイベントの作業の一覧を表示する場合）

ciwchgapwork -sid <system_id>
-list
-tim
[-bpn <process_definition_name>
[-bpv <process_definition_version>]]
[-s <work_item_state>]

形式3（作業の状態を変更する場合）

ciwchgapwork -sid <system_id>
-chg
-f <input_file>
-s <work_item_state>

形式4（オプションファイルを指定して実行する場合）※

ciwchgapwork -file <option_file_name>
[-encoding <character_set>]

形式5（コマンドの形式を表示する場合）※

ciwchgapwork -h

注※

すべてのコマンドで同じ形式で指定します。詳細は，「1.5　コマンド共通のオプション」を参照してください。

機能

アプリケーション呼び出しサービスの呼び出し対象となる作業の一覧を取得します。また，一覧取得した情報を基に作業の状態を変更します。

作業状態変更用入力ファイルフォーマット

作業の状態を変更する場合（形式3）の入力用ファイルのフォーマットを次に示します。

<案件ID>,<作業ID>

表2‒1　入力用ファイルの項目

項番

項目名

説明

1

案件ID

状態を変更させる作業が所属する案件のID

2

作業ID

状態を変更させる作業のID

データの区切り文字には，「,」（半角コンマ）を指定します。

<作業ID>の後ろに区切り文字がない場合，行末までの値が<作業ID>として扱われます。

<案件ID>，および<作業ID>に0～2,147,483,647以外の整数を指定した場合，エラーになります。

<案件ID>，および<作業ID>を指定していない場合，エラーになります。

<作業ID>から後ろの項目は読み込まれません。

<案件ID>と<作業ID>の前後に半角スペース，タブ文字が含まれていた場合は，それらを取り除いた値として扱われます。

次の行はコメント行として扱われるため，読み込まれません。

「#」から始まる行

「KDIW」から始まる行

改行だけの行

SQLを実行して入力用ファイルを作成する方法

入力用ファイルは，「作業状態変更用入力ファイルフォーマット」に従った内容であれば，コマンド以外の方法で作成したファイルが利用できます。SQLを利用して，ワーク管理データベースの情報から入力用ファイルを作成できます。

SQLを利用したファイル作成の実行例および実行結果例を次に示します。この例では，「作業者実行」状態の作業を入力用ファイルのフォーマットで出力しています。

実行例

SELECT PROCESSINSTANCEID ||','|| ID from <SYSTEMID>_WORK_ITEM WHERE STATECODE = 'f';

実行結果例

27,212                 (改行)
28,214                 (改行)
76,390                 (改行)
5003,10003             (改行)

出力結果に，コンマ以外の区切り文字や，囲み文字が出力されないようにしてください。

実行条件

このコマンドを実行できるコンポーネントの稼働状態を次に示します。

コンポーネント

稼働状態

起動中

停止中

CSCIWManagementServer

○

○

案件運用操作

○

○

CSCIWライブラリを使用した業務アプリケーション（J2EEアプリケーション）

○

○

CSCIWライブラリを使用した業務アプリケーション（Javaアプリケーション）

○

○

アプリケーション呼び出しサービス

○

○

RESTサービス

○

○

運用管理RESTサービス

○

○

同一マシンでの他のコマンド

×

○

異なるマシンでの同一コマンド

×

○

異なるマシンでの他のコマンド

×

○

DBMS

○

×

（凡例）

○：コマンドを実行できます。

×：コマンドを実行できません。

引数

-sid <system_id>

システムIDを指定します。指定したシステムIDに対応する作業の一覧取得と状態変更をします。

-list

指定された条件の作業の一覧を標準出力に表示する場合に指定します。

作業の一覧の表示フォーマットを次に示します。

#PIID,WIID,TYPE,REFID,PINAME,WDNAME,PDID,PDNAME,PDVR,CREATIONDATE,STATE,DEADLINE,STARTDATE
<案件ID>,<作業ID>,<種別>,<ref識別子>,<案件名>,<作業定義名>,<ビジネスプロセス定義ID>,<ビジネスプロセス定義名>,<ビジネスプロセス定義バージョン>,<発生日時>,<状態>,<処理期限>,<開始日時>

1行目にはヘッダ情報が表示され，2行目以降には各ヘッダ情報に対応する項目が表示されます。表示項目の意味とヘッダとの対応を次の表に示します。

表2‒2　表示項目（作業の一覧）

列番号

ヘッダ表記

2行目以降の表示内容

意味

1

PIID

案件ID

作業が所属する案件のIDです。

2

WIID

作業ID

作業のIDです。

3

TYPE

種別

作業が対応する，次のどれかのBPMN要素です。

msg：メッセージイベントの場合

ope：サービスタスクまたはビジネスルールタスクの場合

err：エラーイベントの場合

tim：タイマーイベントの場合

4

REFID

ref識別子

作業のref識別子です。タイマーイベントの場合は空文字です。

5

PINAME

案件名

作業が所属する案件の名称です。

6

WDNAME

作業定義名

作業が所属する作業定義の名称です。

7

PDID

ビジネスプロセス定義ID

作業が所属するビジネスプロセス定義のIDです。

8

PDNAME

ビジネスプロセス定義名

作業が所属するビジネスプロセス定義の名称です。

9

PDVR

ビジネスプロセス定義バージョン

作業が所属するビジネスプロセス定義のバージョンです。

10

CREATIONDATE

発生日時

作業の発生日時です。

11

STATE

状態

作業の状態です。

12

DEADLINE

処理期限

作業の処理期限です。

13

STARTDATE

開始日時

作業の開始日時です。

1行目のヘッダ情報は，行頭に「#」が書かれた状態（コメントアウトされた状態）で出力されます。

一覧表示の出力結果を，作業の状態変更（形式3）の入力ファイルとして使用できます。

値がnullの項目は空文字として出力されます。

発生日時，処理期限，および開始日時の項目については，「YYYY/MM/DD hh:mm:ss」の形式で出力されます。

作業の一覧表示の出力例（ciwchgapwork -sid CIW01 -list -ope -s PERFORMINGを指定した場合）を次に示します。

#PIID,WIID,TYPE,REFID,PINAME,WDNAME,PDID,PDNAME,PDVR,CREATIONDATE,STATE,DEADLINE,STARTDATE
1,1001,ope,ref01,Proc1,hoge_STask1,6,hogePD,1,2017/12/29 12:44:59,PERFORMING(f),,2017/12/29 12:54:59
1,1002,ope,ref02,Proc1,foo_STask2,6,hogePD,1,2017/12/29 10:00:00,PERFORMING(f),,2017/12/29 10:10:00
2,1003,ope,ref02,Proc3,foo_STask1,8,fugaPD,1,2017/12/29 10:05:00,PERFORMING(f),,2017/12/29 10:15:00
3,1004,ope,ref04,Proc4,bar_STask2,8,fugaPD,1,2017/12/28 12:00:00,PERFORMING(f),,2017/12/28 12:10:00

作業の一覧表示の出力例（ciwchgapwork -sid CIW01 -list -ope -s READYを指定した場合）を次に示します。

#PIID,WIID,TYPE,REFID,PINAME,WDNAME,PDID,PDNAME,PDVR,CREATIONDATE,STATE,DEADLINE,STARTDATE
4,1005,ope,ref01,Proc5,hoge,6,hogePD,1,2021/10/28 12:34:56,READY(j),,
5,1006,ope,ref02,Proc6,foo,8,fugaPD,1,2021/10/29 10:05:00,READY(j),2021/10/29 10:10:00,

-ope

サービスタスクまたはビジネスルールタスクの作業一覧を表示します。このオプションは-listオプションを指定した場合だけ指定できます。

-msg

メッセージイベントの作業一覧を表示します。このオプションは-listオプションを指定した場合だけ指定できます。

-err

エラーイベントの作業一覧を表示します。このオプションは-listオプションを指定した場合だけ指定できます。

-tim

タイマーイベントの作業一覧を表示します。このオプションは-listオプションを指定した場合だけ指定できます。

-ref <ref_identifier>

一覧表示する作業をref識別子で絞り込む場合に，ref識別子を指定します。このオプションを指定した場合，オプション引数に指定されたref識別子を作業者IDに持つ作業だけを表示します。ref識別子は完全一致で検索されます。

-bpn <process_definition_name>

一覧表示する作業をビジネスプロセス定義によって絞り込む場合に，ビジネスプロセス定義名を指定します。

指定するビジネスプロセス定義名の長さは，<SYSTEMID>_PROCESS_DEFテーブルのNameカラムのバイト数以内にしてください。

このオプションを指定した場合，オプション引数に指定されたビジネスプロセス定義名のビジネスプロセス定義に所属する作業だけを表示します。

-bpv <process_definition_version>

一覧表示する作業をビジネスプロセス定義バージョンによって絞り込む場合に，ビジネスプロセス定義バージョンを指定します。

指定できる値は，-32,768～32,767の整数です。ただし，有効な値は，ビジネスプロセス定義作成時に指定できる0～9,999の整数となります。

-bpnに指定されたビジネスプロセス定義名かつ-bpvに指定されたビジネスプロセス定義バージョンのビジネスプロセス定義に所属する作業だけを表示します。このオプションは-bpnオプションを指定した場合だけ指定できます。このオプションを省略した場合，-bpnで指定したビジネスプロセス定義名のすべてのバージョンが対象になります。

-s <work_item_state>

形式1または形式2の場合

一覧表示する作業の状態を指定します。

指定できる値と，それぞれの意味を次に示します。

READY：実行開始可能

PERFORMING：作業者実行

このオプションが省略された場合，またはオプション引数だけが省略された場合は，「PERFORMING」が指定されたものとして動作します。

形式3の場合

状態変更後の作業状態を指定します。

指定できる値と，それぞれの意味を次に示します。

READY：実行開始可能

PERFORMING：作業者実行

EXECUTED：実行済

現在の作業の状態と，形式3で指定できる-sに指定するオプション引数の組み合わせを次の表に示します。ただし，タイマーイベントの作業は「実行済」（EXECUTED）状態に変更できません。

表2‒3　オプション引数と作業状態の組み合わせ

項番

変更前の状態

-sに指定するオプション引数

変更後の状態

1

実行開始可能（READY）

PERFORMING

作業者実行（PERFORMING）

2

作業者実行（PERFORMING）

READY

実行開始可能（READY）

3

作業者実行（PERFORMING）

EXECUTED

実行済（EXECUTED）

4

実行開始可能（READY）

EXECUTED

実行済（EXECUTED）

-chg

対象作業の状態を変更する場合に指定します。-fのオプション引数で指定された入力ファイルの内容に従って，-sのオプション引数で指定された状態に作業状態を変更します。

-f <input_file>

案件IDと作業IDを記載した入力ファイルを指定します。入力ファイルには状態を変更させる作業を指定します。入力ファイルフォーマットの詳細は，「機能」の「作業状態変更用入力ファイルフォーマット」を参照してください。入力ファイルには，作業の一覧表示（形式1，または形式2）の出力結果をリダイレクトしたファイルを使用できます。

戻り値

項番

リターンコード

内容

1

0

正常終了

2

1

致命的なエラー

3

9※

実行権限エラー

4

10

条件に指定した作業が1件も存在しない

5

51

パラメーター不正

6

150

入力ファイルのアクセスエラー

7

254

異常終了

注※

Windowsの場合だけ発生します。

注意事項

タイマーイベントの作業は実行済（EXECUTED）に状態を変更できません。

作業の状態変更の実行結果に警告の件数が表示された場合は，警告メッセージを確認して，必要に応じて対処してください。

-chgオプションを指定して状態変更する場合，このコマンドの実行ユーザ名がユーザ記述子として設定されます。そのため，ユーザ名の長さは，<SYSTEMID>_PROCESS_INSTANCEテーブルのCreatorカラムのバイト数以内にしてください。

2.1.2　BPMN連携機能を使用しない場合のciwchgapwork

形式

形式1（作業の一覧を表示する場合）

ciwchgapwork -sid <system_id>
-list -ope
[-ref <ref_identifier>]
[-bpn <process_definition_name>
[-bpv <process_definition_version>]]
[-s <work_item_state>]

形式2（作業の状態を変更する場合）

ciwchgapwork -sid <system_id>
-chg
-f <input_file>
-s <work_item_state>

形式3（オプションファイルを指定して実行する場合）※

ciwchgapwork -file <option_file_name>
[-encoding <character_set>]

形式4（コマンドの形式を表示する場合）※

ciwchgapwork -h

注※

すべてのコマンドで同じ形式で指定します。詳細は，「1.5　コマンド共通のオプション」を参照してください。

機能

アプリケーション呼び出しサービスの呼び出し対象となる作業の一覧を取得します。また，一覧取得した情報を基に作業の状態を変更します。

作業状態変更用入力ファイルフォーマット

作業の状態を変更する場合（形式2）の入力用ファイルのフォーマットを次に示します。

<案件ID>,<作業ID>

表2‒4　入力用ファイルの項目

項番

項目名

説明

1

案件ID

状態を変更させる作業が所属する案件のID

2

作業ID

状態を変更させる作業のID

データの区切り文字には，「,」（半角コンマ）を指定します。

<作業ID>の後ろに区切り文字がない場合，行末までの値が<作業ID>として扱われます。

<案件ID>，および<作業ID>に0～2,147,483,647以外の整数を指定した場合，エラーになります。

<案件ID>，および<作業ID>を指定していない場合，エラーになります。

<作業ID>から後ろの項目は読み込まれません。

<案件ID>と<作業ID>の前後に半角スペース，タブ文字が含まれていた場合は，それらを取り除いた値として扱われます。

次の行はコメント行として扱われるため，読み込まれません。

「#」から始まる行

「KDIW」から始まる行

改行だけの行

SQLを実行して入力用ファイルを作成する方法

入力用ファイルは，「作業状態変更用入力ファイルフォーマット」に従った内容であれば，コマンド以外の方法で作成したファイルが利用できます。SQLを利用して，ワーク管理データベースの情報から入力用ファイルを作成できます。

SQLを利用したファイル作成の実行例および実行結果例を次に示します。この例では，「作業者実行」状態の作業を入力用ファイルのフォーマットで出力しています。

実行例

SELECT PROCESSINSTANCEID ||','|| ID from <SYSTEMID>_WORK_ITEM WHERE STATECODE = 'f';

実行結果例

27,212                 (改行)
28,214                 (改行)
76,390                 (改行)
5003,10003             (改行)

出力結果に，コンマ以外の区切り文字や，囲み文字が出力されないようにしてください。

実行条件

このコマンドを実行できるコンポーネントの稼働状態を次に示します。

コンポーネント

稼働状態

起動中

停止中

CSCIWManagementServer

○

○

案件運用操作

○

○

CSCIWライブラリを使用した業務アプリケーション（J2EEアプリケーション）

○

○

CSCIWライブラリを使用した業務アプリケーション（Javaアプリケーション）

○

○

アプリケーション呼び出しサービス

○

○

運用管理RESTサービス

○

○

同一マシンでの他のコマンド

×

○

異なるマシンでの同一コマンド

×

○

異なるマシンでの他のコマンド

×

○

DBMS

○

×

（凡例）

○：コマンドを実行できます。

×：コマンドを実行できません。

引数

-sid <system_id>

システムIDを指定します。指定したシステムIDに対応する作業の一覧取得と状態変更をします。

-list

指定された条件の作業の一覧を標準出力に表示する場合に指定します。

作業の一覧の表示フォーマットを次に示します。

#PIID,WIID,TYPE,REFID,PINAME,WDNAME,PDID,PDNAME,PDVR,CREATIONDATE,STATE,DEADLINE,STARTDATE
<案件ID>,<作業ID>,<種別>,<ref識別子>,<案件名>,<作業定義名>,<ビジネスプロセス定義ID>,<ビジネスプロセス定義名>,<ビジネスプロセス定義バージョン>,<発生日時>,<状態>,<処理期限>,<開始日時>

1行目にはヘッダ情報が表示され，2行目以降には各ヘッダ情報に対応する項目が表示されます。表示項目の意味とヘッダとの対応を次の表に示します。

表2‒5　表示項目（作業の一覧）

列番号

ヘッダ表記

2行目以降の表示内容

意味

1

PIID

案件ID

作業が所属する案件のIDです。

2

WIID

作業ID

作業のIDです。

3

TYPE

種別

次の種別です。

ope：RESTアプリケーション呼び出し

4

REFID

ref識別子

作業のref識別子です。

5

PINAME

案件名

作業が所属する案件の名称です。

6

WDNAME

作業定義名

作業が所属する作業定義の名称です。

7

PDID

ビジネスプロセス定義ID

作業が所属するビジネスプロセス定義のIDです。

8

PDNAME

ビジネスプロセス定義名

作業が所属するビジネスプロセス定義の名称です。

9

PDVR

ビジネスプロセス定義バージョン

作業が所属するビジネスプロセス定義のバージョンです。

10

CREATIONDATE

発生日時

作業の発生日時です。

11

STATE

状態

作業の状態です。

12

DEADLINE

処理期限

作業の処理期限です。

13

STARTDATE

開始日時

作業の開始日時です。

1行目のヘッダ情報は，行頭に「#」が書かれた状態（コメントアウトされた状態）で出力されます。

一覧表示の出力結果を，作業の状態変更（形式2）の入力ファイルとして使用できます。

値がnullの項目は空文字として出力されます。

発生日時，処理期限，および開始日時の項目については，「YYYY/MM/DD hh:mm:ss」の形式で出力されます。

作業の一覧表示の出力例（ciwchgapwork -sid CIW01 -list -ope -s PERFORMINGを指定した場合）を次に示します。

#PIID,WIID,TYPE,REFID,PINAME,WDNAME,PDID,PDNAME,PDVR,CREATIONDATE,STATE,DEADLINE,STARTDATE
1,1001,ope,ref01,Proc1,hoge1,6,hogePD,1,2017/12/29 12:44:59,PERFORMING(f),,2017/12/29 12:54:59
1,1002,ope,ref02,Proc1,foo2,6,hogePD,1,2017/12/29 10:00:00,PERFORMING(f),,2017/12/29 10:10:00
2,1003,ope,ref02,Proc3,foo1,8,fugaPD,1,2017/12/29 10:05:00,PERFORMING(f),,2017/12/29 10:15:00
3,1004,ope,ref04,Proc4,bar2,8,fugaPD,1,2017/12/28 12:00:00,PERFORMING(f),,2017/12/28 12:10:00

作業の一覧表示の出力例（ciwchgapwork -sid CIW01 -list -ope -s READYを指定した場合）を次に示します。

#PIID,WIID,TYPE,REFID,PINAME,WDNAME,PDID,PDNAME,PDVR,CREATIONDATE,STATE,DEADLINE,STARTDATE
4,1005,ope,ref01,Proc5,hoge,6,hogePD,1,2021/10/28 12:34:56,READY(j),,
5,1006,ope,ref02,Proc6,foo,8,fugaPD,1,2021/10/29 10:05:00,READY(j),2021/10/29 10:10:00,

-ope

RESTアプリケーション呼び出しを行う作業一覧を表示します。このオプションは-listオプションを指定した場合，必ず指定してください。

-ref <ref_identifier>

一覧表示する作業をref識別子で絞り込む場合に，ref識別子を指定します。このオプションを指定した場合，オプション引数に指定されたref識別子を作業者IDに持つ作業だけを表示します。ref識別子は完全一致で検索されます。

-bpn <process_definition_name>

一覧表示する作業をビジネスプロセス定義によって絞り込む場合に，ビジネスプロセス定義名を指定します。

指定するビジネスプロセス定義名の長さは，<SYSTEMID>_PROCESS_DEFテーブルのNameカラムのバイト数以内にしてください。

このオプションを指定した場合，オプション引数に指定されたビジネスプロセス定義名のビジネスプロセス定義に所属する作業だけを表示します。

-bpv <process_definition_version>

一覧表示する作業をビジネスプロセス定義バージョンによって絞り込む場合に，ビジネスプロセス定義バージョンを指定します。

指定できる値は，-32,768～32,767の整数です。ただし，有効な値は，ビジネスプロセス定義作成時に指定できる0～9,999の整数となります。

-bpnに指定されたビジネスプロセス定義名かつ-bpvに指定されたビジネスプロセス定義バージョンのビジネスプロセス定義に所属する作業だけを表示します。このオプションは-bpnオプションを指定した場合だけ指定できます。このオプションを省略した場合，-bpnで指定したビジネスプロセス定義名のすべてのバージョンが対象になります。

-s <work_item_state>

形式1の場合

一覧表示する作業の状態を指定します。

指定できる値と，それぞれの意味を次に示します。

READY：実行開始可能

PERFORMING：作業者実行

このオプションが省略された場合，またはオプション引数だけが省略された場合は，「PERFORMING」が指定されたものとして動作します。

形式2の場合

状態変更後の作業状態を指定します。

指定できる値と，それぞれの意味を次に示します。

READY：実行開始可能

PERFORMING：作業者実行

EXECUTED：実行済

現在の作業の状態と，形式2で指定できる-sに指定するオプション引数の組み合わせを次の表に示します。

表2‒6　オプション引数と作業状態の組み合わせ

項番

変更前の状態

-sに指定するオプション引数

変更後の状態

1

実行開始可能（READY）

PERFORMING

作業者実行（PERFORMING）

2

作業者実行（PERFORMING）

READY

実行開始可能（READY）

3

作業者実行（PERFORMING）

EXECUTED

実行済（EXECUTED）

4

実行開始可能（READY）

EXECUTED

実行済（EXECUTED）

-chg

対象作業の状態を変更する場合に指定します。-fのオプション引数で指定された入力ファイルの内容に従って，-sのオプション引数で指定された状態に作業状態を変更します。

-f <input_file>

案件IDと作業IDを記載した入力ファイルを指定します。入力ファイルには状態を変更させる作業を指定します。入力ファイルフォーマットの詳細は，「機能」の「作業状態変更用入力ファイルフォーマット」を参照してください。入力ファイルには，作業の一覧表示（形式1）の出力結果をリダイレクトしたファイルを使用できます。

戻り値

項番

リターンコード

内容

1

0

正常終了

2

1

致命的なエラー

3

9※

実行権限エラー

4

10

条件に指定した作業が1件も存在しない

5

51

パラメーター不正

6

150

入力ファイルのアクセスエラー

7

254

異常終了

注※

Windowsの場合だけ発生します。

注意事項

作業の状態変更の実行結果に警告の件数が表示された場合は，警告メッセージを確認して，必要に応じて対処してください。

-chgオプションを指定して状態変更する場合，このコマンドの実行ユーザ名がユーザ記述子として設定されます。そのため，ユーザ名の長さは，<SYSTEMID>_PROCESS_INSTANCEテーブルのCreatorカラムのバイト数以内にしてください。

2.2　ciwchgdef（条件，生成ルール，および作業アプリケーションの変更）

形式

形式1（条件を変更する場合）

ciwchgdef -sid <system_id>
-bpn <process_definition_name>
[-bpv <process_definition_version>]
-chg -cdn <condition_name>
{(-sql <sql_file>
|-not {0|1})
|(-cln <class_name>
|{-pf <parameter_file>
|-pn})}
[-encoding <character_set>]

形式2（生成ルールを変更する場合）

ciwchgdef -sid <system_id>
-bpn <process_definition_name>
[-bpv <process_definition_version>]
-chg -crrn <rule_name>
{-sql <sql_file>
|(-cln <class_name>
|{-pf <parameter_file>
|-pn})}
[-encoding <character_set>]

形式3（作業アプリケーションを変更する場合）

ciwchgdef -sid <system_id>
-bpn <process_definition_name>
[-bpv <process_definition_version>]
-chg -apn <application_name>
{(-cln <class_name>
|{-pf <parameter_file>
|-pn})
|-rri <ref_identifier>}
[-encoding <character_set>]

形式4（定義情報を表示する場合）

ciwchgdef -sid <system_id>
-bpn <process_definition_name>
[-bpv <process_definition_version>]
-list {-cdn <condition_name>
|-crrn <rule_name>
|-apn <application_name>}

形式5（オプションファイルを指定して実行する場合）※

ciwchgdef -file <option_file_name>
[-encoding <character_set>]

形式6（コマンドの形式を表示する場合）※

ciwchgdef -h

注※

すべてのコマンドで同じ形式で指定します。詳細は，「1.5　コマンド共通のオプション」を参照してください。

機能

登録してあるビジネスプロセス定義をバージョンアップしないで，次の定義の属性を変更します。

条件

生成ルール

作業アプリケーション

このコマンドは，ビジネスプロセス定義の中にすでに存在する条件，生成ルール，および作業アプリケーションの属性を変更します。条件，生成ルール，および作業アプリケーションの追加や削除はできません。

各定義で変更できる属性について，条件，生成ルール，および作業アプリケーションごとに表に示します。

表2‒7　ciwchgdefコマンドで変更できる属性一覧（条件）

変更対象

属性

条件

オプション

備考

RDB検索

Java呼出

共通

定義名

×

×

−

−

種別

×

×

−

条件，生成ルール，および作業アプリケーションの種別

説明

×

×

−

−

Javaオブジェクト呼出

補助定数パラメタ

−

○

-pf

-pn

ある場合：ファイルで指定

ない場合：オプションで指定

クラス名

−

○

-cln

オプションで指定

RDB検索

SQL文

○

−

-sql

ファイルで指定

NOT指定値

○

−

-not

オプションで指定

（凡例）

○：属性を変更できます。

×：属性を変更できません。

−：該当しません。

表2‒8　ciwchgdefコマンドで変更できる属性一覧（生成ルール）

変更対象

属性

生成ルール

オプション

備考

RDB検索

Java呼出

共通

定義名

×

×

−

−

種別

×

×

−

条件，生成ルール，および作業アプリケーションの種別

説明

×

×

−

−

Javaオブジェクト呼出

補助定数パラメタ

−

○

-pf

-pn

ある場合：ファイルで指定

ない場合：オプションで指定

クラス名

−

○

-cln

オプションで指定

RDB検索

SQL文

○

−

-sql

ファイルで指定

（凡例）

○：属性を変更できます。

×：属性を変更できません。

−：該当しません。

表2‒9　ciwchgdefコマンドで変更できる属性一覧（作業アプリケーション）

変更対象

属性

作業アプリケーション

オプション

備考

Java呼出

REST呼出

共通

定義名

×

×

−

−

種別

×

×

−

条件，生成ルール，および作業アプリケーションの種別

説明

×

×

−

−

Javaオブジェクト呼出

補助定数パラメタ

○

−

-pf

-pn

ある場合：ファイルで指定

ない場合：オプションで指定

クラス名

○

−

-cln

オプションで指定

RESTアプリケーション呼出

ref識別子

−

○

-rri

オプションで指定

（凡例）

○：属性を変更できます。

×：属性を変更できません。

−：該当しません。

実行条件

このコマンドを実行できるコンポーネントの稼働状態を次に示します。

コンポーネント

稼働状態

起動中

停止中

CSCIWManagementServer

×※

○

案件運用操作

○

○

CSCIWライブラリを使用した業務アプリケーション（J2EEアプリケーション）

○

○

CSCIWライブラリを使用した業務アプリケーション（Javaアプリケーション）

×※

○

アプリケーション呼び出しサービス

○

○

RESTサービス

○

○

運用管理RESTサービス

○

○

同一マシンでのほかのコマンド

×

○

異なるマシンでの同一コマンド

×

○

異なるマシンでのほかのコマンド

×

○

DBMS

○

×

（凡例）

○：コマンドを実行できます。

×：コマンドを実行できません。

注※

定義情報を表示する場合は，コンポーネントが起動中でも実行できます。

また，条件，生成ルール，または作業アプリケーションの変更の場合は，コンポーネントが起動中でもコマンドを実行できます。ただし，コマンド実行後は変更を反映するためにコンポーネントを再起動してください。

引数

-sid <system_id>

環境構築時に設定したシステムIDを指定します。指定したシステムIDに対応するワーク管理システム上のビジネスプロセス定義が対象になります。

指定できる値は，半角英大文字と半角数字で5文字以内です。ただし，先頭には半角英大文字を指定してください。

-bpn <process_definition_name>

属性変更の対象となるビジネスプロセス定義名を指定します。

-bpv <process_definition_version>

属性変更の対象となるビジネスプロセス定義のバージョンを指定します。このオプションを省略した場合は，指定したビジネスプロセス定義名のすべてのバージョンが対象になります。

-chg

条件，生成ルール，および作業アプリケーションの属性を変更する場合に指定します。

-cdn <condition_name>

条件の属性を変更または表示する場合，対象の条件の定義名を指定します。

-crrn <rule_name>

生成ルールの属性を変更または表示する場合，対象の生成ルールの定義名を指定します。

-apn <application_name>

作業アプリケーションの属性を変更または表示する場合，対象の作業アプリケーションの定義名を指定します。

-sql <sql_file>

条件や生成ルールの種別がRDB検索で，かつSQL文を変更する場合に，変更後のSQL文を記述したファイル名を指定します。SQL文は，次のカラムのバイト数以内で記述してください。

条件（RDB検索）の場合

<SYSTEMID>_CONDITION_SQL_DEFテーブルのContentカラム

生成ルール（RDB検索）の場合

<SYSTEMID>_CREATIONRULE_SQL_DEFテーブルのContentカラム

-not {0｜1}

条件の種別がRDB検索の場合に，TrueまたはFalseの結果を反対にするかどうかを指定します。このオプションに指定できる値は，0または1です。結果を反対にしない場合は0を，反対する場合は1を指定します。

-cln <class_name>

条件，生成ルール，または作業アプリケーションの種別がJavaオブジェクト呼び出しの場合に，変更するJavaクラス名を指定します。クラス名はパッケージ名を含めて指定してください。Javaクラス名は，次のカラムのバイト数以内で指定してください。

条件（Javaオブジェクト呼び出し）の場合

<SYSTEMID>_CONDITION_JAVA_DEFテーブルのClassNameカラム

生成ルール（Javaオブジェクト呼び出し）の場合

<SYSTEMID>_CREATIONRULE_JAVA_DEFテーブルのClassNameカラム

作業アプリケーション（Javaオブジェクト呼び出し）の場合

<SYSTEMID>_APPLICATION_JAVA_DEFテーブルのClassNameカラム

-pf <parameter_file>

補助定数パラメタを変更する場合に，補助定数パラメタを記述したファイル名を指定します。ファイルの補助定数パラメタは，次のカラムのバイト数以内で記述してください。

条件（Javaオブジェクト呼び出し）の場合

<SYSTEMID>_CONDITION_JAVA_DEFテーブルのExParameterカラム

生成ルール（Javaオブジェクト呼び出し）の場合

<SYSTEMID>_CREATIONRULE_JAVA_DEFテーブルのExParameterカラム

作業アプリケーション（Javaオブジェクト呼び出し）の場合

<SYSTEMID>_APPLICATION_DEFテーブルのApplicationParamカラム

-pn

補助定数パラメタをパラメタなしに変更する場合に指定します。

-rri <ref_identifier>

作業アプリケーションの種別がRESTアプリケーション呼び出しの場合に，変更するref識別子を指定します。指定できる値は，半角英数字と「_」（アンダースコア）で，（<SYSTEMID>_APPLICATION_LOCK_INFOテーブルのLockNameカラムのバイト数 - 7）バイト以内です。

-list

条件，生成ルール，および作業アプリケーションの属性を表示します。このオプションを指定した場合に表示される属性を，条件，生成ルール，および作業アプリケーションごとに表に示します。

表2‒10　ciwchgdefコマンドで表示される属性一覧（条件）

表示対象

表示属性

条件

備考

属性

表示される属性名

RDB検索

Java呼出

共通

ビジネスプロセス定義名

Process Definition Name

○

○

−

ビジネスプロセス定義バージョン

Process Definition Version

○

○

−

定義種別

Definition Type

○

○

Conditionが表示される。

定義名

Name

○

○

−

条件の種別

Type

○

○

次のどちらかが表示される。

SQL

Java

説明

Description

○

○

−

Javaオブジェクト呼出

補助定数パラメタ

Parameter

×

○

−

クラス名

Class Name

×

○

−

RDB検索

SQL文

SQL

○

×

−

NOTフラグ

Not Flag

○

×

次のどちらかが表示される。

true

false

（凡例）

○：表示されます。

×：表示されません。

−：ありません。

表2‒11　ciwchgdefコマンドで表示される属性一覧（生成ルール）

表示対象

表示属性

生成ルール

備考

属性

表示される属性名

RDB検索

Java呼出

共通

ビジネスプロセス定義名

Process Definition Name

○

○

−

ビジネスプロセス定義バージョン

Process Definition Version

○

○

−

定義種別

Definition Type

○

○

CreationRuleが表示される。

定義名

Name

○

○

−

生成ルールの種別

Type

○

○

次のどちらかが表示される。

SQL

Java

説明

Description

○

○

−

Javaオブジェクト呼出

補助定数パラメタ

Parameter

×

○

−

クラス名

Class Name

×

○

−

RDB検索

SQL文

SQL

○

×

−

（凡例）

○：表示されます。

×：表示されません。

−：ありません。

表2‒12　ciwchgdefコマンドで表示される属性一覧（作業アプリケーション）

表示対象

表示属性

作業アプリケーション

備考

属性

表示される属性名

Java呼出

REST呼出

共通

ビジネスプロセス定義名

Process Definition Name

○

○

−

ビジネスプロセス定義バージョン

Process Definition Version

○

○

−

定義種別

Definition Type

○

○

Applicationが表示される。

定義名

Name

○

○

−

作業アプリケーションの種別

Type

○

○

次のどちらかが表示される。

Java

REST

説明

Description

○

○

−

Javaオブジェクト呼出

補助定数パラメタ

Parameter

○

×

−

クラス名

Class Name

○

×

−

RESTアプリケーション呼出

ref識別子

Ref Identifier

×

○

−

（凡例）

○：表示されます。

×：表示されません。

−：ありません。

条件，生成ルール，および作業アプリケーションの属性の表示例を次に示します。

ビジネスプロセス定義バージョンを指定して，条件（RDB検索）を表示した場合

Process Definition Name:TESTBP
Process Definition Version:1
Definition Type:Condition
Name:COND1
Type:SQL
Description:RDB検索の条件です。
SQL:select * from CONDTBL where PINAME='@PIName'
Not Flag:false

ビジネスプロセス定義バージョンを指定しないで，生成ルール（RDB検索，Javaオブジェクト呼び出し）を表示した場合

Process Definition Name:TESTBP
Process Definition Version:1
Definition Type:CreationRule
Name:CRRULE1
Type:Java
Description:Java呼び出しの生成ルールです。
Parameter:DATA1,DATA2
Class Name:jp.co.Hitachi.soft.XXX.CreationRule1

Process Definition Name:TESTBP
Process Definition Version:2
Definition Type:CreationRule
Name:CRRULE1
Type:SQL
Description:RDB検索の生成ルールです。
SQL:select * from RULETBL where PINAME='@PIName'

ビジネスプロセス定義バージョンを指定しないで，作業アプリケーション（Java呼び出し，対象の作業アプリケーションなし）を表示した場合

Process Definition Name:TESTBP
Process Definition Version:1
Definition Type:Application
Name:AP1
Type:Java
Description:Java呼び出しの作業アプリケーションです。
Parameter:DATA1,DATA2
Class Name:co.jp.hitachi.soft.IR1

KDIW22606-W The target work application name is missing. work-application-name = AP1, process-definition-name = TESTBP, process-definition-version = 2

ビジネスプロセス定義バージョンを指定して，作業アプリケーション（RESTアプリケーション呼び出し）を表示した場合

Process Definition Name:TESTBP
Process Definition Version:1
Definition Type:Application
Name:AP1
Type:REST
Description:RESTアプリケーション呼び出しの作業アプリケーションです。
Ref Identifier:ref001

-file <option_file_name>

このオプションはすべてのコマンドで指定できます。詳細は，「1.5.1　-fileオプション」を参照してください。

-encoding <character_set>

このオプションはすべてのコマンドで指定できます。

ただし，このコマンドで実行する場合，条件，生成ルール，または作業アプリケーションの変更のときは，-sqlオプションや-pfオプションで指定したファイルの文字コードを指定します。オプションファイルを指定して実行するときは，-fileオプションで指定したオプションファイルの文字コードを指定します。

文字コードには，Javaでサポートされているエンコーディングの正準名を指定してください。省略した場合は，Javaのデフォルトの文字コードが使用されます。

-h

このオプションはすべてのコマンドで指定できます。詳細は，「1.5.2　-hオプション」を参照してください。

戻り値

戻り値

内容

0

正常終了

1

致命的なエラー

9※

実行権限エラー

51

パラメーター不正

110

定義登録ユーザ名の不正

150

ファイルアクセスエラー

254

異常終了

注※

Windowsの場合だけ発生します。

注意事項

ビジネスプロセス定義を変更する場合，このコマンドの実行ユーザ名がビジネスプロセス定義の作成者として登録されます。このため，ユーザ名の長さは，<SYSTEMID>_PROCESS_DEFテーブルのAuthorカラムのバイト数以内にしてください。

RESTアプリケーション呼び出しの作業アプリケーションの変更は，生成済みの作業には反映されません。

2.3　ciwchgenv（システム共通環境情報の変更）

形式

形式1（システム共通環境情報を変更する場合）

ciwchgenv -sid <system_id>
(-pic <piid_reservecount>
｜-aic <aiid_reservecount>
｜-wic <wiid_reservecount>
｜-cic <cnid_reservecount>
｜-dbc <db_character_name>
｜-ec <error_passingcount>)

形式2（システム共通環境情報の一覧を出力する場合）

ciwchgenv -sid <system_id>
[-list]

形式3（オプションファイルを指定して実行する場合）※

ciwchgenv -file <option_file_name>
[-encoding <character_set>]

形式4（コマンドの形式を表示する場合）※

ciwchgenv -h

注※

すべてのコマンドで同じ形式で指定します。詳細は，「1.5　コマンド共通のオプション」を参照してください。

機能

システム共通環境情報を変更します。

このコマンドは，環境構築時に設定したシステム共通環境情報のデフォルト値を変更する場合に実行します。システム共通環境情報のデフォルト値でCSCIWを運用するときは，このコマンドを実行する必要はありません。なお，システム共通環境情報のデフォルト値は，ciwsetenvコマンドを実行したときに自動的に設定されます。ciwsetenvコマンドの詳細は，「2.13　ciwsetenv（環境の構築または削除）」を参照してください。

このコマンドで変更できるシステム共通環境情報を次に示します。

案件IDのキャッシュするID範囲

業務ステップIDのキャッシュするID範囲

作業IDのキャッシュするID範囲

制御ノードIDのキャッシュするID範囲

CSCIWが使用するDBMSの文字セットに対応した，Javaでサポートされているエンコーディングの正準名

同一ルート通過エラー回数

実行条件

このコマンドを実行できるコンポーネントの稼働状態を次に示します。

コンポーネント

稼働状態

起動中

停止中

CSCIWManagementServer

×※

○

案件運用操作

×※

○

CSCIWライブラリを使用した業務アプリケーション（J2EEアプリケーション）

×※

○

CSCIWライブラリを使用した業務アプリケーション（Javaアプリケーション）

×※

○

アプリケーション呼び出しサービス

×※

○

RESTサービス

×※

○

運用管理RESTサービス

×※

○

同一マシンでのほかのコマンド

×

○

異なるマシンでの同一コマンド

×

○

異なるマシンでのほかのコマンド

×

○

DBMS

○

×

（凡例）

○：コマンドを実行できます。

×：コマンドを実行できません。

注※

-listオプション指定時は，起動中でもコマンドを実行できます。

引数

-sid <system_id>

環境構築時に設定したシステムIDを指定します。指定したシステムIDに対応するシステム共通環境情報が対象になります。

指定できる値は，半角英大文字と半角数字で5文字以内です。ただし，先頭には半角英大文字を指定してください。

-pic <piid_reservecount>

案件IDのキャッシュするID範囲を指定します。この値は，案件IDを採番するためにメモリ上にキャッシュするIDの範囲になります。

指定できる値は，3,000〜100,000の整数です。なお，環境構築時のデフォルト値は5,000です。

-aic <aiid_reservecount>

業務ステップIDのキャッシュするID範囲を指定します。この値は，業務ステップIDを採番するためにメモリ上にキャッシュするIDの範囲になります。

指定できる値は3,000〜100,000の整数です。なお，環境構築時のデフォルト値は10,000です。

-wic <wiid_reservecount>

作業IDのキャッシュするID範囲を指定します。この値は，作業IDを採番するためにメモリ上にキャッシュするIDの範囲になります。

指定できる値は3,000〜100,000の整数です。なお，環境構築時のデフォルト値は10,000です。

-cic <cnid_reservecount>

制御ノードIDのキャッシュするID範囲を指定します。この値は，制御ノードIDを採番するためにメモリ上にキャッシュするIDの範囲になります。

指定できる値は3,000〜100,000の整数です。なお，環境構築時のデフォルト値は5,000です。

-dbc <db_character_name>

CSCIWが使用するDBMSの文字セットに対応した，Javaでサポートされているエンコーディングの正準名を指定します。

例

「UTF8」：UTF-8の場合

「MS932」：Shift-JISの場合でプラットフォームがWindowsの場合

「SJIS」：Shift-JISの場合でプラットフォームがUNIXの場合

なお，環境構築時のデフォルト値については，システム共通環境情報の一覧を表示して確認してください。

-ec <error_passingcount>

同一ルート通過エラー回数を指定します。このオプションを指定することによって，後続停止なしの先着ノードに発生する無限ループを防げます。

指定できる値は1〜1,000の整数です。なお，環境構築時のデフォルト値は50です。

無限ループは，先着ノードに続く業務ステップまたは制御ノードからこの先着ノードに戻るようなビジネスプロセス定義によって発生することがあります。

-list

システム共通環境情報の一覧を標準出力に表示する場合に指定します。

システム共通環境情報の表示フォーマットを次に示します。

-- System common environment information --
PIIDReserveCount : 5000
AIIDReserveCount : 10000
WIIDReserveCount : 10000
CNIDReserveCount : 5000
DBCharacterName : SJIS
ErrorPassingCount : 50

表示項目の意味を次の表に示します。

表2‒13　表示項目（システム共通環境情報）

表示項目

意味

PIIDReserveCount

案件IDのキャッシュするID範囲

AIIDReserveCount

業務ステップIDのキャッシュするID範囲

WIIDReserveCount

作業IDのキャッシュするID範囲

CNIDReserveCount

制御ノードIDのキャッシュするID範囲

DBCharacterName

CSCIWが使用するDBMSの文字セットに対応した，Javaでサポートされているエンコーディングの正準名

ErrorPassingCount

同一ルート通過エラー回数

-file <option_file_name>

このオプションはすべてのコマンドで指定できます。詳細は，「1.5.1　-fileオプション」を参照してください。

-encoding <character_set>

このオプションはすべてのコマンドで指定できます。詳細は，「1.5.1　-fileオプション」を参照してください。

-h

このオプションはすべてのコマンドで指定できます。詳細は，「1.5.2　-hオプション」を参照してください。

戻り値

戻り値

内容

0

正常終了

1

致命的なエラー

9※

実行権限エラー

51

パラメーター不正

254

異常終了

注※

Windowsの場合だけ発生します。

2.4　ciwcleanup（プロセス情報の正常化）

形式

形式1（プロセス情報を正常な状態にする場合）

ciwcleanup -sid <system_id>
[-del]

形式2（オプションファイルを指定して実行する場合）※

ciwcleanup -file <option_file_name>
[-encoding <character_set>]

形式3（コマンドの形式を表示する場合）※

ciwcleanup -h

注※

すべてのコマンドで同じ形式で指定します。詳細は，「1.5　コマンド共通のオプション」を参照してください。

機能

異常終了したCSCIWプロセス※の情報を正常な状態にします。

このコマンドは障害が発生した場合の対処として使用します。

障害が発生してCSCIWプロセスが異常終了すると，CSCIWプロセス情報（CSCIWの持つ内部状態）が更新されないで，実際のプロセス状態と不一致になることがあります。不一致な状態を解消するには，このコマンドを実行し，CSCIWプロセス情報を正常な状態にする必要があります。

このコマンドを実行すると，コマンドを実行したマシン上のCSCIWプロセスのプロセス情報だけが正常な状態になります。

注※

CSCIWManagementServer，案件運用操作，CSCIWライブラリを使用した業務アプリケーション，およびCSCIWコマンドが含まれます。

実行条件

このコマンドを実行できるコンポーネントの稼働状態を次に示します。

コンポーネント

稼働状態

起動中

停止中

CSCIWManagementServer

○

○

案件運用操作

○

○

CSCIWライブラリを使用した業務アプリケーション（J2EEアプリケーション）

○

○

CSCIWライブラリを使用した業務アプリケーション（Javaアプリケーション）

○

○

アプリケーション呼び出しサービス

○

○

RESTサービス

○

○

運用管理RESTサービス

○

○

同一マシンでのほかのコマンド

○

○

異なるマシンでの同一コマンド

○

○

異なるマシンでのほかのコマンド

○

○

DBMS

○

×

（凡例）

○：コマンドを実行できます。

×：コマンドを実行できません。

引数

-sid <system_id>

環境構築時に設定したシステムIDを指定します。指定したシステムIDに対応するワーク管理システム上のプロセス情報が対象になります。

システムIDには，自マシン上に環境構築したシステムIDを指定してください。指定できる値は半角英大文字と半角数字で5文字以内です。ただし，先頭は，半角英大文字を指定してください。

-del

正常な状態にしたプロセス情報および「停止」状態のプロセス情報をDBMS上から削除する場合に指定します。

このオプションは，-sオプションを指定したciwlistsidを実行し，「NAME」が「MngSrv」または「JavaAP」で，かつ「STATUS」が「Stopped」のまま変化しないプロセス情報が表示された場合に指定してください。ciwlistsidコマンドの詳細は，「2.7　ciwlistsid（システムID情報の表示）」を参照してください。

このオプションを指定しないと，正常な状態にしたプロセス情報は「停止」状態となり，削除されません。多くのプロセスを同時に起動した場合，「停止」状態のまま変化しないプロセス情報が多量に残り，プロセスの起動性能に影響を与えることがあります。

-file <option_file_name>

このオプションは，すべてのコマンドで指定できます。詳細は，「1.5.1　-fileオプション」を参照してください。

-encoding <character_set>

このオプションは，すべてのコマンドで指定できます。詳細は，「1.5.1　-fileオプション」を参照してください。

-h

このオプションは，すべてのコマンドで指定できます。詳細は，「1.5.2　-hオプション」を参照してください。

戻り値

戻り値

内容

0

正常終了

1

致命的なエラー

9※

実行権限エラー

51

パラメーター不正

254

異常終了

注※

Windowsの場合だけ発生します。

注意事項

異常終了したプロセス情報を正常な状態にするには，異常終了したプロセスが実行されたマシンで，このコマンドを実行する必要があります。ほかのマシンで実行した場合，そのプロセス情報は正常な状態になりません。

2.5　ciwdelpi（案件の削除）

形式

形式1（案件終了後の経過日数を指定して案件を削除する場合）

ciwdelpi -sid <system_id>
-dfc <elapsed_days>
[-ofs]
[-all]
[-bpn <process_definition_name>[-bpv <process_definition_version>]]
[-pin [<process_instance_name>][-esc <escape_character>]]
[-onl]
[-unt [<processing_unit>]]
[-vi]

形式2（案件開始後の経過日数を指定して案件を削除する場合）

ciwdelpi -sid <system_id>
-dfs <elapsed_days>
[-ofs]
[-all]
[-bpn <process_definition_name> [-bpv <process_definition_version>]]
[-pin [<process_instance_name>] [-esc <escape_character>]]
[-unt [<processing_unit>]]
[-vi]

形式3（案件IDリスト指定ファイルを指定して案件を削除する場合）

ciwdelpi -sid <system_id>
-pidfile <process_instance_id_file_name>
[-all]
[-unt [<processing_unit>]]
[-vi]

形式4（オプションファイルを指定して実行する場合）※

ciwdelpi -file <option_file_name>
[-encoding <character_set>]

形式5（コマンドの形式を表示する場合）※

ciwdelpi -h

注※

すべてのコマンドで同じ形式で指定します。詳細は，「1.5　コマンド共通のオプション」を参照してください。

機能

案件削除コマンドは，シンクノードに到達，または強制終了し不要となった案件や未処理の案件を一括で削除します。

削除対象の案件は，次に示す条件でフィルタリングできます。

案件の所属するビジネスプロセス定義の属性情報

案件の属性情報

特定の日時からの経過日数

また，案件IDを設定したファイルを使用すると，ファイルに設定した案件IDの案件を削除できます。

CSCIW 02-10以降では，BPMN連携機能のテーブルの案件データについても削除します。

また，コールアクティビティの呼び出しによって，案件に親子関係が発生します。親子関係にある案件の削除をする場合，次のルールに従って，案件を削除します。

ルート案件を指定した場合，ルート案件とその子案件（子案件の子案件を含む）をすべて削除する

ルート案件以外の案件を指定した場合，指定した案件を削除しない

実行条件

このコマンドを実行できるコンポーネントの稼働状態を次に示します。

コンポーネント

稼働状態

起動中

停止中

CSCIWManagementServer

×※

○

案件運用操作

×※

○

CSCIWライブラリを使用した業務アプリケーション（J2EEアプリケーション）

×※

○

CSCIWライブラリを使用した業務アプリケーション（Javaアプリケーション）

×※

○

アプリケーション呼び出しサービス

×※

○

RESTサービス

×※

○

運用管理RESTサービス

×※

○

同一マシンでのほかのコマンド

×

○

異なるマシンでの同一コマンド

○

○

異なるマシンでのほかのコマンド

×

○

DBMS

○

×

（凡例）

○：コマンドを実行できます。

×：コマンドを実行できません。

注※

-onlオプション指定時は，起動中でもコマンドを実行できます。

引数

-sid <system_id>

環境構築時に設定したシステムIDを指定します。指定したシステムIDに対応するワーク管理システム上の案件が対象になります。

指定できる値は，半角英大文字と半角数字で5文字以内です。ただし，先頭には半角英大文字を指定してください。

-dfc <elapsed_days>

このオプションは，-dfsオプションまたは-pidfileオプションと同時に指定できません。

案件の終了日時から経過した日数を指定します。指定した日数×24時間以上経過した「完了」状態の案件が削除されます。

案件終了後の経過日数は，1970/01/02 00:00:00 GMTから現在の日時までの経過した日数以内で指定してください。指定できる値は0〜2,147,483,647の整数です。

-allオプションを同時に指定すると，「完了」状態に加えて「強制終了」状態の案件を削除できます。

-dfs <elapsed_days>

このオプションは，-dfcオプションまたは-pidfileオプションと同時に指定できません。

案件の開始日時から経過した日数を指定します。指定した日数×24時間以上経過した「完了」状態の案件が削除されます。

案件開始後の経過日数は，1970/01/02 00:00:00 GMTから現在の日時までの経過した日数以内で指定してください。指定できる値は0〜2,147,483,647の整数です。

-allオプションを同時に指定すると，「完了」状態に加えて，「未実行」状態，「実行中」状態，「実行停止」状態および「強制終了」状態の案件を削除できます。ただし，「未実行」状態の案件を削除する場合は，案件開始後の経過日数に0を指定する必要があります。

-pidfile <process_instance_id_file_name>

このオプションは，-dfcオプションまたは-dfsオプションと同時に指定できません。

削除対象となる案件IDのリストを記述したファイル（案件IDリスト指定ファイル）を指定します。案件IDリスト指定ファイルに記述した案件IDに対応する「完了」状態の案件が，案件開始後または案件終了後の経過日数に関係なく削除されます。

案件IDに対応する案件が存在する場合だけ，案件は削除されます。

なお，案件IDに対応する案件が存在しなくても，このコマンドは異常終了しません。

-allオプションを同時に指定すると，案件IDリスト指定ファイルに記述されている案件のうち，「完了」状態の案件に加えて，「未実行」状態，「実行中」状態，「実行停止」状態，および「強制終了」状態の案件を削除できます。

案件IDリスト指定ファイルの記述形式を次に示します。

「#」から始まる行はコメントになります。

案件IDは，-2,147,483,648〜2,147,483,647の整数で指定します。

複数の案件IDを指定する場合の区切り文字には，半角スペースまたは改行を指定します。

案件IDリスト指定ファイルの例を次に示します。この例は，「1」，「2」および「3」の案件IDの案件を削除する場合の例です。

例

ファイル名：ProcessInstaceIDList.txt

# 削除対象の案件IDのリスト
1 2
3

なお，案件IDリスト指定ファイル内の案件IDの数が多い場合，OutOfMemoryErrorが発生するおそれがあります。OutOfMemoryErrorが発生した場合は，次に示すどちらかの対処を実施してください。

コマンド用環境設定ファイル内のCSCIWCMD_JVM_ARGSに，-Xmxオプションを指定し，Javaヒープの最大サイズを増やします。

案件IDリスト指定ファイルを分割し，1ファイル当たりの案件IDの数を減らします。

-ofs

このオプションは，-dfcオプションまたは-dfsオプションを指定した場合だけ指定できます。

経過日数の区切りを00（時）:00（分）:00（秒）とする場合に指定し，指定日数以上経過した案件を削除対象とします。指定日数は，-dfcオプションまたは-dfsオプションで指定します。

このオプションとともに-dfcオプションまたは-dfsオプションに「1」を指定した場合は，コマンド実行日の前日までにシンクノードに到達または案件投入した案件を削除します。また，このオプションとともに-dfcオプションまたは-dfsオプションに「0」を指定した場合は，シンクノードに到達または案件投入したすべての案件を削除します。

このオプションを省略した場合，指定日数×24時間以上経過した案件を削除対象とします。

-all

「完了」状態以外の案件を削除する場合に指定します。

削除できる案件の状態は，-dfcオプション，-dfsオプションまたは-pidfileオプションを指定しているかどうかによって異なります。削除できる案件の状態を次の表に示します。

表2‒14　削除できる案件の状態

指定するオプション

案件の状態

未実行

実行中

実行停止

完了

強制終了

-dfcだけ指定した場合

×

×

×

○

×

-dfcと-allを同時に指定した場合

×

×

×

○

○

-dfsだけ指定した場合

×

×

×

○

×

-dfsと-allを同時に指定した場合

○※

○

○

○

○

-pidfileだけ指定した場合

×

×

×

○

×

-pidfileと-allを同時に指定した場合

○

○

○

○

○

（凡例）

○：削除します。

×：削除しません。

注※

-dfsオプションに0を指定する必要があります。

-bpn <process_definition_name>

ビジネスプロセス定義名を指定します。指定したビジネスプロセス定義名を使用して生成したすべての案件が削除されます。

ビジネスプロセス定義名は，<SYSTEMID>_PROCESS_DEFテーブルのNameカラムのバイト数以内で指定してください。

-bpvオプションを同時に指定すると，ビジネスプロセス定義のバージョンも限定できます。

-bpv <process_definition_version>

このオプションは，-bpnオプションを指定した場合だけ指定できます。

ビジネスプロセス定義のバージョンを指定します。-bpnオプションに指定したビジネスプロセス定義名で，かつこのオプションに指定したバージョンのビジネスプロセス定義を使用して生成したすべての案件が削除されます。

指定できる値は，-32,768〜32,767です。ただし，有効な値はビジネスプロセス定義作成時に指定できる0〜9,999となります。

-pin <process_instance_name>

案件名を指定します。指定した案件名を使用して生成したすべての案件が削除されます。オプションだけ指定し，案件名を省略した場合は，案件名が設定されていない案件が削除されます。

案件名は，「%」（半角パーセント），「_」（半角アンダースコア）およびエスケープ文字を含め，<SYSTEMID>_PROCESS_INSTANCEテーブルのNameカラムのバイト数以内で指定してください。

案件名には，ワイルドカードが指定できます。ワイルドカードの指定方法は，SQLのLIKE条件に従います。任意の文字（0文字以上）を指定するときには「%」を，任意の1文字を指定するときには「_」を指定します。案件名に「%」だけ指定したときは，案件名が設定されているすべての案件が削除されます。

なお，「%」または「_」を含む案件名を指定するときには，「%」または「_」の前にエスケープ文字を指定してください。使用するエスケープ文字は，-escオプションで指定する必要があります。

-esc <escape_character>

このオプションは，-pinオプションを指定した場合だけ指定できます。

-pinオプションで使用するエスケープ文字を指定します。

エスケープ文字には，案件名で使用していない任意の1文字を指定してください。指定できる文字は，LIKE条件のESCAPE句に指定できる文字です。

-onl

このオプションは，-dfcオプションを指定した場合だけ指定できます。

このコマンドをCSCIWManagementServer，案件運用操作およびCSCIWライブラリを使用した業務アプリケーションと同時に実行するときに指定してください。

-unt <processing_unit>

案件を削除するときの処理単位を指定します。

削除処理のトランザクションは，処理単位ごとにコミットされます。

指定できる値は1〜10,000の整数です。なお，このオプションを省略した場合，またはオプションだけを指定して処理単位を省略した場合，100が仮定されます。

なお，HiRDBを使用しているワーク管理システムで，-untオプションの処理単位の値を大きくする場合，HiRDBの排他要求数（pd_lck_pool_size）の設定値以内かどうかを確認してください。処理単位の値が排他要求数（pd_lck_pool_size）の設定値を超える場合は，処理単位の値を小さくするか，または排他要求数（pd_lck_pool_size）の設定値を大きくしてください。なお，排他要求数（pd_lck_pool_size）の見積もりについては，マニュアル「uCosminexus Service Coordinator Interactive Workflow システム構築・運用ガイド」のciwdelpiコマンド実行時の排他要求数の見積もりについて記載されている個所を参照してください。

BPMN連携機能の使用時にコールアクティビティを使用している場合の削除の処理単位は，ルート案件，およびルート案件に子案件が存在するときは子案件（子案件の子案件も含む）を含めて1単位とします。そのため，コールアクティビティを使用する場合は，ビジネスプロセス定義のコールアクティビティの数に応じて，-untオプションの値を検討する必要があります。

-vi

経過情報を標準出力およびメッセージファイルに出力する場合に指定します。

経過情報は，-untオプションに指定した処理単位ごとに出力されます。

-file <option_file_name>

このオプションは，すべてのコマンドで指定できます。詳細は，「1.5.1　-fileオプション」を参照してください。

-encoding <character_set>

このオプションは，すべてのコマンドで指定できます。詳細は，「1.5.1　-fileオプション」を参照してください。

-h

このオプションは，すべてのコマンドで指定できます。詳細は，「1.5.2　-hオプション」を参照してください。

戻り値

戻り値

内容

0

正常終了

1

致命的なエラー

9※

実行権限エラー

10

条件に指定したビジネスプロセス定義が存在しない

20

条件に指定した案件が存在しない

51

パラメーター不正

110

指定した案件IDの不正

150

ファイルアクセスエラー

254

異常終了

注※

Windowsの場合だけ発生します。

注意事項

オプション引数に，文字列を指定する場合の注意事項については，「1.2　コマンドの入力形式」を参照してください。

2.6　ciweditbp（ビジネスプロセス定義の変更）

2.6.1　BPMN連携機能を使用する場合のciweditbp

形式

形式1（変更したビジネスプロセス定義を登録する場合）

ciweditbp -sid <system_id>
-edt
-bpf <process_definition_file>
-bk <old_process_definition_file>
-o <output_file_name>
[-encoding <character_set>]

形式2（オプションファイルを指定して実行する場合）※

ciweditbp -file <option_file_name>
[-encoding <character_set>]

形式3（コマンドの形式を表示する場合）※

ciweditbp -h

注※

すべてのコマンドで同じ形式で指定します。詳細は，「1.5　コマンド共通のオプション」を参照してください。

機能

ビジネスプロセス定義の一部を変更します。すでに案件が存在しているビジネスプロセス定義を，バージョンはそのままで変更できます。ただし，既存の案件，業務ステップおよび作業の情報は変更できません。

変更可能な範囲については，マニュアル「uCosminexus Service Coordinator Interactive Workflow BPMN 連携機能　使用の手引」の，登録済みのビジネスプロセス定義を変更する方法の説明を参照してください。

実行条件

このコマンドを実行できるコンポーネントの稼働状態を次に示します。

コンポーネント

稼働状態

起動中

停止中

CSCIWManagementServer

×※

○

案件運用操作

○

○

CSCIWライブラリを使用した業務アプリケーション（J2EEアプリケーション）

○

○

CSCIWライブラリを使用した業務アプリケーション（Javaアプリケーション）

×※

○

アプリケーション呼び出しサービス

○

○

RESTサービス

○

○

運用管理RESTサービス

○

○

同一マシンでのほかのコマンド

×

○

異なるマシンでの同一コマンド

×

○

異なるマシンでのほかのコマンド

×

○

DBMS

○

×

（凡例）

○：コマンドを実行できます。

×：コマンドを実行できません。

注※

定義を登録する場合は，起動中でもコマンドを実行できます。ただし，コマンド実行後は定義を反映するために必ず再起動してください。

使用手順

このコマンドの使用手順は，マニュアル「uCosminexus Service Coordinator Interactive Workflow BPMN 連携機能　使用の手引」の，ビジネスプロセス定義の変更の流れの説明を参照してください。

引数

-sid <system_id>

環境構築時に設定したシステムIDを指定します。指定したシステムIDに対応するワーク管理システム上のビジネスプロセス定義が対象になります。

指定できる値は，半角英大文字と半角数字で5文字以内です。ただし，先頭には半角英大文字を指定してください。

-edt

変更したビジネスプロセス定義を登録する場合に指定します。

登録したビジネスプロセス定義の作成者は，このコマンドを実行したユーザになります。

このため，ユーザ名の長さは，<SYSTEMID>_PROCESS_DEFテーブルのAuthorカラムのバイト数以内にしてください。

-bpf <process_definition_file>

変更後のビジネスプロセス定義ファイル名を指定します。

変更後のビジネスプロセス定義ファイル名には，-updateオプションを指定したciwtransbpmnコマンドを実行して生成したビジネスプロセス定義ファイルの名称を指定してください。

なお，-updateオプションを指定したciwtransbpmnコマンドを実行して生成したビジネスプロセス定義ファイル以外を指定した場合，動作の保証はできません。

-bk <old_process_definition_file>

変更前のビジネスプロセス定義情報を保存するファイルの名称を指定します。

変更前のビジネスプロセス定義ファイル名には，一意な名称を指定してください。

-o <output_file_name>

変更内容を出力するファイルの名称を指定します。

変更内容は，指定したファイルに出力されます。

出力されたファイルの内容を確認したい場合は，サポートに問い合わせてください。

-file <option_file_name>

このオプションは，すべてのコマンドで指定できます。詳細は，「1.5.1　-fileオプション」を参照してください。

-encoding <character_set>

このオプションは，-oオプションまたは-fileオプションを指定した場合だけ指定できます。文字コードには，Javaでサポートされているエンコーディングの正準名を指定してください。また，このオプションを省略した場合は，Javaのデフォルトの文字コードが指定されます。

-oオプションを指定した場合

-oオプションに指定した出力ファイルの文字コードを指定します。

文字コードには，Javaでサポートされているエンコーディングの正準名を指定してください。

-fileオプションを指定した場合

このオプションは，すべてのコマンドで指定できます。詳細は，「1.5.1　-fileオプション」を参照してください。

-h

このオプションは，すべてのコマンドで指定できます。詳細は，「1.5.2　-hオプション」を参照してください。

戻り値

戻り値

内容

0

正常終了

1

致命的なエラー

9※

実行権限エラー

10

ビジネスプロセス定義の変更なし

51

パラメーター不正

100

ビジネスプロセス定義不正

110

ビジネスプロセス定義以外のデータ不正

150

ファイルアクセスエラー

254

異常終了

注※

Windowsの場合だけ発生します。

注意事項

オプション引数に，文字列を指定する場合の注意事項については，「1.2　コマンドの入力形式」を参照してください。

ビジネスプロセス定義を変更する場合は，このコマンドを実行する前に，CSCIWシステムのバックアップを取得することを推奨します。

マルチマシン構成の場合，どれか1つのマシンでこのコマンドを実行してください。

このコマンドは，CSCIWManagementServerおよびCSCIWを使用しているJavaアプリケーションが起動中でも実行できます。ただし，コマンド実行後に，必ずCSCIWManagementServerおよびCSCIWを使用しているJavaアプリケーションを再起動してください。再起動しないと，ビジネスプロセス定義の変更が反映されません。

BPMNビジネスプロセス定義から定義済みのタスクおよびイベントを削除する場合，削除対象に実行中のタスクおよびイベントがあると，ビジネスプロセス定義を変更できません。

-updateオプションを指定していないciwtransbpmnコマンドで作成したビジネスプロセス定義ファイルは使用できません。

ビジネスプロセス定義の変更によって，変更前に生成されたタスクやイベントなどが持つ情報と，変更後に生成されたタスクやイベントなどが持つ情報が異なることがあります。そのため，必要に応じて業務プログラムや運用手順を見直してください。

タスクやイベントを変更した場合でも，生成済みのタスクやイベントの情報は変更されません。

マニュアル「uCosminexus Service Coordinator Interactive Workflow BPMN 連携機能　使用の手引」の，登録済みのビジネスプロセス定義を変更する方法の説明に記載されている方法でビジネスプロセス定義を変更してください。それ以外の方法で変更した場合，動作の保証はできません。

2.6.2　BPMN連携機能を使用しない場合のciweditbp

形式

形式1（変更内容をファイルに出力する場合）

ciweditbp -sid <system_id>
-bpf <process_definition_file>
-o <output_file_name>
[-encoding <character_set>]

形式2（変更したビジネスプロセス定義を登録する場合）

ciweditbp -sid <system_id>
-edt
-bpf <process_definition_file>
-bk <old_process_definition_file>
-o <output_file_name>
[-encoding <character_set>]

形式3（オプションファイルを指定して実行する場合）※

ciweditbp -file <option_file_name>
[-encoding <character_set>]

形式4（コマンドの形式を表示する場合）※

ciweditbp -h

注※

すべてのコマンドで同じ形式で指定します。詳細は，「1.5　コマンド共通のオプション」を参照してください。

機能

ビジネスプロセス定義の一部を変更します。すでに案件が存在しているビジネスプロセス定義を，バージョンはそのままで変更できます。ただし，既存の案件，業務ステップおよび作業の情報は変更できません。

また，指定したファイルに，変更内容をCSV形式で出力します。

変更内容の出力フォーマットについて

-oオプションを指定して変更内容を出力した場合の出力フォーマットを次に示します。

1行目

ヘッダ情報として，製品名，バージョン，ファイル名，日時などが出力されます。

2行目

ビジネスプロセス定義の識別情報が出力されます。

出力される情報を次の表に示します。

表2‒15　変更内容出力ファイル（ビジネスプロセス定義の識別情報）

行

カラム

内容

1

1

ビジネスプロセス定義名が出力されます。

2

ビジネスプロセス定義のバージョンが出力されます。

3行目以降

変更内容が追加情報，変更情報，削除情報の順に出力されます。CSCIW-Definerで，新規作成した定義は追加情報に，削除した定義は削除情報に，属性を変更した定義は変更情報に情報を出力されます。属性が同じでも，削除および新規作成の操作を実行した場合は，削除情報と追加情報に情報が出力されます。

出力される情報を次の表に示します。

表2‒16　変更内容出力ファイル（追加情報）

行

カラム

内容

1

1

追加を示す固定文字列の「[Addition]」が出力されます。

2以降

1以降

各種別の属性値が出力されます。※

注※

各種別の属性値については，「表2‒19　変更内容出力ファイル（ビジネスプロセス属性値）」〜「表2‒32　変更内容出力ファイル（作業アプリケーション定義属性値：RESTアプリケーション呼び出しの場合）」を参照してください。

表2‒17　変更内容出力ファイル（変更情報）

行

カラム

内容

1

1

変更を示す固定文字列の「[Modification]」が出力されます。

2N※1

1

変更前を示す固定文字列の「Before」が出力されます。

2以降

各種別の属性値が出力されます。※2

2N※1＋1

1

変更後を示す固定文字列の「After」が出力されます。

2以降

各種別の属性値が出力されます。※2

注※1

N＝1，2，3…

注※2

各種別の属性値については，「表2‒19　変更内容出力ファイル（ビジネスプロセス属性値）」〜「表2‒32　変更内容出力ファイル（作業アプリケーション定義属性値：RESTアプリケーション呼び出しの場合）」を参照してください。

表2‒18　変更内容出力ファイル（削除情報）

行

カラム

内容

1

1

[Deletion]（削除を示す固定文字列）

2以降

1以降

各種別の属性値※

注※

各種別の属性値については，「表2‒19　変更内容出力ファイル（ビジネスプロセス属性値）」〜「表2‒32　変更内容出力ファイル（作業アプリケーション定義属性値：RESTアプリケーション呼び出しの場合）」を参照してください。

各種別の属性値の出力内容を「表2‒19　変更内容出力ファイル（ビジネスプロセス属性値）」〜「表2‒32　変更内容出力ファイル（作業アプリケーション定義属性値：RESTアプリケーション呼び出しの場合）」に示します。

特に記載のないかぎり，未設定の属性値は空文字が表示されます。

表2‒19　変更内容出力ファイル（ビジネスプロセス属性値）

列

出力内容

備考

1

種別

ビジネスプロセスを示す固定文字列の「BusinessProcess」が出力されます。

2

ビジネスプロセス名

−

3

バージョン

4

ビジネスプロセスID

5

処理期限ルール名

6

管理者名

7

案件投入可能期間開始

日付が出力されます。

日付の形式はJavaVMに依存します。

なお，案件投入可能期間開始日が未設定の場合は「ORIGIN」，

案件投入可能期間終了日が未設定の場合は「BEYOND」が出力されます。

8

案件投入可能期間終了

9

説明

−

10

アドホックAPIの使用

アドホックAPIを使用する場合は「true」，アドホックAPIを使用しない場合は「false」が出力されます。

（凡例）

−：ありません。

表2‒20　変更内容出力ファイル（業務ステップ属性値）

列

出力内容

備考

1

種別

業務ステップを示す固定文字列の「Activity」が出力されます。

2

業務ステップ名

−

3

業務ステップ定義ID

4

処理期限ルール名

5

事前生成フラグ

「true」（事前生成する），または「false」（事前生成しない）が出力されます。

6

完了条件名

−

7

説明

（凡例）

−：ありません。

表2‒21　変更内容出力ファイル（一般作業属性値）

列

出力内容

備考

1

種別

一般作業を示す固定文字列の「NormalWork」が出力されます。

2

作業名

−

3

作業定義ID

4

振り分けルール名

5

発生条件名

6

完了条件名

7

条件再評価フラグ

「true」（条件を再評価する），または「false」（条件を再評価しない）が出力されます。

8

説明

−

9

作業アプリケーション定義名

（凡例）

−：ありません。

表2‒22　変更内容出力ファイル（並列作業属性値）

列

出力内容

備考

1

種別

並列作業を示す固定文字列の「ParallelWork」が出力されます。

2

作業名

−

3

作業定義ID

4

子作業名

5

子作業生成ルール名

6

発生条件名

7

完了条件名

8

条件再評価フラグ

「true」（条件を再評価する），または「false」（条件を再評価しない）が出力されます。

9

説明

−

（凡例）

−：ありません。

表2‒23　変更内容出力ファイル（分岐ノード，分業ノード，先着ノード，待合ノード，ソースノード，およびシンクノードの属性値）

列

出力内容

備考

1

種別

対象種別を示す固定文字列が出力されます。出力される固定文字列を次に示します。

「XOR-Split」：分岐ノードを示します。

「AND-Split」：分業ノードを示します。

「OR-Join」：先着ノードを示します。

「AND-Join」：待合ノードを示します。

「Source」：ソースノードを示します。

「Sink」：シンクノードを示します。

2

定義名

−

3

制御ノードID

（凡例）

−：ありません。

表2‒24　変更内容出力ファイル（遷移定義属性値）

列

出力内容

備考

1

種別

遷移定義を示す固定文字列の「Flow」が出力されます。

2

遷移定義ID

−

3

遷移元ノード名

次に示す定義種別のどれかが出力されます。

業務ステップ

各種制御ノード

階層定義

ソースノード

シンクノード

4

遷移先ノード名

5

優先順位

デフォルトの分岐先の場合，「Default」が出力されます。

6

分岐条件名

−

（凡例）

−：ありません。

表2‒25　変更内容出力ファイル（階層定義属性値）

列

出力内容

備考

1

種別

階層定義を示す固定文字列の「Hierarchy」が出力されます。

2

階層名

−

3

階層ID

（凡例）

−：ありません。

表2‒26　変更内容出力ファイル（条件属性値：RDB検索の場合）

列

出力内容

備考

1

種別

条件を示す固定文字列の「Condition」が出力されます。

2

定義名

−

3

条件ID

4

条件種別

「SQL」が出力されます。

5

説明

−

6

DB識別子

7

SQL文

8

NOTフラグ

「true」（NOT指定あり），または「false」（NOT指定なし）が出力されます。

（凡例）

−：ありません。

表2‒27　変更内容出力ファイル（条件属性値：Javaオブジェクト呼び出しの場合）

列

出力内容

備考

1

種別

条件を示す固定文字列の「Condition」が出力されます。

2

定義名

−

3

条件ID

4

条件種別

「Java」が出力されます。

5

説明

−

6

Javaクラス名

7

補助定数パラメタ

（凡例）

−：ありません。

表2‒28　変更内容出力ファイル（生成ルール属性値：RDB検索の場合）

列

出力内容

備考

1

種別

生成ルールを示す固定文字列の「CreationRule」が出力されます。

2

定義名

−

3

ルールID

4

生成ルール種別

「SQL」が出力されます。

5

説明

−

6

DB識別子

7

SQL文

（凡例）

−：ありません。

表2‒29　変更内容出力ファイル（生成ルール属性値：Javaオブジェクト呼び出しの場合）

列

出力内容

備考

1

種別

条件を示す固定文字列の「CreationRule」が出力されます。

2

定義名

−

3

ルールID

4

生成ルール種別

「Java」が出力されます。

5

説明

−

6

Javaクラス名

7

補助定数パラメタ

（凡例）

−：ありません。

表2‒30　変更内容出力ファイル（時間取得ルール属性値）

列

出力内容

備考

1

種別

時間取得ルールを示す固定文字列の「TimeRule」が出力されます。

2

定義名

−

3

ルールID

4

時間取得ルール種別

「DATE」が出力されます。

5

説明

−

6

相対日数

（凡例）

−：ありません。

表2‒31　変更内容出力ファイル（作業アプリケーション定義属性値：Javaオブジェクト呼び出しの場合）

列

出力内容

備考

1

種別

条件を示す固定文字列の「Application」が出力されます。

2

作業アプリケーション定義名

−

3

作業アプリケーション定義ID

4

作業アプリケーション種別

「Java」が出力されます。

5

説明

−

6

Javaクラス名

7

補助定数パラメタ

（凡例）

−：ありません。

表2‒32　変更内容出力ファイル（作業アプリケーション定義属性値：RESTアプリケーション呼び出しの場合）

列

出力内容

備考

1

種別

条件を示す固定文字列の「Application」が出力されます。

2

作業アプリケーション定義名

−

3

作業アプリケーション定義ID

4

作業アプリケーション種別

「REST」が出力されます。

5

説明

−

6

ref識別子

（凡例）

−：ありません。

ビジネスプロセス定義の変更について

このコマンドで変更できるビジネスプロセス定義の範囲を次の表に示します。

表に示すビジネスプロセス定義の項目を変更した場合，項目以外（例えば，業務ステップ定義などの座標情報やアイコン種別といったCSCIW-Definerの描画情報など）のビジネスプロセス定義の内容についても変更されます。

また，表に示した項目が変更内容に1つも含まれない場合は，ビジネスプロセス定義の変更は実行されません。

表2‒33　ciweditbpコマンドで変更できるビジネスプロセス定義の範囲

変更対象

変更内容

備考

ビジネスプロセス

属性変更

変更できる属性

処理期限ルール名

管理者

案件投入可能期間

説明

変更できない属性

ビジネスプロセス定義名

バージョン

アドホックAPIの使用

業務ステップ

追加または削除

追加または削除できる位置

遷移元ノード種別

ソースノード

業務ステップ

階層定義

分業ノード

分岐ノード

待合ノード

先着ノード

遷移先ノード種別

業務ステップ

階層定義

分業ノード

分岐ノード

先着ノード（後続停止なし）

シンクノード

属性変更

変更できる属性

業務ステップ名

完了条件名

処理期限ルール名

説明

変更できない属性

事前生成

作業

一般作業

並列作業

追加または削除

−

属性変更

変更できる属性

作業名

振り分けルール名（一般作業の場合）

発生条件名

完了条件名

条件再評価

説明

子作業名（並列作業の場合）

子作業生成ルール名（並列作業の場合）

作業アプリケーション定義名（一般作業の場合）

制御ノード

分岐ノード

先着ノード（後続停止なし）

追加または削除

追加または削除できる位置

遷移元ノード種別

ソースノード

業務ステップ

階層定義

分業ノード

分岐ノード

待合ノード

先着ノード

遷移先ノード種別

業務ステップ

階層定義

分業ノード

分岐ノード

先着ノード（後続停止なし）

シンクノード

属性変更

変更できる属性

定義名

変更できない属性

後続停止

制御ノード

分業ノード

待合ノード

先着ノード（後続停止あり）

追加または削除

追加または削除できない

属性変更

変更できる属性

定義名

変更できない属性

後続停止

遷移定義

追加または削除

次に示すノードへの遷移定義の追加または削除はできない

待合ノード

先着ノード（後続停止あり）

属性変更

変更できる属性（分岐条件の場合）

優先順位（有無を含む）

分岐条件名

遷移元および遷移先も変更できる（ただし，待合ノードおよび先着ノード（後続停止あり）の遷移元が変更になってはいけない）

階層定義

追加または削除

追加または削除できるかどうかは，含まれる定義に依存する

追加または削除できる位置

遷移元ノード種別

ソースノード

業務ステップ

階層定義

分業ノード

分岐ノード

待合ノード

先着ノード

遷移先ノード種別

業務ステップ

階層定義

分業ノード

分岐ノード

先着ノード（後続停止なし）

シンクノード

属性変更

変更できる属性

階層名

条件（RDB検索，Java）

追加または削除

−

属性変更

変更できる属性

定義名

条件の種別

SQL文（RDB検索の場合）

NOTフラグ（RDB検索の場合）

Javaクラス名（Javaオブジェクト呼び出しの場合）

補助定数パラメタ（Javaオブジェクト呼び出しの場合）

説明

ルール

生成ルール（RDB検索，Java）

時間取得ルール（相対時間だけ）

追加または削除

−

属性変更

変更できる属性

定義名

生成ルールの種別

説明

SQL文（生成ルール（RDB検索）の場合）

Javaクラス名（生成ルール（Javaオブジェクト呼び出し）の場合）

補助定数パラメタ（生成ルール（Javaオブジェクト呼び出し）の場合）

相対日数（時間取得ルール（相対時間）の場合）

作業アプリケーション定義（Java，REST）

追加

−

属性変更

変更できる属性

作業アプリケーション定義名

作業アプリケーションの種別

補助定数パラメタ（Javaオブジェクト呼び出しの場合）

説明

Javaクラス名（Javaオブジェクト呼び出しの場合）

ref識別子（RESTアプリケーション呼び出しの場合）

（凡例）

−：制限はありません。

実行条件

このコマンドを実行できるコンポーネントの稼働状態を次に示します。

コンポーネント

稼働状態

起動中

停止中

CSCIWManagementServer

×※

○

案件運用操作

○

○

CSCIWライブラリを使用した業務アプリケーション（J2EEアプリケーション）

○

○

CSCIWライブラリを使用した業務アプリケーション（Javaアプリケーション）

×※

○

アプリケーション呼び出しサービス

○

○

RESTサービス

○

○

運用管理RESTサービス

○

○

同一マシンでのほかのコマンド

×

○

異なるマシンでの同一コマンド

×

○

異なるマシンでのほかのコマンド

×

○

DBMS

○

×

（凡例）

○：コマンドを実行できます。

×：コマンドを実行できません。

注※

変更内容をファイルに出力するだけの場合は，起動中でもコマンドを実行できます。

また，定義を登録する場合は，起動中でもコマンドを実行できます。ただし，コマンド実行後は定義を反映するために必ず再起動してください。

使用手順

このコマンドの使用手順を次に示します。なお，手順2.および3.のCSCIW-Definerの操作の詳細は，マニュアル「uCosminexus Service Coordinator Interactive Workflow ビジネスプロセス開発ガイド」を参照してください。

ciwmngbpコマンドで変更対象のビジネスプロセス定義を取得します。

編集するビジネスプロセス定義と登録済みのビジネスプロセス定義との間に差異が発生しないように，編集する直前にビジネスプロセス定義を取得してください。または，CSCIW-Definerを使用し，ビジネスプロセス定義を取得してください。

ciwmngbpコマンドの例を次に示します。

例

ciwmngbp -sid SID1 -get -bpn SampleBP -bpv 1 -bpf SampleBp.hbx

なお，ciwmngbpコマンドの詳細は，「2.10　ciwmngbp（ビジネスプロセス定義の管理）」を参照してください。

CSCIW-Definerを使用し，手順1.で取得したビジネスプロセス定義を変更します。

ビジネスプロセス定義を変更する場合の注意事項を次に示します。

定義を追加するときは，コピー（［Ctrl］+［C］）および貼り付け（［Ctrl］+［V］）機能を使用しないでください。

業務ステップ間では，作業の移動をしないでください。

ビジネスプロセスと階層または階層と階層での業務ステップ，制御ノード，階層の移動には，切り取り（［Ctrl］+［X］）および貼り付け（［Ctrl］+［V］）機能を使用してください。

ビジネスプロセス遷移ビューから業務ステップ，分業ノード，分岐ノード，待合ノード，先着ノードまたは階層定義を削除するときは，［オブジェクトの削除］を選択してください。［削除］を選択しても，定義情報は削除されません。定義情報が削除されたかどうかは，ビジネスプロセスツリービューで確認できます。

CSCIW-Definerで，変更したビジネスプロセス定義をチェックします。

ciweditbpコマンドで変更内容をファイルに出力し，ビジネスプロセス定義の変更個所を確認します。

変更内容によっては，変更内容出力ファイルだけではわかりにくいことがあるため，ビジネスプロセス定義と対応させて確認してください。

ciweditbpコマンドの例を次に示します。

例

ciweditbp -sid SID1 -bpf SampleBp.hbx -o diff.csv

CSCIWシステムのバックアップを取得します。

ciweditbpコマンドで変更したビジネスプロセス定義を登録します。

ciweditbpコマンドの例を次に示します。

例

ciweditbp -edt -sid SID1 -bpf SampleBp.hbx -bk SampleBp_old.hbx -o diff.csv

引数

-sid <system_id>

環境構築時に設定したシステムIDを指定します。指定したシステムIDに対応するワーク管理システム上のビジネスプロセス定義が対象になります。

指定できる値は，半角英大文字と半角数字で5文字以内です。ただし，先頭には半角英大文字を指定してください。

-edt

変更したビジネスプロセス定義を登録する場合に指定します。

登録したビジネスプロセス定義の作成者は，このコマンドを実行したユーザになります。

このため，ユーザ名の長さは，<SYSTEMID>_PROCESS_DEFテーブルのAuthorカラムのバイト数以内にしてください。

-bpf <process_definition_file>

変更後のビジネスプロセス定義ファイル名を指定します。

変更後のビジネスプロセス定義ファイル名には，CSCIW-Definerで変更したビジネスプロセス定義ファイルの名称を指定してください。

なお，変更後にCSCIW-Definerでチェックを実施し，エラーのなしを確認したビジネスプロセス定義ファイルを指定してください。チェックを実施していないファイルを指定した場合，動作の保証はできません。

また，変更後の定義に含まれている条件定義，生成ルール定義，作業アプリケーション定義のSQL文，Javaクラス名，およびref識別子がデフォルト値から変更されていない場合はエラーになります。

-bk <old_process_definition_file>

変更前のビジネスプロセス定義情報を保存するファイルの名称を指定します。

変更前のビジネスプロセス定義ファイル名には，一意な名称を指定してください。

-o <output_file_name>

変更内容を出力するファイルの名称を指定します。

変更内容は，指定したファイルにCSV形式で出力されます。出力内容を次に示します。

1行目

ヘッダ情報として，製品名，バージョン，ファイル名，日時などが出力されます。

2行目

ビジネスプロセス定義の識別情報が出力されます。

なお，変更内容の出力フォーマットについては，「表2‒15　変更内容出力ファイル（ビジネスプロセス定義の識別情報）」〜「表2‒32　変更内容出力ファイル（作業アプリケーション定義属性値：RESTアプリケーション呼び出しの場合）」を参照してください。

-file <option_file_name>

このオプションは，すべてのコマンドで指定できます。詳細は，「1.5.1　-fileオプション」を参照してください。

-encoding <character_set>

このオプションは，-oオプションまたは-fileオプションを指定した場合だけ指定できます。文字コードには，Javaでサポートされているエンコーディングの正準名を指定してください。また，このオプションを省略した場合は，Javaのデフォルトの文字コードが指定されます。

-oオプションを指定した場合

-oオプションに指定した出力ファイルの文字コードを指定します。

文字コードには，Javaでサポートされているエンコーディングの正準名を指定してください。

-fileオプションを指定した場合

このオプションは，すべてのコマンドで指定できます。詳細は，「1.5.1　-fileオプション」を参照してください。

-h

このオプションは，すべてのコマンドで指定できます。詳細は，「1.5.2　-hオプション」を参照してください。

戻り値

戻り値

内容

0

正常終了

1

致命的なエラー

9※

実行権限エラー

10

ビジネスプロセス定義の変更なし

51

パラメーター不正

100

ビジネスプロセス定義不正

110

ビジネスプロセス定義以外のデータ不正

150

ファイルアクセスエラー

254

異常終了

注※

Windowsの場合だけ発生します。

注意事項

オプション引数に，文字列を指定する場合の注意事項については，「1.2　コマンドの入力形式」を参照してください。

ビジネスプロセス定義を変更する場合は，このコマンドを実行する前に，CSCIWシステムのバックアップを取得することを推奨します。

マルチマシン構成の場合，どれか1つのマシンでこのコマンドを実行してください。

このコマンドは，CSCIWManagementServerおよびCSCIWを使用しているJavaアプリケーションが起動中でも実行できます。ただし，コマンド実行後に，必ずCSCIWManagementServerおよびCSCIWを使用しているJavaアプリケーションを再起動してください。再起動しないと，ビジネスプロセス定義の変更が反映されません。

ビジネスプロセス定義から定義済みの業務ステップを削除する場合，削除対象に実行中の業務ステップがあると，ビジネスプロセス定義を変更できません。

また，定義済みの作業を削除する場合，その作業が属する業務ステップに実行中のものがあると，ビジネスプロセス定義を変更できません。

CSCIW-Definerで新規に作成したビジネスプロセス定義ファイルは使用できません。

ビジネスプロセス定義の変更によって，変更前に生成された業務ステップや作業が持つ情報と，変更後に生成された業務ステップや作業が持つ情報が異なることがあります。例えば，業務ステップ定義名や作業定義名などが該当します。そのため，必要に応じて業務プログラムや運用手順を見直してください。

作業アプリケーション定義を変更した場合でも，呼び出し済みの作業アプリケーションの情報は変更されません。

条件およびルールを変更する場合，業務プログラムや運用手順を見直す必要があります。

2.7　ciwlistsid（システムID情報の表示）

形式

形式1（指定したシステムIDで動作するプロセス情報を表示する場合）

ciwlistsid -sid <system_id>
[-m]
[{(-prc｜-env｜-dbt)｜-fod}]
[-s]

形式2（コマンドを実行したマシンで，実行環境を構築した全システムIDで動作するプロセス情報を表示する場合）

ciwlistsid -all [{(-prc｜-env｜-dbt)｜-fod}]
[-s]

形式3（オプションファイルを指定して実行する場合）※

ciwlistsid -file <option_file_name>
[-encoding <character_set>]

形式4（コマンドの形式を表示する場合）※

ciwlistsid -h

注※

すべてのコマンドで同じ形式で指定します。詳細は，「1.5　コマンド共通のオプション」を参照してください。

機能

CSCIWの実行環境で動作するプロセス情報を表示します。

実行条件

このコマンドを実行できるコンポーネントの稼働状態を次に示します。

コンポーネント

稼働状態

起動中

停止中

CSCIWManagementServer

○

○

案件運用操作

○

○

CSCIWライブラリを使用した業務アプリケーション（J2EEアプリケーション）

○

○

CSCIWライブラリを使用した業務アプリケーション（Javaアプリケーション）

○

○

アプリケーション呼び出しサービス

○

○

RESTサービス

○

○

運用管理RESTサービス

○

○

同一マシンでのほかのコマンド

○

○

異なるマシンでの同一コマンド

○

○

異なるマシンでのほかのコマンド

○

○

DBMS

○

×※

（凡例）

○：コマンドを実行できます。

×：コマンドを実行できません。

注※

DBMSが停止中の場合，「STATUS」に「DB NOT UP」が表示されます。

また，DBMSが停止中の場合，このコマンドの終了に時間が掛かることがあります。

引数

-sid <system_id>

このオプションは，-allオプションと同時に指定できません。

環境構築時に設定したシステムIDを指定します。指定したシステムIDに対応するプロセス情報が対象になります。

指定できる値は，半角英大文字と半角数字で5文字以内です。ただし，先頭には半角英大文字を指定してください。

-all

このオプションは，-sidオプションと同時に指定できません。

コマンドを実行したマシンで，実行環境を構築したすべてのシステムIDが対象になります。対象となる全システムIDで動作するすべてのプロセス情報を表示する場合に指定します。

-m

このオプションは，-sidオプションを指定した場合だけ指定できます。

このオプションを指定すると，-sidオプションに指定したシステムIDで実行環境を構築したマシンが複数存在する場合に，各マシンの指定したシステムIDの実行環境で動作するすべてのプロセス情報が表示されます。また，表示する各プロセスについて動作するマシンのIPアドレスが表示されます。

このオプションを指定しないときは，このコマンドを実行したマシンの実行環境で動作するプロセス情報だけが表示されます。

-prc

表示プロセスのロックIDおよび通知名称を表示する場合に指定します。

-env

次に示す情報を表示する場合に指定します。

環境変数CSCIW_HOMEの設定値

環境変数CSCIW_CONF_DIRの設定値

現在インストールしているCSCIWのバージョン

システムIDをセットアップした時点のCSCIWのバージョン

コマンドを実行したマシンのIPアドレス

-dbt

実行環境を構築したデータベース種別を表示する場合に指定します。

-fod

このオプションは，-prcオプション，-envオプションまたは-dbtオプションと同時に指定できません。

次に示すオプションを指定したときに表示される情報を，すべて表示する場合に指定します。

-prcオプション

-envオプション

-dbtオプション

-s

起動状態が「停止」状態のプロセスを表示する場合に指定します。

このオプションを指定しない場合は，起動状態が「停止」状態以外のプロセスだけ表示します。

-file <option_file_name>

このオプションは，すべてのコマンドで指定できます。詳細は，「1.5.1　-fileオプション」を参照してください。

-encoding <character_set>

このオプションは，すべてのコマンドで指定できます。詳細は，「1.5.1　-fileオプション」を参照してください。

-h

このオプションは，すべてのコマンドで指定できます。詳細は，「1.5.2　-hオプション」を参照してください。

戻り値

戻り値

内容

0

正常終了

1

致命的なエラー

9※

実行権限エラー

50

DBMSが起動していない，またはDBMSへのアクセスの失敗

51

パラメーター不正

100

DBMSから取得したデータの不正

254

異常終了

注※

Windowsの場合だけ発生します。

出力形式

プロセス情報の表示フォーマットを次に示します。

ciwlistsid -sid <system_id>，またはciwlistsid -allを実行した場合

SID   NAME       STATUS

ciwlistsid -sid <system_id> -mを実行した場合

SID   NAME       STATUS     IP

ciwlistsid -sid <system_id> -prc，またはciwlistsid -all -prcを実行した場合

SID   NAME       STATUS     LOCK_ID    NOTIFICATION_ID

ciwlistsid -sid <system_id> -env，またはciwlistsid -all -envを実行した場合

CSCIW_HOME :
CSCIW_CONF_DIR :
CSCIW_VERSION :
IP_ADDRESS :
SID   NAME       STATUS     VERSION

ciwlistsid -sid <system_id> -dbt，またはciwlistsid -all -dbtを実行した場合

SID   NAME       STATUS     DB_TYPE

ciwlistsid -sid <system_id> -fod，ciwlistsid -sid <system_id> -prc -env -dbt，ciwlistsid -all -fodまたはciwlistsid -all -prc -env -dbtを実行した場合

CSCIW_HOME :
CSCIW_CONF_DIR :
CSCIW_VERSION :
IP_ADDRESS :
SID   NAME       STATUS     DB_TYPE VERSION LOCK_ID    NOTIFICATION_ID

ciwlistsid -sid -m -fodを実行した場合（IPアドレスが二つ設定されている場合）

CSCIW_HOME :
CSCIW_CONF_DIR :
CSCIW_VERSION :
IP_ADDRESS :
IP_ADDRESS :
SID   NAME       STATUS     DB_TYPE VERSION LOCK_ID    NOTIFICATION_ID  IP

表示項目の意味を次の表に示します。

表2‒34　表示項目（プロセス情報）

表示項目

内容

CSCIW_HOME

コマンドを実行した環境の環境変数CSCIW_HOMEの設定値が表示されます。

CSCIW_CONF_DIR

コマンドを実行した環境の環境変数CSCIW_CONF_DIRの設定値が表示されます。

CSCIW_CONF_DIRが設定されていない場合，「-」が表示されます。

CSCIW_VERSION

コマンドを実行した環境にインストールされているCSCIWのバージョンが表示されます。

IP_ADDRESS

コマンドを実行したマシンのIPアドレスが表示されます。

なお，IPアドレスが複数設定されているマシンでは，設定されているIPアドレスの個数だけ行が表示されます。

表示形式を次に示します。

IPv4形式の場合：xxx.xxx.xxx.xxx

IPv6形式の場合：zzzz: zzzz: zzzz: zzzz: zzzz: zzzz: zzzz: zzzz

SID

システムIDが表示されます。

NAME

該当するシステムIDで動作するプロセスの機能が表示されます。

機能に表示される項目を次に示します。

「MngSrv」：CSCIWManagementServerを示します。

「JavaAP」：CSCIWライブラリを使用したJavaアプリケーションを示します。

コマンド名：CSCIWのコマンド名が表示されます。

「-」※1

STATUS

該当するシステムIDで動作するプロセスの状態が表示されます。

機能に表示される項目を次に示します。

「Active」：プロセスが動作中であることを示します。

「DB NOT UP」：該当するシステムIDの実行環境を構築したDBMSが起動していないため，プロセス情報を取得できないことを示します。

「DB ERROR」：該当するシステムIDの実行環境を構築したDBMSへのアクセスが失敗したため，プロセス情報を取得できないことを示します。

「Stopped」：プロセスが「停止」状態であることを示します。

「*」：プロセスが異常終了したことを示します。

「-」：該当するシステムIDの実行環境でプロセスが動作していないことを示します。

DB_TYPE

該当するシステムIDの動作環境を構築したDBMSの種別が表示されます。

VERSION

該当するシステムIDをセットアップした時点のCSCIWのバージョンが表示されます。

LOCK_ID

該当するプロセスのロックIDが表示されます。※2

NOTIFICATION_ID

プロセスの通知名称が表示されます。※2

IP

該当するシステムIDが動作するマシンに割り当てられたIPアドレスが表示されます。※2

IPアドレスは，次に示す形式で表示されます。

IPv4形式の場合：ddd.ddd.ddd.ddd（d：10進数）

IPv6形式の場合：xxxx: xxxx: xxxx: xxxx: xxxx: xxxx: xxxx: xxxx（xxxx：16進数）

注※1

次に示す場合に表示されます。

該当するシステムIDの実行環境でプロセスが動作していない場合

実行環境を構築したDBMSが起動していない場合

DBMSにエラーが発生したため，プロセス情報を取得できない場合

注※2

次に示す場合，「-」が表示されます。

該当するシステムIDの実行環境でプロセスが動作していない場合（-sオプションを指定し，かつ「停止」状態のプロセスがあった場合を除く）

該当するシステムIDの実行環境を構築したDBMSが起動していない場合

DBMSにエラーが発生した場合

注意事項

異常終了したプロセスが，このコマンドを実行したマシンで動作していた場合，「STATUS」に「*」が表示されます。また，このコマンドを実行したマシン以外で動作しているプロセスについては，「STATUS」が「*」でなくても異常終了していることがあります。

2.8　ciwmngap（アプリケーション呼び出し制御情報の管理）

2.8.1　BPMN連携機能を使用する場合のciwmngap

形式

形式1（アプリケーション呼び出し制御情報を一覧表示する場合）

ciwmngap -sid <system_id>
-list

形式2（入力用ファイルの内容に従ってアプリケーション呼び出し制御情報を変更する場合）

ciwmngap -sid <system_id>
-chg
-apdf　<application_call_definition_file>

形式3（オプションファイルを指定して実行する場合）※

ciwmngap -file <option_file_name>
[-encoding <character_set>]

形式4（コマンドの形式を表示する場合）※

ciwmngap -h

注※

すべてのコマンドで同じ形式で指定します。詳細は，「1.5　コマンド共通のオプション」を参照してください。

機能

アプリケーション呼び出し制御情報を管理します。

このコマンドで実行できることを次に示します。

アプリケーション呼び出し制御情報の，次の設定の変更

ref識別子単位の，実行間隔，リトライ間隔，リトライ回数などの設定

グループ単位の，実行間隔，リトライ間隔，リトライ回数などの設定

アプリケーション呼び出し制御情報の一覧表示

アプリケーション呼び出し制御情報ファイルのフォーマット

アプリケーション呼び出し制御情報ファイルのフォーマットを次に示します。

<更新オプション>,<種別>,<ref識別子またはグループ名>,<実行間隔>,<リトライ間隔>,<リトライ回数>,<最大作業件数>,<障害復旧間隔>

「#」から始まる行はコメント行として扱われるため，読み込まれません。

改行だけの行は無視されます。

「KDIW」から始まる行は無視されます。そのため，-listオプションでリダイレクトして作成したファイルから，「KDIW」から始まるメッセージの行を削除する必要はありません。

コメント行の場合，およびref識別子の記述がない場合は，指定内容は反映されません。

表2‒35　アプリケーション呼び出し制御情報の項目

列番号

項目名

説明

値域

更新オプション（UPDATEOPTION）ごとの項目要否

U（更新）の場合

D（削除）の場合

1

UPDATEOPTION

更新オプション

情報の更新方法を示すオプション識別子で，この指定に従って情報を更新します。次のどちらかを指定してください。

U：更新

D：削除

UまたはD

○

○

2

TYPE

種別

次のどれかの種別です。

msg：メッセージイベントの場合

ope：サービスタスクまたはビジネスルールタスクの場合

err：エラーイベントの場合

grp：アプリケーション呼び出しグループの場合

tim：タイマーイベントの場合

次のどれかの文字列

msg

ope

err

grp

tim

○

○

3

ID

ref識別子またはグループ名

更新の対象となるref識別子，またはグループ名です。

ref識別子共通設定※1を更新する場合は，(Common)を指定します。

種別（TYPE）にope，msg，またはerrを指定した場合だけ(Common)を指定できます。

タイマーイベントの共通設定※1を更新する場合は，(Create)または(Transit)を指定します。

種別（TYPE）でtimを指定した場合だけ(Create)または(Transit)を指定できます。

次に示すどれかの値

1. 次の条件を両方満たす値

半角英数字とアンダースコア（_）から構成されている

((<SYSTEMID>_<APPLICATION_LOCK_INFOテーブルのLockNameのカラムサイズ) - 7)バイト以内

2. (Common)

3. 種別にtimを指定したとき，(Create)または(Transit)

○

○

4

EXECUTEINTERVAL

実行間隔

呼び出し処理の対象の作業があるかどうかを検索する間隔です（単位：秒）。

次の範囲の半角数字

0～86,400

○

―

5

RETRYINTERVAL

リトライ間隔

※2

呼び出し処理でエラーになった時に，次にリトライするまでの間隔です（単位：秒）。

次の範囲の半角数字

1～86,400

○

―

6

RETRYCOUNT

リトライ回数

※2

呼び出し処理でエラーになった時に，リトライする回数です。

次の範囲の半角数字

0～1,000

○

―

7

WORKITEMMAX

最大作業件数

1回の実行間隔で呼び出し処理をする作業の最大件数です。

次の範囲の半角数字とハイフン

-1（無制限），または0～2,147,483,647

○

―

8

RECOVERYTIME

障害復旧間隔

アプリケーション呼び出しサービス自身に障害が発生した場合に，ほかのプロセスのアプリケーション呼び出しサービスが代わりに呼び出し処理をするまでの時間です（単位：秒）。

次の範囲の半角数字

1～86,400

○

―

（凡例）

○：必須

―：不要（読み込まない）

注※1

ref識別子共通設定とは，エラーイベント，メッセージイベント，サービスタスク，およびビジネスルールタスクのref識別子の共通設定のことで，アプリケーション呼び出し制御情報およびアプリケーション呼び出しグループ定義のどちらにも登録しないref識別子に対して有効になります。

タイマーイベントの共通設定には開始（タイマー）イベントの場合の(Create)と，開始（タイマー）以外のタイマーイベントの場合の(Transit)があります。開始（タイマー）以外のタイマーイベントとは，次に示すBPMN要素です。

キャッチ（タイマー）

イベント・サブプロセス中断開始（タイマー）

イベント・サブプロセス非中断開始（タイマー）

境界中断（タイマー）

境界非中断（タイマー）

ref識別子共通設定(Common)およびタイマーイベントの共通設定(Create)，(Transit)のデフォルト値を次に示します。

項番

BPMN要素

実行間隔（秒）

リトライ間隔（秒）

リトライ回数（回）

最大作業件数（件）

障害復旧間隔（秒）

1

エラーイベント

300

300

0

10,000

1,500

2

メッセージイベント

300

300

0

10,000

1,500

3

サービスタスクまたはビジネスルールタスク

300

300

0

10,000

1,500

4

開始（タイマー）イベント

300

0

0

10,000

1,500

5

開始（タイマー）以外のタイマーイベント

300

0

0

10,000

1,500

注※2

タイマーイベントの場合，リトライ回数，およびリトライ間隔は無視され，0が設定されます。ただし，項目の省略はできないため，デフォルト値の指定を推奨します。

更新オプション（UPDATEOPTION）の指定によって実施される処理を次に示します。

更新オプション（UPDATEOPTION）がUの場合

「表2‒35　アプリケーション呼び出し制御情報の項目」のすべての項目を記入します。

種別（TYPE）と，ref識別子またはグループ名（ID）の組み合わせが重複している行がある場合，最後の行が有効となります。

また，IDに指定したref識別子がアプリケーション呼び出しグループ定義に存在するとエラーになります。

更新オプション（UPDATEOPTION）がDの場合

実行間隔（EXECUTEINTERVAL），リトライ間隔（RETRYINTERVAL），リトライ回数（RETRYCOUNT），最大作業件数（WORKITEMMAX），および障害復旧間隔（RECOVERYTIME）は省略できます。記載した場合もエラーにはなりません。

ref識別子またはグループ名（ID）に(Common)を指定した場合，更新オプション（UPDATEOPTION）にDを指定しても削除されません。

ref識別子またはグループ名（ID）の更新オプション（UPDATEOPTION）の指定値ごとの処理内容を次に示します。

ref識別子またはグループ名（ID）の指定値

更新オプション（UPDATEOPTION）の指定値

処理内容

(Common)

U

アプリケーション呼び出し制御情報を更新します。

D

エラーになります。

(Common)以外

U

対象のアプリケーション呼び出し制御情報が存在する場合は，アプリケーション呼び出し制御情報を更新します。

存在しない場合は，アプリケーション呼び出し制御情報を追加します。

D

対象のアプリケーション呼び出し制御情報が存在する場合は，アプリケーション呼び出し制御情報を削除します。

存在しない場合は該当行を無視します。

アプリケーション呼び出し制御情報ファイルの記述例を次に示します。

U,err,(Common),300,300,0,10000,1500
U,msg,(Common),300,300,0,10000,1500
U,ope,(Common),300,300,0,10000,1500
U,tim,(Create),400,0,0,10000,1500
U,tim,(Transit),400,0,0,10000,1500
U,grp,Group001,300,400,0,10000,1000
U,grp,Group002,300,400,0,10000,1500
U,err,ref001,250,150,0,10000,900
U,msg,ref001,200,150,0,10000,900
U,ope,ref001,200,150,0,10000,1000

なお，アプリケーション呼び出しグループ定義の更新については，「2.9.1　BPMN連携機能を使用する場合のciwmngapgrp」を参照してください。

実行条件

このコマンドを実行できるコンポーネントの稼働状態を次に示します。

コンポーネント

稼働状態

起動中

停止中

CSCIWManagementServer

○

○

案件運用操作

○

○

CSCIWライブラリを使用した業務アプリケーション（J2EEアプリケーション）

○

○

CSCIWライブラリを使用した業務アプリケーション（Javaアプリケーション）

○

○

アプリケーション呼び出しサービス

×※

○

RESTサービス

○

○

運用管理RESTサービス

○

○

同一マシンでのほかのコマンド

×

○

異なるマシンでの同一コマンド

×

○

異なるマシンでのほかのコマンド

×

○

DBMS

○

×

（凡例）

○：コマンドを実行できます。

×：コマンドを実行できません。

注※

-listオプションを指定する場合は，アプリケーション呼び出しサービスの起動中でもコマンドを実行できます。

-chgオプションを指定する場合は，「アプリケーション呼び出しサービス起動中に実行できる操作」を参照してください。

アプリケーション呼び出しサービス起動中に実行できる操作

アプリケーション呼び出しサービスが起動中の場合，次の操作ができます。

アプリケーション呼び出し制御情報の表示

登録済みのアプリケーション呼び出し制御情報の，次に示す項目の変更

実行間隔

リトライ間隔

リトライ回数

最大作業件数

障害復旧間隔

アプリケーション呼び出し制御情報の追加または削除

ただし，追加または削除できるのは，対象のref識別子またはグループに属する作業が生成されていない場合だけです。例を次に示します。

追加対象のref識別子を使用しているビジネスプロセス定義が未登録の場合，対象のref識別子のアプリケーション呼び出し制御情報を追加できます。

削除対象のref識別子を使用しているビジネスプロセス定義をすべて削除したあとに，対象のref識別子のアプリケーション呼び出し制御情報を削除できます。

引数

-sid <system_id>

環境構築時に設定したシステムIDを指定します。指定したシステムIDに対応するアプリケーション呼び出し制御情報が対象になります。

指定できる値は，半角英大文字と半角数字で5文字以内です。ただし，先頭には半角英大文字を指定してください。

-list

アプリケーション呼び出し制御情報を標準出力に表示する場合に指定します。

アプリケーション呼び出し制御情報ファイルのフォーマットに従って，行頭に「#」が書かれた状態（コメントアウトされた状態）で出力されます。出力結果をリダイレクトしてファイルに保存し，変更したい行を編集したり，-apdfオプションに指定したりできます。

アプリケーション呼び出し制御情報の出力例を次に示します。

ref識別子またはグループ名（ID）の値は，ref識別子共通設定(Common)，タイマーイベントの共通設定，アプリケーション呼び出しグループのグループ名，ref識別子の順で表示されます。

図2‒1　アプリケーション呼び出し制御情報の出力例

アプリケーション呼び出しグループ定義の更新については，「2.9.1　BPMN連携機能を使用する場合のciwmngapgrp」を参照してください。

-chg

アプリケーション呼び出し制御情報を変更する場合に指定します。-chgオプションを指定すると，アプリケーション呼び出し制御情報ファイルの内容がチェックされます。チェック結果に問題がなければ，アプリケーション呼び出し制御情報が更新されます。アプリケーション呼び出し制御情報ファイルの最後の行までチェックが実施され，エラーがあればコマンドが終了します。

-apdf <application_call_definition_file>

-chgオプションを指定してアプリケーション呼び出し制御情報を変更する場合に，変更内容が書かれたアプリケーション呼び出し制御情報ファイルのファイル名を指定します。

戻り値

戻り値

内容

0

正常終了

1

致命的なエラー

9※

実行権限エラー

51

パラメーター不正

100

アプリケーション呼び出し制御情報ファイルの内容の不正

150

アプリケーション呼び出し制御情報ファイルのアクセスエラー

254

異常終了

注※

Windowsの場合だけ発生します。

2.8.2　BPMN連携機能を使用しない場合のciwmngap

形式

形式1（アプリケーション呼び出し制御情報を一覧表示する場合）

ciwmngap -sid <system_id>
-list

形式2（入力用ファイルの内容に従ってアプリケーション呼び出し制御情報を変更する場合）

ciwmngap -sid <system_id>
-chg
-apdf　<application_call_definition_file>

形式3（オプションファイルを指定して実行する場合）※

ciwmngap -file <option_file_name>
[-encoding <character_set>]

形式4（コマンドの形式を表示する場合）※

ciwmngap -h

注※

すべてのコマンドで同じ形式で指定します。詳細は，「1.5　コマンド共通のオプション」を参照してください。

機能

アプリケーション呼び出し制御情報を管理します。

このコマンドで実行できることを次に示します。

アプリケーション呼び出し制御情報の，次の設定の変更

ref識別子単位の，実行間隔，リトライ間隔，リトライ回数などの設定

グループ単位の，実行間隔，リトライ間隔，リトライ回数などの設定

アプリケーション呼び出し制御情報の一覧表示

アプリケーション呼び出し制御情報ファイルのフォーマット

アプリケーション呼び出し制御情報ファイルのフォーマットを次に示します。

<更新オプション>,<種別>,<ref識別子またはグループ名>,<実行間隔>,<リトライ間隔>,<リトライ回数>,<最大作業件数>,<障害復旧間隔>

「#」から始まる行はコメント行として扱われるため，読み込まれません。

改行だけの行は無視されます。

「KDIW」から始まる行は無視されます。そのため，-listオプションでリダイレクトして作成したファイルから，「KDIW」から始まるメッセージの行を削除する必要はありません。

コメント行の場合，およびref識別子の記述がない場合は，指定内容は反映されません。

表2‒36　アプリケーション呼び出し制御情報の項目

列番号

項目名

説明

値域

更新オプション（UPDATEOPTION）ごとの項目要否

U（更新）の場合

D（削除）の場合

1

UPDATEOPTION

更新オプション

情報の更新方法を示すオプション識別子で，この指定に従って情報を更新します。次のどちらかを指定してください。

U：更新

D：削除

UまたはD

○

○

2

TYPE

種別

次のどちらかの種別です。

ope：RESTアプリケーション呼び出しの場合

grp：アプリケーション呼び出しグループの場合

次のどちらかの文字列

ope

grp

○

○

3

ID

ref識別子またはグループ名

更新の対象となるref識別子，またはグループ名です。

ref識別子共通設定※を更新する場合は，(Common)を指定します。

種別（TYPE）にopeを指定した場合だけ(Common)を指定できます。

次に示すどちらかの値

1. 次の条件を両方満たす値

半角英数字とアンダースコア（_）から構成されている

((<SYSTEMID>_<APPLICATION_LOCK_INFOテーブルのLockNameのカラムサイズ) - 7)バイト以内

2. (Common)

○

○

4

EXECUTEINTERVAL

実行間隔

呼び出し処理の対象の作業があるかどうかを検索する間隔です（単位：秒）。

次の範囲の半角数字

0～86,400

○

―

5

RETRYINTERVAL

リトライ間隔

呼び出し処理でエラーになった時に，次にリトライするまでの間隔です（単位：秒）。

次の範囲の半角数字

1～86,400

○

―

6

RETRYCOUNT

リトライ回数

呼び出し処理でエラーになった時に，リトライする回数です。

次の範囲の半角数字

0～1,000

○

―

7

WORKITEMMAX

最大作業件数

1回の実行間隔で呼び出し処理をする作業の最大件数です。

次の範囲の半角数字とハイフン

-1（無制限），または0～2,147,483,647

○

―

8

RECOVERYTIME

障害復旧間隔

アプリケーション呼び出しサービス自身に障害が発生した場合に，ほかのプロセスのアプリケーション呼び出しサービスが代わりに呼び出し処理をするまでの時間です（単位：秒）。

次の範囲の半角数字

1～86,400

○

―

（凡例）

○：必須

―：不要（読み込まない）

注※

ref識別子共通設定は，アプリケーション呼び出し制御情報およびアプリケーション呼び出しグループ定義のどちらにも登録しないref識別子に対して有効になる設定です。

ref識別子共通設定(Common)のデフォルト値を次に示します。

項番

種別

実行間隔（秒）

リトライ間隔（秒）

リトライ回数（回）

最大作業件数（件）

障害復旧間隔（秒）

1

RESTアプリケーション呼び出し

300

300

0

10,000

1,500

更新オプション（UPDATEOPTION）の指定によって実施される処理を次に示します。

更新オプション（UPDATEOPTION）がUの場合

「表2‒36　アプリケーション呼び出し制御情報の項目」のすべての項目を記入します。

種別（TYPE）と，ref識別子またはグループ名（ID）の組み合わせが重複している行がある場合，最後の行が有効となります。

また，IDに指定したref識別子がアプリケーション呼び出しグループ定義に存在するとエラーになります。

更新オプション（UPDATEOPTION）がDの場合

実行間隔（EXECUTEINTERVAL），リトライ間隔（RETRYINTERVAL），リトライ回数（RETRYCOUNT），最大作業件数（WORKITEMMAX），および障害復旧間隔（RECOVERYTIME）は省略できます。記載した場合もエラーにはなりません。

ref識別子またはグループ名（ID）に(Common)を指定した場合，更新オプション（UPDATEOPTION）にDを指定しても削除されません。

ref識別子またはグループ名（ID）の更新オプション（UPDATEOPTION）の指定値ごとの処理内容を次に示します。

ref識別子またはグループ名（ID）の指定値

更新オプション（UPDATEOPTION）の指定値

処理内容

(Common)

U

アプリケーション呼び出し制御情報を更新します。

D

エラーになります。

(Common)以外

U

対象のアプリケーション呼び出し制御情報が存在する場合は，アプリケーション呼び出し制御情報を更新します。

存在しない場合は，アプリケーション呼び出し制御情報を追加します。

D

対象のアプリケーション呼び出し制御情報が存在する場合は，アプリケーション呼び出し制御情報を削除します。

存在しない場合は該当行を無視します。

アプリケーション呼び出し制御情報ファイルの記述例を次に示します。

U,ope,(Common),300,300,0,10000,1500
U,grp,Group001,300,400,0,10000,1000
U,grp,Group002,300,400,0,10000,1500
U,ope,ref001,200,150,0,10000,1000

なお，アプリケーション呼び出しグループ定義の更新については，「2.9.2　BPMN連携機能を使用しない場合のciwmngapgrp」を参照してください。

実行条件

このコマンドを実行できるコンポーネントの稼働状態を次に示します。

コンポーネント

稼働状態

起動中

停止中

CSCIWManagementServer

○

○

案件運用操作

○

○

CSCIWライブラリを使用した業務アプリケーション（J2EEアプリケーション）

○

○

CSCIWライブラリを使用した業務アプリケーション（Javaアプリケーション）

○

○

アプリケーション呼び出しサービス

×※

○

運用管理RESTサービス

○

○

同一マシンでのほかのコマンド

×

○

異なるマシンでの同一コマンド

×

○

異なるマシンでのほかのコマンド

×

○

DBMS

○

×

（凡例）

○：コマンドを実行できます。

×：コマンドを実行できません。

注※

-listオプションを指定する場合は，アプリケーション呼び出しサービスの起動中でもコマンドを実行できます。

-chgオプションを指定する場合は，「アプリケーション呼び出しサービス起動中に実行できる操作」を参照してください。

アプリケーション呼び出しサービス起動中に実行できる操作

アプリケーション呼び出しサービスが起動中の場合，次の操作ができます。

アプリケーション呼び出し制御情報の表示

登録済みのアプリケーション呼び出し制御情報の，次に示す項目の変更

実行間隔

リトライ間隔

リトライ回数

最大作業件数

障害復旧間隔

アプリケーション呼び出し制御情報の追加または削除

ただし，追加または削除できるのは，対象のref識別子またはグループに属する作業が生成されていない場合だけです。例を次に示します。

追加対象のref識別子を使用しているビジネスプロセス定義が未登録の場合，対象のref識別子のアプリケーション呼び出し制御情報を追加できます。

削除対象のref識別子を使用しているビジネスプロセス定義をすべて削除したあとに，対象のref識別子のアプリケーション呼び出し制御情報を削除できます。

引数

-sid <system_id>

環境構築時に設定したシステムIDを指定します。指定したシステムIDに対応するアプリケーション呼び出し制御情報が対象になります。

指定できる値は，半角英大文字と半角数字で5文字以内です。ただし，先頭には半角英大文字を指定してください。

-list

アプリケーション呼び出し制御情報を標準出力に表示する場合に指定します。

アプリケーション呼び出し制御情報ファイルのフォーマットに従って，行頭に「#」が書かれた状態（コメントアウトされた状態）で出力されます。出力結果をリダイレクトしてファイルに保存し，変更したい行を編集したり，-apdfオプションに指定したりできます。

アプリケーション呼び出し制御情報の出力例を次に示します。

ref識別子またはグループ名（ID）の値は，ref識別子共通設定(Common)，アプリケーション呼び出しグループのグループ名，ref識別子の順で表示されます。

図2‒2　アプリケーション呼び出し制御情報の出力例

アプリケーション呼び出しグループ定義の更新については，「2.9.2　BPMN連携機能を使用しない場合のciwmngapgrp」を参照してください。

-chg

アプリケーション呼び出し制御情報を変更する場合に指定します。-chgオプションを指定すると，アプリケーション呼び出し制御情報ファイルの内容がチェックされます。チェック結果に問題がなければ，アプリケーション呼び出し制御情報が更新されます。アプリケーション呼び出し制御情報ファイルの最後の行までチェックが実施され，エラーがあればコマンドが終了します。

-apdf <application_call_definition_file>

-chgオプションを指定してアプリケーション呼び出し制御情報を変更する場合に，変更内容が書かれたアプリケーション呼び出し制御情報ファイルのファイル名を指定します。

戻り値

戻り値

内容

0

正常終了

1

致命的なエラー

9※

実行権限エラー

51

パラメーター不正

100

アプリケーション呼び出し制御情報ファイルの内容の不正

150

アプリケーション呼び出し制御情報ファイルのアクセスエラー

254

異常終了

注※

Windowsの場合だけ発生します。

2.9　ciwmngapgrp（アプリケーション呼び出しグループの管理）

2.9.1　BPMN連携機能を使用する場合のciwmngapgrp

形式

形式1（アプリケーション呼び出しグループ定義を一覧で表示する場合）

ciwmngapgrp -sid <system_id>
-list

形式2（入力用ファイルの内容に従ってアプリケーション呼び出しグループ定義を更新する場合）

ciwmngapgrp -sid <system_id>
-chg
-apgf <application_call_group_file>

形式3（オプションファイルを指定して実行する場合）※

ciwmngapgrp -file <option_file_name>
[-encoding <character_set>]

形式4（コマンドの形式を表示する場合）※

ciwmngapgrp -h

注※

すべてのコマンドで同じ形式で指定します。詳細は，「1.5　コマンド共通のオプション」を参照してください。

機能

アプリケーション呼び出しグループを管理します。

このコマンドで実行できることを次に示します。

アプリケーション呼び出しグループ定義の，次の情報更新の操作

アプリケーション呼び出しグループにref識別子を登録

アプリケーション呼び出しグループからref識別子を削除

アプリケーション呼び出しグループ定義の一覧表示

なお，個別にアプリケーション呼び出し制御情報を設定しているref識別子は，アプリケーション呼び出しグループに登録できません。

アプリケーション呼び出しグループ定義ファイルのフォーマット

アプリケーション呼び出しグループ定義ファイルのフォーマットを次に示します。

<更新オプション>,<種別>,<ref識別子>,<所属グループ>

「#」から始まる行はコメント行として扱われるため，読み込まれません。

改行だけの行は無視されます。

「KDIW」から始まる行は無視されます。そのため，-listオプションでリダイレクトして作成したファイルから，「KDIW」から始まるメッセージの行を削除する必要はありません。

コメント行の場合，およびref識別子の記述がない場合は，指定内容は反映されません。

表2‒37　アプリケーション呼び出しグループ定義の項目

列番号

項目名

説明

値域

更新オプション（UPDATEOPTION）ごとの項目要否

U（更新）の場合

D（削除）の場合

1

UPDATEOPTION

更新オプション

情報の更新方法を示すオプション識別子です。この指定に従って情報を更新します。次のどちらかを指定してください。

U：更新

D：削除

UまたはD

○

○

2

TYPE

種別

次のどれかの種別です。

msg：メッセージイベントの場合

ope：サービスタスクまたはビジネスルールタスクの場合

err：エラーイベントの場合

次のどれかの文字列

msg

ope

err

○

○

3

ID

ref識別子

更新の対象となるref識別子です。

次の条件を両方満たす値

半角英数字とアンダースコア（_）から構成されている

((<SYSTEMID>_<APPLICATION_LOCK_INFOテーブルのLockNameのカラムサイズ) - 7)バイト以内

○

○

4

GROUPNAME

所属グループ

ref識別子が所属するグループ名です。アプリケーション呼び出し制御情報に指定するグループ名と一致させてください。

次の条件を両方満たす値

半角英数字とアンダースコア（_）から構成されている

((<SYSTEMID>_<APPLICATION_LOCK_INFOテーブルのLockNameのカラムサイズ) - 7)バイト以内

○

―

（凡例）

○：必須

―：不要（読み込まない）

更新オプション（UPDATEOPTION）の指定によって実施される処理を次に示します。

更新オプション（UPDATEOPTION）がUの場合

種別（TYPE）と，ref識別子（ID）の組み合わせが重複している行がある場合，最後の行が有効となります。

また，IDに指定したref識別子がアプリケーション呼び出し制御情報に存在するとエラーになります。

アプリケーション呼び出しグループ定義を更新する場合は，アプリケーション呼び出しグループ定義のすべての項目を記入します。

更新オプション（UPDATEOPTION）がDの場合

所属グループ（GROUPNAME）は省略できます。記載した場合もエラーにはなりません。

アプリケーション呼び出しグループ定義ファイルの記述例を次に示します。

U,err,ref002,Group01
U,msg,ref002,Group01
U,msg,ref003,Group01
U,ope,ref002,Group01
U,ope,ref003,Group01
U,err,ref003,Group02

なお，アプリケーション呼び出し制御情報の更新については，「2.8.1　BPMN連携機能を使用する場合のciwmngap」を参照してください。

実行条件

このコマンドを実行できるコンポーネントの稼働状態を次に示します。

コンポーネント

稼働状態

起動中

停止中

CSCIWManagementServer

○

○

案件運用操作

○

○

CSCIWライブラリを使用した業務アプリケーション（J2EEアプリケーション）

○

○

CSCIWライブラリを使用した業務アプリケーション（Javaアプリケーション）

○

○

アプリケーション呼び出しサービス

×※

○

RESTサービス

○

○

運用管理RESTサービス

○

○

同一マシンでのほかのコマンド

×

○

異なるマシンでの同一コマンド

×

○

異なるマシンでのほかのコマンド

×

○

DBMS

○

×

（凡例）

○：コマンドを実行できます。

×：コマンドを実行できません。

注※

-listオプションを指定する場合は，アプリケーション呼び出しサービスの起動中でもコマンドを実行できます。

-chgオプションを指定する場合は，「アプリケーション呼び出しサービス起動中に実行できる操作」を参照してください。

アプリケーション呼び出しサービス起動中に実行できる操作

アプリケーション呼び出しサービスが起動中の場合，次の操作ができます。

アプリケーション呼び出しグループ定義の表示

アプリケーション呼び出しグループ定義の追加，変更，または削除

ただし，追加，変更，または削除できるのは，対象のref識別子を持つ作業が生成されていない場合だけです。例を次に示します。

追加または変更対象のref識別子を使用しているビジネスプロセス定義が未登録の場合，対象のref識別子のアプリケーション呼び出しグループ定義を追加または変更できます。

削除対象のref識別子を使用しているビジネスプロセス定義をすべて削除したあとに，対象のref識別子のアプリケーション呼び出しグループ定義を削除できます。

引数

-sid <system_id>

環境構築時に設定したシステムIDを指定します。指定したシステムIDに対応するアプリケーション呼び出しグループ定義が対象になります。

指定できる値は，半角英大文字と半角数字で5文字以内です。ただし，先頭には半角英大文字を指定してください。

-list

アプリケーション呼び出しグループ定義を標準出力に表示する場合に指定します。

アプリケーション呼び出しグループ定義ファイルのフォーマットに従って，行頭に「#」が書かれた状態（コメントアウトされた状態）で出力されます。出力結果をリダイレクトしてファイルに保存し，変更したい行を編集したり，-apgfオプションに指定したりできます。

アプリケーション呼び出しグループ定義の出力例を次に示します。

#UPDATEOPTION,TYPE,ID,GROUPNAME
#,err,ref002,Group01
#,msg,ref002,Group01
#,msg,ref003,Group01
#,ope,ref002,Group01
#,ope,ref003,Group01
#,err,ref003,Group02

所属グループ（GROUPNAME），種別（TYPE），ref識別子（ID）の順でソートして表示されます。

-chg

アプリケーション呼び出しグループ定義を変更する場合に指定します。-chgオプションを指定すると，アプリケーション呼び出しグループ定義ファイルの内容がチェックされます。チェック結果に問題がなければ，アプリケーション呼び出しグループ定義が更新されます。アプリケーション呼び出しグループ定義ファイルの最後の行までチェックが実施され，エラーがあればコマンドが終了します。

-apgf <application_call_group_file>

-chgオプションを指定してアプリケーション呼び出しグループ定義を変更する場合に，変更内容が書かれたアプリケーション呼び出しグループ定義ファイルのファイル名を指定します。

戻り値

戻り値

内容

0

正常終了

1

致命的なエラー

9※

実行権限エラー

51

パラメーター不正

100

アプリケーション呼び出しグループ定義ファイルの内容の不正

150

アプリケーション呼び出しグループ定義ファイルのアクセスエラー

254

異常終了

注※

Windowsの場合だけ発生します。

注意事項

アプリケーション呼び出しグループ定義に登録したグループは，アプリケーション呼び出し制御情報に登録する必要があります。登録しなかった場合，そのグループに登録したref識別子が呼び出されません。

2.9.2　BPMN連携機能を使用しない場合のciwmngapgrp

形式

形式1（アプリケーション呼び出しグループ定義を一覧で表示する場合）

ciwmngapgrp -sid <system_id>
-list

形式2（入力用ファイルの内容に従ってアプリケーション呼び出しグループ定義を更新する場合）

ciwmngapgrp -sid <system_id>
-chg
-apgf <application_call_group_file>

形式3（オプションファイルを指定して実行する場合）※

ciwmngapgrp -file <option_file_name>
[-encoding <character_set>]

形式4（コマンドの形式を表示する場合）※

ciwmngapgrp -h

注※

すべてのコマンドで同じ形式で指定します。詳細は，「1.5　コマンド共通のオプション」を参照してください。

機能

アプリケーション呼び出しグループを管理します。

このコマンドで実行できることを次に示します。

アプリケーション呼び出しグループ定義の，次の情報更新の操作

アプリケーション呼び出しグループにref識別子を登録

アプリケーション呼び出しグループからref識別子を削除

アプリケーション呼び出しグループ定義の一覧表示

なお，個別にアプリケーション呼び出し制御情報を設定しているref識別子は，アプリケーション呼び出しグループに登録できません。

アプリケーション呼び出しグループ定義ファイルのフォーマット

アプリケーション呼び出しグループ定義ファイルのフォーマットを次に示します。

<更新オプション>,<種別>,<ref識別子>,<所属グループ>

「#」から始まる行はコメント行として扱われるため，読み込まれません。

改行だけの行は無視されます。

「KDIW」から始まる行は無視されます。そのため，-listオプションでリダイレクトして作成したファイルから，「KDIW」から始まるメッセージの行を削除する必要はありません。

コメント行の場合，およびref識別子の記述がない場合は，指定内容は反映されません。

表2‒38　アプリケーション呼び出しグループ定義の項目

列番号

項目名

説明

値域

更新オプション（UPDATEOPTION）ごとの項目要否

U（更新）の場合

D（削除）の場合

1

UPDATEOPTION

更新オプション

情報の更新方法を示すオプション識別子です。この指定に従って情報を更新します。次のどちらかを指定してください。

U：更新

D：削除

UまたはD

○

○

2

TYPE

種別

次の種別です。

ope：RESTアプリケーション呼び出し

ope

○

○

3

ID

ref識別子

更新の対象となるref識別子です。

次の条件を両方満たす値

半角英数字とアンダースコア（_）から構成されている

((<SYSTEMID>_<APPLICATION_LOCK_INFOテーブルのLockNameのカラムサイズ) - 7)バイト以内

○

○

4

GROUPNAME

所属グループ

ref識別子が所属するグループ名です。アプリケーション呼び出し制御情報に指定するグループ名と一致させてください。

次の条件を両方満たす値

半角英数字とアンダースコア（_）から構成されている

((<SYSTEMID>_<APPLICATION_LOCK_INFOテーブルのLockNameのカラムサイズ) - 7)バイト以内

○

―

（凡例）

○：必須

―：不要（読み込まない）

更新オプション（UPDATEOPTION）の指定によって実施される処理を次に示します。

更新オプション（UPDATEOPTION）がUの場合

種別（TYPE）と，ref識別子（ID）の組み合わせが重複している行がある場合，最後の行が有効となります。

また，IDに指定したref識別子がアプリケーション呼び出し制御情報に存在するとエラーになります。

アプリケーション呼び出しグループ定義を更新する場合は，アプリケーション呼び出しグループ定義のすべての項目を記入します。

更新オプション（UPDATEOPTION）がDの場合

所属グループ（GROUPNAME）は省略できます。記載した場合もエラーにはなりません。

アプリケーション呼び出しグループ定義ファイルの記述例を次に示します。

U,ope,ref002,Group01
U,ope,ref003,Group01
U,ope,ref004,Group02
U,ope,ref005,Group02

なお，アプリケーション呼び出し制御情報の更新については，「2.8.2　BPMN連携機能を使用しない場合のciwmngap」を参照してください。

実行条件

このコマンドを実行できるコンポーネントの稼働状態を次に示します。

コンポーネント

稼働状態

起動中

停止中

CSCIWManagementServer

○

○

案件運用操作

○

○

CSCIWライブラリを使用した業務アプリケーション（J2EEアプリケーション）

○

○

CSCIWライブラリを使用した業務アプリケーション（Javaアプリケーション）

○

○

アプリケーション呼び出しサービス

×※

○

運用管理RESTサービス

○

○

同一マシンでのほかのコマンド

×

○

異なるマシンでの同一コマンド

×

○

異なるマシンでのほかのコマンド

×

○

DBMS

○

×

（凡例）

○：コマンドを実行できます。

×：コマンドを実行できません。

注※

-listオプションを指定する場合は，アプリケーション呼び出しサービスの起動中でもコマンドを実行できます。

-chgオプションを指定する場合は，「アプリケーション呼び出しサービス起動中に実行できる操作」を参照してください。

アプリケーション呼び出しサービス起動中に実行できる操作

アプリケーション呼び出しサービスが起動中の場合，次の操作ができます。

アプリケーション呼び出しグループ定義の表示

アプリケーション呼び出しグループ定義の追加，変更，または削除

ただし，追加，変更，または削除できるのは，対象のref識別子を持つ作業が生成されていない場合だけです。例を次に示します。

追加または変更対象のref識別子を使用しているビジネスプロセス定義が未登録の場合，対象のref識別子のアプリケーション呼び出しグループ定義を追加または変更できます。

削除対象のref識別子を使用しているビジネスプロセス定義をすべて削除したあとに，対象のref識別子のアプリケーション呼び出しグループ定義を削除できます。

引数

-sid <system_id>

環境構築時に設定したシステムIDを指定します。指定したシステムIDに対応するアプリケーション呼び出しグループ定義が対象になります。

指定できる値は，半角英大文字と半角数字で5文字以内です。ただし，先頭には半角英大文字を指定してください。

-list

アプリケーション呼び出しグループ定義を標準出力に表示する場合に指定します。

アプリケーション呼び出しグループ定義ファイルのフォーマットに従って，行頭に「#」が書かれた状態（コメントアウトされた状態）で出力されます。出力結果をリダイレクトしてファイルに保存し，変更したい行を編集したり，-apgfオプションに指定したりできます。

アプリケーション呼び出しグループ定義の出力例を次に示します。

#UPDATEOPTION,TYPE,ID,GROUPNAME
U,ope,ref002,Group01
U,ope,ref003,Group01
U,ope,ref004,Group02
U,ope,ref005,Group02

所属グループ（GROUPNAME），種別（TYPE），ref識別子（ID）の順でソートして表示されます。

-chg

アプリケーション呼び出しグループ定義を変更する場合に指定します。-chgオプションを指定すると，アプリケーション呼び出しグループ定義ファイルの内容がチェックされます。チェック結果に問題がなければ，アプリケーション呼び出しグループ定義が更新されます。アプリケーション呼び出しグループ定義ファイルの最後の行までチェックが実施され，エラーがあればコマンドが終了します。

-apgf <application_call_group_file>

-chgオプションを指定してアプリケーション呼び出しグループ定義を変更する場合に，変更内容が書かれたアプリケーション呼び出しグループ定義ファイルのファイル名を指定します。

戻り値

戻り値

内容

0

正常終了

1

致命的なエラー

9※

実行権限エラー

51

パラメーター不正

100

アプリケーション呼び出しグループ定義ファイルの内容の不正

150

アプリケーション呼び出しグループ定義ファイルのアクセスエラー

254

異常終了

注※

Windowsの場合だけ発生します。

注意事項

アプリケーション呼び出しグループ定義に登録したグループは，アプリケーション呼び出し制御情報に登録する必要があります。登録しなかった場合，そのグループに登録したref識別子が呼び出されません。

2.10　ciwmngbp（ビジネスプロセス定義の管理）

2.10.1　BPMN連携機能を使用する場合のciwmngbp

形式

形式1（ビジネスプロセス定義を登録する場合）

ciwmngbp -sid <system_id>
-reg
-bpf <process_definition_file>
[-force] [-bpmnf <bpmn_process_definition_file>]

形式2（ビジネスプロセス定義を取得する場合）

ciwmngbp -sid <system_id>
-get
-bpn <process_definition_name>
-bpv <process_definition_version>
-bpf <process_definition_file>
[-force] [-bpmnf <bpmn_process_definition_file>]

形式3（ビジネスプロセス定義の属性を変更する場合）

ciwmngbp -sid <system_id>
-chg
-bpn <process_definition_name>
-bpv <process_definition_version>
(-s {ACTIVE｜INACTIVE}
｜-pfd {<process_from_date>｜ORIGIN}
｜-ptd {<process_to_date>｜BEYOND}
｜-bpa <responsible>)

形式4（ビジネスプロセス定義を削除する場合）

ciwmngbp -sid <system_id>
-del
-bpn <process_definition_name>
-bpv <process_definition_version>

形式5（BPMNビジネスプロセス定義を登録する）

ciwmngbp -sid <system_id>
-regbpmn
-bpn <process_definition_name>
-bpv <process_definition_version>
-bpmnf <bpmn_process_definition_file>

形式6（ワーク管理データベースに登録されているビジネスプロセス定義を一覧表示する場合）

ciwmngbp -sid <system_id>
-list

形式7（オプションファイルを指定して実行する場合）※

ciwmngbp -file <option_file_name>
[-encoding <character_set> ]

形式8（コマンドの形式を表示する場合）※

ciwmngbp -h

注※

すべてのコマンドで同じ形式で指定します。詳細は，「1.5　コマンド共通のオプション」を参照してください。

機能

ビジネスプロセス定義を管理します。

このコマンドで実行できることを次に示します。

ビジネスプロセス定義の登録

ビジネスプロセス定義の取得

ビジネスプロセス定義の属性変更

ビジネスプロセス定義の削除

BPMNビジネスプロセス定義の登録

ビジネスプロセス定義の一覧表示

なお，BPMNビジネスプロセス定義は，ビジネスプロセス定義と紐づけて登録します。

実行条件

このコマンドを実行できるコンポーネントの稼働状態を次に示します。

コンポーネント

稼働状態

起動中

停止中

CSCIWManagementServer

×※

○

案件運用操作

○

○

CSCIWライブラリを使用した業務アプリケーション（J2EEアプリケーション）

○

○

CSCIWライブラリを使用した業務アプリケーション（Javaアプリケーション）

×※

○

アプリケーション呼び出しサービス

○

○

RESTサービス

○

○

運用管理RESTサービス

○

○

同一マシンでのほかのコマンド

×

○

異なるマシンでの同一コマンド

×

○

異なるマシンでのほかのコマンド

×

○

DBMS

○

×

（凡例）

○：コマンドを実行できます。

×：コマンドを実行できません。

注※

-getオプションまたは-listオプション指定時は，起動中でもコマンドを実行できます。

また，-regオプション，-chgオプション，または-delオプション指定時は，起動中でもコマンドを実行できます。ただし，コマンド実行後は変更を反映するために再起動してください。

引数

-sid <system_id>

環境構築時に設定したシステムIDを指定します。指定したシステムIDに対応するワーク管理システム上のビジネスプロセス定義が対象になります。

指定できる値は，半角英大文字と半角数字で5文字以内です。ただし，先頭には半角英大文字を指定してください。

-reg

ビジネスプロセス定義を登録する場合に指定します。

このコマンドを実行したユーザがビジネスプロセス定義の管理者として設定されます。また，登録するビジネスプロセス定義の作成者は，このコマンドを実行したユーザになります。このため，ユーザ名の長さは，<SYSTEMID>_PROCESS_DEFテーブルのAuthorカラムのバイト数以内にしてください。

また，そのほかの注意事項について次に示します。

BPMNビジネスプロセス定義を登録する場合，ビジネスプロセス定義の登録に失敗したときは，BPMNビジネスプロセス定義は登録されません。

-get

ビジネスプロセス定義ファイルを取得する場合に指定します。

-chg

ビジネスプロセス定義の属性を変更する場合に指定します。

このオプションを指定した場合，次に示すオプションをどれかを1つ以上指定する必要があります。

-sオプション

-pfdオプション

-ptdオプション

-bpaオプション

-del

ビジネスプロセス定義を削除する場合に指定します。ただし，削除対象のビジネスプロセス定義が「活性」状態のとき，または削除対象のビジネスプロセス定義に案件が存在するときは，ビジネスプロセス定義を削除できません。

削除対象のビジネスプロセス定義に対応するBPMNビジネスプロセス定義が紐づけて登録されている場合，ビジネスプロセス定義と同時にBPMNビジネスプロセス定義も削除します。

-regbpmn

BPMNビジネスプロセス定義を登録する場合に指定します。

-list

ワーク管理データベースに登録されているビジネスプロセス定義の一覧を，CSV形式で表示する場合に指定します。

ビジネスプロセス定義一覧の表示フォーマットを次に示します。

Name,Version,StateCode,ValidFromDate,ValidToDate,Author,Responsible,ValidBPMNDef
ORSplitJoin1,1,ACTIVE(b),ORIGIN,BEYOND,csciw1,"csciw""1",Unregistered
ORSplitJoin1,2,ACTIVE(b),ORIGIN,BEYOND,csciw1,"csci,w1",Unregistered
ORSplitJoin2,1,INACTIVE(a),Thu Dec 14 00:00:00 JST 2006,Thu Dec 14 23:59:59 JST 2006,csciw1,csciw1,Registered

ビジネスプロセス定義一覧の1行目にはヘッダ情報が表示され，2行目以降には各ヘッダ情報に対応する値が表示されます。

表示項目の意味を次の表に示します。

表2‒39　表示項目（ビジネスプロセス定義一覧）

表示項目

意味

Name

ビジネスプロセス定義名を示します。

Version

ビジネスプロセス定義のバージョンを示します。

StateCode

ビジネスプロセス定義の状態を示します。

ビジネスプロセス定義の状態には，次に示す値が表示されます。

「ACTIVE」：「活性」状態を示します。

「INACTIVE」：「非活性」状態を示します。

ValidFromDate

案件投入可能開始日を示します。

案件投入可能開始日には，実行環境のタイムゾーンに依存した日付が表示されます。ただし，無限遠の過去の場合は「ORIGIN」が表示されます。

ValidToDate

案件投入可能終了日を示します。

案件投入可能終了日には，実行環境のタイムゾーンに依存した日付が表示されます。ただし，無限遠の未来の場合は「BEYOND」が表示されます。

Author

ビジネスプロセス定義の作成者を示します。

Responsible

ビジネスプロセス定義の管理者を示します。

ValidBPMNDef

BPMNビジネスプロセス定義の登録の有無を示します。

BPMNビジネスプロセス定義の登録の有無には，次に示す値が表示されます。

「Registered」：「登録済み」を示します。

「Unregistered」：「未登録」を示します。

-bpn <process_definition_name>

ビジネスプロセス定義名を指定します。指定したビジネスプロセス定義が，取得，属性変更，削除，または，BPMNビジネスプロセス定義の登録の対象になります。

ビジネスプロセス定義名は，<SYSTEMID>_PROCESS_DEFテーブルのNameカラムのバイト数以内で指定してください。

-bpv <process_definition_version>

ビジネスプロセス定義のバージョンを指定します。-bpnオプションに指定したビジネスプロセス定義名，かつこのオプションに指定したバージョンのビジネスプロセス定義が，取得，属性変更，削除，または，BPMNビジネスプロセス定義の登録の対象になります。

指定できる値は，-32,768〜32,767です。ただし，有効な値はciwtransbpmnコマンド実行時に指定できる1〜9,999となります。

-s {ACTIVE｜INACTIVE}

このオプションは，-chgオプションを指定した場合だけ指定できます。

ビジネスプロセス定義の状態を変更する場合に，変更後の状態を指定します。

指定できる値は，「ACTIVE」または「INACTIVE」です。値の意味を次に示します。

「ACTIVE」：「活性」状態に変更します。

「INACTIVE」：「非活性」状態に変更します。

-pfd {<process_from_date>｜ORIGIN}

このオプションは，-chgオプションを指定した場合だけ指定できます。

案件投入可能開始日を変更する場合に，変更後の案件投入可能開始日または「ORIGIN」を指定します。

案件投入可能開始日は，YYYYMMDD（YYYY：西暦，MM：月，DD：日）の形式で指定してください。例えば，20070510を指定した場合，2007/05/10の0時0分0秒を意味します。指定できる日付の範囲は，1970/01/03〜9999/12/30です。

ORIGINを指定した場合，無限遠の過去を意味します。

-ptd {<process_to_date>｜BEYOND}

このオプションは，-chgオプションを指定した場合だけ指定できます。

案件投入可能終了日を変更する場合に，変更後の案件投入可能終了日または「BEYOND」を指定します。

案件投入可能終了日は，YYYYMMDD（YYYY：西暦，MM：月，DD：日）の形式で指定してください。例えば，20070610を指定した場合，2007/06/10の23時59分59秒を意味します。指定できる日付の範囲は，1970/01/03〜9999/12/30です。

BEYONDを指定した場合，無限遠の未来を意味します。

-bpa <responsible>

このオプションは，-chgオプションを指定した場合だけ指定できます。

ビジネスプロセス定義の管理者名を指定します。

ビジネスプロセス定義の管理者名は，<SYSTEMID>_PROCESS_DEFテーブルのResponsibleカラムのバイト数以内で指定してください。

-bpf <process_definition_file>

-regオプションを指定してビジネスプロセス定義を登録する場合

BPMNエディタのビジネスプロセス定義変換機能またはciwtransbpmnコマンドで生成したビジネスプロセス定義を指定します。

なお，-forceオプションを同時に指定すると，同一名で同一バージョンのビジネスプロセス定義があったときに，強制的に上書きできます。

-getオプションを指定してビジネスプロセス定義を取得する場合

ワーク管理システムから取得したビジネスプロセス定義の内容を保存するビジネスプロセス定義ファイル名を指定します。

-forceオプションを同時に指定すると，同一名のビジネスプロセス定義ファイルがあったときに，強制的に上書きできます。

-bpmnf <bpmn_process_definition_file>

-regオプション，および-regbpmnオプションを指定してBPMNビジネスプロセス定義を登録する場合

BPMNエディタで編集し，BPMNエディタの機能でビジネスプロセス定義を変換して生成したか，またはciwtransbpmnコマンドで生成したBPMNビジネスプロセス定義ファイルのファイル名を指定します。それ以外のBPMNビジネスプロセス定義ファイルを使用した場合，動作の保証はできません。

-bpfオプションで指定したビジネスプロセス定義の登録に失敗した場合，指定したBPMNビジネスプロセス定義は登録されません。

BPMNビジネスプロセス定義を登録する場合，ファイルサイズは，4メガバイト（4,194,304バイト）以内にしてください。

-getオプションを指定してBPMNビジネスプロセス定義を取得する場合

ワーク管理システムから取得したBPMNビジネスプロセス定義の内容を保存するBPMNビジネスプロセス定義ファイル名を指定します。

-forceオプションを同時に指定すると，同一名のBPNMビジネスプロセス定義ファイルがあったときに，強制的に上書きできます。

-force

-regオプションを指定してビジネスプロセス定義を登録する場合

ワーク管理システムに同一名で同一バージョンのビジネスプロセス定義が登録されていたときに，-bpfオプションに指定したビジネスプロセス定義を登録します（強制的に上書きします）。ただし，次に示すときは，ビジネスプロセス定義を登録できません。

登録対象のビジネスプロセス定義が「活性」状態のとき

登録対象のビジネスプロセス定義に案件が存在するとき

このオプションを省略すると，同一名で同一バージョンのビジネスプロセス定義が登録されていたときに，ビジネスプロセス定義を登録できません。

-getオプションを指定してビジネスプロセス定義を取得する場合

-bpfオプションに指定したビジネスプロセス定義ファイルと同一名のファイルが存在したときに，そのファイルに指定したビジネスプロセス定義を取得します（強制的に上書きします）。

このオプションを省略すると，同一名のビジネスプロセス定義ファイルが存在したときに，ビジネスプロセス定義を取得できません。

-file <option_file_name>

このオプションは，すべてのコマンドで指定できます。詳細は，「1.5.1　-fileオプション」を参照してください。

-encoding <character_set>

このオプションは，すべてのコマンドで指定できます。詳細は，「1.5.1　-fileオプション」を参照してください。

-h

このオプションは，すべてのコマンドで指定できます。詳細は，「1.5.2　-hオプション」を参照してください。

戻り値

戻り値

内容

0

正常終了

1

致命的なエラー

9※

実行権限エラー

50

指定した状態に変更済みである

51

パラメーター不正

100

ビジネスプロセス定義の内容不正

BPMNビジネスプロセス定義ファイルのファイルサイズが規定値を超過

110

定義登録ユーザ名の不正

150

ビジネスプロセス定義ファイルおよびBPMNビジネスプロセス定義ファイルのアクセスエラー

254

異常終了

注※

Windowsの場合だけ発生します。

注意事項

オプション引数に，文字列を指定する場合の注意事項については，「1.2　コマンドの入力形式」を参照してください。

マルチマシン構成の場合，どれか1つのマシンでこのコマンドを実行してください。

このコマンドは，CSCIWManagementServerおよびCSCIWを使用しているJavaアプリケーションが起動中でも実行できます。ただし，コマンド実行後に，必ずCSCIWManagementServerおよびCSCIWを使用しているJavaアプリケーションを再起動してください。再起動しないと，ビジネスプロセス定義の変更が反映されません。

2.10.2　BPMN連携機能を使用しない場合のciwmngbp

形式

形式1（ビジネスプロセス定義を登録する場合）

ciwmngbp -sid <system_id>
-reg
-bpf <process_definition_file>
[-force]

形式2（ビジネスプロセス定義を取得する場合）

ciwmngbp -sid <system_id>
-get
-bpn <process_definition_name>
-bpv <process_definition_version>
-bpf <process_definition_file>
[-force]

形式3（ビジネスプロセス定義の属性を変更する場合）

ciwmngbp -sid <system_id>
-chg
-bpn <process_definition_name>
-bpv <process_definition_version>
(-s {ACTIVE｜INACTIVE}
｜-pfd {<process_from_date>｜ORIGIN}
｜-ptd {<process_to_date>｜BEYOND}
｜-bpa <responsible>)

形式4（ビジネスプロセス定義を削除する場合）

ciwmngbp -sid <system_id>
-del
-bpn <process_definition_name>
-bpv <process_definition_version>

形式5（ワーク管理データベースに登録されているビジネスプロセス定義を一覧表示する場合）

ciwmngbp -sid <system_id>
-list

形式6（オプションファイルを指定して実行する場合）※

ciwmngbp -file <option_file_name>
[-encoding <character_set> ]

形式7（コマンドの形式を表示する場合）※

ciwmngbp -h

注※

すべてのコマンドで同じ形式で指定します。詳細は，「1.5　コマンド共通のオプション」を参照してください。

機能

ビジネスプロセス定義を管理します。

このコマンドで実行できることを次に示します。

ビジネスプロセス定義の登録

ビジネスプロセス定義の取得

ビジネスプロセス定義の属性変更

ビジネスプロセス定義の削除

ビジネスプロセス定義の一覧表示

実行条件

このコマンドを実行できるコンポーネントの稼働状態を次に示します。

コンポーネント

稼働状態

起動中

停止中

CSCIWManagementServer

×※

○

案件運用操作

○

○

CSCIWライブラリを使用した業務アプリケーション（J2EEアプリケーション）

○

○

CSCIWライブラリを使用した業務アプリケーション（Javaアプリケーション）

×※

○

アプリケーション呼び出しサービス

○

○

RESTサービス

○

○

運用管理RESTサービス

○

○

同一マシンでのほかのコマンド

×

○

異なるマシンでの同一コマンド

×

○

異なるマシンでのほかのコマンド

×

○

DBMS

○

×

（凡例）

○：コマンドを実行できます。

×：コマンドを実行できません。

注※

-getオプションまたは-listオプション指定時は，起動中でもコマンドを実行できます。

また，-regオプション，-chgオプション，または-delオプション指定時は，起動中でもコマンドを実行できます。ただし，コマンド実行後は変更を反映するために再起動してください。

引数

-sid <system_id>

環境構築時に設定したシステムIDを指定します。指定したシステムIDに対応するワーク管理システム上のビジネスプロセス定義が対象になります。

指定できる値は，半角英大文字と半角数字で5文字以内です。ただし，先頭には半角英大文字を指定してください。

-reg

ビジネスプロセス定義を登録する場合に指定します。

登録対象のビジネスプロセス定義に管理者の指定がない場合は，このコマンドを実行したユーザがビジネスプロセス定義の管理者として設定されます。また，登録するビジネスプロセス定義の作成者は，このコマンドを実行したユーザになります。このため，ユーザ名の長さは，<SYSTEMID>_PROCESS_DEFテーブルのAuthorカラムのバイト数以内にしてください。

また，そのほかの注意事項について次に示します。

登録するビジネスプロセス定義ファイルには，CSCIW-Definerでチェックを実施し，エラーのなしを確認したファイルを指定してください。チェックを実施していないファイルを指定した場合，動作の保証はできません。

登録するビジネスプロセス定義ファイルは，CSCIW-Definerで編集してください。CSCIW-Definer以外のプログラム（文書エディタなど）で編集した場合，動作の保証はできません。

登録するビジネスプロセス定義で使用する振り分けルール定義が必要です。振り分けルール定義がない場合，CSCIWManagementServer，案件運用操作およびCSCIWライブラリを使用した業務アプリケーションで，例外が発生することがあります。

登録するビジネスプロセス定義に含まれている条件定義，生成ルール定義，作業アプリケーション定義のSQL文，およびJavaクラス名がデフォルト値から変更されていないとエラーになります。

-get

ビジネスプロセス定義ファイルを取得する場合に指定します。

-chg

ビジネスプロセス定義の属性を変更する場合に指定します。

このオプションを指定した場合，次に示すオプションをどれかを1つ以上指定する必要があります。

-sオプション

-pfdオプション

-ptdオプション

-bpaオプション

-del

ビジネスプロセス定義を削除する場合に指定します。ただし，削除対象のビジネスプロセス定義が「活性」状態のとき，または削除対象のビジネスプロセス定義に案件が存在するときは，ビジネスプロセス定義を削除できません。

-list

ワーク管理データベースに登録されているビジネスプロセス定義の一覧を，CSV形式で表示する場合に指定します。

ビジネスプロセス定義一覧の表示フォーマットを次に示します。

Name,Version,StateCode,ValidFromDate,ValidToDate,Author,Responsible
ORSplitJoin1,1,ACTIVE(b),ORIGIN,BEYOND,csciw1,"csciw""1"
ORSplitJoin1,2,ACTIVE(b),ORIGIN,BEYOND,csciw1,"csci,w1"
ORSplitJoin2,1,INACTIVE(a),Thu Dec 14 00:00:00 JST 2006,Thu Dec 14 23:59:59 JST 2006,csciw1,csciw1

ビジネスプロセス定義一覧の1行目にはヘッダ情報が表示され，2行目以降には各ヘッダ情報に対応する値が表示されます。

表示項目の意味を次の表に示します。

表2‒40　表示項目（ビジネスプロセス定義一覧）

表示項目

意味

Name

ビジネスプロセス定義名を示します。

Version

ビジネスプロセス定義のバージョンを示します。

StateCode

ビジネスプロセス定義の状態を示します。

ビジネスプロセス定義の状態には，次に示す値が表示されます。

「ACTIVE」：「活性」状態を示します。

「INACTIVE」：「非活性」状態を示します。

ValidFromDate

案件投入可能開始日を示します。

案件投入可能開始日には，実行環境のタイムゾーンに依存した日付が表示されます。ただし，無限遠の過去の場合は「ORIGIN」が表示されます。

ValidToDate

案件投入可能終了日を示します。

案件投入可能終了日には，実行環境のタイムゾーンに依存した日付が表示されます。ただし，無限遠の未来の場合は「BEYOND」が表示されます。

Author

ビジネスプロセス定義の作成者を示します。

Responsible

ビジネスプロセス定義の管理者を示します。

-bpn <process_definition_name>

ビジネスプロセス定義名を指定します。指定したビジネスプロセス定義が，取得，属性変更，または削除の対象になります。

ビジネスプロセス定義名は，<SYSTEMID>_PROCESS_DEFテーブルのNameカラムのバイト数以内で指定してください。

-bpv <process_definition_version>

ビジネスプロセス定義のバージョンを指定します。-bpnオプションに指定したビジネスプロセス定義名，かつこのオプションに指定したバージョンのビジネスプロセス定義が，取得，属性変更，または削除の対象になります。

指定できる値は，-32,768〜32,767です。ただし，有効な値はビジネスプロセス定義作成時に指定できる0〜9,999となります。

-s {ACTIVE｜INACTIVE}

このオプションは，-chgオプションを指定した場合だけ指定できます。

ビジネスプロセス定義の状態を変更する場合に，変更後の状態を指定します。

指定できる値は，「ACTIVE」または「INACTIVE」です。値の意味を次に示します。

「ACTIVE」：「活性」状態に変更します。

「INACTIVE」：「非活性」状態に変更します。

-pfd {<process_from_date>｜ORIGIN}

このオプションは，-chgオプションを指定した場合だけ指定できます。

案件投入可能開始日を変更する場合に，変更後の案件投入可能開始日または「ORIGIN」を指定します。

案件投入可能開始日は，YYYYMMDD（YYYY：西暦，MM：月，DD：日）の形式で指定してください。例えば，20070510を指定した場合，2007/05/10の0時0分0秒を意味します。指定できる日付の範囲は，1970/01/03〜9999/12/30です。

ORIGINを指定した場合，無限遠の過去を意味します。

-ptd {<process_to_date>｜BEYOND}

このオプションは，-chgオプションを指定した場合だけ指定できます。

案件投入可能終了日を変更する場合に，変更後の案件投入可能終了日または「BEYOND」を指定します。

案件投入可能終了日は，YYYYMMDD（YYYY：西暦，MM：月，DD：日）の形式で指定してください。例えば，20070610を指定した場合，2007/06/10の23時59分59秒を意味します。指定できる日付の範囲は，1970/01/03〜9999/12/30です。

BEYONDを指定した場合，無限遠の未来を意味します。

-bpa <responsible>

このオプションは，-chgオプションを指定した場合だけ指定できます。

ビジネスプロセス定義の管理者名を指定します。

ビジネスプロセス定義の管理者名は，<SYSTEMID>_PROCESS_DEFテーブルのResponsibleカラムのバイト数以内で指定してください。

-bpf <process_definition_file>

-regオプションを指定してビジネスプロセス定義を登録する場合

CSCIW-Definerで作成したビジネスプロセス定義を指定します。

なお，-forceオプションを同時に指定すると，同一名で同一バージョンのビジネスプロセス定義があったときに，強制的に上書きできます。

-getオプションを指定してビジネスプロセス定義を取得する場合

ワーク管理システムから取得したビジネスプロセス定義の内容を保存するビジネスプロセス定義ファイル名を指定します。

-forceオプションを同時に指定すると，同一名のビジネスプロセス定義ファイルがあったときに，強制的に上書きできます。

-force

-regオプションを指定してビジネスプロセス定義を登録する場合

ワーク管理システムに同一名で同一バージョンのビジネスプロセス定義が登録されていたときに，-bpfオプションに指定したビジネスプロセス定義を登録します（強制的に上書きします）。ただし，次に示すときは，ビジネスプロセス定義を登録できません。

登録対象のビジネスプロセス定義が「活性」状態のとき

登録対象のビジネスプロセス定義に案件が存在するとき

このオプションを省略すると，同一名で同一バージョンのビジネスプロセス定義が登録されていたときに，ビジネスプロセス定義を登録できません。

-getオプションを指定してビジネスプロセス定義を取得する場合

-bpfオプションに指定したビジネスプロセス定義ファイルと同一名のファイルが存在したときに，そのファイルに指定したビジネスプロセス定義を取得します（強制的に上書きします）。

このオプションを省略すると，同一名のビジネスプロセス定義ファイルが存在したときに，ビジネスプロセス定義を取得できません。

-file <option_file_name>

このオプションは，すべてのコマンドで指定できます。詳細は，「1.5.1　-fileオプション」を参照してください。

-encoding <character_set>

このオプションは，すべてのコマンドで指定できます。詳細は，「1.5.1　-fileオプション」を参照してください。

-h

このオプションは，すべてのコマンドで指定できます。詳細は，「1.5.2　-hオプション」を参照してください。

戻り値

戻り値

内容

0

正常終了

1

致命的なエラー

9※

実行権限エラー

50

指定した状態に変更済みである

51

パラメーター不正

100

ビジネスプロセス定義の内容不正

110

定義登録ユーザ名の不正

150

ビジネスプロセス定義ファイルのアクセスエラー

254

異常終了

注※

Windowsの場合だけ発生します。

注意事項

オプション引数に，文字列を指定する場合の注意事項については，「1.2　コマンドの入力形式」を参照してください。

マルチマシン構成の場合，どれか1つのマシンでこのコマンドを実行してください。

このコマンドは，CSCIWManagementServerおよびCSCIWを使用しているJavaアプリケーションが起動中でも実行できます。ただし，コマンド実行後に，必ずCSCIWManagementServerおよびCSCIWを使用しているJavaアプリケーションを再起動してください。再起動しないと，ビジネスプロセス定義の変更が反映されません。

2.11　ciwmngcr（振り分けルール定義の管理）

形式

形式1（振り分けルール定義を登録する場合）

ciwmngcr -sid <system_id>
-reg
-crf <casting_rule_file_name>
[-force]

形式2（振り分けルール定義を取得する場合）

ciwmngcr -sid <system_id>
-get
-crn <casting_rule_name>
-crv <casting_rule_version>
-crf <casting_rule_file_name>
[-force]

形式3（振り分けルール定義の属性を変更する場合）

ciwmngcr -sid <system_id>
-chg
-crn <casting_rule_name>
-crv <casting_rule_version>
(-s {ACTIVE｜INACTIVE}
｜-vfd {<valid_from_date>｜ORIGIN}
｜-vtd {<valid_to_date>｜BEYOND}
｜-cra <responsible>)
[-force]

形式4（振り分けルール定義を削除する場合）

ciwmngcr -sid <system_id>
-del
-crn <casting_rule_name>
-crv <casting_rule_version>

形式5（ワーク管理データベースに登録されている振り分けルール定義を一覧表示する場合）

ciwmngcr -sid <system_id>
-list

形式6（オプションファイルを指定して実行する場合）※

ciwmngcr -file <option_file_name>
[-encoding <character_set>]

形式7（コマンドの形式を表示する場合）※

ciwmngcr -h

注※

すべてのコマンドで同じ形式で指定します。詳細は，「1.5　コマンド共通のオプション」を参照してください。

機能

振り分けルール定義を管理します。

このコマンドで実行できることを次に示します。

振り分けルール定義の登録

振り分けルール定義の取得

振り分けルール定義の属性変更

振り分けルール定義の削除

振り分けルール定義の一覧表示

実行条件

このコマンドを実行できるコンポーネントの稼働状態を次に示します。

コンポーネント

稼働状態

起動中

停止中

CSCIWManagementServer

×※

○

案件運用操作

○

○

CSCIWライブラリを使用した業務アプリケーション（J2EEアプリケーション）

○

○

CSCIWライブラリを使用した業務アプリケーション（Javaアプリケーション）

×※

○

アプリケーション呼び出しサービス

○

○

RESTサービス

○

○

運用管理RESTサービス

○

○

同一マシンでのほかのコマンド

×

○

異なるマシンでの同一コマンド

×

○

異なるマシンでのほかのコマンド

×

○

DBMS

○

×

（凡例）

○：コマンドを実行できます。

×：コマンドを実行できません。

注※

-getオプションまたは-listオプション指定時は，起動中でもコマンドを実行できます。

また，-regオプション，-chgオプション，または-delオプション指定時は，起動中でもコマンドを実行できます。ただし，コマンド実行後は定義を反映するために再起動してください。

引数

-sid <system_id>

環境構築時に設定したシステムIDを指定します。指定したシステムIDに対応するワーク管理システム上の振り分けルール定義が対象になります。

指定できる値は，半角英大文字と半角数字で5文字以内です。ただし，先頭には半角英大文字を指定してください。

-reg

振り分けルール定義を登録する場合に指定します。

登録対象の振り分けルール定義に管理者の指定がない場合は，このコマンドを実行したユーザが振り分けルール定義の管理者として設定されます。また，登録する振り分けルール定義の作成者は，このコマンドを実行したユーザになります。このため，ユーザ名の長さは，<SYSTEMID>_CASTINGRULE_DEFテーブルのAuthorカラムのバイト数以内にしてください。

なお，登録する振り分けルール定義ファイルは，CSCIW-Definerで編集してください。CSCIW-Definer以外のプログラム（文書エディタなど）で編集した場合，動作の保証はできません。

また，振り分けルール定義のSQL文およびJavaクラス名が，デフォルト値から変更されていないとエラーになります。

-get

振り分けルール定義ファイルを取得する場合に指定します。

-chg

振り分けルール定義の属性を変更する場合に指定します。

ビジネスプロセス定義で使用中の振り分けルール定義は，非活性状態または有効期間外などの使用できない状態には変更できません。

このオプションを指定した場合，次に示すオプションのどれかを1つ以上指定してください。

-sオプション

-vfdオプション

-vtdオプション

-craオプション

-del

振り分けルール定義を削除する場合に指定します。ただし，削除対象の振り分けルール定義が「活性」状態のときは削除できません。

-list

ワーク管理データベースに登録されている振り分けルール定義の一覧を，CSV形式で表示する場合に指定します。

振り分けルール定義一覧の表示フォーマットを次に示します。

Name,Version,StateCode,ValidFromDate,ValidToDate,Author,Responsible
CastSQL,1, ACTIVE(b),ORIGIN,BEYOND,csciw1,"csci""w1"
CastSQL,2, ACTIVE(b),ORIGIN,BEYOND,csciw1,"csciw,1"
CastSQL1,1,INACTIVE(a),Thu Dec 14 00:00:00 JST 2006,Thu Dec 14 23:59:59 JST 2006,csciw1,csciw1

振り分けルール定義一覧の1行目にはヘッダ情報が表示され，2行目以降には各ヘッダ情報に対応する値が表示されます。

表示項目の意味を次の表に示します。

表2‒41　表示項目（振り分けルール定義一覧）

表示項目

意味

Name

振り分けルール定義名を示します。

Version

振り分けルール定義のバージョンを示します。

StateCode

振り分けルール定義の状態を示します。

振り分けルール定義の状態には，次に示す値が表示されます。

「ACTIVE」：「活性」状態を示します。

「INACTIVE」：「非活性」状態を示します。

ValidFromDate

有効期間開始日を示します。

有効期間開始日には，実行環境のタイムゾーンに依存した日付が表示されます。ただし，無限遠の過去の場合は「ORIGIN」が表示されます。

ValidToDate

有効期間終了日を示します。

有効期間終了日には，表示形式は実行環境のタイムゾーンに依存した日付が表示されます。ただし，無限遠の未来の場合は「BEYOND」が表示されます。

Author

振り分けルール定義の作成者を示します。

Responsible

振り分けルール定義の管理者を示します。

-crn <casting_rule_name>

振り分けルール定義名を指定します。指定した振り分けルール定義が，取得，属性変更，または削除の対象になります。

振り分けルール定義名は，<SYSTEMID>_CASTINGRULE _DEFテーブルのNameカラムのバイト数以内で指定してください。

-crv <casting_rule_version>

振り分けルール定義のバージョンを指定します。-crnオプションに指定した振り分けルール定義名，かつこのオプションに指定したバージョンの振り分けルール定義が，取得，属性変更，または削除の対象になります。

指定できる値は，-32,768〜32,767です。ただし，有効な値はビジネスプロセス定義作成時に指定できる0〜9,999となります。

-s {ACTIVE｜INACTIVE}

このオプションは，-chgオプションを指定した場合だけ指定できます。

振り分けルール定義の状態を変更する場合に，変更後の状態を指定します。

指定できる値は，「ACTIVE」または「INACTIVE」です。値の意味を次に示します。

「ACTIVE」：「活性」状態に変更します。

「INACTIVE」：「非活性」状態に変更します。

-vfd {<valid_from_date>｜ORIGIN}

このオプションは，-chgオプションを指定した場合だけ指定できます。

有効期間開始日を変更する場合に，変更後の有効期間開始日または「ORIGIN」を指定します。

有効期間開始日は，YYYYMMDD（YYYY：西暦，MM：月，DD：日）の形式で指定してください。例えば，20070510を指定した場合，2007/05/10の0時0分0秒を意味します。指定できる日付の範囲は，1970/01/03〜9999/12/30です。

ORIGINを指定した場合，無限遠の過去を意味します。

-vtd {<valid_to_date>｜BEYOND}

このオプションは，-chgオプションを指定した場合だけ指定できます。

有効期間終了日を変更する場合に，変更後の有効期間終了日または「BEYOND」を指定します。

有効期間終了日は，YYYYMMDD（YYYY：西暦，MM：月，DD：日）の形式で指定してください。例えば，20070610を指定した場合，2007/06/10の23時59分59秒を意味します。指定できる日付の範囲は，1970/01/03〜9999/12/30です。

BEYONDを指定した場合，無限遠の未来を意味します。

-cra <responsible>

このオプションは，-chgオプションを指定した場合だけ指定できます。

振り分けルール定義の管理者名を指定します。

振り分けルール定義の管理者名は，<SYSTEMID>_CASTINGRULE _DEFテーブルのResponsibleカラムのバイト数以内で指定してください。

-crf <casting_rule_file_name>

-regオプションを指定して振り分けルール定義を登録する場合

CSCIW-Definerで作成した振り分けルール定義を指定します。

なお，-forceオプションを同時に指定すると，同一名で同一バージョンの振り分けルール定義があったときに，強制的に上書きできます。

-getオプションを指定して振り分けルール定義を取得する場合

ワーク管理システムから取得した振り分けルール定義の内容を保存する振り分けルール定義ファイル名を指定します。

なお，-forceオプションを同時に指定すると，同一名の振り分けルール定義ファイルがあったときに，強制的に上書きできます。

-force

-regオプションを指定して振り分けルール定義を登録する場合

ワーク管理システムに同一名で同一バージョンの振り分けルール定義が登録されていたときに，-crfオプションに指定した振り分けルール定義を登録します（強制的に上書きします）。ただし，登録対象の振り分けルール定義が「活性」状態のときは，振り分けルール定義を登録できません。

このオプションを省略すると，同一名で同一バージョンの振り分けルール定義が登録されていたときに，振り分けルール定義を登録できません。

-getオプションを指定して振り分けルール定義を取得する場合

-crfオプションに指定した振り分けルール定義ファイルと同一名のファイルが存在したときに，そのファイルに指定した振り分けルール定義を取得します（強制的に上書きします）。

このオプションを省略すると，すでに同一名の振り分けルール定義ファイルが存在したときに，振り分けルール定義を取得できません。

-chgオプションを指定して振り分けルール定義の属性を変更する場合

指定した振り分けルール定義を使用しているビジネスプロセス定義があっても，無条件に使用できない状態にします。このオプションは，-sオプション，-vfdオプション，-vtdオプションによって振り分けルールを使用できない状態（「非活性」状態または有効期間外）に変更するときだけ有効になります。

なお，-forceオプションを指定して定義属性を変更すると，CSCIWManagementServer，案件運用操作およびCSCIWライブラリを使用した業務アプリケーションで例外が発生することがあります。振り分けルール定義の状態を確認してから指定してください。

-file <option_file_name>

このオプションは，すべてのコマンドで指定できます。詳細は，「1.5.1　-fileオプション」を参照してください。

-encoding <character_set>

このオプションは，すべてのコマンドで指定できます。詳細は，「1.5.1　-fileオプション」を参照してください。

-h

このオプションは，すべてのコマンドで指定できます。詳細は，「1.5.2　-hオプション」を参照してください。

戻り値

戻り値

内容

0

正常終了

1

致命的なエラー

9※

実行権限エラー

50

指定した状態に変更済みである

51

パラメーター不正

102

属性の値を変更する振り分けルールの状態不正

110

定義登録ユーザ名の不正

150

振り分けルール定義ファイルのアクセスエラー

254

異常終了

注※

Windowsの場合だけ発生します。

注意事項

オプション引数に，文字列を指定する場合の注意事項については，「1.2　コマンドの入力形式」を参照してください。

マルチマシン構成の場合，どれか1つのマシンでこのコマンドを実行してください。

このコマンドは，CSCIWManagementServerおよびCSCIWを使用しているJavaアプリケーションが起動中でも実行できます。ただし，コマンド実行後に，必ずCSCIWManagementServerおよびCSCIWを使用しているJavaアプリケーションを再起動してください。再起動しないと，振り分けルール定義の変更が反映されません。

2.12　ciwreuseid（IDの再利用）

形式

形式1（使用済みIDを回復する場合）

ciwreuseid -sid <system_id>
-rcv
[-num [<total_id_count>]]
[-k {PI｜AI｜WI｜CI}]

形式2（空きID範囲を表示する場合）

ciwreuseid -sid <system_id>
-list

形式3（オプションファイルを指定して実行する場合）※

ciwreuseid -file <option_file_name>
[-encoding <character_set>]

形式4（コマンドの形式を表示する場合）※

ciwreuseid -h

注※

すべてのコマンドで同じ形式で指定します。詳細は，「1.5　コマンド共通のオプション」を参照してください。

機能

次に示すIDが不足した場合に，使用済みID（削除された案件が使用していたID）を回復し，再利用できるようにします。

案件ID

業務ステップID

作業ID

制御ノードID

実行条件

このコマンドを実行できるコンポーネントの稼働状態を次に示します。

コンポーネント

稼働状態

起動中

停止中

CSCIWManagementServer

○

○

案件運用操作

○

○

CSCIWライブラリを使用した業務アプリケーション（J2EEアプリケーション）

○

○

CSCIWライブラリを使用した業務アプリケーション（Javaアプリケーション）

○

○

アプリケーション呼び出しサービス

○

○

RESTサービス

○

○

運用管理RESTサービス

○

○

同一マシンでのほかのコマンド

×

○

異なるマシンでの同一コマンド

×

○

異なるマシンでのほかのコマンド

×

○

DBMS

○

×

（凡例）

○：コマンドを実行できます。

×：コマンドを実行できません。

引数

-sid <system_id>

環境構築時に設定したシステムIDを指定します。指定したシステムIDに対応するワーク管理システム上のIDが対象になります。

指定できる値は，半角英大文字と半角数字で5文字以内です。ただし，先頭には半角英大文字を指定してください。

-rcv

使用済みIDを回復する場合に指定します。

1,000,000個以上連続した使用済みIDがあるときに回復します。

-num <total_id_count>

ID合計回復数を指定します。使用済みIDを回復し，利用できるID（空きID※）を必要な分だけ確保する場合に指定します。指定したID合計回復数から空きID（未使用ID※および回復済みID※）の数を引いた使用済みIDが回復されます。指定したID数まで回復できないときは，回復できる使用済みIDを回復して，警告付きでコマンドが終了します。すでに空きID（未使用IDおよび回復済みID）が指定したID合計回復数以上のときは，使用済みIDを回復しないでコマンドが正常終了します。

指定できる値は，1,000,000〜2,000,000,000の整数です。なお，このオプションを省略した場合，またはオプションだけを指定してID合計回復数を省略した場合，2,147,483,647が仮定されます。

注※

空きID

未使用IDと回復済みIDの総称です。空きIDがなくなると，新しくIDをキャッシュできなくなり，案件の投入や案件の遷移ができません。

未使用ID

新しくIDをキャッシュするときに使用されるIDのことです。

回復済みID

このコマンドで回復したIDのことです。未使用IDがなくなると，回復済みIDが未使用IDとなります。

-k {PI｜AI｜WI｜CI}

回復するIDの種別を指定します。

指定できる値は，「PI」，「AI」，「WI」または「CI」です。値の意味を次に示します。

PI：案件ID

AI：業務ステップID

WI：作業ID

CI：制御ノードID

なお，このオプションを省略した場合は，すべての種別のID（案件ID，業務ステップID，作業IDおよび制御ノードID）を回復します。

-list

現在，利用できる連続する空きIDの範囲と合計数を表示する場合に指定します。

空きIDの範囲と合計数の表示フォーマットを次に示します。

<PROCESS_INSTANCE_ID>     … 案件ID
 0000001000 - 0099999998  … 1.案件IDの未使用ID範囲ブロック
 0100000000 - 0200000000  … 2.案件IDの回復済みID範囲ブロック1
 0200000000 - 2147483647  … 3.案件IDの回復済みID範囲ブロック2
 TOTALCOUNT = 2147482648  … 案件IDの空きIDの合計（1.＋2.＋3.）※1
<ACTIVITY_INSTANCE_ID>    … 業務ステップID
 0000005000 - 0099999998  … 4.業務ステップIDの未使用ID範囲ブロック
 0100000000 - 0200000000  … 5.業務ステップIDの回復済みID範囲ブロック1
 TOTALCOUNT = 199995000   … 業務ステップIDの空きIDの合計（4.＋5.）※2
<WORK_ITEM_ID>            … 作業ID
 0000005000 - 0099999998  … 6.作業IDの未使用ID範囲ブロック
 0100000000 - 0200000000  … 7.作業IDの回復済みID範囲ブロック1
 TOTALCOUNT = 199995000   … 作業IDの空きIDの合計（6.＋7.）※3
<CONTROLNODE_INSTANCE_ID> … 制御ノードID
 0000003000 - 0099999998  … 8.制御ノードIDの未使用ID範囲ブロック
 0100000000 - 0200000000  … 9.制御ノードIDの回復済みID範囲ブロック1
 TOTALCOUNT = 199997000   … 制御ノードIDの空きIDの合計（8.＋9.）※4

注※1

案件IDの未使用ID範囲ブロック，案件IDの回復済みID範囲ブロック1および案件IDの回復済みID範囲ブロック2の空きIDを合計した値になります。

注※2

業務ステップIDの未使用ID範囲ブロックおよび業務ステップIDの回復済みID範囲ブロック1の空きIDを合計した値になります。

注※3

作業IDの未使用ID範囲ブロックおよび作業IDの回復済みID範囲ブロック1の空きIDを合計した値になります。

注※4

制御ノードIDの未使用ID範囲ブロックおよび制御ノードIDの回復済みID範囲ブロック1の空きIDを合計した値になります。

-file <option_file_name>

このオプションは，すべてのコマンドで指定できます。詳細は，「1.5.1　-fileオプション」を参照してください。

-encoding <character_set>

このオプションは，すべてのコマンドで指定できます。詳細は，「1.5.1　-fileオプション」を参照してください。

-h

このオプションは，すべてのコマンドで指定できます。詳細は，「1.5.2　-hオプション」を参照してください。

戻り値

戻り値

内容

0

正常終了

1

致命的なエラー

9※

実行権限エラー

10

IDが回復できなかった，または指定されたID数回復できなかった

51

パラメーター不正

100

DBMSから取得したデータが不正

254

異常終了

注※

Windowsの場合だけ発生します。

注意事項

使用済みIDの回復は，空きIDが少なくなった場合だけ実行してください。

使用済みIDの回復は，CSCIWライブラリを使用した業務アプリケーションの利用頻度が少ない期間に実行することを推奨します。CSCIWライブラリを使用した業務アプリケーションの動作中に，使用済みIDの回復を実行した場合，業務アプリケーションが排他待ちで同時実行性が落ちることがあります。

2.13　ciwsetenv（環境の構築または削除）

形式

形式1（環境を構築する場合）

ciwsetenv -sid <system_id>
-f <file_name>

形式2（環境を削除する場合）

ciwsetenv -sid <system_id>
-del

形式3（環境をバージョンアップする場合）

ciwsetenv -sid <system_id>
-vup <file_name>

形式4（オプションファイルを指定して実行する場合）※

ciwsetenv -file <option_file_name>
[-encoding <character_set>]

形式5（コマンドの形式を表示する場合）※

ciwsetenv -h

注※

すべてのコマンドで同じ形式で指定します。詳細は，「1.5　コマンド共通のオプション」を参照してください。

機能

CSCIWの実行環境を構築，削除またはバージョンアップします。

環境を構築する場合

CSCIWの実行環境に必要な項目のデフォルト値を設定し，システムIDの設定情報を登録します。なお，このコマンドをほかのマシンで実行している場合は，システムIDの設定情報だけが，自マシンに登録されます。

環境構築の概要を次の図に示します。

図2‒3　環境構築の概要

図中の数字は，次に示す説明の項番と対応しています。

環境構築ファイルを作成します。環境構築ファイルに設定する項目については，「環境構築ファイル」を参照してください。

ciwsetenvコマンド（-fオプション）を実行すると，指定した環境構築ファイルを基に環境が構築されます。

ワーク管理データベースにシステム共通環境情報のデフォルト値が設定され，システム設定プロパティファイルにシステムIDの設定情報が登録されます。

ほかのマシンですでに環境の構築を実行している場合，ciwsetenvコマンド（-fオプション）を実行すると，自マシンのシステム設定プロパティファイルにシステムIDの設定情報だけが登録されます。

ワーク管理データベースのデフォルト値は設定されません。

環境を削除する場合

システムIDの設定情報を削除します。

環境削除の概要を次の図に示します。

図2‒4　環境削除の概要

図中の数字は，次に示す説明の項番と対応しています。

ciwsetenvコマンド（-delオプション）を実行すると，自マシンのシステム設定プロパティファイルに設定されているシステムIDの設定情報が削除されます。

環境をバージョンアップする場合

システムIDの設定情報および各種データを更新します。また，システム設定プロパティファイルを更新します。

バージョンアップは，環境を構築したすべてのマシンで実行してください。

また，バージョンアップを実行する前に，バージョンアップ用のSQLスクリプトファイルを実行し，ワーク管理データベースのテーブルをバージョンアップしてください。テーブルをバージョンアップする手順については，マニュアル「uCosminexus Service Coordinator Interactive Workflow システム構築・運用ガイド」を参照してください。

環境のバージョンアップの概要を次の図に示します。

図2‒5　環境のバージョンアップの概要

図中の数字は，次に示す説明の項番と対応しています。

環境構築ファイルに環境構築時と同じ内容を指定します。環境構築ファイルに設定する項目については，「環境構築ファイル」を参照してください。

ciwsetenvコマンド（-vupオプション）を実行すると，環境がバージョンアップされます。

ワーク管理データベースのシステム共通環境情報および各データ（インスタンス情報など）が更新されます。また，システム設定プロパティファイルに登録されているシステムIDの設定情報が更新されます。

ほかのマシンですでに環境のバージョンアップを実行している場合，ciwsetenvコマンド（-vupオプション）を実行すると，自マシンのシステム設定プロパティファイルに登録されているシステムIDの設定情報だけが更新されます。

ワーク管理データベースの情報は更新されません。

実行条件

このコマンドを実行できるコンポーネントの稼働状態を次に示します。

コンポーネント

稼働状態

起動中

停止中

CSCIWManagementServer

×※1

○

案件運用操作

×※1

○

CSCIWライブラリを使用した業務アプリケーション（J2EEアプリケーション）

×※1

○

CSCIWライブラリを使用した業務アプリケーション（Javaアプリケーション）

×※1

○

アプリケーション呼び出しサービス

×※1

○

RESTサービス

×※1

○

運用管理RESTサービス

×※1

○

同一マシンでのほかのコマンド

×

○

異なるマシンでの同一コマンド

○

○

異なるマシンでのほかのコマンド

○

○

DBMS

○

×※2

（凡例）

○：コマンドを実行できます。

×：コマンドを実行できません。

注※1

異なるマシンで起動している場合は，起動中でもコマンドを実行できます。

注※2

-delオプション指定時は，停止中でもコマンドを実行できます。

引数

-sid <system_id>

システムIDを指定します。指定したシステムIDの環境を構築または削除します。

指定できる値は，半角英大文字と半角数字で5文字以内です。ただし，先頭には半角英大文字を指定してください。

-f <file_name>

環境構築時に必要な項目が設定されている環境構築ファイルの名称を指定します。指定した環境構築ファイルの内容に従って環境が構築されます。

環境構築ファイルに設定する項目については，「環境構築ファイル」を参照してください。

-del

指定したシステムIDの環境を削除する場合に指定します。

なお，このオプションでは，DBMSの情報を削除できません。スキーマ，テーブルおよびインデクスは，DBMSの機能を使用して削除してください。

また，-delオプションを指定して環境を削除する前に，ciwlistsidコマンドを使用して異常終了したプロセスが存在しないことを確認してください。ciwlistsidコマンドの詳細は，「2.7　ciwlistsid（システムID情報の表示）」を参照してください。

異常終了したプロセスが存在する場合は，ciwcleanupコマンドでプロセス情報を正常化したあと，環境を削除してください。ciwcleanupコマンドの詳細は，「2.4　ciwcleanup（プロセス情報の正常化）」を参照してください。

-vup <file_name>

環境をバージョンアップする場合に指定します。

環境構築ファイルは，環境構築時と同じ内容を指定します。

このオプションを実行すると，システム設定プロパティファイルの内容は，指定した環境構築ファイルの内容に書き換えられます。ただし，SystemDBTypeの値だけは書き換えられません。異なるSystemDBTypeを指定した場合はエラーになります。必ず，環境構築時の環境構築ファイルと同じ内容を指定してください。

環境構築ファイルに設定する項目については，「環境構築ファイル」を参照してください。

-file <option_file_name>

このオプションは，すべてのコマンドで指定できます。詳細は，「1.5.1　-fileオプション」を参照してください。

-encoding <character_set>

このオプションはすべてのコマンドで指定できます。詳細は，「1.5.1　-fileオプション」を参照してください。

-h

このオプションはすべてのコマンドで指定できます。詳細は，「1.5.2　-hオプション」を参照してください。

戻り値

戻り値

内容

0

正常終了

1

致命的なエラー

9※

実行権限エラー

51

パラメーター不正

100

環境不正

150

ファイルアクセスエラー

254

異常終了

注※

Windowsの場合だけ発生します。

環境構築ファイル

環境構築ファイルはプロパティファイル形式で指定します。書式はJavaのプロパティファイルの仕様に従います。

値に「¥」（半角円記号）を指定する場合は，「¥」の前に「¥」をエスケープ文字として指定してください。また，ファイルのエンコーディングはUTF-8とし，BOMを付けないで保存してください。

CSCIW 02-20以前で使用していた環境構築ファイル（Unicode形式のファイルを含む）を，そのまま使用することもできます。

環境構築ファイルに設定する項目を次の表に示します。

表2‒42　環境構築ファイルに設定する項目

設定項目

内容

SystemDBType

使用するDBMSの種類を指定します。※

DBMSの種類には，「HiRDB」，「Oracle」または「SQLServer」を指定してください。

SystemDBURL

JDBCのURLを指定します。URLについては，使用するDBMSのマニュアルを参照してください。

SystemDBDriverName

使用するJDBCドライバの名称を指定します。JDBCドライバの詳細は，使用するDBMSのマニュアルを参照してください。

SystemDBUser

CSCIWのテーブルを作成した認可識別子またはユーザ名を指定します。ここで指定した文字列が認可識別子またはユーザ名としてそのまま使用されるため，DBMSの仕様に従って指定してください。例えば，大文字小文字を区別する場合，HiRDBまたはOracleでは「"」で囲む必要がありますが，SQL Serverでは「"」で囲む必要はありません。

SystemDBPassword

CSCIWのテーブルを作成した認可識別子またはユーザのパスワードを指定します。ここで指定した文字列が認可識別子またはユーザのパスワードとしてそのまま使用されるため，DBMSの仕様に従って指定してください。例えば，大文字小文字を区別する場合，HiRDBまたはOracleでは「"」で囲む必要がありますが，SQL Serverでは「"」で囲む必要はありません。

DBCharacterName

CSCIWが使用するDBMSの文字セットに対応した，Javaでサポートされているエンコーディングの正準名を指定します。

例

「UTF8」：UTF-8の場合に指定します。

「MS932」：Windows環境で，Shift-JISの場合に指定します。

「SJIS」：UNIX環境で，Shift-JISの場合に指定します。

SystemDBSchemaName

CSCIWのテーブルを作成したスキーマ名を指定します。

指定した文字列の大文字小文字を区別する場合は，使用するDBMSの種類に関係なく，小文字の文字列を「"」（半角ダブルクォーテーション）で囲む必要があります。「"」で囲まなかった場合は，すべて大文字で指定したものとして扱われます。

なお，スキーマ名は省略できます。省略した場合，SystemDBUserに指定した値がスキーマ名として設定されます。ただし，「"」を使用できないDBMSで大文字小文字を区別する必要があるときは，SystemDBUserで指定した値と，SystemDBSchemaNameで指定する値が同一の場合でも，SystemDBSchemaNameの指定は省略できません。

注※

使用するDBMSの種類が「HiRDB」または「SQLServer」のときに，環境構築ファイルの「SystemDBType」に「Oracle」を指定していても，コマンド実行時にエラーにならないで，環境構築ファイルの指定値で環境が構築されます。この場合，次に示す手順で対処してください。対処しないときは，そのあとの動作を保証できません。

このコマンドを実行し，構築した環境を削除します。

環境構築ファイルの「SystemDBType」の指定値を修正します。

このコマンドを実行し，環境を構築します。

ヒント

環境構築ファイルのひな形として次のファイルを使用できます。

Windowsの場合

<CSCIWインストールディレクトリ>¥sample¥ciwsetenvInputInfo.properties

UNIXの場合

/opt/hitachi/CSCIW/sample/ciwsetenvInputInfo.properties

環境構築ファイルの設定例を次に示します。

例1（使用するDBMSの種類がHiRDBの場合）

SystemDBType=HiRDB
SystemDBURL=jdbc:hitachi:hirdb://DBID=22200,DBHOST=hostA
SystemDBDriverName=JP.co.Hitachi.soft.HiRDB.JDBC.HiRDBDriver
SystemDBUser=USER1
SystemDBPassword=XXXXX
DBCharacterName=UTF8

例2（使用するDBMSの種類がOracleの場合）

SystemDBType=Oracle
SystemDBURL=jdbc:oracle:thin:@XX.XXX.XXX.XXX:1521:ORACLE10g
SystemDBDriverName=oracle.jdbc.driver.OracleDriver
SystemDBUser=USER1
SystemDBPassword=XXXXX
DBCharacterName=UTF8

例3（使用するDBMSの種類がSQL Serverの場合）

SystemDBType=SQLServer
SystemDBURL=jdbc:sqlserver://XXX.XXX.XXX.XXX:1433;selectMethod=cursor;
SystemDBDriverName=com.microsoft.sqlserver.jdbc.SQLServerDriver
SystemDBUser=USER1
SystemDBPassword=XXXXX
SystemDBSchemaName=YYYYYY
DBCharacterName=MS932

注意事項

このコマンドは，異なるシステムIDを指定しても，同一マシンで同時に実行できません。

2.14　ciwtransbpmn（BPMNビジネスプロセス定義ファイルのCSCIWのビジネスプロセス定義ファイルへの変換）

ciwtransbpmnコマンドの詳細について説明します。ciwtransbpmnコマンドは，BPMNビジネスプロセス定義ファイル（.bpmn）を，CSCIWで使用できるビジネスプロセス定義ファイル（.hbx）の形式に変換します。

形式

形式1（BPMNビジネスプロセス定義ファイルのファイル指定）

ciwtransbpmn -src <bpmn_definition_file_name>
[-bpv <process_definition_version>]
[-destdir <output_directory_name>]
[-mimax <generating_max_count>]

形式2（BPMNビジネスプロセス定義ファイルのディレクトリ指定）

ciwtransbpmn -srcdir <directory_name>
[-destdir <output_directory_name>]
[-mimax <generating_max_count>]

形式3（差分変更用のCSCIWビジネスプロセス定義ファイル指定）

ciwtransbpmn -update <bpmn_definition_file_name>
-bpf <business_process_file_name>
[-destdir <output_directory_name>]
[-mimax <generating_max_count>]

形式4（オプションファイルを指定して実行する場合）

ciwtransbpmn -file <option_file_name>
[-encoding <character_set>]

形式5（コマンドの形式を表示する場合）

ciwtransbpmn -h

機能

BPMN2.0に準拠したBPMNビジネスプロセス定義ファイル（.bpmn）から，次のファイルを生成します。

ビジネスプロセス定義ファイル（.hbx）

BPMNビジネスプロセス定義ファイル（.bpmn）

変換元のBPMNビジネスプロセス定義ファイルの指定方法には，ファイル指定とディレクトリ指定があります。ディレクトリ指定では，一度のコマンド実行で，複数の入力ファイルを変換できます。

コマンドを実行すると，-destdirオプションで指定したディレクトリの配下に次のデータが生成されます。

名称

タイプ

出力数

備考

<BPMNファイル名>

ディレクトリ

1つ以上

<BPMNファイル名>は，変換対象のBPMNビジネスプロセス定義ファイルから拡張子を除いた名称です。

-srcdirオプションが指定された場合，変換対象のBPMNビジネスプロセス定義ファイルの数だけディレクトリが作成されます。

ディレクトリが存在しない場合は作成します。

<ビジネスプロセス名>#<ビジネスプロセス定義バージョン>.hbx

ビジネスプロセス定義ファイル

1つ以上

-bpvオプションを省略した場合，<ビジネスプロセス定義バージョン>は「0001」になります。

同名のファイルが存在する場合は，ファイルを上書きします。

-updateオプションを指定した場合，-bpfオプションで指定したビジネスプロセスに対応するプロセス要素の変換結果だけを出力します。

-updateオプションを指定した場合，<ビジネスプロセス定義バージョン>は-bpfオプションで指定したファイル名に付与されたビジネスプロセスバージョンとなります。

<ビジネスプロセス名>#<ビジネスプロセス定義バージョン>.bpmn

BPMNビジネスプロセス定義ファイル

1つ以上

-bpvオプションを省略した場合，<ビジネスプロセス定義バージョン>は「0001」になります。

同名のファイルが存在する場合は，ファイルを上書きします。

ファイルの内容は，入力のBPMNビジネスプロセス定義ファイルと同一です（ファイル名だけ変更されます）。

-updateオプションを指定した場合，<ビジネスプロセス定義バージョン>は-bpfオプションで指定したファイル名に付与されたビジネスプロセスバージョンとなります。

実行権限

このコマンドは，管理者特権を使用しなくても実行できます。

ただし，uCosminexus Business Process Developerのインストール先を，管理者だけに更新権限が与えられているディレクトリ（「C:¥Program Files」など）にしている場合は，管理者特権で実行してください。管理者特権で実行しないと，メッセージおよびトレースファイルの出力先をデフォルトにしている場合に，メッセージおよびトレースファイルが出力されません。

実行条件

このコマンドを実行できるコンポーネントの稼働状態を次に示します。なお，このコマンドを，同一マシンで複数同時に実行しないでください。

コンポーネント

稼働状態

起動中

停止中

CSCIWManagementServer

○

○

案件運用操作

○

○

CSCIWライブラリを使用した業務アプリケーション（J2EEアプリケーション）

○

○

CSCIWライブラリを使用した業務アプリケーション（Javaアプリケーション）

○

○

アプリケーション呼び出しサービス

○

○

RESTサービス

○

○

運用管理RESTサービス

○

○

同一マシンでの他のコマンド

○

○

異なるマシンでの同一コマンド

○

○

異なるマシンでの他のコマンド

○

○

DBMS

○

○

（凡例）

○：コマンドを実行できます。

引数

-src <bpmn_definition_file_name>

変換対象のBPMNビジネスプロセス定義ファイル（.bpmn）を指定します。

-srcdir <directory_name>

変換対象のBPMNビジネスプロセス定義ファイル（.bpmn）が格納されているディレクトリを指定します。

このオプションを指定すると，指定したディレクトリの直下にあるすべてのBPMNビジネスプロセス定義ファイルが変換されます。各ファイルの処理中にエラーが発生した場合，コマンドは終了せずに，エラーが発生したファイルの処理だけがスキップされます。

-bpv <process_definition_version>

生成するビジネスプロセス定義バージョンを指定します。

指定できる値は0001～9999です。先頭の連続する0は省略できます。

このオプションを省略した場合，0001が指定されたと見なされます。

-destdir <destination_directory_name>

変換結果の出力ルートディレクトリを指定します。指定したディレクトリが存在しない場合は，ディレクトリが作成されます。

このオプションを省略した場合，変換結果は次のディレクトリに出力されます。

<コマンド実行時のカレントディレクトリ>/ciwtransbpmn

-mimax <generating_max_count>

サブプロセス（マルチインスタンス）に対応する階層定義の生成数を設定します。サブプロセス（マルチインスタンス）は，次の2つの要素を含みます。

サブプロセス（シーケンシャルマルチインスタンス）

サブプロセス（パラレルマルチインスタンス）

オプション指定値は，サブプロセス（マルチインスタンス）に指定された繰り返し回数（loopCardinality）のXPath評価値以上を指定する必要があります。実際の繰り返し回数は，実行環境でのビジネスプロセス動作時点で決まります。実際の繰り返し回数がコマンド実行時のオプション指定値を上回った場合は，実行環境でエラーになります。なお，サブプロセス（マルチインスタンス）の定義で，繰り返し回数に1以上の整数値が指定されている場合は，オプション指定値は無視されます。

指定できる値は1～999の整数です。オプションが省略された場合のデフォルト値は10です。

-update <bpmn_definition_file_name>

登録済みのビジネスプロセスを一部変更する場合に，該当するビジネスプロセスが含まれる，変換対象のBPMNビジネスプロセス定義ファイル（.bpmn）を指定します。

-bpf <business_process_file_name>

登録済みのビジネスプロセスを一部変更する場合に，該当するビジネスプロセスが含まれる，登録済みのビジネスプロセス定義ファイル（.hbx）を指定します。ciwmngbpコマンドで取得したビジネスプロセス定義ファイルを指定してください。-updateオプションで指定したBPMNビジネスプロセス定義ファイル中に対応するプロセス定義が存在しない場合は，エラーとなります。

-file <option_file_name>

このオプションはすべてのコマンドで指定できます。詳細は，「1.5.1　-fileオプション」を参照してください。

-encoding <character_set>

このオプションはすべてのコマンドで指定できます。詳細は，「1.5.1　-fileオプション」を参照してください。

-h

このオプションはすべてのコマンドで指定できます。詳細は，「1.5.2　-hオプション」を参照してください。

CSCIWのチェック処理と設定

変換処理の実行時に，CSCIWのビジネスプロセスを検証します。検証内容は，ビジネスプロセスの登録時と同様です。

検証結果にエラーがあった場合は，入力となったBPMNビジネスプロセス定義ファイルに対する生成物（ディレクトリおよびファイル）は出力しません。

バイト長チェックで使用する最大長および文字コードは，次に示すチェック用プロパティファイルで指定します。

<uCosminexus Business Process Developer インストールディレクトリ>¥conf¥ciwtransbpmn.properties

指定する値は，実行環境のデータベースのテーブルの設定に合わせる必要があります。

DBCharacterName：データベースの文字コード

それ以外：対応するカラムの最大バイト長

キー名称

デフォルト値

説明

テーブル名※1

カラム名

process.name

64

ビジネスプロセス定義名

PROCESS_DEFINITION

Name

activity.name

64

業務ステップ定義名

ACTIVITY_DEFINITION

Name

activity.description

250

説明（業務ステップ定義）

ACTIVITY_DEFINITION

Description

work.name

64

作業定義名

WORK_DEFINITION

Name

work.description

250

説明（作業定義）

WORK_DEFINITION

Description

control.name

64

定義名（制御ノード定義）

CONTROLNODE_DEFINITION

Name

condition.name

64

定義名（条件定義）

CONDITION_DEFINITION

Name

condition.description

250

説明（条件定義）

CONDITION_DEFINITION

Description

condition.java.classname

255

Javaクラス名（条件定義（Java））

CONDITION_JAVA_DEF

ClassName

condition.java.exparameter

2,000

補助定数パラメタ（条件定義（Java））

CONDITION_JAVA_DEF

ExParameter

creation.name

64

定義名（生成ルール定義）

CREATIONRULE_DEFINITION

Name

creation.description

250

説明（生成ルール定義）

CREATIONRULE_DEFINITION

Description

creation.java.classname

255

Javaクラス名（生成ルール定義（Java））

CREATIONRULE_JAVA_DEF

ClassName

creation.java.exparameter

2,000

補助定数パラメタ（生成ルール定義（Java））

CREATIONRULE_JAVA_DEF

ExParameter

application.name

64

定義名（作業アプリケーション定義）

APPLICATION_DEF

ApplicationName

application.param

2,000

補助定数パラメタ（作業アプリケーション定義）

APPLICATION_DEF

ApplicationParam

application.description

250

説明（作業アプリケーション定義）

APPLICATION_DEF

Description

application.java.classname

255

Javaクラス名（作業アプリケーション定義（Java））

APPLICATION_JAVA_DEF

ClassName

hierarchy.name

64

階層名

HIERARCHY_DEFNITION

Name

DBCharacterName

UTF-8

バイト長チェック時の文字コード※2

－

－

（凡例）

−：該当しません。

注※1

実際のテーブル名は，先頭に<SYSTEMID>_が付与されます。

注※2

Javaでサポートされているエンコーディングの正準名を指定します。

戻り値

戻り値

内容

0

正常終了

1

致命的なエラー

9

実行権限エラー

49

BPMN解析での警告，およびCSCIWのビジネスプロセス検証での警告

51

パラメーター不正

100

BPMN解析エラー・ビジネスプロセス定義変換時エラー

120

登録済みビジネスプロセスの変更（-updateオプション）に伴うエラー

150

I/Oエラー

200

-srcdirオプションで指定したディレクトリ内のどれかのファイルでエラー発生

240

CSCIWのビジネスプロセス検証でのエラー

254

異常終了

注意事項

オプション引数に，文字列を指定する場合の注意事項については，「1.2　コマンドの入力形式」を参照してください。

入力となるBPMNビジネスプロセス定義ファイルは，BPMNエディタで正しく検証されたファイルである必要があります。また，BPMNビジネスプロセス定義ファイルがBPMN2.0仕様に従わない場合の動作は保証対象外です（すべてのケースでコマンド実行時エラーとなるとは限りません）。

BPMNビジネスプロセス定義ファイルの記載には制限があります。詳細は，マニュアルuCosminexus Service Coordinator Interactive Workflow　BPMN連携機能　使用の手引の「1.3.1　BPMN連携機能で使用できるBPMN要素」および「2.3.1(1)　BPMNビジネスプロセス定義ファイルの作成時の規則」を参照してください。

KDIW20002-Eメッセージが出力された場合，入力のBPMNビジネスプロセス定義ファイルが正しくない可能性があります。また，BPMNビジネスプロセス定義ファイルが正しくないとき，KDIW20002-Eメッセージの原因として，NullPointerExceptionが発生している可能性があります。

サブプロセス（シーケンシャルマルチインスタンス），またはサブプロセス（パラレルマルチインスタンス）を含むBPMNビジネスプロセス定義ファイルを入力とする場合，-mimaxオプションを指定していないと，KDIW61126-Wメッセージが出力されます（ただし，loopCardinalityが1以上の整数値のときを除きます）。また，-mimaxオプションの値を正しく設定していない場合，実行環境で実行時エラーになるおそれがあります。なお，KDIW61126-Wメッセージが出力されていて，その他のエラーが発生していない場合，コマンドのリターンコードは49となります。

このコマンドのログに関する設定は，uCosminexus Business Process Developer設定ファイルの設定を使用します。詳細は，マニュアルuCosminexus Service Coordinator Interactive Workflow BPMN 連携機能　使用の手引を参照してください。

付録

付録A　各バージョンの変更内容

付録A.1　03-10での変更内容

ビジネスプロセス定義に関する次のコマンドに，BPMN連携機能を使用する場合のコマンドの使用方法を追加しました。

ciweditbp

ciwmngbp

付録A.2　03-00での変更内容

Cosminexus V11に対応しました。

ciwtransbpmnコマンドの実行権限を変更しました。

BPMN要素として，ビジネスルールタスクを追加しました。

コマンドを実行できるコンポーネントの稼働状態の表に「運用管理RESTサービス」の状態を追加しました。

ciwsetenvコマンドで使用できる環境構築ファイルのひな形の格納先を記載しました。

ciwtransbpmnコマンドを，同一マシンで複数同時に実行しないよう明記しました。

ciwtransbpmnコマンドのログに関する情報の設定先を，uCosminexus Business Process Developer設定ファイルに変更しました。

付録A.3　02-30での変更内容

FirefoxおよびChromeに対応しました。

アプリケーション呼び出しに関する次のコマンドに，BPMN連携機能を使用しない場合のコマンドの使用方法を追加しました。

ciwchgapwork

ciwmngap

ciwmngapgrp

コマンドを実行できるコンポーネントの稼働状態の表に「アプリケーション呼び出しサービス」および「RESTサービス」の状態を追加しました。

ciwchgdefコマンドに，RESTアプリケーション呼び出しの場合に，変更するref識別子を指定する-rriオプションを追加しました。

ciweditbpコマンドの変更対象に，RESTアプリケーションを追加しました。また，RESTアプリケーション呼び出しの場合の変更内容出力ファイルの形式を追加しました。

ciwmngapコマンドについて，アプリケーション呼び出しサービスを起動中に，アプリケーション呼び出し制御情報の表示，変更，追加，または削除をできるようにしました。

ciwmngapgrpコマンドについて，アプリケーション呼び出しサービスを起動中に，アプリケーション呼び出しグループ定義の表示，変更，追加，または削除をできるようにしました。

「環境設定ファイル」のエンコーディングについての説明を変更しました。

付録A.4　02-20での変更内容

アプリケーション呼び出しサービスの呼び出し対象となる作業の一覧を取得する，ciwchgapworkコマンドを追加しました。

ciwlistsidコマンドの-sオプションに，オプションを指定しない場合の説明を追加しました。

ciwmngapコマンドで管理するアプリケーション呼び出し制御情報の種別に，タイマーイベントを追加しました。

ciwtransbpmnコマンドに，サブプロセス（マルチインスタンス）に対応する階層定義の生成数を設定する-mimaxオプションを追加しました。

付録A.5　02-10での変更内容

アプリケーション呼び出し制御情報を管理する，ciwmngapコマンドを追加しました。

アプリケーション呼び出しグループを管理する，ciwmngapgrpコマンドを追加しました。

ciwdelpiコマンドで削除できる案件として，BPMN連携機能で使用するテーブルの案件データを追加しました。また，親子関係にある案件の削除時のルールの説明を追加しました。

ciwdelpiコマンドの-untオプションに，BPMN連携機能のコールアクティビティを使用している場合の削除の処理単位に関する説明を追加しました。

ciwtransbpmnコマンドに，登録済みのビジネスプロセスを一部変更する場合に使用する，-updateオプションおよび-bpfオプションを追加しました。

ciwtransbpmnコマンドの注意事項に，KDIW20002-Eメッセージが出力される要因の説明を追加しました。

ビジネスプロセスの変換時に実施される，CSCIWのビジネスプロセスのチェック処理に関する説明を追加しました。

付録A.6　02-00での変更内容

BPMNビジネスプロセス定義ファイルをCSCIWのビジネスプロセス定義ファイルに変換する，ciwtransbpmnコマンドを追加しました。

-oオプションを指定したciweditbpコマンドの実行時に出力される，ビジネスプロセス属性値の変更内容に，アドホックAPIの使用に関する行を追加しました。

付録A.7　01-95での変更内容

なし。

付録A.8　01-90での変更内容

「文字列を指定する場合の注意事項」に，UNIXで「¥」（バックスラッシュ）を含む文字列を指定する場合の注意事項を追加しました。

コマンドの実行権限の変更方法についての参照先を追加しました。

表2-6の表示属性「作業アプリケーションの種別（Type）」の備考欄の説明を変更しました。

付録A.9　01-70での変更内容

Cosminexus V8に対応しました。

ビジネスプロセス定義の条件，生成ルール，および作業アプリケーションの定義の属性を変更する，ciwchgdefコマンドを追加しました。

ファイル名およびディレクトリ名を指定する場合の注意事項を追加しました。

コマンドを実行できるコンポーネントに業務アプリケーション（Javaアプリケーション）を追加しました。

一般作業属性値の出力内容に作業アプリケーション定義名を追加しました。

条件属性値（Javaオブジェクト呼び出しの場合）の変更内容出力ファイルの表を追加しました。

生成ルール属性値（Javaオブジェクト呼び出しの場合）の変更内容出力ファイルの表を追加しました。

作業アプリケーション定義属性値（Javaオブジェクト呼び出しの場合）の変更内容出力ファイルの表を追加しました。

ciweditbpコマンドで変更できるビジネスプロセス定義の範囲の表の変更対象（作業，条件，ルール）の変更できる属性を変更しました。

ciweditbpコマンドで変更できるビジネスプロセス定義の範囲の表に変更対象（作業アプリケーション（Java））を追加しました。

ciweditbpコマンドの引数（-bpf）の説明に注意事項を追加しました。

ciweditbpコマンドの説明に注意事項を追加しました。

ciwmngbpコマンドおよびciwmngcrコマンドの引数（-reg）の説明に注意事項を追加しました。

ciwsetenvコマンドの引数（-del）の説明に注意事項を追加しました。

付録A.10　01-60での変更内容

ciwlistsidコマンドの引数（-env）が表示する情報に，実行したマシンのIPアドレスを追加しました。なお，この追加に伴って，出力形式および表示項目（プロセス情報）の表にもIP_ADDRESSを追加しました。

ciwmngbpコマンドの引数（-pfdおよび-ptd）に指定できる案件投入可能期間の範囲の上限を9999/12/30に変更しました。

ciwmngcrコマンドの引数（-vfdおよび-vtd）に指定できる案件投入可能期間の範囲の上限を9999/12/30に変更しました。

ciwsetenvコマンドに次に示す項目を追加しました。

バージョンアップ機能

使用するDBMSにSQLServer

環境構築ファイルに設定する項目に「SystemDBSchemaName」

ビジネスプロセスを管理するツールを，WorkCoordinator DefinerからCSCIW-Definerへ変更しました。

索引

B

BPMNビジネスプロセス定義ファイルのCSCIWのビジネスプロセス定義ファイルへの変換〔ciwtransbpmnコマンド〕[1]

BPMNビジネスプロセス定義ファイルのディレクトリ指定〔形式（ciwtransbpmn）〕[1]

BPMNビジネスプロセス定義ファイルのファイル指定〔形式（ciwtransbpmn）〕[1]

BPMNビジネスプロセス定義を登録する〔形式（ciwmngbp）〕

BPMN連携機能を使用しない場合[1]

BPMN連携機能を使用する場合[1]

C

ciwchgapwork

BPMN連携機能を使用しない場合[1]

BPMN連携機能を使用する場合[1]

ciwchgdef[1]

ciwchgenv[1]

ciwcleanup[1]

ciwdelpi[1]

ciweditbp

BPMN連携機能を使用しない場合[1]

BPMN連携機能を使用する場合[1]

ciwlistsid[1]

ciwmngap

BPMN連携機能を使用しない場合[1]

BPMN連携機能を使用する場合[1]

ciwmngapgrp

BPMN連携機能を使用しない場合[1]

BPMN連携機能を使用する場合[1]

ciwmngbp

BPMN連携機能を使用しない場合[1]

BPMN連携機能を使用する場合[1]

ciwmngcr[1]

ciwreuseid[1]

ciwsetenv[1]

ciwtransbpmnコマンド[1]

CSCIWで使用するコマンドの一覧[1]

F

-fileオプション[1]

H

-hオプション[1]

I

IDの再利用[1]

R

ref識別子共通設定

BPMN連携機能を使用しない場合[1]

BPMN連携機能を使用する場合[1]

あ

空きID[1]

空きID範囲を表示する〔形式（ciwreuseid）〕[1]

アプリケーション呼び出しグループ定義ファイルのフォーマット

BPMN連携機能を使用しない場合[1]

BPMN連携機能を使用する場合[1]

アプリケーション呼び出しグループ定義を一覧で表示する〔形式（ciwmngapgrp）〕

BPMN連携機能を使用しない場合[1]

BPMN連携機能を使用する場合[1]

アプリケーション呼び出しグループの管理

BPMN連携機能を使用しない場合[1]

BPMN連携機能を使用する場合[1]

アプリケーション呼び出し作業の状態変更

BPMN連携機能を使用しない場合[1]

BPMN連携機能を使用する場合[1]

アプリケーション呼び出し制御情報の管理

BPMN連携機能を使用しない場合[1]

BPMN連携機能を使用する場合[1]

アプリケーション呼び出し制御情報ファイルのフォーマット

BPMN連携機能を使用しない場合[1]

BPMN連携機能を使用する場合[1]

アプリケーション呼び出し制御情報を一覧表示する〔形式（ciwmngap）〕

BPMN連携機能を使用しない場合[1]

BPMN連携機能を使用する場合[1]

案件IDリスト指定ファイルを指定して案件を削除する〔形式（ciwdelpi）〕[1]

案件開始後の経過日数を指定して案件を削除する〔形式（ciwdelpi）〕[1]

案件終了後の経過日数を指定して案件を削除する〔形式（ciwdelpi）〕[1]

案件の削除[1]

か

回復済みID[1]

環境構築ファイルに設定する項目[1]

環境の構築または削除[1]

環境を構築する〔形式（ciwsetenv）〕[1]

環境を削除する〔形式（ciwsetenv）〕[1]

環境をバージョンアップする〔形式（ciwsetenv）〕[1]

こ

コマンド共通のオプション[1]

コマンドの概要[1]

コマンドの実行権限[1]

コマンドの種類[1]

コマンドの詳細[1]

コマンドの入力形式[1]

コマンドの文法の記述形式[1]

コマンドを実行したマシンで，実行環境を構築した全システムIDで動作するプロセス情報を表示する〔形式（ciwlistsid）〕[1]

さ

作業アプリケーションを変更する〔形式（ciwchgdef）〕[1]

作業の一覧を表示する〔形式（ciwchgapwork）〕

BPMN連携機能を使用しない場合[1]

BPMN連携機能を使用する場合[1]

作業の状態変更をする〔形式（ciwchgapwork）〕

BPMN連携機能を使用しない場合[1]

BPMN連携機能を使用する場合[1]

削除できる案件の状態[1]

差分変更用のCSCIWビジネスプロセス定義ファイル指定〔形式（ciwtransbpmn）〕[1]

し

システムID情報の表示[1]

システム共通環境情報の一覧を出力する〔形式（ciwchgenv）〕[1]

システム共通環境情報の変更[1]

システム共通環境情報を変更する〔形式（ciwchgenv）〕[1]

指定したシステムIDで動作するプロセス情報を表示する〔形式（ciwlistsid）〕[1]

条件，生成ルール，および作業アプリケーションの変更[1]

条件を変更する〔形式（ciwchgdef）〕[1]

使用済みIDを回復する〔形式（ciwreuseid）〕[1]

せ

生成ルールを変更する〔形式（ciwchgdef）〕[1]

た

タイマーイベント共通設定

BPMN連携機能を使用する場合[1]

タイマーイベントの作業の一覧を表示する〔形式（ciwchgapwork）〕

BPMN連携機能を使用する場合[1]

て

定義情報を表示する〔形式（ciwchgdef）〕[1]

と

登録済みビジネスプロセス定義の変更〔ciwtransbpmnコマンド〕[1]

に

入力用ファイルの内容に従ってアプリケーション呼び出しグループ定義を更新する〔形式（ciwmngapgrp）〕

BPMN連携機能を使用しない場合[1]

BPMN連携機能を使用する場合[1]

入力用ファイルの内容に従ってアプリケーション呼び出し制御情報を変更する〔形式（ciwmngap）〕

BPMN連携機能を使用しない場合[1]

BPMN連携機能を使用する場合[1]

ひ

引数[1]

ビジネスプロセス定義の管理

BPMN連携機能を使用しない場合[1]

BPMN連携機能を使用する場合[1]

ビジネスプロセス定義の属性を変更する〔形式（ciwmngbp）〕

BPMN連携機能を使用しない場合[1]

BPMN連携機能を使用する場合[1]

ビジネスプロセス定義の変更

BPMN連携機能を使用しない場合[1]

BPMN連携機能を使用する場合[1]

ビジネスプロセス定義バージョン〔ciwtransbpmnコマンド〕[1]

ビジネスプロセス定義を削除する〔形式（ciwmngbp）〕

BPMN連携機能を使用しない場合[1]

BPMN連携機能を使用する場合[1]

ビジネスプロセス定義を取得する〔形式（ciwmngbp）〕

BPMN連携機能を使用しない場合[1]

BPMN連携機能を使用する場合[1]

ビジネスプロセス定義を登録する〔形式（ciwmngbp）〕

BPMN連携機能を使用しない場合[1]

BPMN連携機能を使用する場合[1]

表示項目（システム共通環境情報）[1]

表示項目（ビジネスプロセス定義一覧）

BPMN連携機能を使用しない場合[1]

BPMN連携機能を使用する場合[1]

表示項目（振り分けルール定義一覧）[1]

表示項目（プロセス情報）[1]

ふ

振り分けルール定義の管理[1]

振り分けルール定義の属性を変更する〔形式（ciwmngcr）〕[1]

振り分けルール定義を削除する〔形式（ciwmngcr）〕[1]

振り分けルール定義を取得する〔形式（ciwmngcr）〕[1]

振り分けルール定義を登録する〔形式（ciwmngcr）〕[1]

プロセス情報の正常化[1]

プロセス情報を正常な状態にする〔形式（ciwcleanup）〕[1]

へ

変更したビジネスプロセス定義を登録する〔形式（ciweditbp）〕

BPMN連携機能を使用しない場合[1]

BPMN連携機能を使用する場合[1]

変更内容出力ファイル（一般作業属性値）

BPMN連携機能を使用しない場合[1]

変更内容出力ファイル（階層定義属性値）

BPMN連携機能を使用しない場合[1]

変更内容出力ファイル（業務ステップ属性値）

BPMN連携機能を使用しない場合[1]

変更内容出力ファイル（作業アプリケーション定義属性値： Javaオブジェクト呼び出しの場合）

BPMN連携機能を使用しない場合[1]

変更内容出力ファイル（作業アプリケーション定義属性値：RESTアプリケーション呼び出しの場合）

BPMN連携機能を使用しない場合[1]

変更内容出力ファイル（削除情報）

BPMN連携機能を使用しない場合[1]

変更内容出力ファイル（時間取得ルール属性値）

BPMN連携機能を使用しない場合[1]

変更内容出力ファイル（条件属性値：Javaオブジェクト呼び出しの場合）

BPMN連携機能を使用しない場合[1]

変更内容出力ファイル（条件属性値：RDB検索の場合）

BPMN連携機能を使用しない場合[1]

変更内容出力ファイル（生成ルール属性値：Javaオブジェクト呼び出しの場合）

BPMN連携機能を使用しない場合[1]

変更内容出力ファイル（生成ルール属性値：RDB検索の場合）

BPMN連携機能を使用しない場合[1]

変更内容出力ファイル（遷移定義属性値）

BPMN連携機能を使用しない場合[1]

変更内容出力ファイル（追加情報）

BPMN連携機能を使用しない場合[1]

変更内容出力ファイル（ビジネスプロセス属性値）

BPMN連携機能を使用しない場合[1]

変更内容出力ファイル（ビジネスプロセス定義の識別情報）

BPMN連携機能を使用しない場合[1]

変更内容出力ファイル（分岐ノード，分業ノード，先着ノード，待合ノード，ソースノード，シンクノードの属性値）

BPMN連携機能を使用しない場合[1]

変更内容出力ファイル（並列作業属性値）

BPMN連携機能を使用しない場合[1]

変更内容出力ファイル（変更情報）

BPMN連携機能を使用しない場合[1]

変更内容をファイルに出力する〔形式（ciweditbp）〕

BPMN連携機能を使用しない場合[1]

み

未使用ID[1]

わ

ワーク管理データベースに登録されているビジネスプロセス定義を一覧表示する〔形式（ciwmngbp）〕

BPMN連携機能を使用しない場合[1]

BPMN連携機能を使用する場合[1]

ワーク管理データベースに登録されている振り分けルール定義を一覧表示する〔形式（ciwmngcr）〕[1]

マニュアル発行元

株式会社 日立製作所

〒100-8280　東京都千代田区丸の内一丁目6番6号