1movescu(1) OFFIS DCMTK movescu(1)
2
6 movescu - DICOM retrieve (C-MOVE) SCU
7
9 movescu [options] peer port [dcmfile-in...]
10
12 The movescu application implements both an SCU for the Query/Retrieve
13 Service Class and an SCP for the Storage Service Class. movescu
14 supports retrieve functionality using the C-MOVE message. It sends
15 query keys to an SCP and awaits responses. It will accept associations
16 for the purpose of receiving images sent as a result of the C-MOVE
17 request. The application can be used to test SCPs of the Query/Retrieve
18 Service Class. The movescu application can initiate the transfer of
19 images to a third party or can retrieve images to itself. Note that the
20 use of the term 'move' is a misnomer. The C-MOVE operation actually
21 performs an image copy (no images will be deleted from the SCP).
22
24 peer hostname of DICOM peer
25 port tcp/ip port number of peer
27 dcmfile-in DICOM query file(s)
29
31 general options
32 -h --help
33 print this help text and exit
34 --version
36 print version information and exit
37 --arguments
39 print expanded command line arguments
40 -q --quiet
42 quiet mode, print no warnings and errors
43 -v --verbose
45 verbose mode, print processing details
46 -d --debug
48 debug mode, print debug information
49 -ll --log-level [l]evel: string constant
51 (fatal, error, warn, info, debug, trace)
52 use level l for the logger
53 -lc --log-config [f]ilename: string
55 use config file f for the logger
56 network options
58 override matching keys:
59 -k --key [k]ey: gggg,eeee="str" or dictionary name="str"
61 override matching key
62 query information model:
64 -P --patient
66 use patient root information model (default)
67 -S --study
69 use study root information model
70 -O --psonly
72 use patient/study only information model
73 application entity titles:
75 -aet --aetitle [a]etitle: string
77 set my calling AE title (default: MOVESCU)
78 -aec --call [a]etitle: string
80 set called AE title of peer (default: ANY-SCP)
81 -aem --move [a]etitle: string
83 set move destination AE title (default: MOVESCU)
84 preferred network transfer syntaxes (incoming associations):
86 +x= --prefer-uncompr
88 prefer explicit VR local byte order (default)
89 +xe --prefer-little
91 prefer explicit VR little endian TS
92 +xb --prefer-big
94 prefer explicit VR big endian TS
95 +xs --prefer-lossless
97 prefer default JPEG lossless TS
98 +xy --prefer-jpeg8
100 prefer default JPEG lossy TS for 8 bit data
101 +xx --prefer-jpeg12
103 prefer default JPEG lossy TS for 12 bit data
104 +xv --prefer-j2k-lossless
106 prefer JPEG 2000 lossless TS
107 +xw --prefer-j2k-lossy
109 prefer JPEG 2000 lossy TS
110 +xt --prefer-jls-lossless
112 prefer JPEG-LS lossless TS
113 +xu --prefer-jls-lossy
115 prefer JPEG-LS lossy TS
116 +xm --prefer-mpeg2
118 prefer MPEG2 Main Profile @ Main Level TS
119 +xh --prefer-mpeg2-high
121 prefer MPEG2 Main Profile @ High Level TS
122 +xr --prefer-rle
124 prefer RLE lossless TS
125 +xd --prefer-deflated
127 prefer deflated explicit VR little endian TS
128 +xi --implicit
130 accept implicit VR little endian TS only
131 +xa --accept-all
133 accept all supported transfer syntaxes
134 proposed transmission transfer syntaxes (outgoing associations):
136 -x= --propose-uncompr
138 propose all uncompressed TS, explicit VR
139 with local byte ordering first (default)
140 -xe --propose-little
142 propose all uncompressed TS, explicit VR little endian first
143 -xb --propose-big
145 propose all uncompressed TS, explicit VR big endian first
146 -xi --propose-implicit
148 propose implicit VR little endian TS only
149 network host access control (tcp wrapper):
151 -ac --access-full
153 accept connections from any host (default)
154 +ac --access-control
156 enforce host access control rules
157 port for incoming network associations:
159 --no-port
161 no port for incoming associations (default)
162 +P --port [n]umber: integer
164 port number for incoming associations
165 handling of illegal datasets following 'pending' move responses:
167 -pi --pending-ignore
169 assume no dataset present (default)
170 -pr --pending-read
172 read and ignore dataset
173 other network options:
175 -to --timeout [s]econds: integer (default: unlimited)
177 timeout for connection requests
178 -ta --acse-timeout [s]econds: integer (default: 30)
180 timeout for ACSE messages
181 -td --dimse-timeout [s]econds: integer (default: unlimited)
183 timeout for DIMSE messages
184 -pdu --max-pdu [n]umber of bytes: integer (4096..131072)
186 set max receive pdu to n bytes (default: 16384)
187 -dhl --disable-host-lookup
189 disable hostname lookup
190 --repeat [n]umber: integer
192 repeat n times
193 --abort
195 abort association instead of releasing it
196 --ignore
198 ignore store data, receive but do not store
199 --cancel [n]umber: integer
201 cancel after n responses (default: never)
202 -up --uid-padding
204 silently correct space-padded UIDs
205 output options
207 general:
208 -od --output-directory [d]irectory: string (default: ".")
210 write received objects to existing directory d
211 bit preserving mode:
213 -B --normal
215 allow implicit format conversions (default)
216 +B --bit-preserving
218 write data exactly as read
219 output file format:
221 +F --write-file
223 write file format (default)
224 -F --write-dataset
226 write data set without file meta information
227 output transfer syntax
229 (not with --bit-preserving or compressed transmission):
230 +t= --write-xfer-same
232 write with same TS as input (default)
233 +te --write-xfer-little
235 write with explicit VR little endian TS
236 +tb --write-xfer-big
238 write with explicit VR big endian TS
239 +ti --write-xfer-implicit
241 write with implicit VR little endian TS
242 +td --write-xfer-deflated
244 write with deflated explicit VR little endian TS
245 post-1993 value representations (not with --bit-preserving):
247 +u --enable-new-vr
249 enable support for new VRs (UN/UT) (default)
250 -u --disable-new-vr
252 disable support for new VRs, convert to OB
253 group length encoding (not with --bit-preserving):
255 +g= --group-length-recalc
257 recalculate group lengths if present (default)
258 +g --group-length-create
260 always write with group length elements
261 -g --group-length-remove
263 always write without group length elements
264 length encoding in sequences and items (not with --bit-preserving):
266 +e --length-explicit
268 write with explicit lengths (default)
269 -e --length-undefined
271 write with undefined lengths
272 data set trailing padding
274 (not with --write-dataset or --bit-preserving):
275 -p --padding-off
277 no padding (default)
278 +p --padding-create [f]ile-pad [i]tem-pad: integer
280 align file on multiple of f bytes and items on
281 multiple of i bytes
282 deflate compression level (only with --write-xfer-deflated/same):
284 +cl --compression-level [l]evel: integer (default: 6)
286 0=uncompressed, 1=fastest, 9=best compression
287
289 Each file supplied on the command line will be sent to the SCP as part
290 of a C-MOVE request. The query file must be a valid DICOM data set
291 containing the dataset part of a C-MOVE-RQ message. The query file
292 could, for instance, be created with the dump2dcm utility from a script
293 like the following example:
294 # request all images for the patient with ID=PAT001
296 (0008,0052) CS [PATIENT] # QueryRetrieveLevel
297 (0010,0020) LO [PAT001] # PatientID
298 Individual attributes of each file sent can be modified or supplemented
300 using the '-k key' option. For example the command:
301 movescu -k 0010,0020=PAT002 caesar 5678 patqry.dcm
303 will, when sent to the SCP caesar at TCP/IP port 5678, cause any
305 PatientID attribute in patqry.dcm to have the value 'PAT002'. If such
306 an attribute is present it will be replaced, if absent it will be
307 inserted. The -k option can be present more than once. The value part
308 (after the '=') may be absent causing the attribute to be sent with
309 zero length. It is not possible to replace or insert attributes within
310 sequences using the -k option.
311 If no file is specified on the command line, the query must be
313 specified completely with one or more '-k key' options.
314 For all uses of movescu, the SCP must be configured to 'know' about the
316 AE title where the images are to be transmitted. This is required since
317 the C-MOVE request only contains the AE Title of the target and the SCP
318 must be able to convert this AE Title into TCP/IP address and port
319 number in order to actually send the images over a separate
320 association.
321 The C-MOVE operation of the Query/Retrieve Service Class is able
323 retrieve images or to initiate a copy of images to a third party.
324 Known Problems
326 movescu is intended to be used as a testing tool for DICOM software
327 developers. The query keys file must be created by hand based upon the
328 contents of the SCP.
329 Even when using a third-party move it may be necessary to set the
331 TCP/IP port number to a reasonable value (via the --port option). Per
332 default, port number 104 is used which is a restricted port on many
333 systems. movescu always tries to listen for incoming associations.
334 The movescu application makes no attempt to prevent incorrect queries.
336 In particular, the query keys of a C-MOVE request should only contain
337 the QueryRetrieveLevel attribute and one or more of the so-called
338 'unique key attributes' (PatientID, StudyInstanceUID, SeriesInstanceUID
339 and SOPInstanceUID).
340 DICOM Conformance
342 SCU Conformance
343 The movescu application supports the following SOP Classes as an SCU:
344 MOVEPatientRootQueryRetrieveInformationModel 1.2.840.10008.5.1.4.1.2.1.2
346 MOVEStudyRootQueryRetrieveInformationModel 1.2.840.10008.5.1.4.1.2.2.2
347 MOVEPatientStudyOnlyQueryRetrieveInformationModel 1.2.840.10008.5.1.4.1.2.3.2
348 The movescu application will propose presentation contexts for one of
350 the abovementioned supported SOP Classes depending on command line
351 options (-P, -S, or -O). Each proposed presentation context will
352 propose the transfer syntaxes:
353 LittleEndianImplicitTransferSyntax 1.2.840.10008.1.2
355 LittleEndianExplicitTransferSyntax 1.2.840.10008.1.2.1
356 BigEndianExplicitTransferSyntax 1.2.840.10008.1.2.2
357 This behaviour can be changed with the --propose options.
359 SCP Conformance
361 The movescu application supports the following SOP Classes as an SCP:
362 VerificationSOPClass 1.2.840.10008.1.1
364 RETIRED_StoredPrintStorage 1.2.840.10008.5.1.1.27
366 RETIRED_HardcopyGrayscaleImageStorage 1.2.840.10008.5.1.1.29
367 RETIRED_HardcopyColorImageStorage 1.2.840.10008.5.1.1.30
368 ComputedRadiographyImageStorage 1.2.840.10008.5.1.4.1.1.1
369 DigitalXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.1.1
370 DigitalXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.1.1.1
371 DigitalMammographyXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.1.2
372 DigitalMammographyXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.1.2.1
373 DigitalIntraOralXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.1.3
374 DigitalIntraOralXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.1.3.1
375 CTImageStorage 1.2.840.10008.5.1.4.1.1.2
376 EnhancedCTImageStorage 1.2.840.10008.5.1.4.1.1.2.1
377 RETIRED_UltrasoundMultiframeImageStorage 1.2.840.10008.5.1.4.1.1.3
378 UltrasoundMultiframeImageStorage 1.2.840.10008.5.1.4.1.1.3.1
379 MRImageStorage 1.2.840.10008.5.1.4.1.1.4
380 EnhancedMRImageStorage 1.2.840.10008.5.1.4.1.1.4.1
381 MRSpectroscopyStorage 1.2.840.10008.5.1.4.1.1.4.2
382 EnhancedMRColorImageStorage 1.2.840.10008.5.1.4.1.1.4.3
383 RETIRED_NuclearMedicineImageStorage 1.2.840.10008.5.1.4.1.1.5
384 RETIRED_UltrasoundImageStorage 1.2.840.10008.5.1.4.1.1.6
385 UltrasoundImageStorage 1.2.840.10008.5.1.4.1.1.6.1
386 EnhancedUSVolumeStorage 1.2.840.10008.5.1.4.1.1.6.2
387 SecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7
388 MultiframeSingleBitSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.1
389 MultiframeGrayscaleByteSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.2
390 MultiframeGrayscaleWordSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.3
391 MultiframeTrueColorSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.4
392 RETIRED_StandaloneOverlayStorage 1.2.840.10008.5.1.4.1.1.8
393 RETIRED_StandaloneCurveStorage 1.2.840.10008.5.1.4.1.1.9
394 DRAFT_WaveformStorage 1.2.840.10008.5.1.4.1.1.9.1
395 TwelveLeadECGWaveformStorage 1.2.840.10008.5.1.4.1.1.9.1.1
396 GeneralECGWaveformStorage 1.2.840.10008.5.1.4.1.1.9.1.2
397 AmbulatoryECGWaveformStorage 1.2.840.10008.5.1.4.1.1.9.1.3
398 HemodynamicWaveformStorage 1.2.840.10008.5.1.4.1.1.9.2.1
399 CardiacElectrophysiologyWaveformStorage 1.2.840.10008.5.1.4.1.1.9.3.1
400 BasicVoiceAudioWaveformStorage 1.2.840.10008.5.1.4.1.1.9.4.1
401 GeneralAudioWaveformStorage 1.2.840.10008.5.1.4.1.1.9.4.2
402 ArterialPulseWaveformStorage 1.2.840.10008.5.1.4.1.1.9.5.1
403 RespiratoryWaveformStorage 1.2.840.10008.5.1.4.1.1.9.6.1
404 RETIRED_StandaloneModalityLUTStorage 1.2.840.10008.5.1.4.1.1.10
405 RETIRED_StandaloneVOILUTStorage 1.2.840.10008.5.1.4.1.1.11
406 GrayscaleSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.1
407 ColorSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.2
408 PseudoColorSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.3
409 BlendingSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.4
410 XAXRFGrayscaleSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.5
411 XRayAngiographicImageStorage 1.2.840.10008.5.1.4.1.1.12.1
412 EnhancedXAImageStorage 1.2.840.10008.5.1.4.1.1.12.1.1
413 XRayRadiofluoroscopicImageStorage 1.2.840.10008.5.1.4.1.1.12.2
414 EnhancedXRFImageStorage 1.2.840.10008.5.1.4.1.1.12.2.1
415 XRay3DAngiographicImageStorage 1.2.840.10008.5.1.4.1.1.13.1.1
416 XRay3DCraniofacialImageStorage 1.2.840.10008.5.1.4.1.1.13.1.2
417 BreastTomosynthesisImageStorage 1.2.840.10008.5.1.4.1.1.13.1.3
418 RETIRED_XRayAngiographicBiPlaneImageStorage 1.2.840.10008.5.1.4.1.1.12.3
419 NuclearMedicineImageStorage 1.2.840.10008.5.1.4.1.1.20
420 RawDataStorage 1.2.840.10008.5.1.4.1.1.66
421 SpatialRegistrationStorage 1.2.840.10008.5.1.4.1.1.66.1
422 SpatialFiducialsStorage 1.2.840.10008.5.1.4.1.1.66.2
423 DeformableSpatialRegistrationStorage 1.2.840.10008.5.1.4.1.1.66.3
424 SegmentationStorage 1.2.840.10008.5.1.4.1.1.66.4
425 SurfaceSegmentationStorage 1.2.840.10008.5.1.4.1.1.66.5
426 RealWorldValueMappingStorage 1.2.840.10008.5.1.4.1.1.67
427 RETIRED_VLImageStorage 1.2.840.10008.5.1.4.1.1.77.1
428 VLEndoscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.1
429 VideoEndoscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.1.1
430 VLMicroscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.2
431 VideoMicroscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.2.1
432 VLSlideCoordinatesMicroscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.3
433 VLPhotographicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.4
434 VideoPhotographicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.4.1
435 OphthalmicPhotography8BitImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.1
436 OphthalmicPhotography16BitImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.2
437 StereometricRelationshipStorage 1.2.840.10008.5.1.4.1.1.77.1.5.3
438 OphthalmicTomographyImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.4
439 VLWholeSlideMicroscopyImageStorage 1.2.840.10008.5.1.4.1.1.77.1.6
440 RETIRED_VLMultiFrameImageStorage 1.2.840.10008.5.1.4.1.1.77.2
441 LensometryMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.1
442 AutorefractionMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.2
443 KeratometryMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.3
444 SubjectiveRefractionMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.4
445 VisualAcuityMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.5
446 SpectaclePrescriptionReportStorage 1.2.840.10008.5.1.4.1.1.78.6
447 OphthalmicAxialMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.7
448 IntraocularLensCalculationsStorage 1.2.840.10008.5.1.4.1.1.78.8
449 MacularGridThicknessAndVolumeReportStorage 1.2.840.10008.5.1.4.1.1.79.1
450 OphthalmicVisualFieldStaticPerimetryMeasurementsSt. 1.2.840.10008.5.1.4.1.1.80.1
451 DRAFT_SRTextStorage 1.2.840.10008.5.1.4.1.1.88.1
452 DRAFT_SRAudioStorage 1.2.840.10008.5.1.4.1.1.88.2
453 DRAFT_SRDetailStorage 1.2.840.10008.5.1.4.1.1.88.3
454 DRAFT_SRComprehensiveStorage 1.2.840.10008.5.1.4.1.1.88.4
455 BasicTextSRStorage 1.2.840.10008.5.1.4.1.1.88.11
456 EnhancedSRStorage 1.2.840.10008.5.1.4.1.1.88.22
457 ComprehensiveSRStorage 1.2.840.10008.5.1.4.1.1.88.33
458 ProcedureLogStorage 1.2.840.10008.5.1.4.1.1.88.40
459 MammographyCADSRStorage 1.2.840.10008.5.1.4.1.1.88.50
460 KeyObjectSelectionDocumentStorage 1.2.840.10008.5.1.4.1.1.88.59
461 ChestCADSRStorage 1.2.840.10008.5.1.4.1.1.88.65
462 XRayRadiationDoseSRStorage 1.2.840.10008.5.1.4.1.1.88.67
463 ColonCADSRStorage 1.2.840.10008.5.1.4.1.1.88.69
464 ImplantationPlanSRDocumentStorage 1.2.840.10008.5.1.4.1.1.88.70
465 EncapsulatedPDFStorage 1.2.840.10008.5.1.4.1.1.104.1
466 EncapsulatedCDAStorage 1.2.840.10008.5.1.4.1.1.104.2
467 PositronEmissionTomographyImageStorage 1.2.840.10008.5.1.4.1.1.128
468 RETIRED_StandalonePETCurveStorage 1.2.840.10008.5.1.4.1.1.129
469 EnhancedPETImageStorage 1.2.840.10008.5.1.4.1.1.130
470 BasicStructuredDisplayStorage 1.2.840.10008.5.1.4.1.1.131
471 RTImageStorage 1.2.840.10008.5.1.4.1.1.481.1
472 RTDoseStorage 1.2.840.10008.5.1.4.1.1.481.2
473 RTStructureSetStorage 1.2.840.10008.5.1.4.1.1.481.3
474 RTBeamsTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.4
475 RTPlanStorage 1.2.840.10008.5.1.4.1.1.481.5
476 RTBrachyTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.6
477 RTTreatmentSummaryRecordStorage 1.2.840.10008.5.1.4.1.1.481.7
478 RTIonPlanStorage 1.2.840.10008.5.1.4.1.1.481.8
479 RTIonBeamsTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.9
480 DRAFT_RTBeamsDeliveryInstructionStorage 1.2.840.10008.5.1.4.34.1
481 GenericImplantTemplateStorage 1.2.840.10008.5.1.4.43.1
482 ImplantAssemblyTemplateStorage 1.2.840.10008.5.1.4.44.1
483 ImplantTemplateGroupStorage 1.2.840.10008.5.1.4.45.1
484 The movescu application will accept presentation contexts for all of
486 the abovementioned supported SOP Classes using any of the transfer
487 syntaxes:
488 LittleEndianImplicitTransferSyntax 1.2.840.10008.1.2
490 LittleEndianExplicitTransferSyntax 1.2.840.10008.1.2.1
491 BigEndianExplicitTransferSyntax 1.2.840.10008.1.2.2
492 When acting as an SCP, the movescu application will prefer transfer
494 syntaxes having an explicit encoding over the default implicit transfer
495 syntax. If movescu is running on big-endian hardware it will prefer
496 BigEndianExplicit to LittleEndianExplicit transfer syntax (and vice
497 versa). This behaviour can be changed with the --prefer options (see
498 above). Using option --accept-all any of the following transfer
499 syntaxes is supported:
500 LittleEndianImplicitTransferSyntax 1.2.840.10008.1.2
502 LittleEndianExplicitTransferSyntax 1.2.840.10008.1.2.1
503 DeflatedExplicitVRLittleEndianTransferSyntax 1.2.840.10008.1.2.1.99
504 BigEndianExplicitTransferSyntax 1.2.840.10008.1.2.2
505 JPEGProcess1TransferSyntax 1.2.840.10008.1.2.4.50
506 JPEGProcess2_4TransferSyntax 1.2.840.10008.1.2.4.51
507 JPEGProcess14SV1TransferSyntax 1.2.840.10008.1.2.4.70
508 JPEGLSLosslessTransferSyntax 1.2.840.10008.1.2.4.80
509 JPEGLSLossyTransferSyntax 1.2.840.10008.1.2.4.81
510 JPEG2000LosslessOnlyTransferSyntax 1.2.840.10008.1.2.4.90
511 JPEG2000TransferSyntax 1.2.840.10008.1.2.4.91
512 MPEG2MainProfileAtMainLevelTransferSyntax 1.2.840.10008.1.2.4.100
513 MPEG2MainProfileAtHighLevelTransferSyntax 1.2.840.10008.1.2.4.101
514 RLELosslessTransferSyntax 1.2.840.10008.1.2.5
515 The movescu application does not support extended negotiation.
517 Access Control
519 When compiled on Unix platforms with TCP wrapper support, host-based
520 access control can be enabled with the --access-control command line
521 option. In this case the access control rules defined in the system's
522 host access control tables for movescu are enforced. The default
523 locations of the host access control tables are /etc/hosts.allow and
524 /etc/hosts.deny. Further details are described in hosts_access(5).
525
527 movescu --patient --port 9876 --move TEST_AE --call ARCHIVE caesar 104 q.dcm
528 sends the attributes contained in the DICOM file 'q.dcm' as part of a
530 C-MOVE request to application entity ARCHIVE on the host caesar at port
531 104 using the Patient Root query model. movescu itself uses the default
532 AE title MOVESCU. The C-MOVE request will specifiy that images should
533 be transferred to the destination AE title TEST_AE (via the --move
534 option). How the SCP interprets this request depends on its
535 configuration. movescu will listen on part 9876 for incoming
536 associations in order to receive the requested images from the SCP.
537 Images can be copied to a third party by using a different destination
539 AE title (e.g. --move ANOTHER_AE). Of course, the SCP must 'know' this
540 AE title and the destination must be acting as an SCP of the Storage
541 Service Class (the storescp application can be used for this purpose).
542
544 The level of logging output of the various command line tools and
545 underlying libraries can be specified by the user. By default, only
546 errors and warnings are written to the standard error stream. Using
547 option --verbose also informational messages like processing details
548 are reported. Option --debug can be used to get more details on the
549 internal activity, e.g. for debugging purposes. Other logging levels
550 can be selected using option --log-level. In --quiet mode only fatal
551 errors are reported. In such very severe error events, the application
552 will usually terminate. For more details on the different logging
553 levels, see documentation of module 'oflog'.
554 In case the logging output should be written to file (optionally with
556 logfile rotation), to syslog (Unix) or the event log (Windows) option
557 --log-config can be used. This configuration file also allows for
558 directing only certain messages to a particular output stream and for
559 filtering certain messages based on the module or application where
560 they are generated. An example configuration file is provided in
561 <etcdir>/logger.cfg).
562
564 All command line tools use the following notation for parameters:
565 square brackets enclose optional values (0-1), three trailing dots
566 indicate that multiple values are allowed (1-n), a combination of both
567 means 0 to n values.
568 Command line options are distinguished from parameters by a leading '+'
570 or '-' sign, respectively. Usually, order and position of command line
571 options are arbitrary (i.e. they can appear anywhere). However, if
572 options are mutually exclusive the rightmost appearance is used. This
573 behaviour conforms to the standard evaluation rules of common Unix
574 shells.
575 In addition, one or more command files can be specified using an '@'
577 sign as a prefix to the filename (e.g. @command.txt). Such a command
578 argument is replaced by the content of the corresponding text file
579 (multiple whitespaces are treated as a single separator unless they
580 appear between two quotation marks) prior to any further evaluation.
581 Please note that a command file cannot contain another command file.
582 This simple but effective approach allows to summarize common
583 combinations of options/parameters and avoids longish and confusing
584 command lines (an example is provided in file <datadir>/dumppat.txt).
585
587 The movescu utility will attempt to load DICOM data dictionaries
588 specified in the DCMDICTPATH environment variable. By default, i.e. if
589 the DCMDICTPATH environment variable is not set, the file
590 <datadir>/dicom.dic will be loaded unless the dictionary is built into
591 the application (default for Windows).
592 The default behaviour should be preferred and the DCMDICTPATH
594 environment variable only used when alternative data dictionaries are
595 required. The DCMDICTPATH environment variable has the same format as
596 the Unix shell PATH variable in that a colon (':') separates entries.
597 On Windows systems, a semicolon (';') is used as a separator. The data
598 dictionary code will attempt to load each file specified in the
599 DCMDICTPATH environment variable. It is an error if no data dictionary
600 can be loaded.
601
603 findscu(1), dump2dcm(1)
604
606 Copyright (C) 1994-2010 by OFFIS e.V., Escherweg 2, 26121 Oldenburg,
607 Germany.
608Version 3.6.0 6 Jan 2011 movescu(1)