dcmpsrcv: プレゼンテーションステートビューア向けネットワーク受信

書式

dcmpsrcv [options] config-file

説明

dcmpsrcv は Grayscale Softcopy Presentation State Viewer から呼び出されるアプリケーションで、手動での実行は想定していません。ビューアの各コンポーネントで共有される共通設定ファイルを読み込み、着信するアソシエーション要求を受け付ける TCP/IP ソケットを開きます。DICOM 接続ごとに別プロセスを起動します。SCP として storescp ユーティリティと同じストレージ SOP クラスをサポートしますが、カプセル化された転送構文には対応しません。受信した画像は共通のビューアデータベースに保存されます。詳細は完全なコンフォーマンスステートメントを参照してください。

引数

config-file  configuration file to be read

オプション

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 を使用します
-t --terminate: 実行中の受信プロセスをすべて終了します

LOGGING

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

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

COMMAND LINE

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

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

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

ENVIRONMENT

dcmpsrcv ユーティリティは、DCMDICTPATH 環境変数で指定された DICOM データ辞書を読み込もうとします。既定では、つまり DCMDICTPATH 環境変数が設定されていない場合は、辞書がアプリケーションに組み込まれていない限り（Windows では既定で組み込み）、< datadir>/dicom.dic が読み込まれます。

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

FILES

< etcdir>/dcmpstat.cfg - 設定ファイルの例