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)

オプション

全般オプション

-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 - 設定ファイルのサンプル