1movescu(1) OFFIS DCMTK movescu(1)
2
3
4
6 movescu - DICOM retrieve (C-MOVE) SCU
7
8
10 movescu [options] peer port [dcmfile-in...]
11
13 The movescu application implements both an SCU for the Query/Retrieve
14 Service Class and an SCP for the Storage Service Class. movescu
15 supports retrieve functionality using the C-MOVE message. It sends
16 query keys to an SCP and awaits responses. It will accept associations
17 for the purpose of receiving images sent as a result of the C-MOVE
18 request. The application can be used to test SCPs of the Query/Retrieve
19 Service Class. The movescu application can initiate the transfer of
20 images to a third party or can retrieve images to itself. Note that the
21 use of the term 'move' is a misnomer. The C-MOVE operation actually
22 performs an image copy (no images will be deleted from the SCP).
23
25 peer hostname of DICOM peer
26
27 port tcp/ip port number of peer
28
29 dcmfile-in DICOM query file(s)
30
32 general options
33 -h --help
34 print this help text and exit
35
36 --version
37 print version information and exit
38
39 --arguments
40 print expanded command line arguments
41
42 -q --quiet
43 quiet mode, print no warnings and errors
44
45 -v --verbose
46 verbose mode, print processing details
47
48 -d --debug
49 debug mode, print debug information
50
51 -ll --log-level [l]evel: string constant
52 (fatal, error, warn, info, debug, trace)
53 use level l for the logger
54
55 -lc --log-config [f]ilename: string
56 use config file f for the logger
57
58 network options
59 override matching keys:
60
61 -k --key [k]ey: gggg,eeee="str" or dictionary name="str"
62 override matching key
63
64 query information model:
65
66 -P --patient
67 use patient root information model (default)
68
69 -S --study
70 use study root information model
71
72 -O --psonly
73 use patient/study only information model
74
75 application entity titles:
76
77 -aet --aetitle [a]etitle: string
78 set my calling AE title (default: MOVESCU)
79
80 -aec --call [a]etitle: string
81 set called AE title of peer (default: ANY-SCP)
82
83 -aem --move [a]etitle: string
84 set move destination AE title (default: MOVESCU)
85
86 preferred network transfer syntaxes (incoming associations):
87
88 +x= --prefer-uncompr
89 prefer explicit VR local byte order (default)
90
91 +xe --prefer-little
92 prefer explicit VR little endian TS
93
94 +xb --prefer-big
95 prefer explicit VR big endian TS
96
97 +xs --prefer-lossless
98 prefer default JPEG lossless TS
99
100 +xy --prefer-jpeg8
101 prefer default JPEG lossy TS for 8 bit data
102
103 +xx --prefer-jpeg12
104 prefer default JPEG lossy TS for 12 bit data
105
106 +xv --prefer-j2k-lossless
107 prefer JPEG 2000 lossless TS
108
109 +xw --prefer-j2k-lossy
110 prefer JPEG 2000 lossy TS
111
112 +xt --prefer-jls-lossless
113 prefer JPEG-LS lossless TS
114
115 +xu --prefer-jls-lossy
116 prefer JPEG-LS lossy TS
117
118 +xm --prefer-mpeg2
119 prefer MPEG2 Main Profile @ Main Level TS
120
121 +xh --prefer-mpeg2-high
122 prefer MPEG2 Main Profile @ High Level TS
123
124 +xn --prefer-mpeg4
125 prefer MPEG4 AVC/H.264 High Profile / Level 4.1 TS
126
127 +xl --prefer-mpeg4-bd
128 prefer MPEG4 AVC/H.264 BD-compatible HP / Level 4.1 TS
129
130 +x2 --prefer-mpeg4-2-2d
131 prefer MPEG4 AVC/H.264 HP / Level 4.2 TS for 2D Videos
132
133 +x3 --prefer-mpeg4-2-3d
134 prefer MPEG4 AVC/H.264 HP / Level 4.2 TS for 3D Videos
135
136 +xo --prefer-mpeg4-2-st
137 prefer MPEG4 AVC/H.264 Stereo HP / Level 4.2 TS
138
139 +x4 --prefer-hevc
140 prefer HEVC H.265 Main Profile / Level 5.1 TS
141
142 +x5 --prefer-hevc10
143 prefer HEVC H.265 Main 10 Profile / Level 5.1 TS
144
145 +xr --prefer-rle
146 prefer RLE lossless TS
147
148 +xd --prefer-deflated
149 prefer deflated explicit VR little endian TS
150
151 +xi --implicit
152 accept implicit VR little endian TS only
153
154 +xa --accept-all
155 accept all supported transfer syntaxes
156
157 proposed transmission transfer syntaxes (outgoing associations):
158
159 -x= --propose-uncompr
160 propose all uncompressed TS, explicit VR
161 with local byte ordering first (default)
162
163 -xe --propose-little
164 propose all uncompressed TS, explicit VR little endian first
165
166 -xb --propose-big
167 propose all uncompressed TS, explicit VR big endian first
168
169 -xd --propose-deflated
170 propose deflated explicit VR little endian TS
171 and all uncompressed transfer syntaxes
172
173 -xi --propose-implicit
174 propose implicit VR little endian TS only
175
176 network host access control (tcp wrapper):
177
178 -ac --access-full
179 accept connections from any host (default)
180
181 +ac --access-control
182 enforce host access control rules
183
184 port for incoming network associations:
185
186 --no-port
187 no port for incoming associations (default)
188
189 +P --port [n]umber: integer
190 port number for incoming associations
191
192 handling of illegal datasets following 'pending' move responses:
193
194 -pi --pending-ignore
195 assume no dataset present (default)
196
197 -pr --pending-read
198 read and ignore dataset
199
200 other network options:
201
202 -to --timeout [s]econds: integer (default: unlimited)
203 timeout for connection requests
204
205 -ta --acse-timeout [s]econds: integer (default: 30)
206 timeout for ACSE messages
207
208 -td --dimse-timeout [s]econds: integer (default: unlimited)
209 timeout for DIMSE messages
210
211 -pdu --max-pdu [n]umber of bytes: integer (4096..131072)
212 set max receive pdu to n bytes (default: 16384)
213
214 -dhl --disable-host-lookup
215 disable hostname lookup
216
217 --repeat [n]umber: integer
218 repeat n times
219
220 --abort
221 abort association instead of releasing it
222
223 --ignore
224 ignore store data, receive but do not store
225
226 --cancel [n]umber: integer
227 cancel after n responses (default: never)
228
229 -up --uid-padding
230 silently correct space-padded UIDs
231
232 output options
233 general:
234
235 -od --output-directory [d]irectory: string (default: ".")
236 write received objects to existing directory d
237
238 bit preserving mode:
239
240 -B --normal
241 allow implicit format conversions (default)
242
243 +B --bit-preserving
244 write data exactly as read
245
246 output file format:
247
248 +F --write-file
249 write file format (default)
250
251 -F --write-dataset
252 write data set without file meta information
253
254 output transfer syntax
255 (not with --bit-preserving or compressed transmission):
256
257 +t= --write-xfer-same
258 write with same TS as input (default)
259
260 +te --write-xfer-little
261 write with explicit VR little endian TS
262
263 +tb --write-xfer-big
264 write with explicit VR big endian TS
265
266 +ti --write-xfer-implicit
267 write with implicit VR little endian TS
268
269 +td --write-xfer-deflated
270 write with deflated explicit VR little endian TS
271
272 post-1993 value representations (not with --bit-preserving):
273
274 +u --enable-new-vr
275 enable support for new VRs (UN/UT) (default)
276
277 -u --disable-new-vr
278 disable support for new VRs, convert to OB
279
280 group length encoding (not with --bit-preserving):
281
282 +g= --group-length-recalc
283 recalculate group lengths if present (default)
284
285 +g --group-length-create
286 always write with group length elements
287
288 -g --group-length-remove
289 always write without group length elements
290
291 length encoding in sequences and items (not with --bit-preserving):
292
293 +e --length-explicit
294 write with explicit lengths (default)
295
296 -e --length-undefined
297 write with undefined lengths
298
299 data set trailing padding
300 (not with --write-dataset or --bit-preserving):
301
302 -p --padding-off
303 no padding (default)
304
305 +p --padding-create [f]ile-pad [i]tem-pad: integer
306 align file on multiple of f bytes and items on
307 multiple of i bytes
308
309 deflate compression level
310 (only with --propose-deflated or --write-xfer-deflated/same):
311
312 +cl --compression-level [l]evel: integer (default: 6)
313 0=uncompressed, 1=fastest, 9=best compression
314
316 Each file supplied on the command line will be sent to the SCP as part
317 of a C-MOVE request. The query file must be a valid DICOM data set
318 containing the dataset part of a C-MOVE-RQ message. The query file
319 could, for instance, be created with the dump2dcm utility from a script
320 like the following example:
321
322 # request all images for the patient with ID=PAT001
323 (0008,0052) CS [PATIENT] # QueryRetrieveLevel
324 (0010,0020) LO [PAT001] # PatientID
325
326 Individual attributes of each file sent can be modified or supplemented
327 using the -k (or --key) option. For example the command:
328
329 movescu -k 0010,0020=PAT002 caesar 5678 patqry.dcm
330
331 will, when sent to the SCP caesar at TCP/IP port 5678, cause any
332 PatientID attribute in patqry.dcm to have the value 'PAT002'. If such
333 an attribute is present it will be replaced, if absent it will be
334 inserted. The -k option can be present more than once. The value part
335 (after the '=') may be absent causing the attribute to be sent with
336 zero length. It is not possible to replace or insert attributes within
337 sequences using the -k option.
338
339 If no file is specified on the command line, the query must be
340 specified completely with one or more -k options. If multiple query
341 files are provided, movescu will send multiple C-MOVE requests to the
342 SCP.
343
344 For all uses of movescu, the SCP must be configured to 'know' about the
345 AE title where the images are to be transmitted. This is required since
346 the C-MOVE request only contains the AE Title of the target and the SCP
347 must be able to convert this AE Title into TCP/IP address and port
348 number in order to actually send the images over a separate
349 association.
350
351 The C-MOVE operation of the Query/Retrieve Service Class is able
352 retrieve images (when option --port is used) or to initiate a copy of
353 images to a third party.
354
355 Known Problems
356 movescu is intended to be used as a testing tool for DICOM software
357 developers. The query keys file must be created by hand based upon the
358 contents of the SCP.
359
360 The movescu application makes no attempt to prevent incorrect queries.
361 In particular, the query keys of a C-MOVE request should only contain
362 the QueryRetrieveLevel attribute and one or more of the so-called
363 'unique key attributes' (PatientID, StudyInstanceUID, SeriesInstanceUID
364 and SOPInstanceUID).
365
366 In case the storage client does not end the connection while movescu is
367 playing the role of the storage server (i. e. the --port is used) but
368 the client instead expects movescu to close down the storage
369 connection, movescu will wait infinitely. In that case movescu will
370 neither close the association that was used to issue the C-MOVE request
371 to the C-MOVE server.
372
373 DICOM Conformance
374 SCU Conformance
375 The movescu application supports the following SOP Classes as an SCU:
376
377 MOVEPatientRootQueryRetrieveInformationModel 1.2.840.10008.5.1.4.1.2.1.2
378 MOVEStudyRootQueryRetrieveInformationModel 1.2.840.10008.5.1.4.1.2.2.2
379 MOVEPatientStudyOnlyQueryRetrieveInformationModel 1.2.840.10008.5.1.4.1.2.3.2
380
381 The movescu application will propose presentation contexts for one of
382 the abovementioned supported SOP Classes depending on the command line
383 options (-P, -S, or -O). It will also propose the corresponding SOP
384 Class from the following list, although it is not really used (this is
385 a relict of the RSNA'93 demonstration):
386
387 FINDPatientRootQueryRetrieveInformationModel 1.2.840.10008.5.1.4.1.2.1.1
388 FINDStudyRootQueryRetrieveInformationModel 1.2.840.10008.5.1.4.1.2.2.1
389 FINDPatientStudyOnlyQueryRetrieveInformationModel 1.2.840.10008.5.1.4.1.2.3.1
390
391 For outgoing associations, the following transfer syntaxes are
392 supported:
393
394 LittleEndianImplicitTransferSyntax 1.2.840.10008.1.2
395 LittleEndianExplicitTransferSyntax 1.2.840.10008.1.2.1
396 DeflatedExplicitVRLittleEndianTransferSyntax 1.2.840.10008.1.2.1.99 (*)
397 BigEndianExplicitTransferSyntax 1.2.840.10008.1.2.2
398
399 (*) if compiled with zlib support enabled (see --version output)
400
401 Which transfer syntaxes are actually proposed in what order, can be
402 specified with the --propose options.
403
404 SCP Conformance
405 The movescu application supports the following SOP Classes as an SCP:
406
407 VerificationSOPClass 1.2.840.10008.1.1
408
409 RETIRED_StoredPrintStorage 1.2.840.10008.5.1.1.27
410 RETIRED_HardcopyGrayscaleImageStorage 1.2.840.10008.5.1.1.29
411 RETIRED_HardcopyColorImageStorage 1.2.840.10008.5.1.1.30
412 ComputedRadiographyImageStorage 1.2.840.10008.5.1.4.1.1.1
413 DigitalXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.1.1
414 DigitalXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.1.1.1
415 DigitalMammographyXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.1.2
416 DigitalMammographyXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.1.2.1
417 DigitalIntraOralXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.1.3
418 DigitalIntraOralXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.1.3.1
419 CTImageStorage 1.2.840.10008.5.1.4.1.1.2
420 EnhancedCTImageStorage 1.2.840.10008.5.1.4.1.1.2.1
421 LegacyConvertedEnhancedCTImageStorage 1.2.840.10008.5.1.4.1.1.2.2
422 RETIRED_UltrasoundMultiframeImageStorage 1.2.840.10008.5.1.4.1.1.3
423 UltrasoundMultiframeImageStorage 1.2.840.10008.5.1.4.1.1.3.1
424 MRImageStorage 1.2.840.10008.5.1.4.1.1.4
425 EnhancedMRImageStorage 1.2.840.10008.5.1.4.1.1.4.1
426 MRSpectroscopyStorage 1.2.840.10008.5.1.4.1.1.4.2
427 EnhancedMRColorImageStorage 1.2.840.10008.5.1.4.1.1.4.3
428 LegacyConvertedEnhancedMRImageStorage 1.2.840.10008.5.1.4.1.1.4.4
429 RETIRED_NuclearMedicineImageStorage 1.2.840.10008.5.1.4.1.1.5
430 RETIRED_UltrasoundImageStorage 1.2.840.10008.5.1.4.1.1.6
431 UltrasoundImageStorage 1.2.840.10008.5.1.4.1.1.6.1
432 EnhancedUSVolumeStorage 1.2.840.10008.5.1.4.1.1.6.2
433 SecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7
434 MultiframeSingleBitSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.1
435 MultiframeGrayscaleByteSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.2
436 MultiframeGrayscaleWordSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.3
437 MultiframeTrueColorSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.4
438 RETIRED_StandaloneOverlayStorage 1.2.840.10008.5.1.4.1.1.8
439 RETIRED_StandaloneCurveStorage 1.2.840.10008.5.1.4.1.1.9
440 DRAFT_WaveformStorage 1.2.840.10008.5.1.4.1.1.9.1
441 TwelveLeadECGWaveformStorage 1.2.840.10008.5.1.4.1.1.9.1.1
442 GeneralECGWaveformStorage 1.2.840.10008.5.1.4.1.1.9.1.2
443 AmbulatoryECGWaveformStorage 1.2.840.10008.5.1.4.1.1.9.1.3
444 HemodynamicWaveformStorage 1.2.840.10008.5.1.4.1.1.9.2.1
445 CardiacElectrophysiologyWaveformStorage 1.2.840.10008.5.1.4.1.1.9.3.1
446 BasicVoiceAudioWaveformStorage 1.2.840.10008.5.1.4.1.1.9.4.1
447 GeneralAudioWaveformStorage 1.2.840.10008.5.1.4.1.1.9.4.2
448 ArterialPulseWaveformStorage 1.2.840.10008.5.1.4.1.1.9.5.1
449 RespiratoryWaveformStorage 1.2.840.10008.5.1.4.1.1.9.6.1
450 MultichannelRespiratoryWaveformStorage 1.2.840.10008.5.1.4.1.1.9.6.2
451 RoutineScalpElectroencephalogramWaveformStorage 1.2.840.10008.5.1.4.1.1.9.7.1
452 ElectromyogramWaveformStorage 1.2.840.10008.5.1.4.1.1.9.7.2
453 ElectrooculogramWaveformStorage 1.2.840.10008.5.1.4.1.1.9.7.3
454 SleepElectroencephalogramWaveformStorage 1.2.840.10008.5.1.4.1.1.9.7.4
455 BodyPositionWaveformStorage 1.2.840.10008.5.1.4.1.1.9.8.1
456 RETIRED_StandaloneModalityLUTStorage 1.2.840.10008.5.1.4.1.1.10
457 RETIRED_StandaloneVOILUTStorage 1.2.840.10008.5.1.4.1.1.11
458 GrayscaleSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.1
459 ColorSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.2
460 PseudoColorSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.3
461 BlendingSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.4
462 XAXRFGrayscaleSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.5
463 GrayscalePlanarMPRVolumetricPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.6
464 CompositingPlanarMPRVolumetricPresent.StateStorage 1.2.840.10008.5.1.4.1.1.11.7
465 AdvancedBlendingPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.8
466 VolumeRenderingVolumetricPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.9
467 SegmentedVolumeRenderingVolumetricPres.StateStorage 1.2.840.10008.5.1.4.1.1.11.10
468 MultipleVolumeRenderingVolumetricPres.StateStorage 1.2.840.10008.5.1.4.1.1.11.11
469 XRayAngiographicImageStorage 1.2.840.10008.5.1.4.1.1.12.1
470 EnhancedXAImageStorage 1.2.840.10008.5.1.4.1.1.12.1.1
471 XRayRadiofluoroscopicImageStorage 1.2.840.10008.5.1.4.1.1.12.2
472 EnhancedXRFImageStorage 1.2.840.10008.5.1.4.1.1.12.2.1
473 RETIRED_XRayAngiographicBiPlaneImageStorage 1.2.840.10008.5.1.4.1.1.12.3
474 XRay3DAngiographicImageStorage 1.2.840.10008.5.1.4.1.1.13.1.1
475 XRay3DCraniofacialImageStorage 1.2.840.10008.5.1.4.1.1.13.1.2
476 BreastTomosynthesisImageStorage 1.2.840.10008.5.1.4.1.1.13.1.3
477 BreastProjectionXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.13.1.4
478 BreastProjectionXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.13.1.5
479 IntravascularOpt.Coh.Tom.ImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.14.1
480 IntravascularOpt.Coh.Tom.ImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.14.2
481 NuclearMedicineImageStorage 1.2.840.10008.5.1.4.1.1.20
482 ParametricMapStorage 1.2.840.10008.5.1.4.1.1.30
483 RawDataStorage 1.2.840.10008.5.1.4.1.1.66
484 SpatialRegistrationStorage 1.2.840.10008.5.1.4.1.1.66.1
485 SpatialFiducialsStorage 1.2.840.10008.5.1.4.1.1.66.2
486 DeformableSpatialRegistrationStorage 1.2.840.10008.5.1.4.1.1.66.3
487 SegmentationStorage 1.2.840.10008.5.1.4.1.1.66.4
488 SurfaceSegmentationStorage 1.2.840.10008.5.1.4.1.1.66.5
489 TractographyResultsStorage 1.2.840.10008.5.1.4.1.1.66.6
490 RealWorldValueMappingStorage 1.2.840.10008.5.1.4.1.1.67
491 SurfaceScanMeshStorage 1.2.840.10008.5.1.4.1.1.68.1
492 SurfaceScanPointCloudStorage 1.2.840.10008.5.1.4.1.1.68.2
493 RETIRED_VLImageStorage 1.2.840.10008.5.1.4.1.1.77.1
494 VLEndoscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.1
495 VideoEndoscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.1.1
496 VLMicroscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.2
497 VideoMicroscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.2.1
498 VLSlideCoordinatesMicroscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.3
499 VLPhotographicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.4
500 VideoPhotographicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.4.1
501 OphthalmicPhotography8BitImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.1
502 OphthalmicPhotography16BitImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.2
503 StereometricRelationshipStorage 1.2.840.10008.5.1.4.1.1.77.1.5.3
504 OphthalmicTomographyImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.4
505 WideFieldOphthalmicPhoto.Stereogr.Proj.ImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.5
506 WideFieldOphthalmicPhotogr.3DCoordinatesImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.6
507 OphthalmicOpticalCoherenceTomogr.EnFaceImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.7
508 OphthalmicOpticalCoh.Tomogr.BscanVolumeAnalysisStor. 1.2.840.10008.5.1.4.1.1.77.1.5.8
509 VLWholeSlideMicroscopyImageStorage 1.2.840.10008.5.1.4.1.1.77.1.6
510 DermoscopicPhotographyImageStorage 1.2.840.10008.5.1.4.1.1.77.1.7
511 RETIRED_VLMultiframeImageStorage 1.2.840.10008.5.1.4.1.1.77.2
512 LensometryMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.1
513 AutorefractionMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.2
514 KeratometryMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.3
515 SubjectiveRefractionMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.4
516 VisualAcuityMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.5
517 SpectaclePrescriptionReportStorage 1.2.840.10008.5.1.4.1.1.78.6
518 OphthalmicAxialMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.7
519 IntraocularLensCalculationsStorage 1.2.840.10008.5.1.4.1.1.78.8
520 MacularGridThicknessAndVolumeReportStorage 1.2.840.10008.5.1.4.1.1.79.1
521 OphthalmicVisualFieldStaticPerimetryMeasurementsSt. 1.2.840.10008.5.1.4.1.1.80.1
522 OphthalmicThicknessMapStorage 1.2.840.10008.5.1.4.1.1.81.1
523 CornealTopographyMapStorage 1.2.840.10008.5.1.4.1.1.82.1
524 DRAFT_SRTextStorage 1.2.840.10008.5.1.4.1.1.88.1
525 DRAFT_SRAudioStorage 1.2.840.10008.5.1.4.1.1.88.2
526 DRAFT_SRDetailStorage 1.2.840.10008.5.1.4.1.1.88.3
527 DRAFT_SRComprehensiveStorage 1.2.840.10008.5.1.4.1.1.88.4
528 BasicTextSRStorage 1.2.840.10008.5.1.4.1.1.88.11
529 EnhancedSRStorage 1.2.840.10008.5.1.4.1.1.88.22
530 ComprehensiveSRStorage 1.2.840.10008.5.1.4.1.1.88.33
531 Comprehensive3DSRStorage 1.2.840.10008.5.1.4.1.1.88.34
532 ExtensibleSRStorage 1.2.840.10008.5.1.4.1.1.88.35
533 ProcedureLogStorage 1.2.840.10008.5.1.4.1.1.88.40
534 MammographyCADSRStorage 1.2.840.10008.5.1.4.1.1.88.50
535 KeyObjectSelectionDocumentStorage 1.2.840.10008.5.1.4.1.1.88.59
536 ChestCADSRStorage 1.2.840.10008.5.1.4.1.1.88.65
537 XRayRadiationDoseSRStorage 1.2.840.10008.5.1.4.1.1.88.67
538 RadiopharmaceuticalRadiationDoseSRStorage 1.2.840.10008.5.1.4.1.1.88.68
539 ColonCADSRStorage 1.2.840.10008.5.1.4.1.1.88.69
540 ImplantationPlanSRDocumentStorage 1.2.840.10008.5.1.4.1.1.88.70
541 AcquisitionContextSRStorage 1.2.840.10008.5.1.4.1.1.88.71
542 SimplifiedAdultEchoSRStorage 1.2.840.10008.5.1.4.1.1.88.72
543 PatientRadiationDoseSRStorage 1.2.840.10008.5.1.4.1.1.88.73
544 PlannedImagingAgentAdministrationSRStorage 1.2.840.10008.5.1.4.1.1.88.74
545 PerformedImagingAgentAdministrationSRStorage 1.2.840.10008.5.1.4.1.1.88.75
546 EnhancedXRayRadiationDoseSRStorage 1.2.840.10008.5.1.4.1.1.88.76
547 ContentAssessmentResultsStorage 1.2.840.10008.5.1.4.1.1.90.1
548 MicroscopyBulkSimpleAnnotationsStorage 1.2.840.10008.5.1.4.1.1.91.1
549 EncapsulatedPDFStorage 1.2.840.10008.5.1.4.1.1.104.1
550 EncapsulatedCDAStorage 1.2.840.10008.5.1.4.1.1.104.2
551 EncapsulatedSTLStorage 1.2.840.10008.5.1.4.1.1.104.3
552 EncapsulatedOBJStorage 1.2.840.10008.5.1.4.1.1.104.4
553 EncapsulatedMTLStorage 1.2.840.10008.5.1.4.1.1.104.5
554 PositronEmissionTomographyImageStorage 1.2.840.10008.5.1.4.1.1.128
555 LegacyConvertedEnhancedPETImageStorage 1.2.840.10008.5.1.4.1.1.128.1
556 RETIRED_StandalonePETCurveStorage 1.2.840.10008.5.1.4.1.1.129
557 EnhancedPETImageStorage 1.2.840.10008.5.1.4.1.1.130
558 BasicStructuredDisplayStorage 1.2.840.10008.5.1.4.1.1.131
559 CTPerformedProcedureProtocolStorage 1.2.840.10008.5.1.4.1.1.200.2
560 XAPerformedProcedureProtocolStorage 1.2.840.10008.5.1.4.1.1.200.8
561 RTImageStorage 1.2.840.10008.5.1.4.1.1.481.1
562 RTDoseStorage 1.2.840.10008.5.1.4.1.1.481.2
563 RTStructureSetStorage 1.2.840.10008.5.1.4.1.1.481.3
564 RTBeamsTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.4
565 RTPlanStorage 1.2.840.10008.5.1.4.1.1.481.5
566 RTBrachyTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.6
567 RTTreatmentSummaryRecordStorage 1.2.840.10008.5.1.4.1.1.481.7
568 RTIonPlanStorage 1.2.840.10008.5.1.4.1.1.481.8
569 RTIonBeamsTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.9
570 RTPhysicianIntentStorage 1.2.840.10008.5.1.4.1.1.481.10
571 RTSegmentAnnotationStorage 1.2.840.10008.5.1.4.1.1.481.11
572 RTRadiationSetStorage 1.2.840.10008.5.1.4.1.1.481.12
573 CArmPhotonElectronRadiationStorage 1.2.840.10008.5.1.4.1.1.481.13
574 TomotherapeuticRadiationStorage 1.2.840.10008.5.1.4.1.1.481.14
575 RoboticArmRadiationStorage 1.2.840.10008.5.1.4.1.1.481.15
576 RTRadiationRecordSetStorage 1.2.840.10008.5.1.4.1.1.481.16
577 RTRadiationSalvageRecordStorage 1.2.840.10008.5.1.4.1.1.481.17
578 TomotherapeuticRadiationRecordStorage 1.2.840.10008.5.1.4.1.1.481.18
579 CArmPhotonElectronRadiationRecordStorage 1.2.840.10008.5.1.4.1.1.481.19
580 RoboticRadiationRecordStorage 1.2.840.10008.5.1.4.1.1.481.20
581 RTRadiationSetDeliveryInstructionStorage 1.2.840.10008.5.1.4.1.1.481.21
582 RTTreatmentPreparationStorage 1.2.840.10008.5.1.4.1.1.481.22
583 DICOS_CTImageStorage 1.2.840.10008.5.1.4.1.1.501.1
584 DICOS_DigitalXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.501.2.1
585 DICOS_DigitalXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.501.2.2
586 DICOS_ThreatDetectionReportStorage 1.2.840.10008.5.1.4.1.1.501.3
587 DICOS_2DAITStorage 1.2.840.10008.5.1.4.1.1.501.4
588 DICOS_3DAITStorage 1.2.840.10008.5.1.4.1.1.501.5
589 DICOS_QuadrupoleResonanceStorage 1.2.840.10008.5.1.4.1.1.501.6
590 DICONDE_EddyCurrentImageStorage 1.2.840.10008.5.1.4.1.1.601.1
591 DICONDE_EddyCurrentMultiframeImageStorage 1.2.840.10008.5.1.4.1.1.601.2
592 DRAFT_RTBeamsDeliveryInstructionStorage 1.2.840.10008.5.1.4.34.1
593 RTBeamsDeliveryInstructionStorage 1.2.840.10008.5.1.4.34.7
594 RTBrachyApplicationSetupDeliveryInstructionStorage 1.2.840.10008.5.1.4.34.10
595
596 The movescu application will usually accept presentation contexts for
597 all of the abovementioned supported SOP Classes using any of the
598 following transfer syntaxes:
599
600 LittleEndianImplicitTransferSyntax 1.2.840.10008.1.2
601 LittleEndianExplicitTransferSyntax 1.2.840.10008.1.2.1
602 BigEndianExplicitTransferSyntax 1.2.840.10008.1.2.2
603
604 When acting as an SCP, the movescu application will prefer transfer
605 syntaxes having an explicit encoding over the default implicit transfer
606 syntax. If movescu is running on big-endian hardware it will prefer
607 BigEndianExplicit to LittleEndianExplicit transfer syntax (and vice
608 versa). This behavior can be changed with the --prefer options (see
609 above). Using option --accept-all any of the following transfer
610 syntaxes is supported:
611
612 LittleEndianImplicitTransferSyntax 1.2.840.10008.1.2
613 LittleEndianExplicitTransferSyntax 1.2.840.10008.1.2.1
614 DeflatedExplicitVRLittleEndianTransferSyntax 1.2.840.10008.1.2.1.99 (*)
615 BigEndianExplicitTransferSyntax 1.2.840.10008.1.2.2
616 JPEGProcess1TransferSyntax 1.2.840.10008.1.2.4.50
617 JPEGProcess2_4TransferSyntax 1.2.840.10008.1.2.4.51
618 JPEGProcess14SV1TransferSyntax 1.2.840.10008.1.2.4.70
619 JPEGLSLosslessTransferSyntax 1.2.840.10008.1.2.4.80
620 JPEGLSLossyTransferSyntax 1.2.840.10008.1.2.4.81
621 JPEG2000LosslessOnlyTransferSyntax 1.2.840.10008.1.2.4.90
622 JPEG2000TransferSyntax 1.2.840.10008.1.2.4.91
623 MPEG2MainProfileAtMainLevelTransferSyntax 1.2.840.10008.1.2.4.100
624 MPEG2MainProfileAtHighLevelTransferSyntax 1.2.840.10008.1.2.4.101
625 MPEG4HighProfileLevel4_1TransferSyntax 1.2.840.10008.1.2.4.102
626 MPEG4BDcompatibleHighProfileLevel4_1TransferSyntax 1.2.840.10008.1.2.4.103
627 MPEG4HighProfileLevel4_2_For2DVideoTransferSyntax 1.2.840.10008.1.2.4.104
628 MPEG4HighProfileLevel4_2_For3DVideoTransferSyntax 1.2.840.10008.1.2.4.105
629 MPEG4StereoHighProfileLevel4_2TransferSyntax 1.2.840.10008.1.2.4.106
630 HEVCMainProfileLevel5_1TransferSyntax 1.2.840.10008.1.2.4.107
631 HEVCMain10ProfileLevel5_1TransferSyntax 1.2.840.10008.1.2.4.108
632 RLELosslessTransferSyntax 1.2.840.10008.1.2.5
633
634 (*) if compiled with zlib support enabled (see --version output)
635
636 The movescu application does not support extended negotiation.
637
638 Access Control
639 When compiled on Unix platforms with TCP wrapper support, host-based
640 access control can be enabled with the --access-control command line
641 option. In this case the access control rules defined in the system's
642 host access control tables for movescu are enforced. The default
643 locations of the host access control tables are /etc/hosts.allow and
644 /etc/hosts.deny. Further details are described in hosts_access(5).
645
647 movescu --patient --port 9876 --move TEST_AE --call ARCHIVE caesar 104 q.dcm
648
649 sends the attributes contained in the DICOM file 'q.dcm' as part of a
650 C-MOVE request to application entity ARCHIVE on the host caesar at port
651 104 using the Patient Root query model. movescu itself uses the default
652 AE title MOVESCU. The C-MOVE request will specify that images should be
653 transferred to the destination AE title TEST_AE (via the --move
654 option). How the SCP interprets this request depends on its
655 configuration. movescu will listen on part 9876 for incoming
656 associations in order to receive the requested images from the SCP.
657
658 Images can be copied to a third party by using a different destination
659 AE title (e.g. --move ANOTHER_AE). Of course, the SCP must 'know' this
660 AE title and the destination must be acting as an SCP of the Storage
661 Service Class (the storescp application can be used for this purpose).
662
664 The level of logging output of the various command line tools and
665 underlying libraries can be specified by the user. By default, only
666 errors and warnings are written to the standard error stream. Using
667 option --verbose also informational messages like processing details
668 are reported. Option --debug can be used to get more details on the
669 internal activity, e.g. for debugging purposes. Other logging levels
670 can be selected using option --log-level. In --quiet mode only fatal
671 errors are reported. In such very severe error events, the application
672 will usually terminate. For more details on the different logging
673 levels, see documentation of module 'oflog'.
674
675 In case the logging output should be written to file (optionally with
676 logfile rotation), to syslog (Unix) or the event log (Windows) option
677 --log-config can be used. This configuration file also allows for
678 directing only certain messages to a particular output stream and for
679 filtering certain messages based on the module or application where
680 they are generated. An example configuration file is provided in
681 <etcdir>/logger.cfg.
682
684 All command line tools use the following notation for parameters:
685 square brackets enclose optional values (0-1), three trailing dots
686 indicate that multiple values are allowed (1-n), a combination of both
687 means 0 to n values.
688
689 Command line options are distinguished from parameters by a leading '+'
690 or '-' sign, respectively. Usually, order and position of command line
691 options are arbitrary (i.e. they can appear anywhere). However, if
692 options are mutually exclusive the rightmost appearance is used. This
693 behavior conforms to the standard evaluation rules of common Unix
694 shells.
695
696 In addition, one or more command files can be specified using an '@'
697 sign as a prefix to the filename (e.g. @command.txt). Such a command
698 argument is replaced by the content of the corresponding text file
699 (multiple whitespaces are treated as a single separator unless they
700 appear between two quotation marks) prior to any further evaluation.
701 Please note that a command file cannot contain another command file.
702 This simple but effective approach allows one to summarize common
703 combinations of options/parameters and avoids longish and confusing
704 command lines (an example is provided in file <datadir>/dumppat.txt).
705
707 The movescu utility uses the following exit codes when terminating.
708 This enables the user to check for the reason why the application
709 terminated.
710
711 general
712 EXITCODE_NO_ERROR 0
713 EXITCODE_COMMANDLINE_SYNTAX_ERROR 1
714 EXITCODE_INSUFFICIENT_PRIVILEGES 2
715 EXITCODE_SETUID_FAILED 3
716
717 output file errors
718 EXITCODE_CANNOT_WRITE_OUTPUT_FILE 40
719 EXITCODE_INVALID_OUTPUT_DIRECTORY 45
720
721 network errors
722 EXITCODE_CANNOT_INITIALIZE_NETWORK 60
723 EXITCODE_CANNOT_NEGOTIATE_ASSOCIATION 61
724 EXITCODE_CANNOT_CREATE_ASSOC_PARAMETERS 65
725 EXITCODE_NO_PRESENTATION_CONTEXT 66
726 EXITCODE_CANNOT_CLOSE_ASSOCIATION 67
727 EXITCODE_CMOVE_WARNING 68
728 EXITCODE_CMOVE_ERROR 69
729
731 The movescu utility will attempt to load DICOM data dictionaries
732 specified in the DCMDICTPATH environment variable. By default, i.e. if
733 the DCMDICTPATH environment variable is not set, the file
734 <datadir>/dicom.dic will be loaded unless the dictionary is built into
735 the application (default for Windows).
736
737 The default behavior should be preferred and the DCMDICTPATH
738 environment variable only used when alternative data dictionaries are
739 required. The DCMDICTPATH environment variable has the same format as
740 the Unix shell PATH variable in that a colon (':') separates entries.
741 On Windows systems, a semicolon (';') is used as a separator. The data
742 dictionary code will attempt to load each file specified in the
743 DCMDICTPATH environment variable. It is an error if no data dictionary
744 can be loaded.
745
747 findscu(1), storescp(1), dump2dcm(1)
748
750 Copyright (C) 1994-2022 by OFFIS e.V., Escherweg 2, 26121 Oldenburg,
751 Germany.
752
753
754
755Version 3.6.7 Fri Apr 22 2022 movescu(1)