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 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 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 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 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 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 (*) if compiled with zlib support enabled (see --version output)
635 The movescu application does not support extended negotiation.
637 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 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 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 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 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 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 general
712 EXITCODE_NO_ERROR 0
713 EXITCODE_COMMANDLINE_SYNTAX_ERROR 1
714 EXITCODE_INSUFFICIENT_PRIVILEGES 2
715 EXITCODE_SETUID_FAILED 3
716 output file errors
718 EXITCODE_CANNOT_WRITE_OUTPUT_FILE 40
719 EXITCODE_INVALID_OUTPUT_DIRECTORY 45
720 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 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.
752Version 3.6.7 Fri Apr 22 2022 movescu(1)