OFFIS DCMTK  Version 3.6.0
movescu.man
1 /*!
2 
3 \if MANPAGES
4 \page movescu DICOM retrieve (C-MOVE) SCU
5 \else
6 \page movescu movescu: DICOM retrieve (C-MOVE) SCU
7 \endif
8 
9 \section synopsis SYNOPSIS
10 
11 \verbatim
12 movescu [options] peer port [dcmfile-in...]
13 \endverbatim
14 
15 \section description DESCRIPTION
16 
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
26 SCP).
27 
28 \section parameters PARAMETERS
29 
30 \verbatim
31 peer hostname of DICOM peer
32 
33 port tcp/ip port number of peer
34 
35 dcmfile-in DICOM query file(s)
36 \endverbatim
37 
38 \section options OPTIONS
39 
40 \subsection general_options general options
41 \verbatim
42  -h --help
43  print this help text and exit
44 
45  --version
46  print version information and exit
47 
48  --arguments
49  print expanded command line arguments
50 
51  -q --quiet
52  quiet mode, print no warnings and errors
53 
54  -v --verbose
55  verbose mode, print processing details
56 
57  -d --debug
58  debug mode, print debug information
59 
60  -ll --log-level [l]evel: string constant
61  (fatal, error, warn, info, debug, trace)
62  use level l for the logger
63 
64  -lc --log-config [f]ilename: string
65  use config file f for the logger
66 \endverbatim
67 
68 \subsection network_options network options
69 \verbatim
70 override matching keys:
71 
72  -k --key [k]ey: gggg,eeee="str" or dictionary name="str"
73  override matching key
74 
75 query information model:
76 
77  -P --patient
78  use patient root information model (default)
79 
80  -S --study
81  use study root information model
82 
83  -O --psonly
84  use patient/study only information model
85 
86 application entity titles:
87 
88  -aet --aetitle [a]etitle: string
89  set my calling AE title (default: MOVESCU)
90 
91  -aec --call [a]etitle: string
92  set called AE title of peer (default: ANY-SCP)
93 
94  -aem --move [a]etitle: string
95  set move destination AE title (default: MOVESCU)
96 
97 preferred network transfer syntaxes (incoming associations):
98 
99  +x= --prefer-uncompr
100  prefer explicit VR local byte order (default)
101 
102  +xe --prefer-little
103  prefer explicit VR little endian TS
104 
105  +xb --prefer-big
106  prefer explicit VR big endian TS
107 
108  +xs --prefer-lossless
109  prefer default JPEG lossless TS
110 
111  +xy --prefer-jpeg8
112  prefer default JPEG lossy TS for 8 bit data
113 
114  +xx --prefer-jpeg12
115  prefer default JPEG lossy TS for 12 bit data
116 
117  +xv --prefer-j2k-lossless
118  prefer JPEG 2000 lossless TS
119 
120  +xw --prefer-j2k-lossy
121  prefer JPEG 2000 lossy TS
122 
123  +xt --prefer-jls-lossless
124  prefer JPEG-LS lossless TS
125 
126  +xu --prefer-jls-lossy
127  prefer JPEG-LS lossy TS
128 
129  +xm --prefer-mpeg2
130  prefer MPEG2 Main Profile @ Main Level TS
131 
132  +xh --prefer-mpeg2-high
133  prefer MPEG2 Main Profile @ High Level TS
134 
135  +xr --prefer-rle
136  prefer RLE lossless TS
137 
138  +xd --prefer-deflated
139  prefer deflated explicit VR little endian TS
140 
141  +xi --implicit
142  accept implicit VR little endian TS only
143 
144  +xa --accept-all
145  accept all supported transfer syntaxes
146 
147 proposed transmission transfer syntaxes (outgoing associations):
148 
149  -x= --propose-uncompr
150  propose all uncompressed TS, explicit VR
151  with local byte ordering first (default)
152 
153  -xe --propose-little
154  propose all uncompressed TS, explicit VR little endian first
155 
156  -xb --propose-big
157  propose all uncompressed TS, explicit VR big endian first
158 
159  -xi --propose-implicit
160  propose implicit VR little endian TS only
161 
162 network host access control (tcp wrapper):
163 
164  -ac --access-full
165  accept connections from any host (default)
166 
167  +ac --access-control
168  enforce host access control rules
169 
170 port for incoming network associations:
171 
172  --no-port
173  no port for incoming associations (default)
174 
175  +P --port [n]umber: integer
176  port number for incoming associations
177 
178 handling of illegal datasets following 'pending' move responses:
179 
180  -pi --pending-ignore
181  assume no dataset present (default)
182 
183  -pr --pending-read
184  read and ignore dataset
185 
186 other network options:
187 
188  -to --timeout [s]econds: integer (default: unlimited)
189  timeout for connection requests
190 
191  -ta --acse-timeout [s]econds: integer (default: 30)
192  timeout for ACSE messages
193 
194  -td --dimse-timeout [s]econds: integer (default: unlimited)
195  timeout for DIMSE messages
196 
197  -pdu --max-pdu [n]umber of bytes: integer (4096..131072)
198  set max receive pdu to n bytes (default: 16384)
199 
200  -dhl --disable-host-lookup
201  disable hostname lookup
202 
203  --repeat [n]umber: integer
204  repeat n times
205 
206  --abort
207  abort association instead of releasing it
208 
209  --ignore
210  ignore store data, receive but do not store
211 
212  --cancel [n]umber: integer
213  cancel after n responses (default: never)
214 
215  -up --uid-padding
216  silently correct space-padded UIDs
217 \endverbatim
218 
219 \subsection output_options output options
220 \verbatim
221 general:
222 
223  -od --output-directory [d]irectory: string (default: ".")
224  write received objects to existing directory d
225 
226 bit preserving mode:
227 
228  -B --normal
229  allow implicit format conversions (default)
230 
231  +B --bit-preserving
232  write data exactly as read
233 
234 output file format:
235 
236  +F --write-file
237  write file format (default)
238 
239  -F --write-dataset
240  write data set without file meta information
241 
242 output transfer syntax
243 (not with --bit-preserving or compressed transmission):
244 
245  +t= --write-xfer-same
246  write with same TS as input (default)
247 
248  +te --write-xfer-little
249  write with explicit VR little endian TS
250 
251  +tb --write-xfer-big
252  write with explicit VR big endian TS
253 
254  +ti --write-xfer-implicit
255  write with implicit VR little endian TS
256 
257  +td --write-xfer-deflated
258  write with deflated explicit VR little endian TS
259 
260 post-1993 value representations (not with --bit-preserving):
261 
262  +u --enable-new-vr
263  enable support for new VRs (UN/UT) (default)
264 
265  -u --disable-new-vr
266  disable support for new VRs, convert to OB
267 
268 group length encoding (not with --bit-preserving):
269 
270  +g= --group-length-recalc
271  recalculate group lengths if present (default)
272 
273  +g --group-length-create
274  always write with group length elements
275 
276  -g --group-length-remove
277  always write without group length elements
278 
279 length encoding in sequences and items (not with --bit-preserving):
280 
281  +e --length-explicit
282  write with explicit lengths (default)
283 
284  -e --length-undefined
285  write with undefined lengths
286 
287 data set trailing padding
288 (not with --write-dataset or --bit-preserving):
289 
290  -p --padding-off
291  no padding (default)
292 
293  +p --padding-create [f]ile-pad [i]tem-pad: integer
294  align file on multiple of f bytes and items on
295  multiple of i bytes
296 
297 deflate compression level (only with --write-xfer-deflated/same):
298 
299  +cl --compression-level [l]evel: integer (default: 6)
300  0=uncompressed, 1=fastest, 9=best compression
301 \endverbatim
302 
303 \section notes NOTES
304 
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
309 example:
310 
311 \verbatim
312 # request all images for the patient with ID=PAT001
313 (0008,0052) CS [PATIENT] # QueryRetrieveLevel
314 (0010,0020) LO [PAT001] # PatientID
315 \endverbatim
316 
317 Individual attributes of each file sent can be modified or supplemented
318 using the "-k key" option. For example the command:
319 
320 \verbatim
321 movescu -k 0010,0020=PAT002 caesar 5678 patqry.dcm
322 \endverbatim
323 
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.
330 
331 If no file is specified on the command line, the query must be specified
332 completely with one or more "-k key" options.
333 
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.
339 
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.
342 
343 \subsection known_problems Known Problems
344 
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
347 contents of the SCP.
348 
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.
353 
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
358 SOPInstanceUID).
359 
360 \subsection dicom_conformance DICOM Conformance
361 
362 \subsubsection scu_conformance SCU Conformance
363 
364 The \b movescu application supports the following SOP Classes as an SCU:
365 
366 \verbatim
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
370 \endverbatim
371 
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
375 syntaxes:
376 
377 \verbatim
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
381 \endverbatim
382 
383 This behaviour can be changed with the \e --propose options.
384 
385 \subsubsection scp_conformance SCP Conformance
386 
387 The \b movescu application supports the following SOP Classes as an SCP:
388 
389 \verbatim
390 VerificationSOPClass 1.2.840.10008.1.1
391 
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
511 \endverbatim
512 
513 The \b movescu application will accept presentation contexts for all of the
514 abovementioned supported SOP Classes using any of the transfer syntaxes:
515 
516 \verbatim
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
520 \endverbatim
521 
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:
528 
529 \verbatim
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
544 \endverbatim
545 
546 The \b movescu application does not support extended negotiation.
547 
548 \subsection access_control Access Control
549 
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).
556 
557 \section examples EXAMPLES
558 
559 \verbatim
560 movescu --patient --port 9876 --move TEST_AE --call ARCHIVE caesar 104 q.dcm
561 \endverbatim
562 
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
570 from the SCP.
571 
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).
576 
577 \section logging LOGGING
578 
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".
588 
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>).
595 
596 \section command_line COMMAND LINE
597 
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.
601 
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.
607 
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>).
617 
618 \section environment ENVIRONMENT
619 
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).
625 
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.
633 
634 \section see_also SEE ALSO
635 
636 <b>findscu</b>(1), <b>dump2dcm</b>(1)
637 
638 \section copyright COPYRIGHT
639 
640 Copyright (C) 1994-2010 by OFFIS e.V., Escherweg 2, 26121 Oldenburg, Germany.
641 
642 */


Generated on Thu Aug 27 2015 for OFFIS DCMTK Version 3.6.0 by Doxygen 1.8.9.1