1getscu(1) OFFIS DCMTK getscu(1)
2
6 getscu - DICOM retrieve (C-GET) SCU
7
10 getscu [options] peer port [dcmfile-in...]
11
13 The getscu application implements an SCU for the Query/Retrieve Service
14 Class. getscu supports retrieve functionality using the C-GET message.
15 It sends query keys to an SCP and waits for responses with images or
16 other DICOM objects sent via C-STORE. As the DICOM service demands, C-
17 GET and the accompanying C-STORE messages are handled on the same
18 association. Therefore, objects can only be received by getscu itself
19 and cannot be sent to a third party (movescu would be the right tool
20 for this task).
21
23 peer hostname of DICOM peer
24 port tcp/ip port number of peer
26 dcmfile-in DICOM query file(s)
28
30 general options
31 -h --help
32 print this help text and exit
33 --version
35 print version information and exit
36 --arguments
38 print expanded command line arguments
39 -q --quiet
41 quiet mode, print no warnings and errors
42 -v --verbose
44 verbose mode, print processing details
45 -d --debug
47 debug mode, print debug information
48 -ll --log-level [l]evel: string constant
50 (fatal, error, warn, info, debug, trace)
51 use level l for the logger
52 -lc --log-config [f]ilename: string
54 use config file f for the logger
55 +v --verbose-pc
57 show presentation contexts in verbose mode
58 network options
60 override matching keys:
61 -k --key [k]ey: gggg,eeee="str", path or dictionary name="str"
63 override matching key
64 query information model:
66 -P --patient
68 use patient root information model (default)
69 -S --study
71 use study root information model
72 -O --psonly
74 use patient/study only information model
75 application entity titles:
77 -aet --aetitle [a]etitle: string
79 set my calling AE title (default: GETSCU)
80 -aec --call [a]etitle: string
82 set called AE title of peer (default: ANY-SCP)
83 preferred storage transfer syntaxes (incoming associations):
85 +x= --prefer-uncompr
87 prefer explicit VR local byte order (default)
88 +xe --prefer-little
90 prefer explicit VR little endian TS
91 +xb --prefer-big
93 prefer explicit VR big endian TS
94 +xs --prefer-lossless
96 prefer default JPEG lossless TS
97 +xy --prefer-jpeg8
99 prefer default JPEG lossy TS for 8 bit data
100 +xx --prefer-jpeg12
102 prefer default JPEG lossy TS for 12 bit data
103 +xv --prefer-j2k-lossless
105 prefer JPEG 2000 lossless TS
106 +xw --prefer-j2k-lossy
108 prefer JPEG 2000 lossy TS
109 +xt --prefer-jls-lossless
111 prefer JPEG-LS lossless TS
112 +xu --prefer-jls-lossy
114 prefer JPEG-LS lossy TS
115 +xm --prefer-mpeg2
117 prefer MPEG2 Main Profile @ Main Level TS
118 +xh --prefer-mpeg2-high
120 prefer MPEG2 Main Profile @ High Level TS
121 +xn --prefer-mpeg4
123 prefer MPEG4 AVC/H.264 HP / Level 4.1 TS
124 +xl --prefer-mpeg4-bd
126 prefer MPEG4 AVC/H.264 BD-compatible HP / Level 4.1 TS
127 +x2 --prefer-mpeg4-2-2d
129 prefer MPEG4 AVC/H.264 HP / Level 4.2 TS for 2D Videos
130 +x3 --prefer-mpeg4-2-3d
132 prefer MPEG4 AVC/H.264 HP / Level 4.2 TS for 3D Videos
133 +xo --prefer-mpeg4-2-st
135 prefer MPEG4 AVC/H.264 Stereo HP / Level 4.2 TS
136 +x4 --prefer-hevc
138 prefer HEVC H.265 Main Profile / Level 5.1 TS
139 +x5 --prefer-hevc10
141 prefer HEVC H.265 Main 10 Profile / Level 5.1 TS
142 +xr --prefer-rle
144 prefer RLE lossless TS
145 +xd --prefer-deflated
147 prefer deflated explicit VR little endian TS
148 +xi --implicit
150 accept implicit VR little endian TS only
151 proposed retrieve transfer syntaxes (outgoing associations):
153 -x= --propose-uncompr
155 propose all uncompressed TS, explicit VR
156 with local byte ordering first (default)
157 -xe --propose-little
159 propose all uncompressed TS, explicit VR little endian first
160 -xb --propose-big
162 propose all uncompressed TS, explicit VR big endian first
163 -xd --propose-deflated
165 propose deflated explicit VR little endian TS
166 and all uncompressed transfer syntaxes
167 -xi --propose-implicit
169 propose implicit VR little endian TS only
170 other network options:
172 -to --timeout [s]econds: integer (default: unlimited)
174 timeout for connection requests
175 -ta --acse-timeout [s]econds: integer (default: 30)
177 timeout for ACSE messages
178 -td --dimse-timeout [s]econds: integer (default: unlimited)
180 timeout for DIMSE messages
181 -pdu --max-pdu [n]umber of bytes: integer (4096..131072)
183 set max receive pdu to n bytes (default: 16384)
184 --repeat [n]umber: integer
186 repeat n times
187 --abort
189 abort association instead of releasing it
190 output options
192 general:
193 -od --output-directory [d]irectory: string (default: ".")
195 write received objects to existing directory d
196 storage mode:
198 -B --normal
200 receive in memory, then write to disk (default)
201 +B --bit-preserving
203 receive directly to disk
204 --ignore
206 ignore store data, receive but do not store
207
209 Each file supplied on the command line will be sent to the SCP as part
210 of a C-GET request. The query file must be a valid DICOM data set
211 containing the dataset part of a C-GET-RQ message. The query file
212 could, for instance, be created with the dump2dcm utility from a script
213 like the following example:
214 # request all images for the patient with ID=PAT001
216 (0008,0052) CS [PATIENT] # QueryRetrieveLevel
217 (0010,0020) LO [PAT001] # PatientID
218 Another possibility is to use the dcmodify tool to create a file from
220 scratch using the option --create-file with successive calls to the
221 --insert option. Individual attributes can be modified or supplemented
222 using the -k (or --key) option. For example the command:
223 getscu -k "0010,0020=PAT002" caesar 5678 patqry.dcm
225 will, when sent to the SCP caesar at TCP/IP port 5678, cause any
227 PatientID attribute in patqry.dcm to have the value 'PAT002'. If such
228 an attribute is present it will be replaced, if absent it will be
229 inserted. The -k option can be present more than once. The value part
230 (after the '=') may be absent causing the attribute to be sent with
231 zero length. It is also possible to specify sequences, items and nested
232 attributes using the -k option. In these cases, a special 'path'
233 notation has to be used. Details can be found in the dcmodify
234 documentation.
235 If no file is specified on the command line, the query must be
237 specified completely with one or more -k options. If multiple query
238 files are provided, getscu will send multiple C-GET requests to the
239 SCP.
240 Known Problems
242 getscu is intended to be used as a testing tool for DICOM software
243 developers. The query keys file must be created by hand based upon the
244 contents of the SCP.
245 C-GET is not supported by all Query/Retrieve SCPs. The C-MOVE protocol
247 which is implemented by the movescu tool is more commonly found in
248 practice.
249 The getscu application makes no attempt to prevent incorrect queries.
251 In particular, the query keys of a C-MOVE request should only contain
252 the QueryRetrieveLevel attribute and one or more of the so-called
253 'unique key attributes' (PatientID, StudyInstanceUID, SeriesInstanceUID
254 and SOPInstanceUID).
255 DICOM Conformance
257 SCU Conformance
258 The getscu application supports the following SOP Classes as an SCU:
259 GETPatientRootQueryRetrieveInformationModel 1.2.840.10008.5.1.4.1.2.1.3
261 GETStudyRootQueryRetrieveInformationModel 1.2.840.10008.5.1.4.1.2.2.3
262 GETPatientStudyOnlyQueryRetrieveInformationModel 1.2.840.10008.5.1.4.1.2.3.3
263 The getscu application will propose presentation contexts for one of
265 the abovementioned supported SOP Classes depending on command line
266 options (-P, -S, or -O). For outgoing associations, the following
267 transfer syntaxes are supported:
268 LittleEndianImplicitTransferSyntax 1.2.840.10008.1.2
270 LittleEndianExplicitTransferSyntax 1.2.840.10008.1.2.1
271 DeflatedExplicitVRLittleEndianTransferSyntax 1.2.840.10008.1.2.1.99 (*)
272 BigEndianExplicitTransferSyntax 1.2.840.10008.1.2.2
273 (*) if compiled with zlib support enabled (see --version output)
275 Which transfer syntaxes are actually proposed in what order, can be
277 specified with the --propose options.
278 Storage Conformance
280 The getscu application supports the following SOP Classes as an SCP:
281 VerificationSOPClass 1.2.840.10008.1.1
283 RETIRED_StoredPrintStorage 1.2.840.10008.5.1.1.27
285 RETIRED_HardcopyGrayscaleImageStorage 1.2.840.10008.5.1.1.29
286 RETIRED_HardcopyColorImageStorage 1.2.840.10008.5.1.1.30
287 ComputedRadiographyImageStorage 1.2.840.10008.5.1.4.1.1.1
288 DigitalXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.1.1
289 DigitalXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.1.1.1
290 DigitalMammographyXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.1.2
291 DigitalMammographyXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.1.2.1
292 DigitalIntraOralXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.1.3
293 DigitalIntraOralXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.1.3.1
294 CTImageStorage 1.2.840.10008.5.1.4.1.1.2
295 EnhancedCTImageStorage 1.2.840.10008.5.1.4.1.1.2.1
296 LegacyConvertedEnhancedCTImageStorage 1.2.840.10008.5.1.4.1.1.2.2
297 RETIRED_UltrasoundMultiframeImageStorage 1.2.840.10008.5.1.4.1.1.3
298 UltrasoundMultiframeImageStorage 1.2.840.10008.5.1.4.1.1.3.1
299 MRImageStorage 1.2.840.10008.5.1.4.1.1.4
300 EnhancedMRImageStorage 1.2.840.10008.5.1.4.1.1.4.1
301 MRSpectroscopyStorage 1.2.840.10008.5.1.4.1.1.4.2
302 EnhancedMRColorImageStorage 1.2.840.10008.5.1.4.1.1.4.3
303 LegacyConvertedEnhancedMRImageStorage 1.2.840.10008.5.1.4.1.1.4.4
304 RETIRED_NuclearMedicineImageStorage 1.2.840.10008.5.1.4.1.1.5
305 RETIRED_UltrasoundImageStorage 1.2.840.10008.5.1.4.1.1.6
306 UltrasoundImageStorage 1.2.840.10008.5.1.4.1.1.6.1
307 EnhancedUSVolumeStorage 1.2.840.10008.5.1.4.1.1.6.2
308 SecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7
309 MultiframeSingleBitSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.1
310 MultiframeGrayscaleByteSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.2
311 MultiframeGrayscaleWordSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.3
312 MultiframeTrueColorSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.4
313 RETIRED_StandaloneOverlayStorage 1.2.840.10008.5.1.4.1.1.8
314 RETIRED_StandaloneCurveStorage 1.2.840.10008.5.1.4.1.1.9
315 TwelveLeadECGWaveformStorage 1.2.840.10008.5.1.4.1.1.9.1.1
316 GeneralECGWaveformStorage 1.2.840.10008.5.1.4.1.1.9.1.2
317 AmbulatoryECGWaveformStorage 1.2.840.10008.5.1.4.1.1.9.1.3
318 HemodynamicWaveformStorage 1.2.840.10008.5.1.4.1.1.9.2.1
319 CardiacElectrophysiologyWaveformStorage 1.2.840.10008.5.1.4.1.1.9.3.1
320 BasicVoiceAudioWaveformStorage 1.2.840.10008.5.1.4.1.1.9.4.1
321 GeneralAudioWaveformStorage 1.2.840.10008.5.1.4.1.1.9.4.2
322 ArterialPulseWaveformStorage 1.2.840.10008.5.1.4.1.1.9.5.1
323 RespiratoryWaveformStorage 1.2.840.10008.5.1.4.1.1.9.6.1
324 RETIRED_StandaloneModalityLUTStorage 1.2.840.10008.5.1.4.1.1.10
325 RETIRED_StandaloneVOILUTStorage 1.2.840.10008.5.1.4.1.1.11
326 GrayscaleSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.1
327 ColorSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.2
328 PseudoColorSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.3
329 BlendingSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.4
330 XAXRFGrayscaleSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.5
331 XRayAngiographicImageStorage 1.2.840.10008.5.1.4.1.1.12.1
332 EnhancedXAImageStorage 1.2.840.10008.5.1.4.1.1.12.1.1
333 XRayRadiofluoroscopicImageStorage 1.2.840.10008.5.1.4.1.1.12.2
334 EnhancedXRFImageStorage 1.2.840.10008.5.1.4.1.1.12.2.1
335 RETIRED_XRayAngiographicBiPlaneImageStorage 1.2.840.10008.5.1.4.1.1.12.3
336 XRay3DAngiographicImageStorage 1.2.840.10008.5.1.4.1.1.13.1.1
337 XRay3DCraniofacialImageStorage 1.2.840.10008.5.1.4.1.1.13.1.2
338 BreastTomosynthesisImageStorage 1.2.840.10008.5.1.4.1.1.13.1.3
339 IntravascularOpt.Coh.Tom.ImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.14.1
340 IntravascularOpt.Coh.Tom.ImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.14.2
341 NuclearMedicineImageStorage 1.2.840.10008.5.1.4.1.1.20
342 RawDataStorage 1.2.840.10008.5.1.4.1.1.66
343 SpatialRegistrationStorage 1.2.840.10008.5.1.4.1.1.66.1
344 SpatialFiducialsStorage 1.2.840.10008.5.1.4.1.1.66.2
345 DeformableSpatialRegistrationStorage 1.2.840.10008.5.1.4.1.1.66.3
346 SegmentationStorage 1.2.840.10008.5.1.4.1.1.66.4
347 SurfaceSegmentationStorage 1.2.840.10008.5.1.4.1.1.66.5
348 RealWorldValueMappingStorage 1.2.840.10008.5.1.4.1.1.67
349 SurfaceScanMeshStorage 1.2.840.10008.5.1.4.1.1.68.1
350 SurfaceScanPointCloudStorage 1.2.840.10008.5.1.4.1.1.68.2
351 RETIRED_VLImageStorage 1.2.840.10008.5.1.4.1.1.77.1
352 VLEndoscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.1
353 VideoEndoscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.1.1
354 VLMicroscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.2
355 VideoMicroscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.2.1
356 VLSlideCoordinatesMicroscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.3
357 VLPhotographicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.4
358 VideoPhotographicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.4.1
359 OphthalmicPhotography8BitImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.1
360 OphthalmicPhotography16BitImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.2
361 StereometricRelationshipStorage 1.2.840.10008.5.1.4.1.1.77.1.5.3
362 OphthalmicTomographyImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.4
363 VLWholeSlideMicroscopyImageStorage 1.2.840.10008.5.1.4.1.1.77.1.6
364 RETIRED_VLMultiframeImageStorage 1.2.840.10008.5.1.4.1.1.77.2
365 LensometryMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.1
366 AutorefractionMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.2
367 KeratometryMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.3
368 SubjectiveRefractionMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.4
369 VisualAcuityMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.5
370 SpectaclePrescriptionReportStorage 1.2.840.10008.5.1.4.1.1.78.6
371 OphthalmicAxialMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.7
372 IntraocularLensCalculationsStorage 1.2.840.10008.5.1.4.1.1.78.8
373 MacularGridThicknessAndVolumeReportStorage 1.2.840.10008.5.1.4.1.1.79.1
374 OphthalmicVisualFieldStaticPerimetryMeasurementsSt. 1.2.840.10008.5.1.4.1.1.80.1
375 OphthalmicThicknessMapStorage 1.2.840.10008.5.1.4.1.1.81.1
376 BasicTextSRStorage 1.2.840.10008.5.1.4.1.1.88.11
377 EnhancedSRStorage 1.2.840.10008.5.1.4.1.1.88.22
378 ComprehensiveSRStorage 1.2.840.10008.5.1.4.1.1.88.33
379 Comprehensive3DSRStorage 1.2.840.10008.5.1.4.1.1.88.34
380 ProcedureLogStorage 1.2.840.10008.5.1.4.1.1.88.40
381 MammographyCADSRStorage 1.2.840.10008.5.1.4.1.1.88.50
382 KeyObjectSelectionDocumentStorage 1.2.840.10008.5.1.4.1.1.88.59
383 ChestCADSRStorage 1.2.840.10008.5.1.4.1.1.88.65
384 XRayRadiationDoseSRStorage 1.2.840.10008.5.1.4.1.1.88.67
385 ColonCADSRStorage 1.2.840.10008.5.1.4.1.1.88.69
386 ImplantationPlanSRDocumentStorage 1.2.840.10008.5.1.4.1.1.88.70
387 EncapsulatedPDFStorage 1.2.840.10008.5.1.4.1.1.104.1
388 EncapsulatedCDAStorage 1.2.840.10008.5.1.4.1.1.104.2
389 PositronEmissionTomographyImageStorage 1.2.840.10008.5.1.4.1.1.128
390 LegacyConvertedEnhancedPETImageStorage 1.2.840.10008.5.1.4.1.1.128.1
391 RETIRED_StandalonePETCurveStorage 1.2.840.10008.5.1.4.1.1.129
392 EnhancedPETImageStorage 1.2.840.10008.5.1.4.1.1.130
393 BasicStructuredDisplayStorage 1.2.840.10008.5.1.4.1.1.131
394 RTImageStorage 1.2.840.10008.5.1.4.1.1.481.1
395 RTDoseStorage 1.2.840.10008.5.1.4.1.1.481.2
396 RTStructureSetStorage 1.2.840.10008.5.1.4.1.1.481.3
397 RTBeamsTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.4
398 RTPlanStorage 1.2.840.10008.5.1.4.1.1.481.5
399 RTBrachyTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.6
400 RTTreatmentSummaryRecordStorage 1.2.840.10008.5.1.4.1.1.481.7
401 RTIonPlanStorage 1.2.840.10008.5.1.4.1.1.481.8
402 RTIonBeamsTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.9
403 RTBeamsDeliveryInstructionStorage 1.2.840.10008.5.1.4.34.7
404 The getscu application will usually accept presentation contexts for
406 all of the abovementioned supported SOP Classes using any of the
407 following transfer syntaxes:
408 LittleEndianImplicitTransferSyntax 1.2.840.10008.1.2
410 LittleEndianExplicitTransferSyntax 1.2.840.10008.1.2.1
411 BigEndianExplicitTransferSyntax 1.2.840.10008.1.2.2
412 When acting as a storage SCP, the getscu application will prefer
414 transfer syntaxes having an explicit encoding over the default implicit
415 transfer syntax. If getscu is running on big-endian hardware it will
416 prefer BigEndianExplicit to LittleEndianExplicit transfer syntax (and
417 vice versa). This behavior can be changed with the --prefer options
418 (see above). Depending on the --prefer option actually used, a
419 combination of the following transfer syntaxes is supported:
420 LittleEndianImplicitTransferSyntax 1.2.840.10008.1.2
422 LittleEndianExplicitTransferSyntax 1.2.840.10008.1.2.1
423 DeflatedExplicitVRLittleEndianTransferSyntax 1.2.840.10008.1.2.1.99 (*)
424 BigEndianExplicitTransferSyntax 1.2.840.10008.1.2.2
425 JPEGProcess1TransferSyntax 1.2.840.10008.1.2.4.50
426 JPEGProcess2_4TransferSyntax 1.2.840.10008.1.2.4.51
427 JPEGProcess14SV1TransferSyntax 1.2.840.10008.1.2.4.70
428 JPEGLSLosslessTransferSyntax 1.2.840.10008.1.2.4.80
429 JPEGLSLossyTransferSyntax 1.2.840.10008.1.2.4.81
430 JPEG2000LosslessOnlyTransferSyntax 1.2.840.10008.1.2.4.90
431 JPEG2000TransferSyntax 1.2.840.10008.1.2.4.91
432 MPEG2MainProfileAtMainLevelTransferSyntax 1.2.840.10008.1.2.4.100
433 MPEG2MainProfileAtHighLevelTransferSyntax 1.2.840.10008.1.2.4.101
434 MPEG4HighProfileLevel4_1TransferSyntax 1.2.840.10008.1.2.4.102
435 MPEG4BDcompatibleHighProfileLevel4_1TransferSyntax 1.2.840.10008.1.2.4.103
436 MPEG4HighProfileLevel4_2_For2DVideoTransferSyntax 1.2.840.10008.1.2.4.104
437 MPEG4HighProfileLevel4_2_For3DVideoTransferSyntax 1.2.840.10008.1.2.4.105
438 MPEG4StereoHighProfileLevel4_2TransferSyntax 1.2.840.10008.1.2.4.106
439 HEVCMainProfileLevel5_1TransferSyntax 1.2.840.10008.1.2.4.107
440 HEVCMain10ProfileLevel5_1TransferSyntax 1.2.840.10008.1.2.4.108
441 RLELosslessTransferSyntax 1.2.840.10008.1.2.5
442 (*) if compiled with zlib support enabled (see --version output)
444 The getscu application does not support extended negotiation.
446
448 getscu --patient --call ARCHIVE caesar 104 q.dcm
449 sends the attributes contained in the DICOM file 'q.dcm' as part of a
451 C-GET request to application entity ARCHIVE on the host caesar at port
452 104 using the Patient Root query model. getscu itself uses the default
453 AE title GETSCU.
454 In contrast to C-MOVE-based Query/Retrieve SOP Classes, the C-GET-based
456 SOP Classes utilized by getscu only permit retrieving the desired
457 objects on the same connection, i.e. getscu will receive the objects
458 itself. Thus, it is not possible to tell the SCP to transmit the
459 objects to a third party. This is a limitation of the DICOM protocol
460 and not of the getscu tool.
461
463 The level of logging output of the various command line tools and
464 underlying libraries can be specified by the user. By default, only
465 errors and warnings are written to the standard error stream. Using
466 option --verbose also informational messages like processing details
467 are reported. Option --debug can be used to get more details on the
468 internal activity, e.g. for debugging purposes. Other logging levels
469 can be selected using option --log-level. In --quiet mode only fatal
470 errors are reported. In such very severe error events, the application
471 will usually terminate. For more details on the different logging
472 levels, see documentation of module 'oflog'.
473 In case the logging output should be written to file (optionally with
475 logfile rotation), to syslog (Unix) or the event log (Windows) option
476 --log-config can be used. This configuration file also allows for
477 directing only certain messages to a particular output stream and for
478 filtering certain messages based on the module or application where
479 they are generated. An example configuration file is provided in
480 <etcdir>/logger.cfg.
481
483 All command line tools use the following notation for parameters:
484 square brackets enclose optional values (0-1), three trailing dots
485 indicate that multiple values are allowed (1-n), a combination of both
486 means 0 to n values.
487 Command line options are distinguished from parameters by a leading '+'
489 or '-' sign, respectively. Usually, order and position of command line
490 options are arbitrary (i.e. they can appear anywhere). However, if
491 options are mutually exclusive the rightmost appearance is used. This
492 behavior conforms to the standard evaluation rules of common Unix
493 shells.
494 In addition, one or more command files can be specified using an '@'
496 sign as a prefix to the filename (e.g. @command.txt). Such a command
497 argument is replaced by the content of the corresponding text file
498 (multiple whitespaces are treated as a single separator unless they
499 appear between two quotation marks) prior to any further evaluation.
500 Please note that a command file cannot contain another command file.
501 This simple but effective approach allows one to summarize common
502 combinations of options/parameters and avoids longish and confusing
503 command lines (an example is provided in file <datadir>/dumppat.txt).
504
506 The getscu utility will attempt to load DICOM data dictionaries
507 specified in the DCMDICTPATH environment variable. By default, i.e. if
508 the DCMDICTPATH environment variable is not set, the file
509 <datadir>/dicom.dic will be loaded unless the dictionary is built into
510 the application (default for Windows).
511 The default behavior should be preferred and the DCMDICTPATH
513 environment variable only used when alternative data dictionaries are
514 required. The DCMDICTPATH environment variable has the same format as
515 the Unix shell PATH variable in that a colon (':') separates entries.
516 On Windows systems, a semicolon (';') is used as a separator. The data
517 dictionary code will attempt to load each file specified in the
518 DCMDICTPATH environment variable. It is an error if no data dictionary
519 can be loaded.
520
522 findscu(1), movescu(1), dump2dcm(1), dcmodify(1)
523
525 Copyright (C) 2011-2022 by OFFIS e.V., Escherweg 2, 26121 Oldenburg,
526 Germany.
527Version 3.6.7 Fri Apr 22 2022 getscu(1)