⚠️ これは 非公式の翻訳サイトです。DCMTK / OFFIS とは無関係です。正確な情報は 原文(https://support.dcmtk.org/docs/movescu.html) を参照してください。

movescu: DICOM 取得(C-MOVE)SCU

書式

movescu [options] peer port [dcmfile-in...]

説明

movescu は、Query/Retrieve サービスクラスの SCU と Storage サービスクラスの SCP の両方を実装したアプリケーションです。movescu は C-MOVE メッセージによる取得機能をサポートします。問い合わせキーを SCP に送り、その応答を待ちます。また、C-MOVE 要求の結果として送られてくる画像を受信するためにアソシエーションを受け入れます。本アプリケーションは Query/Retrieve サービスクラスの SCP をテストする用途に使えます。movescu は画像の第三者への転送を開始することも、画像を自分自身へ取得することもできます。なお「move」という語は厳密には正確ではありません。C-MOVE 操作は実際には画像のコピーを行うものであり、SCP 側の画像が削除されることはありません。

引数

peer        hostname of DICOM peer

port        tcp/ip port number of peer

dcmfile-in  DICOM query file(s)

オプション

全般オプション

-h --help
このヘルプを表示して終了します
--version
バージョン情報を表示して終了します
--arguments
展開後のコマンドライン引数を表示します
-q --quiet
quiet モード、警告やエラーを表示しません
-v --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 を使用します

ネットワークオプション

-i4 --ipv4
IPv4 のみを使用します(既定値)
-i6 --ipv6
IPv6 のみを使用します
-i0 --ip-auto
IPv6/IPv4 デュアルスタックを使用します。マッチングキーの上書き:
-k --key [k]ey: gggg,eeee="str" or dictionary name="str"
マッチングキーを上書きします。問い合わせ情報モデル:
-P --patient
patient root 情報モデルを使用します(既定値)
-S --study
study root 情報モデルを使用します
-O --psonly
patient/study only 情報モデルを使用します。アプリケーションエンティティ名:
-aet --aetitle [a]etitle: string
自分の calling AE Title を設定します(既定値: MOVESCU)
-aec --call [a]etitle: string
相手の called AE Title を設定します(既定値: ANY-SCP)
-aem --move [a]etitle: string
move 先の AE Title を設定します(既定値: MOVESCU)。優先する転送構文(受信アソシエーション):
+x= --prefer-uncompr
explicit VR ローカルバイト順を優先します(既定値)
+xe --prefer-little
explicit VR little endian TS を優先します
+xb --prefer-big
explicit VR big endian TS を優先します
+xs --prefer-lossless
既定の JPEG lossless TS を優先します
+xy --prefer-jpeg8
8 ビットデータ向けに既定の JPEG lossy TS を優先します
+xx --prefer-jpeg12
12 ビットデータ向けに既定の JPEG lossy TS を優先します
+xv --prefer-j2k-lossless
JPEG 2000 lossless TS を優先します
+xw --prefer-j2k-lossy
JPEG 2000 lossy TS を優先します
+xt --prefer-jls-lossless
JPEG-LS lossless TS を優先します
+xu --prefer-jls-lossy
JPEG-LS lossy TS を優先します
+xm --prefer-mpeg2
MPEG2 Main Profile @ Main Level TS を優先します
+xh --prefer-mpeg2-high
MPEG2 Main Profile @ High Level TS を優先します
+xn --prefer-mpeg4
MPEG4 AVC/H.264 High Profile / Level 4.1 TS を優先します
+xl --prefer-mpeg4-bd
MPEG4 AVC/H.264 BD-compatible HP / Level 4.1 TS を優先します
+x2 --prefer-mpeg4-2-2d
2D 動画向けに MPEG4 AVC/H.264 HP / Level 4.2 TS を優先します
+x3 --prefer-mpeg4-2-3d
3D 動画向けに MPEG4 AVC/H.264 HP / Level 4.2 TS を優先します
+xo --prefer-mpeg4-2-st
MPEG4 AVC/H.264 Stereo HP / Level 4.2 TS を優先します
+x4 --prefer-hevc
HEVC/H.265 Main Profile / Level 5.1 TS を優先します
+x5 --prefer-hevc10
HEVC/H.265 Main Profile / Level 5.1 TS を優先します
+xr --prefer-rle
RLE lossless TS を優先します
+xd --prefer-deflated
deflated explicit VR little endian TS を優先します
+xi --implicit
implicit VR little endian TS のみを受け入れます
+xa --accept-all
サポートする全転送構文を受け入れます。提案する送信転送構文(送信アソシエーション):
-x= --propose-uncompr
非圧縮の全 TS を提案し、ローカルバイト順の explicit VR を先頭にします(既定値)
-xe --propose-little
非圧縮の全 TS を提案し、explicit VR little endian を先頭にします
-xb --propose-big
非圧縮の全 TS を提案し、explicit VR big endian を先頭にします
-xd --propose-deflated
deflated explicit VR little endian TS と非圧縮の全転送構文を提案します
-xi --propose-implicit
implicit VR little endian TS のみを提案します。ネットワークホストアクセス制御(tcp wrapper):
-ac --access-full
任意のホストからの接続を受け入れます(既定値)
+ac --access-control
ホストアクセス制御ルールを適用します。受信ネットワークアソシエーション用ポート:
--no-port
受信アソシエーション用ポートを開きません(既定値)
+P --port [n]umber: integer
受信アソシエーション用ポート番号。'pending' move 応答に続く不正データセットの扱い:
-pi --pending-ignore
データセットが存在しないものとみなします(既定値)
-pr --pending-read
データセットを読み込んで無視します。その他のネットワークオプション:
-to --timeout [s]econds: integer (default: unlimited)
接続要求のタイムアウト
-ta --acse-timeout [s]econds: integer (default: 30)
ACSE メッセージのタイムアウト
-td --dimse-timeout [s]econds: integer (default: unlimited)
DIMSE メッセージのタイムアウト
-pdu --max-pdu [n]umber of bytes: integer (4096..131072)
受信 PDU の最大値を n バイトに設定します(既定値: 16384)
-dhl --disable-host-lookup
ホスト名の名前解決を無効にします
--repeat [n]umber: integer
n 回繰り返します
--abort
アソシエーションを解放せず中断(abort)します
--ignore
保存データを無視し、受信しますが保存しません
--cancel [n]umber: integer
n 件の応答後にキャンセルします(既定値: しない)
-up --uid-padding
スペースで埋められた UID を黙って訂正します

トランスポート層セキュリティ(TLS)オプション

-tls --disable-tls
通常の TCP/IP 接続を使用します(既定値)
+tls --enable-tls [p]rivate key file, [c]ertificate file: string
認証付きのセキュアな TLS 接続を使用します。秘密鍵のパスワード(--enable-tls 指定時のみ):
+ps --std-passwd
パスワードを stdin から入力するよう求めます(既定値)
+pw --use-passwd [p]assword: string
指定したパスワードを使用します
-pw --null-passwd
空文字列をパスワードとして使用します。鍵と証明書のファイル形式:
-pem --pem-keys
鍵と証明書を PEM ファイルとして読み込みます(既定値)
-der --der-keys
鍵と証明書を DER ファイルとして読み込みます。認証局:
+cf --add-cert-file [f]ilename: string
証明書ファイルを証明書リストに追加します
+cd --add-cert-dir [d]irectory: string
d 内の証明書を証明書リストに追加します
+crl --add-crl-file [f]ilename: string
証明書失効リスト(CRL)ファイルを追加します(--enable-crl-vfy を含意する)
+crv --enable-crl-vfy
リーフ証明書の CRL 検証を有効にします
+cra --enable-crl-all
チェーン全体の CRL 検証を有効にします。セキュリティプロファイル:
+ph --list-profiles
サポートする TLS プロファイルを一覧表示して終了します
+pg --profile-8996
BCP 195 RFC 8996 TLS Profile(既定値)
+pm --profile-8996-mod
Modified BCP 195 RFC 8996 TLS Profile # このプロファイルに必要な TLS 機能をすべて # 基盤の TLS ライブラリがサポートする場合のみ利用可能
+py --profile-bcp195-nd
Non-downgrading BCP 195 TLS Profile(廃止)
+px --profile-bcp195
BCP 195 TLS Profile(廃止)
+pz --profile-bcp195-ex
Extended BCP 195 TLS Profile(廃止)
+pb --profile-basic
Basic TLS Secure Transport Connection Profile(廃止)# 基盤の TLS ライブラリが 3DES をサポートする場合のみ利用可能
+pa --profile-aes
AES TLS Secure Transport Connection Profile(廃止)
+pn --profile-null
認証付き非暗号化通信(廃止、IHE ATNA で使われていた)。暗号スイート:
+cc --list-ciphers
サポートする TLS 暗号スイートを一覧表示して終了します
+cs --cipher [c]iphersuite name: string
暗号スイートをネゴシエート対象リストに追加します
+dp --dhparam [f]ilename: string
DH/DSS 暗号スイート用の DH パラメータを読み込みます。サーバ名表示(SNI):
--no-sni
SNI を使用しません(既定値)
--expect-sni [s]erver name: string
サーバ名 s への要求を期待します。疑似乱数生成器:
+rs --seed [f]ilename: string
f の内容で乱数生成器をシードします
+ws --write-seed
変更したシードを書き戻します(--seed 指定時のみ)
+wf --write-seed-file [f]ilename: string (only with --seed)
変更したシードをファイル f に書き出します。ピア認証:
-rc --require-peer-cert
ピア証明書を検証し、無ければ失敗とします(既定値)
-vc --verify-peer-cert
ピア証明書があれば検証します
-ic --ignore-peer-cert
ピア証明書を検証しません

出力オプション

-od --output-directory [d]irectory: string (default: ".")
受信したオブジェクトを既存のディレクトリ d に書き出します。ビット保存モード:
-B --normal
暗黙の形式変換を許可します(既定値)
+B --bit-preserving
読み込んだままのデータを正確に書き出します。出力ファイル形式:
+F --write-file
ファイル形式で書き出します(既定値)
-F --write-dataset
ファイルメタ情報を付けずにデータセットを書き出します。出力転送構文(--bit-preserving または圧縮転送とは併用不可):
+t= --write-xfer-same
入力と同じ TS で書き出します(既定値)
+te --write-xfer-little
explicit VR little endian TS で書き出します
+tb --write-xfer-big
explicit VR big endian TS で書き出します
+ti --write-xfer-implicit
implicit VR little endian TS で書き出します
+td --write-xfer-deflated
deflated explicit VR little endian TS で書き出します。1993 年以降の値表現(--bit-preserving とは併用不可):
+u --enable-new-vr
新しい VR(UN/UT)のサポートを有効にします(既定値)
-u --disable-new-vr
新しい VR のサポートを無効にし、OB に変換します。グループ長エンコーディング(--bit-preserving とは併用不可):
+g= --group-length-recalc
グループ長があれば再計算します(既定値)
+g --group-length-create
常にグループ長要素を付けて書き出します
-g --group-length-remove
常にグループ長要素を付けずに書き出します。シーケンスおよびアイテムの長さエンコーディング(--bit-preserving とは併用不可):
+e --length-explicit
明示的な長さで書き出します(既定値)
-e --length-undefined
未定義の長さで書き出します。データセット末尾のパディング(--write-dataset または --bit-preserving とは併用不可):
-p --padding-off
パディングしません(既定値)
+p --padding-create [f]ile-pad [i]tem-pad: integer
ファイルを f バイトの倍数に、アイテムを i バイトの倍数に整列させます。deflate 圧縮レベル(--propose-deflated または --write-xfer-deflated/same 指定時のみ):
+cl --compression-level [l]evel: integer (default: 6)
0=非圧縮, 1=最速, 9=最高圧縮

注記

コマンドラインで指定した各ファイルは、C-MOVE 要求の一部として SCP に送られます。問い合わせファイルは、C-MOVE-RQ メッセージのデータセット部分を含む有効な DICOM データセットでなければなりません。問い合わせファイルは、たとえば dump2dcm ユーティリティを使い、次のようなスクリプトから作成できます:

# request all images for the patient with ID=PAT001
(0008,0052) CS [PATIENT]     # QueryRetrieveLevel
(0010,0020) LO [PAT001]      # PatientID

送信する各ファイルの個々の属性は、-k(または –key)オプションで変更・補足できます。たとえば次のコマンド:

movescu -k 0010,0020=PAT002 caesar 5678 patqry.dcm

は、TCP/IP ポート 5678 の SCP caesar に送られたとき、patqry.dcm 内のすべての PatientID 属性を 'PAT002' という値にします。該当する属性があれば置き換え、無ければ挿入します。-k オプションは複数回指定できます。'=' の後ろの値部分は省略でき、その場合は属性が長さ 0 で送られます。-k オプションでシーケンス内の属性を置換・挿入することはできません。

コマンドラインでファイルを指定しない場合、問い合わせは 1 つ以上の -k オプションで完全に指定しなければなりません。複数の問い合わせファイルを与えた場合、movescu は複数の C-MOVE 要求を SCP に送ります。

movescu をどのように使う場合でも、SCP は画像の送信先となる AE Title を「知っている」よう設定されていなければなりません。C-MOVE 要求には送信先の AE Title しか含まれず、SCP が別のアソシエーションを通じて実際に画像を送るには、この AE Title を TCP/IP アドレスとポート番号に変換できる必要があるためです。

Query/Retrieve サービスクラスの C-MOVE 操作は、(–port オプションを使えば)画像を取得することも、第三者への画像コピーを開始することもできます。

既知の問題

movescu は DICOM ソフトウェア開発者のテストツールとして使われることを想定しています。問い合わせキーのファイルは、SCP の内容に基づいて手作業で作成しなければなりません。

movescu は不正な問い合わせを防ぐことを一切しません。特に、C-MOVE 要求の問い合わせキーには QueryRetrieveLevel 属性と、いわゆる「ユニークキー属性」(PatientID、StudyInstanceUID、SeriesInstanceUID、SOPInstanceUID)の 1 つ以上だけを含めるべきです。

movescu がストレージサーバの役割を果たしている(すなわち –port を使っている)状況で、ストレージクライアントが接続を終了せず、代わりに movescu にストレージ接続を閉じることを期待している場合、movescu は無限に待ち続けます。この場合、movescu は C-MOVE 要求を C-MOVE サーバに送るために使ったアソシエーションも閉じません。

DICOM 適合性

SCU 適合性

movescu は SCU として次の SOP クラスをサポートします:

MOVEPatientRootQueryRetrieveInformationModel         1.2.840.10008.5.1.4.1.2.1.2
MOVEStudyRootQueryRetrieveInformationModel           1.2.840.10008.5.1.4.1.2.2.2
MOVEPatientStudyOnlyQueryRetrieveInformationModel    1.2.840.10008.5.1.4.1.2.3.2

movescu は、コマンドラインオプション(-P-S-O)に応じて、上記のサポート対象 SOP クラスのいずれか 1 つについてプレゼンテーションコンテキストを提案します。また、次のリストから対応する SOP クラスも提案しますが、これは実際には使われません(RSNA'93 のデモの名残です):

FINDPatientRootQueryRetrieveInformationModel         1.2.840.10008.5.1.4.1.2.1.1
FINDStudyRootQueryRetrieveInformationModel           1.2.840.10008.5.1.4.1.2.2.1
FINDPatientStudyOnlyQueryRetrieveInformationModel    1.2.840.10008.5.1.4.1.2.3.1

送信アソシエーションでは、次の転送構文をサポートします:

LittleEndianImplicitTransferSyntax                   1.2.840.10008.1.2
LittleEndianExplicitTransferSyntax                   1.2.840.10008.1.2.1
DeflatedExplicitVRLittleEndianTransferSyntax         1.2.840.10008.1.2.1.99 (*)
BigEndianExplicitTransferSyntax                      1.2.840.10008.1.2.2

(*) zlib サポートを有効にしてコンパイルした場合のみ(–version の出力を参照)

どの転送構文をどの順序で実際に提案するかは、–propose オプションで指定できます。

SCP 適合性

movescu は SCP として次の SOP クラスをサポートします:

VerificationSOPClass                                 1.2.840.10008.1.1

RETIRED_StoredPrintStorage                           1.2.840.10008.5.1.1.27
RETIRED_HardcopyGrayscaleImageStorage                1.2.840.10008.5.1.1.29
RETIRED_HardcopyColorImageStorage                    1.2.840.10008.5.1.1.30
ComputedRadiographyImageStorage                      1.2.840.10008.5.1.4.1.1.1
DigitalXRayImageStorageForPresentation               1.2.840.10008.5.1.4.1.1.1.1
DigitalXRayImageStorageForProcessing                 1.2.840.10008.5.1.4.1.1.1.1.1
DigitalMammographyXRayImageStorageForPresentation    1.2.840.10008.5.1.4.1.1.1.2
DigitalMammographyXRayImageStorageForProcessing      1.2.840.10008.5.1.4.1.1.1.2.1
DigitalIntraOralXRayImageStorageForPresentation      1.2.840.10008.5.1.4.1.1.1.3
DigitalIntraOralXRayImageStorageForProcessing        1.2.840.10008.5.1.4.1.1.1.3.1
CTImageStorage                                       1.2.840.10008.5.1.4.1.1.2
EnhancedCTImageStorage                               1.2.840.10008.5.1.4.1.1.2.1
LegacyConvertedEnhancedCTImageStorage                1.2.840.10008.5.1.4.1.1.2.2
RETIRED_UltrasoundMultiframeImageStorage             1.2.840.10008.5.1.4.1.1.3
UltrasoundMultiframeImageStorage                     1.2.840.10008.5.1.4.1.1.3.1
MRImageStorage                                       1.2.840.10008.5.1.4.1.1.4
EnhancedMRImageStorage                               1.2.840.10008.5.1.4.1.1.4.1
MRSpectroscopyStorage                                1.2.840.10008.5.1.4.1.1.4.2
EnhancedMRColorImageStorage                          1.2.840.10008.5.1.4.1.1.4.3
LegacyConvertedEnhancedMRImageStorage                1.2.840.10008.5.1.4.1.1.4.4
RETIRED_NuclearMedicineImageStorage                  1.2.840.10008.5.1.4.1.1.5
RETIRED_UltrasoundImageStorage                       1.2.840.10008.5.1.4.1.1.6
UltrasoundImageStorage                               1.2.840.10008.5.1.4.1.1.6.1
EnhancedUSVolumeStorage                              1.2.840.10008.5.1.4.1.1.6.2
PhotoacousticImageStorage                            1.2.840.10008.5.1.4.1.1.6.3
SecondaryCaptureImageStorage                         1.2.840.10008.5.1.4.1.1.7
MultiframeSingleBitSecondaryCaptureImageStorage      1.2.840.10008.5.1.4.1.1.7.1
MultiframeGrayscaleByteSecondaryCaptureImageStorage  1.2.840.10008.5.1.4.1.1.7.2
MultiframeGrayscaleWordSecondaryCaptureImageStorage  1.2.840.10008.5.1.4.1.1.7.3
MultiframeTrueColorSecondaryCaptureImageStorage      1.2.840.10008.5.1.4.1.1.7.4
RETIRED_StandaloneOverlayStorage                     1.2.840.10008.5.1.4.1.1.8
RETIRED_StandaloneCurveStorage                       1.2.840.10008.5.1.4.1.1.9
DRAFT_WaveformStorage                                1.2.840.10008.5.1.4.1.1.9.1
TwelveLeadECGWaveformStorage                         1.2.840.10008.5.1.4.1.1.9.1.1
GeneralECGWaveformStorage                            1.2.840.10008.5.1.4.1.1.9.1.2
AmbulatoryECGWaveformStorage                         1.2.840.10008.5.1.4.1.1.9.1.3
General32BitECGWaveformStorage                       1.2.840.10008.5.1.4.1.1.9.1.4
HemodynamicWaveformStorage                           1.2.840.10008.5.1.4.1.1.9.2.1
CardiacElectrophysiologyWaveformStorage              1.2.840.10008.5.1.4.1.1.9.3.1
BasicVoiceAudioWaveformStorage                       1.2.840.10008.5.1.4.1.1.9.4.1
GeneralAudioWaveformStorage                          1.2.840.10008.5.1.4.1.1.9.4.2
ArterialPulseWaveformStorage                         1.2.840.10008.5.1.4.1.1.9.5.1
RespiratoryWaveformStorage                           1.2.840.10008.5.1.4.1.1.9.6.1
MultichannelRespiratoryWaveformStorage               1.2.840.10008.5.1.4.1.1.9.6.2
RoutineScalpElectroencephalogramWaveformStorage      1.2.840.10008.5.1.4.1.1.9.7.1
ElectromyogramWaveformStorage                        1.2.840.10008.5.1.4.1.1.9.7.2
ElectrooculogramWaveformStorage                      1.2.840.10008.5.1.4.1.1.9.7.3
SleepElectroencephalogramWaveformStorage             1.2.840.10008.5.1.4.1.1.9.7.4
BodyPositionWaveformStorage                          1.2.840.10008.5.1.4.1.1.9.8.1
WaveformPresentationStateStorage                     1.2.840.10008.5.1.4.1.1.9.100.1
WaveformAcquisitionPresentationStateStorage          1.2.840.10008.5.1.4.1.1.9.100.2
RETIRED_StandaloneModalityLUTStorage                 1.2.840.10008.5.1.4.1.1.10
RETIRED_StandaloneVOILUTStorage                      1.2.840.10008.5.1.4.1.1.11
GrayscaleSoftcopyPresentationStateStorage            1.2.840.10008.5.1.4.1.1.11.1
ColorSoftcopyPresentationStateStorage                1.2.840.10008.5.1.4.1.1.11.2
PseudoColorSoftcopyPresentationStateStorage          1.2.840.10008.5.1.4.1.1.11.3
BlendingSoftcopyPresentationStateStorage             1.2.840.10008.5.1.4.1.1.11.4
XAXRFGrayscaleSoftcopyPresentationStateStorage       1.2.840.10008.5.1.4.1.1.11.5
GrayscalePlanarMPRVolumetricPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.6
CompositingPlanarMPRVolumetricPresent.StateStorage   1.2.840.10008.5.1.4.1.1.11.7
AdvancedBlendingPresentationStateStorage             1.2.840.10008.5.1.4.1.1.11.8
VolumeRenderingVolumetricPresentationStateStorage    1.2.840.10008.5.1.4.1.1.11.9
SegmentedVolumeRenderingVolumetricPres.StateStorage  1.2.840.10008.5.1.4.1.1.11.10
MultipleVolumeRenderingVolumetricPres.StateStorage   1.2.840.10008.5.1.4.1.1.11.11
VariableModalityLUTSoftcopyPresentationStateStorage  1.2.840.10008.5.1.4.1.1.11.12
XRayAngiographicImageStorage                         1.2.840.10008.5.1.4.1.1.12.1
EnhancedXAImageStorage                               1.2.840.10008.5.1.4.1.1.12.1.1
XRayRadiofluoroscopicImageStorage                    1.2.840.10008.5.1.4.1.1.12.2
EnhancedXRFImageStorage                              1.2.840.10008.5.1.4.1.1.12.2.1
RETIRED_XRayAngiographicBiPlaneImageStorage          1.2.840.10008.5.1.4.1.1.12.3
XRay3DAngiographicImageStorage                       1.2.840.10008.5.1.4.1.1.13.1.1
XRay3DCraniofacialImageStorage                       1.2.840.10008.5.1.4.1.1.13.1.2
BreastTomosynthesisImageStorage                      1.2.840.10008.5.1.4.1.1.13.1.3
BreastProjectionXRayImageStorageForPresentation      1.2.840.10008.5.1.4.1.1.13.1.4
BreastProjectionXRayImageStorageForProcessing        1.2.840.10008.5.1.4.1.1.13.1.5
IntravascularOpt.Coh.Tom.ImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.14.1
IntravascularOpt.Coh.Tom.ImageStorageForProcessing   1.2.840.10008.5.1.4.1.1.14.2
NuclearMedicineImageStorage                          1.2.840.10008.5.1.4.1.1.20
ParametricMapStorage                                 1.2.840.10008.5.1.4.1.1.30
RawDataStorage                                       1.2.840.10008.5.1.4.1.1.66
SpatialRegistrationStorage                           1.2.840.10008.5.1.4.1.1.66.1
SpatialFiducialsStorage                              1.2.840.10008.5.1.4.1.1.66.2
DeformableSpatialRegistrationStorage                 1.2.840.10008.5.1.4.1.1.66.3
SegmentationStorage                                  1.2.840.10008.5.1.4.1.1.66.4
SurfaceSegmentationStorage                           1.2.840.10008.5.1.4.1.1.66.5
TractographyResultsStorage                           1.2.840.10008.5.1.4.1.1.66.6
LabelMapSegmentationStorage                          1.2.840.10008.5.1.4.1.1.66.7
HeightMapSegmentationStorage                         1.2.840.10008.5.1.4.1.1.66.8
RealWorldValueMappingStorage                         1.2.840.10008.5.1.4.1.1.67
SurfaceScanMeshStorage                               1.2.840.10008.5.1.4.1.1.68.1
SurfaceScanPointCloudStorage                         1.2.840.10008.5.1.4.1.1.68.2
RETIRED_VLImageStorage                               1.2.840.10008.5.1.4.1.1.77.1
VLEndoscopicImageStorage                             1.2.840.10008.5.1.4.1.1.77.1.1
VideoEndoscopicImageStorage                          1.2.840.10008.5.1.4.1.1.77.1.1.1
VLMicroscopicImageStorage                            1.2.840.10008.5.1.4.1.1.77.1.2
VideoMicroscopicImageStorage                         1.2.840.10008.5.1.4.1.1.77.1.2.1
VLSlideCoordinatesMicroscopicImageStorage            1.2.840.10008.5.1.4.1.1.77.1.3
VLPhotographicImageStorage                           1.2.840.10008.5.1.4.1.1.77.1.4
VideoPhotographicImageStorage                        1.2.840.10008.5.1.4.1.1.77.1.4.1
OphthalmicPhotography8BitImageStorage                1.2.840.10008.5.1.4.1.1.77.1.5.1
OphthalmicPhotography16BitImageStorage               1.2.840.10008.5.1.4.1.1.77.1.5.2
StereometricRelationshipStorage                      1.2.840.10008.5.1.4.1.1.77.1.5.3
OphthalmicTomographyImageStorage                     1.2.840.10008.5.1.4.1.1.77.1.5.4
WideFieldOphthalmicPhoto.Stereogr.Proj.ImageStorage  1.2.840.10008.5.1.4.1.1.77.1.5.5
WideFieldOphthalmicPhotogr.3DCoordinatesImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.6
OphthalmicOpticalCoherenceTomogr.EnFaceImageStorage  1.2.840.10008.5.1.4.1.1.77.1.5.7
OphthalmicOpticalCoh.Tomogr.BscanVolumeAnalysisStor. 1.2.840.10008.5.1.4.1.1.77.1.5.8
VLWholeSlideMicroscopyImageStorage                   1.2.840.10008.5.1.4.1.1.77.1.6
DermoscopicPhotographyImageStorage                   1.2.840.10008.5.1.4.1.1.77.1.7
ConfocalMicroscopyImageStorage                       1.2.840.10008.5.1.4.1.1.77.1.8
ConfocalMicroscopyTiledPyramidalImageStorage         1.2.840.10008.5.1.4.1.1.77.1.9
RETIRED_VLMultiframeImageStorage                     1.2.840.10008.5.1.4.1.1.77.2
LensometryMeasurementsStorage                        1.2.840.10008.5.1.4.1.1.78.1
AutorefractionMeasurementsStorage                    1.2.840.10008.5.1.4.1.1.78.2
KeratometryMeasurementsStorage                       1.2.840.10008.5.1.4.1.1.78.3
SubjectiveRefractionMeasurementsStorage              1.2.840.10008.5.1.4.1.1.78.4
VisualAcuityMeasurementsStorage                      1.2.840.10008.5.1.4.1.1.78.5
SpectaclePrescriptionReportStorage                   1.2.840.10008.5.1.4.1.1.78.6
OphthalmicAxialMeasurementsStorage                   1.2.840.10008.5.1.4.1.1.78.7
IntraocularLensCalculationsStorage                   1.2.840.10008.5.1.4.1.1.78.8
MacularGridThicknessAndVolumeReportStorage           1.2.840.10008.5.1.4.1.1.79.1
OphthalmicVisualFieldStaticPerimetryMeasurementsSt.  1.2.840.10008.5.1.4.1.1.80.1
OphthalmicThicknessMapStorage                        1.2.840.10008.5.1.4.1.1.81.1
CornealTopographyMapStorage                          1.2.840.10008.5.1.4.1.1.82.1
DRAFT_SRTextStorage                                  1.2.840.10008.5.1.4.1.1.88.1
DRAFT_SRAudioStorage                                 1.2.840.10008.5.1.4.1.1.88.2
DRAFT_SRDetailStorage                                1.2.840.10008.5.1.4.1.1.88.3
DRAFT_SRComprehensiveStorage                         1.2.840.10008.5.1.4.1.1.88.4
BasicTextSRStorage                                   1.2.840.10008.5.1.4.1.1.88.11
EnhancedSRStorage                                    1.2.840.10008.5.1.4.1.1.88.22
ComprehensiveSRStorage                               1.2.840.10008.5.1.4.1.1.88.33
Comprehensive3DSRStorage                             1.2.840.10008.5.1.4.1.1.88.34
ExtensibleSRStorage                                  1.2.840.10008.5.1.4.1.1.88.35
ProcedureLogStorage                                  1.2.840.10008.5.1.4.1.1.88.40
MammographyCADSRStorage                              1.2.840.10008.5.1.4.1.1.88.50
KeyObjectSelectionDocumentStorage                    1.2.840.10008.5.1.4.1.1.88.59
ChestCADSRStorage                                    1.2.840.10008.5.1.4.1.1.88.65
XRayRadiationDoseSRStorage                           1.2.840.10008.5.1.4.1.1.88.67
RadiopharmaceuticalRadiationDoseSRStorage            1.2.840.10008.5.1.4.1.1.88.68
ColonCADSRStorage                                    1.2.840.10008.5.1.4.1.1.88.69
ImplantationPlanSRStorage                            1.2.840.10008.5.1.4.1.1.88.70
AcquisitionContextSRStorage                          1.2.840.10008.5.1.4.1.1.88.71
SimplifiedAdultEchoSRStorage                         1.2.840.10008.5.1.4.1.1.88.72
PatientRadiationDoseSRStorage                        1.2.840.10008.5.1.4.1.1.88.73
PlannedImagingAgentAdministrationSRStorage           1.2.840.10008.5.1.4.1.1.88.74
PerformedImagingAgentAdministrationSRStorage         1.2.840.10008.5.1.4.1.1.88.75
EnhancedXRayRadiationDoseSRStorage                   1.2.840.10008.5.1.4.1.1.88.76
WaveformAnnotationSRStorage                          1.2.840.10008.5.1.4.1.1.88.77
ContentAssessmentResultsStorage                      1.2.840.10008.5.1.4.1.1.90.1
MicroscopyBulkSimpleAnnotationsStorage               1.2.840.10008.5.1.4.1.1.91.1
EncapsulatedPDFStorage                               1.2.840.10008.5.1.4.1.1.104.1
EncapsulatedCDAStorage                               1.2.840.10008.5.1.4.1.1.104.2
EncapsulatedSTLStorage                               1.2.840.10008.5.1.4.1.1.104.3
EncapsulatedOBJStorage                               1.2.840.10008.5.1.4.1.1.104.4
EncapsulatedMTLStorage                               1.2.840.10008.5.1.4.1.1.104.5
PositronEmissionTomographyImageStorage               1.2.840.10008.5.1.4.1.1.128
LegacyConvertedEnhancedPETImageStorage               1.2.840.10008.5.1.4.1.1.128.1
RETIRED_StandalonePETCurveStorage                    1.2.840.10008.5.1.4.1.1.129
EnhancedPETImageStorage                              1.2.840.10008.5.1.4.1.1.130
BasicStructuredDisplayStorage                        1.2.840.10008.5.1.4.1.1.131
CTPerformedProcedureProtocolStorage                  1.2.840.10008.5.1.4.1.1.200.2
XAPerformedProcedureProtocolStorage                  1.2.840.10008.5.1.4.1.1.200.8
RTImageStorage                                       1.2.840.10008.5.1.4.1.1.481.1
RTDoseStorage                                        1.2.840.10008.5.1.4.1.1.481.2
RTStructureSetStorage                                1.2.840.10008.5.1.4.1.1.481.3
RTBeamsTreatmentRecordStorage                        1.2.840.10008.5.1.4.1.1.481.4
RTPlanStorage                                        1.2.840.10008.5.1.4.1.1.481.5
RTBrachyTreatmentRecordStorage                       1.2.840.10008.5.1.4.1.1.481.6
RTTreatmentSummaryRecordStorage                      1.2.840.10008.5.1.4.1.1.481.7
RTIonPlanStorage                                     1.2.840.10008.5.1.4.1.1.481.8
RTIonBeamsTreatmentRecordStorage                     1.2.840.10008.5.1.4.1.1.481.9
RTPhysicianIntentStorage                             1.2.840.10008.5.1.4.1.1.481.10
RTSegmentAnnotationStorage                           1.2.840.10008.5.1.4.1.1.481.11
RTRadiationSetStorage                                1.2.840.10008.5.1.4.1.1.481.12
CArmPhotonElectronRadiationStorage                   1.2.840.10008.5.1.4.1.1.481.13
TomotherapeuticRadiationStorage                      1.2.840.10008.5.1.4.1.1.481.14
RoboticArmRadiationStorage                           1.2.840.10008.5.1.4.1.1.481.15
RTRadiationRecordSetStorage                          1.2.840.10008.5.1.4.1.1.481.16
RTRadiationSalvageRecordStorage                      1.2.840.10008.5.1.4.1.1.481.17
TomotherapeuticRadiationRecordStorage                1.2.840.10008.5.1.4.1.1.481.18
CArmPhotonElectronRadiationRecordStorage             1.2.840.10008.5.1.4.1.1.481.19
RoboticRadiationRecordStorage                        1.2.840.10008.5.1.4.1.1.481.20
RTRadiationSetDeliveryInstructionStorage             1.2.840.10008.5.1.4.1.1.481.21
RTTreatmentPreparationStorage                        1.2.840.10008.5.1.4.1.1.481.22
EnhancedRTImageStorage                               1.2.840.10008.5.1.4.1.1.481.23
EnhancedContinuousRTImageStorage                     1.2.840.10008.5.1.4.1.1.481.24
RTPatientPositionAcquisitionInstructionStorage       1.2.840.10008.5.1.4.1.1.481.25
DICOS_CTImageStorage                                 1.2.840.10008.5.1.4.1.1.501.1
DICOS_DigitalXRayImageStorageForPresentation         1.2.840.10008.5.1.4.1.1.501.2.1
DICOS_DigitalXRayImageStorageForProcessing           1.2.840.10008.5.1.4.1.1.501.2.2
DICOS_ThreatDetectionReportStorage                   1.2.840.10008.5.1.4.1.1.501.3
DICOS_2DAITStorage                                   1.2.840.10008.5.1.4.1.1.501.4
DICOS_3DAITStorage                                   1.2.840.10008.5.1.4.1.1.501.5
DICOS_QuadrupoleResonanceStorage                     1.2.840.10008.5.1.4.1.1.501.6
DICONDE_EddyCurrentImageStorage                      1.2.840.10008.5.1.4.1.1.601.1
DICONDE_EddyCurrentMultiframeImageStorage            1.2.840.10008.5.1.4.1.1.601.2
DICONDE_ThermographyImageStorage                     1.2.840.10008.5.1.4.1.1.601.3
DICONDE_ThermographyMultiFrameImageStorage           1.2.840.10008.5.1.4.1.1.601.4
DICONDE_UltrasoundWaveformStorage                    1.2.840.10008.5.1.4.1.1.601.5
DRAFT_RTBeamsDeliveryInstructionStorage              1.2.840.10008.5.1.4.34.1
RTBeamsDeliveryInstructionStorage                    1.2.840.10008.5.1.4.34.7
RTBrachyApplicationSetupDeliveryInstructionStorage   1.2.840.10008.5.1.4.34.10

movescu は通常、上記のサポート対象 SOP クラスすべてについて、次のいずれかの転送構文を使うプレゼンテーションコンテキストを受け入れます:

LittleEndianImplicitTransferSyntax                   1.2.840.10008.1.2
LittleEndianExplicitTransferSyntax                   1.2.840.10008.1.2.1
BigEndianExplicitTransferSyntax                      1.2.840.10008.1.2.2

SCP として動作するとき、movescu は明示的なエンコーディングを持つ転送構文を、既定の暗黙的な転送構文よりも優先します。movescu が big-endian のハードウェア上で動いている場合は BigEndianExplicit を LittleEndianExplicit より優先します(逆も同様)。この挙動は –prefer オプションで変更できます(上記参照)。–accept-all オプションを使うと、次のいずれの転送構文もサポートされます:

LittleEndianImplicitTransferSyntax                   1.2.840.10008.1.2
LittleEndianExplicitTransferSyntax                   1.2.840.10008.1.2.1
EncapsulatedUncompressedExplicitVRLittleEndianTr.S.  1.2.840.10008.1.2.1.98
DeflatedExplicitVRLittleEndianTransferSyntax         1.2.840.10008.1.2.1.99 (*)
BigEndianExplicitTransferSyntax                      1.2.840.10008.1.2.2
JPEGProcess1TransferSyntax                           1.2.840.10008.1.2.4.50
JPEGProcess2_4TransferSyntax                         1.2.840.10008.1.2.4.51
JPEGProcess14SV1TransferSyntax                       1.2.840.10008.1.2.4.70
JPEGLSLosslessTransferSyntax                         1.2.840.10008.1.2.4.80
JPEGLSLossyTransferSyntax                            1.2.840.10008.1.2.4.81
JPEG2000LosslessOnlyTransferSyntax                   1.2.840.10008.1.2.4.90
JPEG2000TransferSyntax                               1.2.840.10008.1.2.4.91
MPEG2MainProfileAtMainLevelTransferSyntax            1.2.840.10008.1.2.4.100
FragmentableMPEG2MainProfile/MainLevelTransferSyntax 1.2.840.10008.1.2.4.100.1
MPEG2MainProfileAtHighLevelTransferSyntax            1.2.840.10008.1.2.4.101
FragmentableMPEG2MainProfil/tHighLevelTransferSyntax 1.2.840.10008.1.2.4.101.1
MPEG4HighProfileLevel4_1TransferSyntax               1.2.840.10008.1.2.4.102
FragmentableMPEG4HighProfileLevel4_1TransferSyntax   1.2.840.10008.1.2.4.102.1
MPEG4BDcompatibleHighProfileLevel4_1TransferSyntax   1.2.840.10008.1.2.4.103
FragmentableMPEG4BDcompatibleHighProfileLevel4_1T.S. 1.2.840.10008.1.2.4.103.1
MPEG4HighProfileLevel4_2_For2DVideoTransferSyntax    1.2.840.10008.1.2.4.104
FragmentableMPEG4HighProfileLevel4_2_For2DVideoTr.S. 1.2.840.10008.1.2.4.104.1
MPEG4HighProfileLevel4_2_For3DVideoTransferSyntax    1.2.840.10008.1.2.4.105
FragmentableMPEG4HighProfileLevel4_2_For3DVideoTr.S. 1.2.840.10008.1.2.4.105.1
MPEG4StereoHighProfileLevel4_2TransferSyntax         1.2.840.10008.1.2.4.106
FragmentableMPEG4StereoHighProfileLevel4_2TransferS. 1.2.840.10008.1.2.4.106.1
HEVCMainProfileLevel5_1TransferSyntax                1.2.840.10008.1.2.4.107
HEVCMain10ProfileLevel5_1TransferSyntax              1.2.840.10008.1.2.4.108
JPEGXLLosslesTransferSyntax                          1.2.840.10008.1.2.4.110
JPEGXLJPEGRecompressionTransferSyntax                1.2.840.10008.1.2.4.111
JPEGXLTransferSyntax                                 1.2.840.10008.1.2.4.112
HighThroughputJPEG2000ImageCompressionLossless.Tr.S. 1.2.840.10008.1.2.4.201
HighThroughputJPEG2000RPCLImageCompressionLoss.Tr.S. 1.2.840.10008.1.2.4.202
HighThroughputJPEG2000ImageCompressionTransferSynta. 1.2.840.10008.1.2.4.203
RLELosslessTransferSyntax                            1.2.840.10008.1.2.5
DeflatedImageFrameCompressionTransferSyntax          1.2.840.10008.1.2.8.1

(*) zlib サポートを有効にしてコンパイルした場合のみ(–version の出力を参照)

movescu は拡張ネゴシエーションをサポートしません。

アクセス制御

TCP wrapper サポート付きで Unix プラットフォーム上にコンパイルした場合、–access-control コマンドラインオプションでホストベースのアクセス制御を有効にできます。この場合、システムのホストアクセス制御テーブルで movescu 向けに定義されたアクセス制御ルールが適用されます。ホストアクセス制御テーブルの既定の場所は /etc/hosts.allow/etc/hosts.deny です。詳細は hosts_access(5) に記載されています。

movescu --patient --port 9876 --move TEST_AE --call ARCHIVE caesar 104 q.dcm

これは、DICOM ファイル "q.dcm" に含まれる属性を C-MOVE 要求の一部として、ホスト caesar のポート 104 上のアプリケーションエンティティ ARCHIVE へ、Patient Root 問い合わせモデルを使って送ります。movescu 自身は既定の AE Title である MOVESCU を使います。この C-MOVE 要求は、画像を送信先 AE Title である TEST_AE へ転送するよう(–move オプションで)指定します。SCP がこの要求をどう解釈するかは、その設定次第です。movescu は、SCP から要求した画像を受信するため、受信アソシエーションをポート 9876 で待ち受けます。

送信先の AE Title を変える(例: –move ANOTHER_AE)ことで、第三者へ画像をコピーできます。もちろん、SCP はこの AE Title を「知って」いなければならず、送信先は Storage サービスクラスの SCP として動作している必要があります(この用途には storescp アプリケーションが使えます)。

ロギング

各種コマンドラインツールおよび基盤ライブラリのロギング出力のレベルは、ユーザーが指定できます。既定では、エラーと警告のみが標準エラー出力に書き出されます。–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 ファイルに用意されています)。

終了コード

movescu ユーティリティは、終了時に次の終了コードを使います。これにより、アプリケーションが終了した理由をユーザーが確認できます。

全般

EXITCODE_NO_ERROR                         0
EXITCODE_COMMANDLINE_SYNTAX_ERROR         1
EXITCODE_INSUFFICIENT_PRIVILEGES          2
EXITCODE_SETUID_FAILED                    3

出力ファイルエラー

EXITCODE_CANNOT_WRITE_OUTPUT_FILE        40
EXITCODE_INVALID_OUTPUT_DIRECTORY        45

ネットワークエラー

EXITCODE_CANNOT_INITIALIZE_NETWORK       60
EXITCODE_CANNOT_NEGOTIATE_ASSOCIATION    61
EXITCODE_CANNOT_CREATE_ASSOC_PARAMETERS  65
EXITCODE_NO_PRESENTATION_CONTEXT         66
EXITCODE_CANNOT_CLOSE_ASSOCIATION        67
EXITCODE_CMOVE_WARNING                   68
EXITCODE_CMOVE_ERROR                     69
EXITCODE_CANNOT_CREATE_TLS_LAYER         70

環境変数

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

既定の挙動を優先すべきであり、DCMDICTPATH 環境変数は代替のデータ辞書が必要なときにのみ使うべきです。DCMDICTPATH 環境変数は、エントリをコロン (":") で区切るという点で Unix シェルの PATH 変数と同じ形式です。Windows システムでは、区切りにセミコロン (";") を使います。データ辞書のコードは、DCMDICTPATH 環境変数で指定された各ファイルを読み込もうとします。データ辞書を 1 つも読み込めない場合はエラーとなります。

関連項目

findscu(1), storescp(1), dump2dcm(1)

Copyright (C) 1994-2025 by OFFIS e.V., Escherweg 2, 26121 Oldenburg, Germany.