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