1getscu(1)                         OFFIS DCMTK                        getscu(1)
2
3
4

NAME

6       getscu - DICOM retrieve (C-GET) SCU
7
8

SYNOPSIS

10       getscu [options] peer port [dcmfile-in...]
11

DESCRIPTION

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

PARAMETERS

23       peer        hostname of DICOM peer
24
25       port        tcp/ip port number of peer
26
27       dcmfile-in  DICOM query file(s)
28

OPTIONS

30   general options
31         -h    --help
32                 print this help text and exit
33
34               --version
35                 print version information and exit
36
37               --arguments
38                 print expanded command line arguments
39
40         -q    --quiet
41                 quiet mode, print no warnings and errors
42
43         -v    --verbose
44                 verbose mode, print processing details
45
46         -d    --debug
47                 debug mode, print debug information
48
49         -ll   --log-level  [l]evel: string constant
50                 (fatal, error, warn, info, debug, trace)
51                 use level l for the logger
52
53         -lc   --log-config  [f]ilename: string
54                 use config file f for the logger
55
56         +v    --verbose-pc
57                 show presentation contexts in verbose mode
58
59   network options
60       override matching keys:
61
62         -k    --key  [k]ey: gggg,eeee="str", path or dictionary name="str"
63                 override matching key
64
65       query information model:
66
67         -P    --patient
68                 use patient root information model (default)
69
70         -S    --study
71                 use study root information model
72
73         -O    --psonly
74                 use patient/study only information model
75
76       application entity titles:
77
78         -aet  --aetitle  [a]etitle: string
79                 set my calling AE title (default: GETSCU)
80
81         -aec  --call  [a]etitle: string
82                 set called AE title of peer (default: ANY-SCP)
83
84       preferred storage transfer syntaxes (incoming associations):
85
86         +x=   --prefer-uncompr
87                 prefer explicit VR local byte order (default)
88
89         +xe   --prefer-little
90                 prefer explicit VR little endian TS
91
92         +xb   --prefer-big
93                 prefer explicit VR big endian TS
94
95         +xs   --prefer-lossless
96                 prefer default JPEG lossless TS
97
98         +xy   --prefer-jpeg8
99                 prefer default JPEG lossy TS for 8 bit data
100
101         +xx   --prefer-jpeg12
102                 prefer default JPEG lossy TS for 12 bit data
103
104         +xv   --prefer-j2k-lossless
105                 prefer JPEG 2000 lossless TS
106
107         +xw   --prefer-j2k-lossy
108                 prefer JPEG 2000 lossy TS
109
110         +xt   --prefer-jls-lossless
111                 prefer JPEG-LS lossless TS
112
113         +xu   --prefer-jls-lossy
114                 prefer JPEG-LS lossy TS
115
116         +xm   --prefer-mpeg2
117                 prefer MPEG2 Main Profile @ Main Level TS
118
119         +xh   --prefer-mpeg2-high
120                 prefer MPEG2 Main Profile @ High Level TS
121
122         +xn   --prefer-mpeg4
123                 prefer MPEG4 AVC/H.264 HP / Level 4.1 TS
124
125         +xl   --prefer-mpeg4-bd
126                 prefer MPEG4 AVC/H.264 BD-compatible HP / Level 4.1 TS
127
128         +x2   --prefer-mpeg4-2-2d
129                 prefer MPEG4 AVC/H.264 HP / Level 4.2 TS for 2D Videos
130
131         +x3   --prefer-mpeg4-2-3d
132                 prefer MPEG4 AVC/H.264 HP / Level 4.2 TS for 3D Videos
133
134         +xo   --prefer-mpeg4-2-st
135                 prefer MPEG4 AVC/H.264 Stereo HP / Level 4.2 TS
136
137         +x4   --prefer-hevc
138                 prefer HEVC H.265 Main Profile / Level 5.1 TS
139
140         +x5   --prefer-hevc10
141                 prefer HEVC H.265 Main 10 Profile / Level 5.1 TS
142
143         +xr   --prefer-rle
144                 prefer RLE lossless TS
145
146         +xd   --prefer-deflated
147                 prefer deflated explicit VR little endian TS
148
149         +xi   --implicit
150                 accept implicit VR little endian TS only
151
152        proposed retrieve transfer syntaxes (outgoing associations):
153
154         -x=   --propose-uncompr
155                 propose all uncompressed TS, explicit VR
156                 with local byte ordering first (default)
157
158         -xe   --propose-little
159                 propose all uncompressed TS, explicit VR little endian first
160
161         -xb   --propose-big
162                 propose all uncompressed TS, explicit VR big endian first
163
164         -xd   --propose-deflated
165                 propose deflated explicit VR little endian TS
166                 and all uncompressed transfer syntaxes
167
168         -xi   --propose-implicit
169                 propose implicit VR little endian TS only
170
171       other network options:
172
173         -to   --timeout  [s]econds: integer (default: unlimited)
174                 timeout for connection requests
175
176         -ta   --acse-timeout  [s]econds: integer (default: 30)
177                 timeout for ACSE messages
178
179         -td   --dimse-timeout  [s]econds: integer (default: unlimited)
180                 timeout for DIMSE messages
181
182         -pdu  --max-pdu  [n]umber of bytes: integer (4096..131072)
183                 set max receive pdu to n bytes (default: 16384)
184
185               --repeat  [n]umber: integer
186                 repeat n times
187
188               --abort
189                 abort association instead of releasing it
190
191   output options
192       general:
193
194         -od   --output-directory  [d]irectory: string (default: ".")
195                 write received objects to existing directory d
196
197       storage mode:
198
199         -B    --normal
200                 receive in memory, then write to disk (default)
201
202         +B    --bit-preserving
203                 receive directly to disk
204
205               --ignore
206                 ignore store data, receive but do not store
207

NOTES

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
215       # request all images for the patient with ID=PAT001
216       (0008,0052) CS [PATIENT]     # QueryRetrieveLevel
217       (0010,0020) LO [PAT001]      # PatientID
218
219       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
224       getscu -k "0010,0020=PAT002" caesar 5678 patqry.dcm
225
226       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
236       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
241   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
246       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
250       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
256   DICOM Conformance
257   SCU Conformance
258       The getscu application supports the following SOP Classes as an SCU:
259
260       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
264       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
269       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
274       (*) if compiled with zlib support enabled (see --version output)
275
276       Which  transfer  syntaxes  are  actually proposed in what order, can be
277       specified with the --propose options.
278
279   Storage Conformance
280       The getscu application supports the following SOP Classes as an SCP:
281
282       VerificationSOPClass                                 1.2.840.10008.1.1
283
284       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
405       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
409       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
413       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
421       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
443       (*) if compiled with zlib support enabled (see --version output)
444
445       The getscu application does not support extended negotiation.
446

EXAMPLES

448       getscu --patient --call ARCHIVE caesar 104 q.dcm
449
450       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
455       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

LOGGING

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
474       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

COMMAND LINE

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
488       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
495       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

ENVIRONMENT

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
512       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

SEE ALSO

522       findscu(1), movescu(1), dump2dcm(1), dcmodify(1)
523
525       Copyright (C) 2011-2017 by OFFIS e.V., Escherweg  2,  26121  Oldenburg,
526       Germany.
527
528
529
530Version 3.6.2                   Fri Jul 14 2017                      getscu(1)
Impressum