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 RETIRED_StandaloneModalityLUTStorage 1.2.840.10008.5.1.4.1.1.10
451 RETIRED_StandaloneVOILUTStorage 1.2.840.10008.5.1.4.1.1.11
452 GrayscaleSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.1
453 ColorSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.2
454 PseudoColorSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.3
455 BlendingSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.4
456 XAXRFGrayscaleSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.5
457 GrayscalePlanarMPRVolumetricPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.6
458 CompositingPlanarMPRVolumetricPresent.StateStorage 1.2.840.10008.5.1.4.1.1.11.7
459 AdvancedBlendingPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.8
460 VolumeRenderingVolumetricPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.9
461 SegmentedVolumeRenderingVolumetricPres.StateStorage 1.2.840.10008.5.1.4.1.1.11.10
462 MultipleVolumeRenderingVolumetricPres.StateStorage 1.2.840.10008.5.1.4.1.1.11.11
463 XRayAngiographicImageStorage 1.2.840.10008.5.1.4.1.1.12.1
464 EnhancedXAImageStorage 1.2.840.10008.5.1.4.1.1.12.1.1
465 XRayRadiofluoroscopicImageStorage 1.2.840.10008.5.1.4.1.1.12.2
466 EnhancedXRFImageStorage 1.2.840.10008.5.1.4.1.1.12.2.1
467 RETIRED_XRayAngiographicBiPlaneImageStorage 1.2.840.10008.5.1.4.1.1.12.3
468 XRay3DAngiographicImageStorage 1.2.840.10008.5.1.4.1.1.13.1.1
469 XRay3DCraniofacialImageStorage 1.2.840.10008.5.1.4.1.1.13.1.2
470 BreastTomosynthesisImageStorage 1.2.840.10008.5.1.4.1.1.13.1.3
471 BreastProjectionXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.13.1.4
472 BreastProjectionXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.13.1.5
473 IntravascularOpt.Coh.Tom.ImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.14.1
474 IntravascularOpt.Coh.Tom.ImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.14.2
475 NuclearMedicineImageStorage 1.2.840.10008.5.1.4.1.1.20
476 ParametricMapStorage 1.2.840.10008.5.1.4.1.1.30
477 RawDataStorage 1.2.840.10008.5.1.4.1.1.66
478 SpatialRegistrationStorage 1.2.840.10008.5.1.4.1.1.66.1
479 SpatialFiducialsStorage 1.2.840.10008.5.1.4.1.1.66.2
480 DeformableSpatialRegistrationStorage 1.2.840.10008.5.1.4.1.1.66.3
481 SegmentationStorage 1.2.840.10008.5.1.4.1.1.66.4
482 SurfaceSegmentationStorage 1.2.840.10008.5.1.4.1.1.66.5
483 TractographyResultsStorage 1.2.840.10008.5.1.4.1.1.66.6
484 RealWorldValueMappingStorage 1.2.840.10008.5.1.4.1.1.67
485 SurfaceScanMeshStorage 1.2.840.10008.5.1.4.1.1.68.1
486 SurfaceScanPointCloudStorage 1.2.840.10008.5.1.4.1.1.68.2
487 RETIRED_VLImageStorage 1.2.840.10008.5.1.4.1.1.77.1
488 VLEndoscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.1
489 VideoEndoscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.1.1
490 VLMicroscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.2
491 VideoMicroscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.2.1
492 VLSlideCoordinatesMicroscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.3
493 VLPhotographicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.4
494 VideoPhotographicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.4.1
495 OphthalmicPhotography8BitImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.1
496 OphthalmicPhotography16BitImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.2
497 StereometricRelationshipStorage 1.2.840.10008.5.1.4.1.1.77.1.5.3
498 OphthalmicTomographyImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.4
499 WideFieldOphthalmicPhoto.Stereogr.Proj.ImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.5
500 WideFieldOphthalmicPhotogr.3DCoordinatesImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.6
501 OphthalmicOpticalCoherenceTomogr.EnFaceImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.7
502 OphthalmicOpticalCoh.Tomogr.BscanVolumeAnalysisStor. 1.2.840.10008.5.1.4.1.1.77.1.5.8
503 VLWholeSlideMicroscopyImageStorage 1.2.840.10008.5.1.4.1.1.77.1.6
504 RETIRED_VLMultiframeImageStorage 1.2.840.10008.5.1.4.1.1.77.2
505 LensometryMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.1
506 AutorefractionMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.2
507 KeratometryMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.3
508 SubjectiveRefractionMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.4
509 VisualAcuityMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.5
510 SpectaclePrescriptionReportStorage 1.2.840.10008.5.1.4.1.1.78.6
511 OphthalmicAxialMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.7
512 IntraocularLensCalculationsStorage 1.2.840.10008.5.1.4.1.1.78.8
513 MacularGridThicknessAndVolumeReportStorage 1.2.840.10008.5.1.4.1.1.79.1
514 OphthalmicVisualFieldStaticPerimetryMeasurementsSt. 1.2.840.10008.5.1.4.1.1.80.1
515 OphthalmicThicknessMapStorage 1.2.840.10008.5.1.4.1.1.81.1
516 CornealTopographyMapStorage 1.2.840.10008.5.1.4.1.1.82.1
517 DRAFT_SRTextStorage 1.2.840.10008.5.1.4.1.1.88.1
518 DRAFT_SRAudioStorage 1.2.840.10008.5.1.4.1.1.88.2
519 DRAFT_SRDetailStorage 1.2.840.10008.5.1.4.1.1.88.3
520 DRAFT_SRComprehensiveStorage 1.2.840.10008.5.1.4.1.1.88.4
521 BasicTextSRStorage 1.2.840.10008.5.1.4.1.1.88.11
522 EnhancedSRStorage 1.2.840.10008.5.1.4.1.1.88.22
523 ComprehensiveSRStorage 1.2.840.10008.5.1.4.1.1.88.33
524 Comprehensive3DSRStorage 1.2.840.10008.5.1.4.1.1.88.34
525 ExtensibleSRStorage 1.2.840.10008.5.1.4.1.1.88.35
526 ProcedureLogStorage 1.2.840.10008.5.1.4.1.1.88.40
527 MammographyCADSRStorage 1.2.840.10008.5.1.4.1.1.88.50
528 KeyObjectSelectionDocumentStorage 1.2.840.10008.5.1.4.1.1.88.59
529 ChestCADSRStorage 1.2.840.10008.5.1.4.1.1.88.65
530 XRayRadiationDoseSRStorage 1.2.840.10008.5.1.4.1.1.88.67
531 RadiopharmaceuticalRadiationDoseSRStorage 1.2.840.10008.5.1.4.1.1.88.68
532 ColonCADSRStorage 1.2.840.10008.5.1.4.1.1.88.69
533 ImplantationPlanSRDocumentStorage 1.2.840.10008.5.1.4.1.1.88.70
534 AcquisitionContextSRStorage 1.2.840.10008.5.1.4.1.1.88.71
535 SimplifiedAdultEchoSRStorage 1.2.840.10008.5.1.4.1.1.88.72
536 PatientRadiationDoseSRStorage 1.2.840.10008.5.1.4.1.1.88.73
537 ContentAssessmentResultsStorage 1.2.840.10008.5.1.4.1.1.90.1
538 EncapsulatedPDFStorage 1.2.840.10008.5.1.4.1.1.104.1
539 EncapsulatedCDAStorage 1.2.840.10008.5.1.4.1.1.104.2
540 EncapsulatedSTLStorage 1.2.840.10008.5.1.4.1.1.104.3
541 PositronEmissionTomographyImageStorage 1.2.840.10008.5.1.4.1.1.128
542 LegacyConvertedEnhancedPETImageStorage 1.2.840.10008.5.1.4.1.1.128.1
543 RETIRED_StandalonePETCurveStorage 1.2.840.10008.5.1.4.1.1.129
544 EnhancedPETImageStorage 1.2.840.10008.5.1.4.1.1.130
545 BasicStructuredDisplayStorage 1.2.840.10008.5.1.4.1.1.131
546 CTPerformedProcedureProtocolStorage 1.2.840.10008.5.1.4.1.1.200.2
547 RTImageStorage 1.2.840.10008.5.1.4.1.1.481.1
548 RTDoseStorage 1.2.840.10008.5.1.4.1.1.481.2
549 RTStructureSetStorage 1.2.840.10008.5.1.4.1.1.481.3
550 RTBeamsTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.4
551 RTPlanStorage 1.2.840.10008.5.1.4.1.1.481.5
552 RTBrachyTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.6
553 RTTreatmentSummaryRecordStorage 1.2.840.10008.5.1.4.1.1.481.7
554 RTIonPlanStorage 1.2.840.10008.5.1.4.1.1.481.8
555 RTIonBeamsTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.9
556 DICOS_CTImageStorage 1.2.840.10008.5.1.4.1.1.501.1
557 DICOS_DigitalXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.501.2.1
558 DICOS_DigitalXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.501.2.2
559 DICOS_ThreatDetectionReportStorage 1.2.840.10008.5.1.4.1.1.501.3
560 DICOS_2DAITStorage 1.2.840.10008.5.1.4.1.1.501.4
561 DICOS_3DAITStorage 1.2.840.10008.5.1.4.1.1.501.5
562 DICOS_QuadrupoleResonanceStorage 1.2.840.10008.5.1.4.1.1.501.6
563 DICONDE_EddyCurrentImageStorage 1.2.840.10008.5.1.4.1.1.601.1
564 DICONDE_EddyCurrentMultiframeImageStorage 1.2.840.10008.5.1.4.1.1.601.2
565 DRAFT_RTBeamsDeliveryInstructionStorage 1.2.840.10008.5.1.4.34.1
566 RTBeamsDeliveryInstructionStorage 1.2.840.10008.5.1.4.34.7
567 RTBrachyApplicationSetupDeliveryInstructionStorage 1.2.840.10008.5.1.4.34.10
568 The movescu application will usually accept presentation contexts for
570 all of the abovementioned supported SOP Classes using any of the
571 following transfer syntaxes:
572 LittleEndianImplicitTransferSyntax 1.2.840.10008.1.2
574 LittleEndianExplicitTransferSyntax 1.2.840.10008.1.2.1
575 BigEndianExplicitTransferSyntax 1.2.840.10008.1.2.2
576 When acting as an SCP, the movescu application will prefer transfer
578 syntaxes having an explicit encoding over the default implicit transfer
579 syntax. If movescu is running on big-endian hardware it will prefer
580 BigEndianExplicit to LittleEndianExplicit transfer syntax (and vice
581 versa). This behavior can be changed with the --prefer options (see
582 above). Using option --accept-all any of the following transfer
583 syntaxes is supported:
584 LittleEndianImplicitTransferSyntax 1.2.840.10008.1.2
586 LittleEndianExplicitTransferSyntax 1.2.840.10008.1.2.1
587 DeflatedExplicitVRLittleEndianTransferSyntax 1.2.840.10008.1.2.1.99 (*)
588 BigEndianExplicitTransferSyntax 1.2.840.10008.1.2.2
589 JPEGProcess1TransferSyntax 1.2.840.10008.1.2.4.50
590 JPEGProcess2_4TransferSyntax 1.2.840.10008.1.2.4.51
591 JPEGProcess14SV1TransferSyntax 1.2.840.10008.1.2.4.70
592 JPEGLSLosslessTransferSyntax 1.2.840.10008.1.2.4.80
593 JPEGLSLossyTransferSyntax 1.2.840.10008.1.2.4.81
594 JPEG2000LosslessOnlyTransferSyntax 1.2.840.10008.1.2.4.90
595 JPEG2000TransferSyntax 1.2.840.10008.1.2.4.91
596 MPEG2MainProfileAtMainLevelTransferSyntax 1.2.840.10008.1.2.4.100
597 MPEG2MainProfileAtHighLevelTransferSyntax 1.2.840.10008.1.2.4.101
598 MPEG4HighProfileLevel4_1TransferSyntax 1.2.840.10008.1.2.4.102
599 MPEG4BDcompatibleHighProfileLevel4_1TransferSyntax 1.2.840.10008.1.2.4.103
600 MPEG4HighProfileLevel4_2_For2DVideoTransferSyntax 1.2.840.10008.1.2.4.104
601 MPEG4HighProfileLevel4_2_For3DVideoTransferSyntax 1.2.840.10008.1.2.4.105
602 MPEG4StereoHighProfileLevel4_2TransferSyntax 1.2.840.10008.1.2.4.106
603 HEVCMainProfileLevel5_1TransferSyntax 1.2.840.10008.1.2.4.107
604 HEVCMain10ProfileLevel5_1TransferSyntax 1.2.840.10008.1.2.4.108
605 RLELosslessTransferSyntax 1.2.840.10008.1.2.5
606 (*) if compiled with zlib support enabled (see --version output)
608 The movescu application does not support extended negotiation.
610 Access Control
612 When compiled on Unix platforms with TCP wrapper support, host-based
613 access control can be enabled with the --access-control command line
614 option. In this case the access control rules defined in the system's
615 host access control tables for movescu are enforced. The default
616 locations of the host access control tables are /etc/hosts.allow and
617 /etc/hosts.deny. Further details are described in hosts_access(5).
618
620 movescu --patient --port 9876 --move TEST_AE --call ARCHIVE caesar 104 q.dcm
621 sends the attributes contained in the DICOM file 'q.dcm' as part of a
623 C-MOVE request to application entity ARCHIVE on the host caesar at port
624 104 using the Patient Root query model. movescu itself uses the default
625 AE title MOVESCU. The C-MOVE request will specify that images should be
626 transferred to the destination AE title TEST_AE (via the --move
627 option). How the SCP interprets this request depends on its
628 configuration. movescu will listen on part 9876 for incoming
629 associations in order to receive the requested images from the SCP.
630 Images can be copied to a third party by using a different destination
632 AE title (e.g. --move ANOTHER_AE). Of course, the SCP must 'know' this
633 AE title and the destination must be acting as an SCP of the Storage
634 Service Class (the storescp application can be used for this purpose).
635
637 The level of logging output of the various command line tools and
638 underlying libraries can be specified by the user. By default, only
639 errors and warnings are written to the standard error stream. Using
640 option --verbose also informational messages like processing details
641 are reported. Option --debug can be used to get more details on the
642 internal activity, e.g. for debugging purposes. Other logging levels
643 can be selected using option --log-level. In --quiet mode only fatal
644 errors are reported. In such very severe error events, the application
645 will usually terminate. For more details on the different logging
646 levels, see documentation of module 'oflog'.
647 In case the logging output should be written to file (optionally with
649 logfile rotation), to syslog (Unix) or the event log (Windows) option
650 --log-config can be used. This configuration file also allows for
651 directing only certain messages to a particular output stream and for
652 filtering certain messages based on the module or application where
653 they are generated. An example configuration file is provided in
654 <etcdir>/logger.cfg.
655
657 All command line tools use the following notation for parameters:
658 square brackets enclose optional values (0-1), three trailing dots
659 indicate that multiple values are allowed (1-n), a combination of both
660 means 0 to n values.
661 Command line options are distinguished from parameters by a leading '+'
663 or '-' sign, respectively. Usually, order and position of command line
664 options are arbitrary (i.e. they can appear anywhere). However, if
665 options are mutually exclusive the rightmost appearance is used. This
666 behavior conforms to the standard evaluation rules of common Unix
667 shells.
668 In addition, one or more command files can be specified using an '@'
670 sign as a prefix to the filename (e.g. @command.txt). Such a command
671 argument is replaced by the content of the corresponding text file
672 (multiple whitespaces are treated as a single separator unless they
673 appear between two quotation marks) prior to any further evaluation.
674 Please note that a command file cannot contain another command file.
675 This simple but effective approach allows one to summarize common
676 combinations of options/parameters and avoids longish and confusing
677 command lines (an example is provided in file <datadir>/dumppat.txt).
678
680 The movescu utility uses the following exit codes when terminating.
681 This enables the user to check for the reason why the application
682 terminated.
683 general
685 EXITCODE_NO_ERROR 0
686 EXITCODE_COMMANDLINE_SYNTAX_ERROR 1
687 EXITCODE_INSUFFICIENT_PRIVILEGES 2
688 EXITCODE_SETUID_FAILED 3
689 output file errors
691 EXITCODE_CANNOT_WRITE_OUTPUT_FILE 40
692 EXITCODE_INVALID_OUTPUT_DIRECTORY 45
693 network errors
695 EXITCODE_CANNOT_INITIALIZE_NETWORK 60
696 EXITCODE_CANNOT_NEGOTIATE_ASSOCIATION 61
697 EXITCODE_CANNOT_CREATE_ASSOC_PARAMETERS 65
698 EXITCODE_NO_PRESENTATION_CONTEXT 66
699 EXITCODE_CANNOT_CLOSE_ASSOCIATION 67
700 EXITCODE_CMOVE_WARNING 68
701 EXITCODE_CMOVE_ERROR 69
702
704 The movescu utility will attempt to load DICOM data dictionaries
705 specified in the DCMDICTPATH environment variable. By default, i.e. if
706 the DCMDICTPATH environment variable is not set, the file
707 <datadir>/dicom.dic will be loaded unless the dictionary is built into
708 the application (default for Windows).
709 The default behavior should be preferred and the DCMDICTPATH
711 environment variable only used when alternative data dictionaries are
712 required. The DCMDICTPATH environment variable has the same format as
713 the Unix shell PATH variable in that a colon (':') separates entries.
714 On Windows systems, a semicolon (';') is used as a separator. The data
715 dictionary code will attempt to load each file specified in the
716 DCMDICTPATH environment variable. It is an error if no data dictionary
717 can be loaded.
718
720 findscu(1), storescp(1), dump2dcm(1)
721
723 Copyright (C) 1994-2018 by OFFIS e.V., Escherweg 2, 26121 Oldenburg,
724 Germany.
725Version 3.6.4 Thu Nov 29 2018 movescu(1)