dcmpssnd: プレゼンテーションステートビューア用のネットワーク送信

書式

dcmpssnd [options] config-file target study [series] [instance]

説明

dcmpssnd アプリケーションは Grayscale Softcopy Presentation State Viewer から呼び出されるもので、手動で起動することは想定していません。本アプリケーションはビューアの各コンポーネントが共有する共通設定ファイルを読み込み、指定したターゲットとの DICOM アソシエーションの確立を試みます。確立できた場合は、ビューアのデータベースから必要な DICOM インスタンスを選び出し、SCU としてサポートする DICOM の保存サービスクラスを使って送信します。送信が終わると、成否にかかわらずアプリケーションは終了します。本アプリケーションは storescu ユーティリティと同じ保存 SOP クラスをサポートしますが、カプセル化された転送構文はサポートしません。詳細は適合性宣言（conformance statement）の全文を参照してください。

引数

config-file  configuration file to be read

target       symbolic identifier of send target in config file

study        study instance UID of study in database to be sent

series       series instance UID (default: send complete study)

instance     SOP instance UID (default: send complete series)

オプション

general options

-h --help: このヘルプを表示して終了します
--version: バージョン情報を表示して終了します
--arguments: 展開後のコマンドライン引数を表示します
-q --quiet: quiet モード。警告やエラーを表示しません
-v --verbose: verbose モード。処理の詳細を表示します
-d --debug: debug モード。デバッグ情報を表示します
-ll --log-level [l]evel: string constant: (fatal, error, warn, info, debug, trace) ロガーにレベル l を使用します
-lc --log-config [f]ilename: string: ロガーに設定ファイル f を使用します

ロギング

各コマンドラインツールおよびその基盤となるライブラリのロギング出力レベルは、ユーザーが指定できます。既定では、エラーと警告のみが標準エラー出力へ書き出されます。オプション –verbose を使うと、処理の詳細などの情報メッセージも報告されます。オプション –debug を使えば、デバッグ目的などで内部動作のより詳しい情報を得られます。それ以外のロギングレベルはオプション –log-level で選択できます。–quiet モードでは致命的エラーだけが報告されます。このような非常に重大なエラーが発生した場合、アプリケーションは通常終了します。各ロギングレベルの詳細は、モジュール "oflog" のドキュメントを参照してください。

ロギング出力をファイルへ（必要に応じてログファイルのローテーション付きで）、あるいは syslog（Unix）やイベントログ（Windows）へ書き出したい場合は、オプション –log-config を使えます。この設定ファイルでは、特定のメッセージだけを特定の出力ストリームへ振り分けたり、メッセージを生成したモジュールやアプリケーションに基づいて特定のメッセージをフィルタリングしたりすることもできます。設定ファイルの例は < etcdir>/logger.cfg に用意されています。

コマンドライン

すべてのコマンドラインツールは、引数について次の表記を用います。角括弧は省略可能な値（0〜1 個）を囲み、末尾の 3 つのドットは複数の値を指定できること（1〜n 個）を示します。両者を組み合わせると 0〜n 個の値を意味します。

コマンドラインオプションは、先頭の '+' または '-' 記号によって引数と区別されます。通常、コマンドラインオプションの順序や位置は任意であり、どこに現れても構いません。ただし、相互に排他的なオプションの場合は、最も右にあるものが使われます。この挙動は、一般的な Unix シェルの標準的な評価規則に従っています。

さらに、ファイル名の前に '@' 記号を付けることで、1 つ以上のコマンドファイルを指定できます（例: @command.txt）。このようなコマンド引数は、以降の評価に先立って、対応するテキストファイルの内容に置き換えられます（連続する空白は、引用符で囲まれていない限り単一の区切りとして扱われます）。なお、コマンドファイルの中に別のコマンドファイルを含めることはできません。この単純ながら効果的な方法を使えば、よく使うオプションや引数の組み合わせをまとめられ、長く分かりにくいコマンドラインを避けられます（例は < datadir>/dumppat.txt にあります）。

環境変数

dcmpssnd ユーティリティは、環境変数 DCMDICTPATH で指定された DICOM データ辞書の読み込みを試みます。既定では、すなわち環境変数 DCMDICTPATH が設定されていない場合は、ファイル < datadir>/dicom.dic が読み込まれます（ただしデータ辞書がアプリケーションに組み込まれている場合を除きます。Windows では組み込みが既定です）。

通常はこの既定の動作が望ましく、DCMDICTPATH 環境変数は別のデータ辞書が必要な場合にのみ使うとよいでしょう。DCMDICTPATH 環境変数は Unix シェルの PATH 変数と同じ形式で、コロン（":"）でエントリを区切ります。Windows システムでは区切り文字にセミコロン（";"）を使います。データ辞書のコードは、DCMDICTPATH 環境変数に指定された各ファイルの読み込みを試みます。データ辞書を 1 つも読み込めなかった場合はエラーになります。

ファイル

< etcdir>/dcmpstat.cfg - 設定ファイルのサンプル