1movescu(1) OFFIS DCMTK movescu(1)
2
6 movescu - DICOM retrieve (C-MOVE) SCU
7
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 port tcp/ip port number of peer
28 dcmfile-in DICOM query file(s)
30
32 general options
33 -h --help
34 print this help text and exit
35 --version
37 print version information and exit
38 --arguments
40 print expanded command line arguments
41 -q --quiet
43 quiet mode, print no warnings and errors
44 -v --verbose
46 verbose mode, print processing details
47 -d --debug
49 debug mode, print debug information
50 -ll --log-level [l]evel: string constant
52 (fatal, error, warn, info, debug, trace)
53 use level l for the logger
54 -lc --log-config [f]ilename: string
56 use config file f for the logger
57 network options
59 override matching keys:
60 -k --key [k]ey: gggg,eeee="str" or dictionary name="str"
62 override matching key
63 query information model:
65 -P --patient
67 use patient root information model (default)
68 -S --study
70 use study root information model
71 -O --psonly
73 use patient/study only information model
74 application entity titles:
76 -aet --aetitle [a]etitle: string
78 set my calling AE title (default: MOVESCU)
79 -aec --call [a]etitle: string
81 set called AE title of peer (default: ANY-SCP)
82 -aem --move [a]etitle: string
84 set move destination AE title (default: MOVESCU)
85 preferred network transfer syntaxes (incoming associations):
87 +x= --prefer-uncompr
89 prefer explicit VR local byte order (default)
90 +xe --prefer-little
92 prefer explicit VR little endian TS
93 +xb --prefer-big
95 prefer explicit VR big endian TS
96 +xs --prefer-lossless
98 prefer default JPEG lossless TS
99 +xy --prefer-jpeg8
101 prefer default JPEG lossy TS for 8 bit data
102 +xx --prefer-jpeg12
104 prefer default JPEG lossy TS for 12 bit data
105 +xv --prefer-j2k-lossless
107 prefer JPEG 2000 lossless TS
108 +xw --prefer-j2k-lossy
110 prefer JPEG 2000 lossy TS
111 +xt --prefer-jls-lossless
113 prefer JPEG-LS lossless TS
114 +xu --prefer-jls-lossy
116 prefer JPEG-LS lossy TS
117 +xm --prefer-mpeg2
119 prefer MPEG2 Main Profile @ Main Level TS
120 +xh --prefer-mpeg2-high
122 prefer MPEG2 Main Profile @ High Level TS
123 +xn --prefer-mpeg4
125 prefer MPEG4 AVC/H.264 High Profile / Level 4.1 TS
126 +xl --prefer-mpeg4-bd
128 prefer MPEG4 AVC/H.264 BD-compatible HP / Level 4.1 TS
129 +x2 --prefer-mpeg4-2-2d
131 prefer MPEG4 AVC/H.264 HP / Level 4.2 TS for 2D Videos
132 +x3 --prefer-mpeg4-2-3d
134 prefer MPEG4 AVC/H.264 HP / Level 4.2 TS for 3D Videos
135 +xo --prefer-mpeg4-2-st
137 prefer MPEG4 AVC/H.264 Stereo HP / Level 4.2 TS
138 +x4 --prefer-hevc
140 prefer HEVC H.265 Main Profile / Level 5.1 TS
141 +x5 --prefer-hevc10
143 prefer HEVC H.265 Main 10 Profile / Level 5.1 TS
144 +xr --prefer-rle
146 prefer RLE lossless TS
147 +xd --prefer-deflated
149 prefer deflated explicit VR little endian TS
150 +xi --implicit
152 accept implicit VR little endian TS only
153 +xa --accept-all
155 accept all supported transfer syntaxes
156 proposed transmission transfer syntaxes (outgoing associations):
158 -x= --propose-uncompr
160 propose all uncompressed TS, explicit VR
161 with local byte ordering first (default)
162 -xe --propose-little
164 propose all uncompressed TS, explicit VR little endian first
165 -xb --propose-big
167 propose all uncompressed TS, explicit VR big endian first
168 -xd --propose-deflated
170 propose deflated explicit VR little endian TS
171 and all uncompressed transfer syntaxes
172 -xi --propose-implicit
174 propose implicit VR little endian TS only
175 network host access control (tcp wrapper):
177 -ac --access-full
179 accept connections from any host (default)
180 +ac --access-control
182 enforce host access control rules
183 port for incoming network associations:
185 --no-port
187 no port for incoming associations (default)
188 +P --port [n]umber: integer
190 port number for incoming associations
191 handling of illegal datasets following 'pending' move responses:
193 -pi --pending-ignore
195 assume no dataset present (default)
196 -pr --pending-read
198 read and ignore dataset
199 other network options:
201 -to --timeout [s]econds: integer (default: unlimited)
203 timeout for connection requests
204 -ta --acse-timeout [s]econds: integer (default: 30)
206 timeout for ACSE messages
207 -td --dimse-timeout [s]econds: integer (default: unlimited)
209 timeout for DIMSE messages
210 -pdu --max-pdu [n]umber of bytes: integer (4096..131072)
212 set max receive pdu to n bytes (default: 16384)
213 -dhl --disable-host-lookup
215 disable hostname lookup
216 --repeat [n]umber: integer
218 repeat n times
219 --abort
221 abort association instead of releasing it
222 --ignore
224 ignore store data, receive but do not store
225 --cancel [n]umber: integer
227 cancel after n responses (default: never)
228 -up --uid-padding
230 silently correct space-padded UIDs
231 output options
233 general:
234 -od --output-directory [d]irectory: string (default: ".")
236 write received objects to existing directory d
237 bit preserving mode:
239 -B --normal
241 allow implicit format conversions (default)
242 +B --bit-preserving
244 write data exactly as read
245 output file format:
247 +F --write-file
249 write file format (default)
250 -F --write-dataset
252 write data set without file meta information
253 output transfer syntax
255 (not with --bit-preserving or compressed transmission):
256 +t= --write-xfer-same
258 write with same TS as input (default)
259 +te --write-xfer-little
261 write with explicit VR little endian TS
262 +tb --write-xfer-big
264 write with explicit VR big endian TS
265 +ti --write-xfer-implicit
267 write with implicit VR little endian TS
268 +td --write-xfer-deflated
270 write with deflated explicit VR little endian TS
271 post-1993 value representations (not with --bit-preserving):
273 +u --enable-new-vr
275 enable support for new VRs (UN/UT) (default)
276 -u --disable-new-vr
278 disable support for new VRs, convert to OB
279 group length encoding (not with --bit-preserving):
281 +g= --group-length-recalc
283 recalculate group lengths if present (default)
284 +g --group-length-create
286 always write with group length elements
287 -g --group-length-remove
289 always write without group length elements
290 length encoding in sequences and items (not with --bit-preserving):
292 +e --length-explicit
294 write with explicit lengths (default)
295 -e --length-undefined
297 write with undefined lengths
298 data set trailing padding
300 (not with --write-dataset or --bit-preserving):
301 -p --padding-off
303 no padding (default)
304 +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 deflate compression level
310 (only with --propose-deflated or --write-xfer-deflated/same):
311 +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 # request all images for the patient with ID=PAT001
323 (0008,0052) CS [PATIENT] # QueryRetrieveLevel
324 (0010,0020) LO [PAT001] # PatientID
325 Individual attributes of each file sent can be modified or supplemented
327 using the -k (or --key) option. For example the command:
328 movescu -k 0010,0020=PAT002 caesar 5678 patqry.dcm
330 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 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 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 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 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 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 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 DICOM Conformance
374 SCU Conformance
375 The movescu application supports the following SOP Classes as an SCU:
376 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 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 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 For outgoing associations, the following transfer syntaxes are
392 supported:
393 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 (*) if compiled with zlib support enabled (see --version output)
400 Which transfer syntaxes are actually proposed in what order, can be
402 specified with the --propose options.
403 SCP Conformance
405 The movescu application supports the following SOP Classes as an SCP:
406 VerificationSOPClass 1.2.840.10008.1.1
408 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 ContentAssessmentResultsStorage 1.2.840.10008.5.1.4.1.1.90.1
547 EncapsulatedPDFStorage 1.2.840.10008.5.1.4.1.1.104.1
548 EncapsulatedCDAStorage 1.2.840.10008.5.1.4.1.1.104.2
549 EncapsulatedSTLStorage 1.2.840.10008.5.1.4.1.1.104.3
550 EncapsulatedOBJStorage 1.2.840.10008.5.1.4.1.1.104.4
551 EncapsulatedMTLStorage 1.2.840.10008.5.1.4.1.1.104.5
552 PositronEmissionTomographyImageStorage 1.2.840.10008.5.1.4.1.1.128
553 LegacyConvertedEnhancedPETImageStorage 1.2.840.10008.5.1.4.1.1.128.1
554 RETIRED_StandalonePETCurveStorage 1.2.840.10008.5.1.4.1.1.129
555 EnhancedPETImageStorage 1.2.840.10008.5.1.4.1.1.130
556 BasicStructuredDisplayStorage 1.2.840.10008.5.1.4.1.1.131
557 CTPerformedProcedureProtocolStorage 1.2.840.10008.5.1.4.1.1.200.2
558 RTImageStorage 1.2.840.10008.5.1.4.1.1.481.1
559 RTDoseStorage 1.2.840.10008.5.1.4.1.1.481.2
560 RTStructureSetStorage 1.2.840.10008.5.1.4.1.1.481.3
561 RTBeamsTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.4
562 RTPlanStorage 1.2.840.10008.5.1.4.1.1.481.5
563 RTBrachyTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.6
564 RTTreatmentSummaryRecordStorage 1.2.840.10008.5.1.4.1.1.481.7
565 RTIonPlanStorage 1.2.840.10008.5.1.4.1.1.481.8
566 RTIonBeamsTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.9
567 RTPhysicianIntentStorage 1.2.840.10008.5.1.4.1.1.481.10
568 RTSegmentAnnotationStorage 1.2.840.10008.5.1.4.1.1.481.11
569 RTRadiationSetStorage 1.2.840.10008.5.1.4.1.1.481.12
570 CArmPhotonElectronRadiationStorage 1.2.840.10008.5.1.4.1.1.481.13
571 TomotherapeuticRadiationStorage 1.2.840.10008.5.1.4.1.1.481.14
572 RoboticArmRadiationStorage 1.2.840.10008.5.1.4.1.1.481.15
573 RTRadiationRecordSetStorage 1.2.840.10008.5.1.4.1.1.481.16
574 RTRadiationSalvageRecordStorage 1.2.840.10008.5.1.4.1.1.481.17
575 TomotherapeuticRadiationRecordStorage 1.2.840.10008.5.1.4.1.1.481.18
576 CArmPhotonElectronRadiationRecordStorage 1.2.840.10008.5.1.4.1.1.481.19
577 RoboticRadiationRecordStorage 1.2.840.10008.5.1.4.1.1.481.20
578 DICOS_CTImageStorage 1.2.840.10008.5.1.4.1.1.501.1
579 DICOS_DigitalXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.501.2.1
580 DICOS_DigitalXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.501.2.2
581 DICOS_ThreatDetectionReportStorage 1.2.840.10008.5.1.4.1.1.501.3
582 DICOS_2DAITStorage 1.2.840.10008.5.1.4.1.1.501.4
583 DICOS_3DAITStorage 1.2.840.10008.5.1.4.1.1.501.5
584 DICOS_QuadrupoleResonanceStorage 1.2.840.10008.5.1.4.1.1.501.6
585 DICONDE_EddyCurrentImageStorage 1.2.840.10008.5.1.4.1.1.601.1
586 DICONDE_EddyCurrentMultiframeImageStorage 1.2.840.10008.5.1.4.1.1.601.2
587 DRAFT_RTBeamsDeliveryInstructionStorage 1.2.840.10008.5.1.4.34.1
588 RTBeamsDeliveryInstructionStorage 1.2.840.10008.5.1.4.34.7
589 RTBrachyApplicationSetupDeliveryInstructionStorage 1.2.840.10008.5.1.4.34.10
590 The movescu application will usually accept presentation contexts for
592 all of the abovementioned supported SOP Classes using any of the
593 following transfer syntaxes:
594 LittleEndianImplicitTransferSyntax 1.2.840.10008.1.2
596 LittleEndianExplicitTransferSyntax 1.2.840.10008.1.2.1
597 BigEndianExplicitTransferSyntax 1.2.840.10008.1.2.2
598 When acting as an SCP, the movescu application will prefer transfer
600 syntaxes having an explicit encoding over the default implicit transfer
601 syntax. If movescu is running on big-endian hardware it will prefer
602 BigEndianExplicit to LittleEndianExplicit transfer syntax (and vice
603 versa). This behavior can be changed with the --prefer options (see
604 above). Using option --accept-all any of the following transfer
605 syntaxes is supported:
606 LittleEndianImplicitTransferSyntax 1.2.840.10008.1.2
608 LittleEndianExplicitTransferSyntax 1.2.840.10008.1.2.1
609 DeflatedExplicitVRLittleEndianTransferSyntax 1.2.840.10008.1.2.1.99 (*)
610 BigEndianExplicitTransferSyntax 1.2.840.10008.1.2.2
611 JPEGProcess1TransferSyntax 1.2.840.10008.1.2.4.50
612 JPEGProcess2_4TransferSyntax 1.2.840.10008.1.2.4.51
613 JPEGProcess14SV1TransferSyntax 1.2.840.10008.1.2.4.70
614 JPEGLSLosslessTransferSyntax 1.2.840.10008.1.2.4.80
615 JPEGLSLossyTransferSyntax 1.2.840.10008.1.2.4.81
616 JPEG2000LosslessOnlyTransferSyntax 1.2.840.10008.1.2.4.90
617 JPEG2000TransferSyntax 1.2.840.10008.1.2.4.91
618 MPEG2MainProfileAtMainLevelTransferSyntax 1.2.840.10008.1.2.4.100
619 MPEG2MainProfileAtHighLevelTransferSyntax 1.2.840.10008.1.2.4.101
620 MPEG4HighProfileLevel4_1TransferSyntax 1.2.840.10008.1.2.4.102
621 MPEG4BDcompatibleHighProfileLevel4_1TransferSyntax 1.2.840.10008.1.2.4.103
622 MPEG4HighProfileLevel4_2_For2DVideoTransferSyntax 1.2.840.10008.1.2.4.104
623 MPEG4HighProfileLevel4_2_For3DVideoTransferSyntax 1.2.840.10008.1.2.4.105
624 MPEG4StereoHighProfileLevel4_2TransferSyntax 1.2.840.10008.1.2.4.106
625 HEVCMainProfileLevel5_1TransferSyntax 1.2.840.10008.1.2.4.107
626 HEVCMain10ProfileLevel5_1TransferSyntax 1.2.840.10008.1.2.4.108
627 RLELosslessTransferSyntax 1.2.840.10008.1.2.5
628 (*) if compiled with zlib support enabled (see --version output)
630 The movescu application does not support extended negotiation.
632 Access Control
634 When compiled on Unix platforms with TCP wrapper support, host-based
635 access control can be enabled with the --access-control command line
636 option. In this case the access control rules defined in the system's
637 host access control tables for movescu are enforced. The default
638 locations of the host access control tables are /etc/hosts.allow and
639 /etc/hosts.deny. Further details are described in hosts_access(5).
640
642 movescu --patient --port 9876 --move TEST_AE --call ARCHIVE caesar 104 q.dcm
643 sends the attributes contained in the DICOM file 'q.dcm' as part of a
645 C-MOVE request to application entity ARCHIVE on the host caesar at port
646 104 using the Patient Root query model. movescu itself uses the default
647 AE title MOVESCU. The C-MOVE request will specify that images should be
648 transferred to the destination AE title TEST_AE (via the --move
649 option). How the SCP interprets this request depends on its
650 configuration. movescu will listen on part 9876 for incoming
651 associations in order to receive the requested images from the SCP.
652 Images can be copied to a third party by using a different destination
654 AE title (e.g. --move ANOTHER_AE). Of course, the SCP must 'know' this
655 AE title and the destination must be acting as an SCP of the Storage
656 Service Class (the storescp application can be used for this purpose).
657
659 The level of logging output of the various command line tools and
660 underlying libraries can be specified by the user. By default, only
661 errors and warnings are written to the standard error stream. Using
662 option --verbose also informational messages like processing details
663 are reported. Option --debug can be used to get more details on the
664 internal activity, e.g. for debugging purposes. Other logging levels
665 can be selected using option --log-level. In --quiet mode only fatal
666 errors are reported. In such very severe error events, the application
667 will usually terminate. For more details on the different logging
668 levels, see documentation of module 'oflog'.
669 In case the logging output should be written to file (optionally with
671 logfile rotation), to syslog (Unix) or the event log (Windows) option
672 --log-config can be used. This configuration file also allows for
673 directing only certain messages to a particular output stream and for
674 filtering certain messages based on the module or application where
675 they are generated. An example configuration file is provided in
676 <etcdir>/logger.cfg.
677
679 All command line tools use the following notation for parameters:
680 square brackets enclose optional values (0-1), three trailing dots
681 indicate that multiple values are allowed (1-n), a combination of both
682 means 0 to n values.
683 Command line options are distinguished from parameters by a leading '+'
685 or '-' sign, respectively. Usually, order and position of command line
686 options are arbitrary (i.e. they can appear anywhere). However, if
687 options are mutually exclusive the rightmost appearance is used. This
688 behavior conforms to the standard evaluation rules of common Unix
689 shells.
690 In addition, one or more command files can be specified using an '@'
692 sign as a prefix to the filename (e.g. @command.txt). Such a command
693 argument is replaced by the content of the corresponding text file
694 (multiple whitespaces are treated as a single separator unless they
695 appear between two quotation marks) prior to any further evaluation.
696 Please note that a command file cannot contain another command file.
697 This simple but effective approach allows one to summarize common
698 combinations of options/parameters and avoids longish and confusing
699 command lines (an example is provided in file <datadir>/dumppat.txt).
700
702 The movescu utility uses the following exit codes when terminating.
703 This enables the user to check for the reason why the application
704 terminated.
705 general
707 EXITCODE_NO_ERROR 0
708 EXITCODE_COMMANDLINE_SYNTAX_ERROR 1
709 EXITCODE_INSUFFICIENT_PRIVILEGES 2
710 EXITCODE_SETUID_FAILED 3
711 output file errors
713 EXITCODE_CANNOT_WRITE_OUTPUT_FILE 40
714 EXITCODE_INVALID_OUTPUT_DIRECTORY 45
715 network errors
717 EXITCODE_CANNOT_INITIALIZE_NETWORK 60
718 EXITCODE_CANNOT_NEGOTIATE_ASSOCIATION 61
719 EXITCODE_CANNOT_CREATE_ASSOC_PARAMETERS 65
720 EXITCODE_NO_PRESENTATION_CONTEXT 66
721 EXITCODE_CANNOT_CLOSE_ASSOCIATION 67
722 EXITCODE_CMOVE_WARNING 68
723 EXITCODE_CMOVE_ERROR 69
724
726 The movescu utility will attempt to load DICOM data dictionaries
727 specified in the DCMDICTPATH environment variable. By default, i.e. if
728 the DCMDICTPATH environment variable is not set, the file
729 <datadir>/dicom.dic will be loaded unless the dictionary is built into
730 the application (default for Windows).
731 The default behavior should be preferred and the DCMDICTPATH
733 environment variable only used when alternative data dictionaries are
734 required. The DCMDICTPATH environment variable has the same format as
735 the Unix shell PATH variable in that a colon (':') separates entries.
736 On Windows systems, a semicolon (';') is used as a separator. The data
737 dictionary code will attempt to load each file specified in the
738 DCMDICTPATH environment variable. It is an error if no data dictionary
739 can be loaded.
740
742 findscu(1), storescp(1), dump2dcm(1)
743
745 Copyright (C) 1994-2021 e.V., Escherweg 2, 26121 Oldenburg, Germany.
746Version 3.6.6 Thu Jan 14 2021 movescu(1)