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 PositronEmissionTomographyImageStorage 1.2.840.10008.5.1.4.1.1.128
541 LegacyConvertedEnhancedPETImageStorage 1.2.840.10008.5.1.4.1.1.128.1
542 RETIRED_StandalonePETCurveStorage 1.2.840.10008.5.1.4.1.1.129
543 EnhancedPETImageStorage 1.2.840.10008.5.1.4.1.1.130
544 BasicStructuredDisplayStorage 1.2.840.10008.5.1.4.1.1.131
545 CTPerformedProcedureProtocolStorage 1.2.840.10008.5.1.4.1.1.200.2
546 RTImageStorage 1.2.840.10008.5.1.4.1.1.481.1
547 RTDoseStorage 1.2.840.10008.5.1.4.1.1.481.2
548 RTStructureSetStorage 1.2.840.10008.5.1.4.1.1.481.3
549 RTBeamsTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.4
550 RTPlanStorage 1.2.840.10008.5.1.4.1.1.481.5
551 RTBrachyTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.6
552 RTTreatmentSummaryRecordStorage 1.2.840.10008.5.1.4.1.1.481.7
553 RTIonPlanStorage 1.2.840.10008.5.1.4.1.1.481.8
554 RTIonBeamsTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.9
555 DICOS_CTImageStorage 1.2.840.10008.5.1.4.1.1.501.1
556 DICOS_DigitalXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.501.2.1
557 DICOS_DigitalXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.501.2.2
558 DICOS_ThreatDetectionReportStorage 1.2.840.10008.5.1.4.1.1.501.3
559 DICOS_2DAITStorage 1.2.840.10008.5.1.4.1.1.501.4
560 DICOS_3DAITStorage 1.2.840.10008.5.1.4.1.1.501.5
561 DICOS_QuadrupoleResonanceStorage 1.2.840.10008.5.1.4.1.1.501.6
562 DICONDE_EddyCurrentImageStorage 1.2.840.10008.5.1.4.1.1.601.1
563 DICONDE_EddyCurrentMultiframeImageStorage 1.2.840.10008.5.1.4.1.1.601.2
564 DRAFT_RTBeamsDeliveryInstructionStorage 1.2.840.10008.5.1.4.34.1
565 RTBeamsDeliveryInstructionStorage 1.2.840.10008.5.1.4.34.7
566 RTBrachyApplicationSetupDeliveryInstructionStorage 1.2.840.10008.5.1.4.34.10
567 The movescu application will usually accept presentation contexts for
569 all of the abovementioned supported SOP Classes using any of the
570 following transfer syntaxes:
571 LittleEndianImplicitTransferSyntax 1.2.840.10008.1.2
573 LittleEndianExplicitTransferSyntax 1.2.840.10008.1.2.1
574 BigEndianExplicitTransferSyntax 1.2.840.10008.1.2.2
575 When acting as an SCP, the movescu application will prefer transfer
577 syntaxes having an explicit encoding over the default implicit transfer
578 syntax. If movescu is running on big-endian hardware it will prefer
579 BigEndianExplicit to LittleEndianExplicit transfer syntax (and vice
580 versa). This behavior can be changed with the --prefer options (see
581 above). Using option --accept-all any of the following transfer
582 syntaxes is supported:
583 LittleEndianImplicitTransferSyntax 1.2.840.10008.1.2
585 LittleEndianExplicitTransferSyntax 1.2.840.10008.1.2.1
586 DeflatedExplicitVRLittleEndianTransferSyntax 1.2.840.10008.1.2.1.99 (*)
587 BigEndianExplicitTransferSyntax 1.2.840.10008.1.2.2
588 JPEGProcess1TransferSyntax 1.2.840.10008.1.2.4.50
589 JPEGProcess2_4TransferSyntax 1.2.840.10008.1.2.4.51
590 JPEGProcess14SV1TransferSyntax 1.2.840.10008.1.2.4.70
591 JPEGLSLosslessTransferSyntax 1.2.840.10008.1.2.4.80
592 JPEGLSLossyTransferSyntax 1.2.840.10008.1.2.4.81
593 JPEG2000LosslessOnlyTransferSyntax 1.2.840.10008.1.2.4.90
594 JPEG2000TransferSyntax 1.2.840.10008.1.2.4.91
595 MPEG2MainProfileAtMainLevelTransferSyntax 1.2.840.10008.1.2.4.100
596 MPEG2MainProfileAtHighLevelTransferSyntax 1.2.840.10008.1.2.4.101
597 MPEG4HighProfileLevel4_1TransferSyntax 1.2.840.10008.1.2.4.102
598 MPEG4BDcompatibleHighProfileLevel4_1TransferSyntax 1.2.840.10008.1.2.4.103
599 MPEG4HighProfileLevel4_2_For2DVideoTransferSyntax 1.2.840.10008.1.2.4.104
600 MPEG4HighProfileLevel4_2_For3DVideoTransferSyntax 1.2.840.10008.1.2.4.105
601 MPEG4StereoHighProfileLevel4_2TransferSyntax 1.2.840.10008.1.2.4.106
602 HEVCMainProfileLevel5_1TransferSyntax 1.2.840.10008.1.2.4.107
603 HEVCMain10ProfileLevel5_1TransferSyntax 1.2.840.10008.1.2.4.108
604 RLELosslessTransferSyntax 1.2.840.10008.1.2.5
605 (*) if compiled with zlib support enabled (see --version output)
607 The movescu application does not support extended negotiation.
609 Access Control
611 When compiled on Unix platforms with TCP wrapper support, host-based
612 access control can be enabled with the --access-control command line
613 option. In this case the access control rules defined in the system's
614 host access control tables for movescu are enforced. The default
615 locations of the host access control tables are /etc/hosts.allow and
616 /etc/hosts.deny. Further details are described in hosts_access(5).
617
619 movescu --patient --port 9876 --move TEST_AE --call ARCHIVE caesar 104 q.dcm
620 sends the attributes contained in the DICOM file 'q.dcm' as part of a
622 C-MOVE request to application entity ARCHIVE on the host caesar at port
623 104 using the Patient Root query model. movescu itself uses the default
624 AE title MOVESCU. The C-MOVE request will specify that images should be
625 transferred to the destination AE title TEST_AE (via the --move
626 option). How the SCP interprets this request depends on its
627 configuration. movescu will listen on part 9876 for incoming
628 associations in order to receive the requested images from the SCP.
629 Images can be copied to a third party by using a different destination
631 AE title (e.g. --move ANOTHER_AE). Of course, the SCP must 'know' this
632 AE title and the destination must be acting as an SCP of the Storage
633 Service Class (the storescp application can be used for this purpose).
634
636 The level of logging output of the various command line tools and
637 underlying libraries can be specified by the user. By default, only
638 errors and warnings are written to the standard error stream. Using
639 option --verbose also informational messages like processing details
640 are reported. Option --debug can be used to get more details on the
641 internal activity, e.g. for debugging purposes. Other logging levels
642 can be selected using option --log-level. In --quiet mode only fatal
643 errors are reported. In such very severe error events, the application
644 will usually terminate. For more details on the different logging
645 levels, see documentation of module 'oflog'.
646 In case the logging output should be written to file (optionally with
648 logfile rotation), to syslog (Unix) or the event log (Windows) option
649 --log-config can be used. This configuration file also allows for
650 directing only certain messages to a particular output stream and for
651 filtering certain messages based on the module or application where
652 they are generated. An example configuration file is provided in
653 <etcdir>/logger.cfg.
654
656 All command line tools use the following notation for parameters:
657 square brackets enclose optional values (0-1), three trailing dots
658 indicate that multiple values are allowed (1-n), a combination of both
659 means 0 to n values.
660 Command line options are distinguished from parameters by a leading '+'
662 or '-' sign, respectively. Usually, order and position of command line
663 options are arbitrary (i.e. they can appear anywhere). However, if
664 options are mutually exclusive the rightmost appearance is used. This
665 behavior conforms to the standard evaluation rules of common Unix
666 shells.
667 In addition, one or more command files can be specified using an '@'
669 sign as a prefix to the filename (e.g. @command.txt). Such a command
670 argument is replaced by the content of the corresponding text file
671 (multiple whitespaces are treated as a single separator unless they
672 appear between two quotation marks) prior to any further evaluation.
673 Please note that a command file cannot contain another command file.
674 This simple but effective approach allows one to summarize common
675 combinations of options/parameters and avoids longish and confusing
676 command lines (an example is provided in file <datadir>/dumppat.txt).
677
679 The movescu utility uses the following exit codes when terminating.
680 This enables the user to check for the reason why the application
681 terminated.
682 general
684 EXITCODE_NO_ERROR 0
685 EXITCODE_COMMANDLINE_SYNTAX_ERROR 1
686 EXITCODE_INSUFFICIENT_PRIVILEGES 2
687 EXITCODE_SETUID_FAILED 3
688 output file errors
690 EXITCODE_CANNOT_WRITE_OUTPUT_FILE 40
691 EXITCODE_INVALID_OUTPUT_DIRECTORY 45
692 network errors
694 EXITCODE_CANNOT_INITIALIZE_NETWORK 60
695 EXITCODE_CANNOT_NEGOTIATE_ASSOCIATION 61
696 EXITCODE_CANNOT_CREATE_ASSOC_PARAMETERS 65
697 EXITCODE_NO_PRESENTATION_CONTEXT 66
698 EXITCODE_CANNOT_CLOSE_ASSOCIATION 67
699 EXITCODE_CMOVE_WARNING 68
700 EXITCODE_CMOVE_ERROR 69
701
703 The movescu utility will attempt to load DICOM data dictionaries
704 specified in the DCMDICTPATH environment variable. By default, i.e. if
705 the DCMDICTPATH environment variable is not set, the file
706 <datadir>/dicom.dic will be loaded unless the dictionary is built into
707 the application (default for Windows).
708 The default behavior should be preferred and the DCMDICTPATH
710 environment variable only used when alternative data dictionaries are
711 required. The DCMDICTPATH environment variable has the same format as
712 the Unix shell PATH variable in that a colon (':') separates entries.
713 On Windows systems, a semicolon (';') is used as a separator. The data
714 dictionary code will attempt to load each file specified in the
715 DCMDICTPATH environment variable. It is an error if no data dictionary
716 can be loaded.
717
719 findscu(1), storescp(1), dump2dcm(1)
720
722 Copyright (C) 1994-2017 by OFFIS e.V., Escherweg 2, 26121 Oldenburg,
723 Germany.
724Version 3.6.2 Fri Jul 14 2017 movescu(1)