OFFIS DCMTK  Version 3.6.0
dcmqrscp.man
1 /*!
2 
3 \if MANPAGES
4 \page dcmqrscp DICOM image archive (central test node)
5 \else
6 \page dcmqrscp dcmqrscp: DICOM image archive (central test node)
7 \endif
8 
9 \section synopsis SYNOPSIS
10 
11 \verbatim
12 dcmqrscp [options] [port]
13 \endverbatim
14 
15 \section description DESCRIPTION
16 
17 The Image Central Test Node (\b dcmqrscp) Application implements a simple image
18 archive. It manages a number of storage areas and allows images to be stored
19 in these storage areas using the DICOM Storage Service Class. It also allows
20 image attributes to be queried and images to be retrieved using the DICOM
21 Query/Retrieve Service Class. The \b dcmqrscp application also implements
22 access restriction rules to limit operations to specific peer application
23 entities.
24 
25 The \b dcmqrscp application is intended to be used in DICOM demonstrations and
26 as a compatibilitiy test tool. In particular, \b dcmqrscp will delete images
27 if its quota restrictions have been exceeded.
28 
29 \section parameters PARAMETERS
30 
31 \verbatim
32 port tcp/ip port number to listen on (default: in config file)
33 \endverbatim
34 
35 \section options OPTIONS
36 
37 \subsection general_options general options
38 \verbatim
39  -h --help
40  print this help text and exit
41 
42  --version
43  print version information and exit
44 
45  --arguments
46  print expanded command line arguments
47 
48  -q --quiet
49  quiet mode, print no warnings and errors
50 
51  -v --verbose
52  verbose mode, print processing details
53 
54  -d --debug
55  debug mode, print debug information
56 
57  -ll --log-level [l]evel: string constant
58  (fatal, error, warn, info, debug, trace)
59  use level l for the logger
60 
61  -lc --log-config [f]ilename: string
62  use config file f for the logger
63 
64  -c --config [f]ilename: string
65  use specific configuration file
66  (default: /usr/local/etc/dcmtk/dcmqrscp.cfg)
67 
68  # This option allows a specific configuration file to be
69  # specified. By default, the configuration file in the
70  # system configuration directory ("etc" on Unix systems and
71  # current working directory on Windows systems) with the name
72  # "dcmqrscp.cfg" will be used. It is an error if a valid
73  # configuration file is not available. See the documentation
74  # on configuration for more information (dcmqrcnf.txt and the
75  # example configuration file dcmqrscp.cfg).
76 \endverbatim
77 
78 \subsection multiprocess_options multi-process options
79 \verbatim
80  -s --single-process
81  single process mode
82 
83  # This option instructs dcmqrscp to run in single process mode.
84  # Normally, dcmqrscp will spawn a new copy of itself to handle
85  # each association. This option will prevent such copies being
86  # spawned and is particularly useful when running within a
87  # debugger.
88 
89  --fork
90  fork child process for each association (default)
91 \endverbatim
92 
93 \subsection database_options database options
94 \verbatim
95 association negotiation:
96 
97  --require-find
98  reject all MOVE/GET presentation contexts for
99  which no corresponding FIND context is proposed
100 
101  # This option causes dcmqrscp to enforce a restriction about
102  # FIND and MOVE presentation contexts. The RSNA'93 demonstration
103  # required that a CTN refuse to accept a presentation context for
104  # a MOVE if a FIND presentation context is not also requested.
105  # This option enforces this restriction.
106 
107  --no-parallel-store
108  reject multiple simultaneous STORE presentation
109  contexts for one application entity title
110 
111  # This option causes dcmqrscp to refuse storage presentations
112  # contexts for AE Titles if another association has already
113  # sucessfully negotiated storage presentation contexts for the
114  # AE Title. This option should only be needed for debugging
115  # since the dcmqrscp database back-end sequentialises access via
116  # file-locking.
117 
118  --disable-get
119  disable C-GET support
120 
121  --allow-shutdown
122  allow external shutdown via a private SOP class
123 
124 checking identifier validity:
125 
126  -XF --check-find
127  check C-FIND identifier validity
128 
129  # This option causes dcmqrscp database back-end to perform checks
130  # on the Query Identifiers for a C-FIND command. With this option,
131  # dcmqrscp will reject any queries which do not conform to the very
132  # strict DICOM rules for Query Identifiers.
133 
134  --no-check-find
135  do not check C-FIND identifier validity (default)
136 
137  -XM --check-move
138  check C-MOVE identifier validity
139 
140 
141  # This option causes dcmqrscp database back-end to perform checks
142  # on the Query Identifiers for a C-MOVE command. With this option,
143  # dcmqrscp will reject any queries which do not conform to the very
144  # strict DICOM rules for Query Identifiers.
145 
146  --no-check-move
147  do not check C-MOVE identifier validity (default)
148 
149 restriction of move targets:
150 
151  --move-unrestricted
152  do not restrict move destination (default)
153 
154  -ZA --move-aetitle
155  restrict move destination to requesting AE title
156 
157  -ZH --move-host
158  restrict move destination to requesting host
159 
160  -ZV --move-vendor
161  restrict move destination to requesting vendor
162 
163 restriction of query/retrieve models:
164 
165  -QP --no-patient-root
166  do not support Patient Root Q/R models
167 
168  -QS --no-study-root
169  do not support Study Root Q/R models
170 
171  -QO --no-patient-study
172  do not support Patient/Study Only Q/R models
173 \endverbatim
174 
175 \subsection network_options network options
176 \verbatim
177 preferred network transfer syntaxes (incoming associations):
178 
179  +x= --prefer-uncompr
180  prefer explicit VR local byte order (default)
181 
182  +xe --prefer-little
183  prefer explicit VR little endian TS
184 
185  +xb --prefer-big
186  prefer explicit VR big endian TS
187 
188  +xs --prefer-lossless
189  prefer default JPEG lossless TS
190 
191  +xy --prefer-jpeg8
192  prefer default JPEG lossy TS for 8 bit data
193 
194  +xx --prefer-jpeg12
195  prefer default JPEG lossy TS for 12 bit data
196 
197  +xv --prefer-j2k-lossless
198  prefer JPEG 2000 lossless TS
199 
200  +xw --prefer-j2k-lossy
201  prefer JPEG 2000 lossy TS
202 
203  +xt --prefer-jls-lossless
204  prefer JPEG-LS lossless TS
205 
206  +xu --prefer-jls-lossy
207  prefer JPEG-LS lossy TS
208 
209  +xm --prefer-mpeg2
210  prefer MPEG2 Main Profile @ Main Level TS
211 
212  +xh --prefer-mpeg2-high
213  prefer MPEG2 Main Profile @ High Level TS
214 
215  +xr --prefer-rle
216  prefer RLE lossless TS
217 
218  +xd --prefer-deflated
219  prefer deflated explicit VR little endian TS
220 
221  +xi --implicit
222  accept implicit VR little endian TS only
223 
224 proposed transmission transfer syntaxes (outgoing associations):
225 
226  -x= --propose-uncompr
227  propose all uncompressed TS, explicit VR
228  with local byte ordering first (default)
229 
230  -xe --propose-little
231  propose all uncompressed TS, explicit VR little endian first
232 
233  -xb --propose-big
234  propose all uncompressed TS, explicit VR big endian first
235 
236  -xi --propose-implicit
237  propose implicit VR little endian TS only
238 
239  -xs --propose-lossless
240  propose default JPEG lossless TS
241  and all uncompressed transfer syntaxes
242 
243  -xy --propose-jpeg8
244  propose default JPEG lossy TS for 8 bit data
245  and all uncompressed transfer syntaxes
246 
247  -xx --propose-jpeg12
248  propose default JPEG lossy TS for 12 bit data
249  and all uncompressed transfer syntaxes
250 
251  -xv --propose-j2k-lossless
252  propose JPEG 2000 lossless TS
253  and all uncompressed transfer syntaxes
254 
255  -xw --propose-j2k-lossy
256  propose JPEG 2000 lossy TS
257  and all uncompressed transfer syntaxes
258 
259  -xt --propose-jls-lossless
260  propose JPEG-LS lossless TS
261  and all uncompressed transfer syntaxes
262 
263  -xu --propose-jls-lossy
264  propose JPEG-LS lossy TS
265  and all uncompressed transfer syntaxes
266 
267  -xm --propose-mpeg2
268  propose MPEG2 Main Profile @ Main Level TS only
269 
270  -xh --propose-mpeg2-high
271  propose MPEG2 Main Profile @ High Level TS only
272 
273  -xr --propose-rle
274  propose RLE lossless TS
275  and all uncompressed transfer syntaxes
276 
277  -xd --propose-deflated
278  propose deflated explicit VR little endian TS
279  and all uncompressed transfer syntaxes
280 
281 network host access control (tcp wrapper):
282 
283  -ac --access-full
284  accept connections from any host (default)
285 
286  +ac --access-control
287  enforce host access control rules
288 
289 other network options:
290 
291  -to --timeout [s]econds: integer (default: unlimited)
292  timeout for connection requests
293 
294  -ta --acse-timeout [s]econds: integer (default: 30)
295  timeout for ACSE messages
296 
297  -td --dimse-timeout [s]econds: integer (default: unlimited)
298  timeout for DIMSE messages
299 
300  -pdu --max-pdu [n]umber of bytes: integer (4096..131072)
301  set max receive pdu to n bytes
302  (default: use value from configuration file)
303 
304  -dhl --disable-host-lookup
305  disable hostname lookup
306 
307  --refuse
308  refuse association
309 
310  --reject
311  reject association if no implementation class UID
312 
313  --ignore
314  ignore store data, receive but do not store
315 
316  # This option causes dcmqrscp database back-end to ignore
317  # all images received by the Storage Service Class. All images
318  # will be received from the network but not stored to disk nor
319  # recorded in database.
320 
321  -up --uid-padding
322  silently correct space-padded UIDs
323 \endverbatim
324 
325 \subsection encoding_options encoding options
326 \verbatim
327 post-1993 value representations:
328 
329  +u --enable-new-vr
330  enable support for new VRs (UN/UT) (default)
331 
332  -u --disable-new-vr
333  disable support for new VRs, convert to OB
334 
335  # This option disables generation of new VRs (UN/UT) when writing
336  # DICOM encoded data to a file to the network. This option can be
337  # used to force compatibility with applications which do not support
338  # these value representations.
339 \endverbatim
340 
341 \subsection output_options output options
342 \verbatim
343 bit preserving mode:
344 
345  -B --normal
346  allow implicit format conversions (default)
347 
348  +B --bit-preserving
349  write data exactly as read
350 
351 output file format:
352 
353  +F --write-file
354  write file format (default)
355 
356  -F --write-dataset
357  write data set without file meta information
358 
359 output transfer syntax:
360 (not with --bit-preserving or compressed transmission)
361 
362  +t= --write-xfer-same
363  write with same TS as input (default)
364 
365  +te --write-xfer-little
366  write with explicit VR little endian TS
367 
368  +tb --write-xfer-big
369  write with explicit VR big endian TS
370 
371  +ti --write-xfer-implicit
372  write with implicit VR little endian TS
373 
374  +td --write-xfer-deflated
375  write with deflated explicit VR little endian TS
376 
377 group length encoding (not with --bit-preserving):
378 
379  +g= --group-length-recalc
380  recalculate group lengths if present (default)
381 
382  +g --group-length-create
383  always write with group length elements
384 
385  -g --group-length-remove
386  always write without group length elements
387 
388 length encoding in sequences and items (not with --bit-preserving):
389 
390  +e --length-explicit
391  write with explicit lengths (default)
392 
393  -e --length-undefined
394  write with undefined lengths
395 
396 data set trailing padding (not with --write-dataset or --bit-preserving):
397 
398  -p --padding-off
399  no padding (default)
400 
401  +p --padding-create [f]ile-pad [i]tem-pad: integer
402  align file on multiple of f bytes
403  and items on multiple of i bytes
404 
405 deflate compression level (only with --propose-deflated or
406 --write-xfer-deflated/same):
407 
408  +cl --compression-level [l]evel: integer (default: 6)
409  0=uncompressed, 1=fastest, 9=best compression
410 \endverbatim
411 
412 \section notes NOTES
413 
414 \subsection operation Operation
415 
416 \b dcmqrscp waits for another application to connect at the presentation
417 address (port number) specified in its configuration file (or overridden by a
418 command line option). When another application connects, \b dcmqrscp expects
419 it to be a DICOM application and to use calling and called AE Titles specified
420 in <b>dcmqrscp's</b> configuration file. \b dcmqrscp will accept associations
421 with Presentation Contexts for SOP Classes of the Verification Service Class,
422 Storage Service Class and Query/Retreive Service Class. Associations will be
423 rejected or Presentation Contexts will be refused if the peer application does
424 not have appropriate access rights as specified by \b dcmqrscp configuration
425 file.
426 
427 \b dcmqrscp will receive images on Presentation Contexts of the Storage Service
428 Class, write them to a configurable storage area associated with the class AE
429 title, extract attributes from these images and store them in a database.
430 \b dcmqrscp will receive query requests and generate query responses on
431 Presentation Contexts of the Query/Retrieve Service class. \b dcmqrscp will
432 receive retrieve requests and generate retrieve responses on Presentation
433 Contexts of the Query/Retrieve Service class. \b dcmqrscp will also process
434 C-CANCEL messages to interrupt query/retrieve operations.
435 
436 Under normal operations \b dcmqrscp will never exit, it keeps on waiting for
437 new associations until killed.
438 
439 \subsection dicom_conformance DICOM Conformance
440 
441 \subsubsection scu_conformance SCU Conformance
442 
443 The \b dcmqrscp application supports the following SOP Classes as an SCU:
444 
445 \verbatim
446 VerificationSOPClass 1.2.840.10008.1.1
447 
448 RETIRED_StoredPrintStorage 1.2.840.10008.5.1.1.27
449 RETIRED_HardcopyGrayscaleImageStorage 1.2.840.10008.5.1.1.29
450 RETIRED_HardcopyColorImageStorage 1.2.840.10008.5.1.1.30
451 ComputedRadiographyImageStorage 1.2.840.10008.5.1.4.1.1.1
452 DigitalXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.1.1
453 DigitalXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.1.1.1
454 DigitalMammographyXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.1.2
455 DigitalMammographyXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.1.2.1
456 DigitalIntraOralXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.1.3
457 DigitalIntraOralXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.1.3.1
458 CTImageStorage 1.2.840.10008.5.1.4.1.1.2
459 EnhancedCTImageStorage 1.2.840.10008.5.1.4.1.1.2.1
460 RETIRED_UltrasoundMultiframeImageStorage 1.2.840.10008.5.1.4.1.1.3
461 UltrasoundMultiframeImageStorage 1.2.840.10008.5.1.4.1.1.3.1
462 MRImageStorage 1.2.840.10008.5.1.4.1.1.4
463 EnhancedMRImageStorage 1.2.840.10008.5.1.4.1.1.4.1
464 MRSpectroscopyStorage 1.2.840.10008.5.1.4.1.1.4.2
465 EnhancedMRColorImageStorage 1.2.840.10008.5.1.4.1.1.4.3
466 RETIRED_NuclearMedicineImageStorage 1.2.840.10008.5.1.4.1.1.5
467 RETIRED_UltrasoundImageStorage 1.2.840.10008.5.1.4.1.1.6
468 UltrasoundImageStorage 1.2.840.10008.5.1.4.1.1.6.1
469 EnhancedUSVolumeStorage 1.2.840.10008.5.1.4.1.1.6.2
470 SecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7
471 MultiframeSingleBitSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.1
472 MultiframeGrayscaleByteSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.2
473 MultiframeGrayscaleWordSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.3
474 MultiframeTrueColorSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.4
475 RETIRED_StandaloneOverlayStorage 1.2.840.10008.5.1.4.1.1.8
476 RETIRED_StandaloneCurveStorage 1.2.840.10008.5.1.4.1.1.9
477 DRAFT_WaveformStorage 1.2.840.10008.5.1.4.1.1.9.1
478 TwelveLeadECGWaveformStorage 1.2.840.10008.5.1.4.1.1.9.1.1
479 GeneralECGWaveformStorage 1.2.840.10008.5.1.4.1.1.9.1.2
480 AmbulatoryECGWaveformStorage 1.2.840.10008.5.1.4.1.1.9.1.3
481 HemodynamicWaveformStorage 1.2.840.10008.5.1.4.1.1.9.2.1
482 CardiacElectrophysiologyWaveformStorage 1.2.840.10008.5.1.4.1.1.9.3.1
483 BasicVoiceAudioWaveformStorage 1.2.840.10008.5.1.4.1.1.9.4.1
484 GeneralAudioWaveformStorage 1.2.840.10008.5.1.4.1.1.9.4.2
485 ArterialPulseWaveformStorage 1.2.840.10008.5.1.4.1.1.9.5.1
486 RespiratoryWaveformStorage 1.2.840.10008.5.1.4.1.1.9.6.1
487 RETIRED_StandaloneModalityLUTStorage 1.2.840.10008.5.1.4.1.1.10
488 RETIRED_StandaloneVOILUTStorage 1.2.840.10008.5.1.4.1.1.11
489 GrayscaleSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.1
490 ColorSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.2
491 PseudoColorSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.3
492 BlendingSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.4
493 XAXRFGrayscaleSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.5
494 XRayAngiographicImageStorage 1.2.840.10008.5.1.4.1.1.12.1
495 EnhancedXAImageStorage 1.2.840.10008.5.1.4.1.1.12.1.1
496 XRayRadiofluoroscopicImageStorage 1.2.840.10008.5.1.4.1.1.12.2
497 EnhancedXRFImageStorage 1.2.840.10008.5.1.4.1.1.12.2.1
498 XRay3DAngiographicImageStorage 1.2.840.10008.5.1.4.1.1.13.1.1
499 XRay3DCraniofacialImageStorage 1.2.840.10008.5.1.4.1.1.13.1.2
500 BreastTomosynthesisImageStorage 1.2.840.10008.5.1.4.1.1.13.1.3
501 RETIRED_XRayAngiographicBiPlaneImageStorage 1.2.840.10008.5.1.4.1.1.12.3
502 NuclearMedicineImageStorage 1.2.840.10008.5.1.4.1.1.20
503 RawDataStorage 1.2.840.10008.5.1.4.1.1.66
504 SpatialRegistrationStorage 1.2.840.10008.5.1.4.1.1.66.1
505 SpatialFiducialsStorage 1.2.840.10008.5.1.4.1.1.66.2
506 DeformableSpatialRegistrationStorage 1.2.840.10008.5.1.4.1.1.66.3
507 SegmentationStorage 1.2.840.10008.5.1.4.1.1.66.4
508 SurfaceSegmentationStorage 1.2.840.10008.5.1.4.1.1.66.5
509 RealWorldValueMappingStorage 1.2.840.10008.5.1.4.1.1.67
510 RETIRED_VLImageStorage 1.2.840.10008.5.1.4.1.1.77.1
511 VLEndoscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.1
512 VideoEndoscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.1.1
513 VLMicroscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.2
514 VideoMicroscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.2.1
515 VLSlideCoordinatesMicroscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.3
516 VLPhotographicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.4
517 VideoPhotographicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.4.1
518 OphthalmicPhotography8BitImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.1
519 OphthalmicPhotography16BitImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.2
520 StereometricRelationshipStorage 1.2.840.10008.5.1.4.1.1.77.1.5.3
521 OphthalmicTomographyImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.4
522 VLWholeSlideMicroscopyImageStorage 1.2.840.10008.5.1.4.1.1.77.1.6
523 RETIRED_VLMultiFrameImageStorage 1.2.840.10008.5.1.4.1.1.77.2
524 LensometryMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.1
525 AutorefractionMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.2
526 KeratometryMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.3
527 SubjectiveRefractionMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.4
528 VisualAcuityMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.5
529 SpectaclePrescriptionReportStorage 1.2.840.10008.5.1.4.1.1.78.6
530 OphthalmicAxialMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.7
531 IntraocularLensCalculationsStorage 1.2.840.10008.5.1.4.1.1.78.8
532 MacularGridThicknessAndVolumeReportStorage 1.2.840.10008.5.1.4.1.1.79.1
533 OphthalmicVisualFieldStaticPerimetryMeasurementsSt. 1.2.840.10008.5.1.4.1.1.80.1
534 DRAFT_SRTextStorage 1.2.840.10008.5.1.4.1.1.88.1
535 DRAFT_SRAudioStorage 1.2.840.10008.5.1.4.1.1.88.2
536 DRAFT_SRDetailStorage 1.2.840.10008.5.1.4.1.1.88.3
537 DRAFT_SRComprehensiveStorage 1.2.840.10008.5.1.4.1.1.88.4
538 BasicTextSRStorage 1.2.840.10008.5.1.4.1.1.88.11
539 EnhancedSRStorage 1.2.840.10008.5.1.4.1.1.88.22
540 ComprehensiveSRStorage 1.2.840.10008.5.1.4.1.1.88.33
541 ProcedureLogStorage 1.2.840.10008.5.1.4.1.1.88.40
542 MammographyCADSRStorage 1.2.840.10008.5.1.4.1.1.88.50
543 KeyObjectSelectionDocumentStorage 1.2.840.10008.5.1.4.1.1.88.59
544 ChestCADSRStorage 1.2.840.10008.5.1.4.1.1.88.65
545 XRayRadiationDoseSRStorage 1.2.840.10008.5.1.4.1.1.88.67
546 ColonCADSRStorage 1.2.840.10008.5.1.4.1.1.88.69
547 ImplantationPlanSRDocumentStorage 1.2.840.10008.5.1.4.1.1.88.70
548 EncapsulatedPDFStorage 1.2.840.10008.5.1.4.1.1.104.1
549 EncapsulatedCDAStorage 1.2.840.10008.5.1.4.1.1.104.2
550 PositronEmissionTomographyImageStorage 1.2.840.10008.5.1.4.1.1.128
551 RETIRED_StandalonePETCurveStorage 1.2.840.10008.5.1.4.1.1.129
552 EnhancedPETImageStorage 1.2.840.10008.5.1.4.1.1.130
553 BasicStructuredDisplayStorage 1.2.840.10008.5.1.4.1.1.131
554 RTImageStorage 1.2.840.10008.5.1.4.1.1.481.1
555 RTDoseStorage 1.2.840.10008.5.1.4.1.1.481.2
556 RTStructureSetStorage 1.2.840.10008.5.1.4.1.1.481.3
557 RTBeamsTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.4
558 RTPlanStorage 1.2.840.10008.5.1.4.1.1.481.5
559 RTBrachyTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.6
560 RTTreatmentSummaryRecordStorage 1.2.840.10008.5.1.4.1.1.481.7
561 RTIonPlanStorage 1.2.840.10008.5.1.4.1.1.481.8
562 RTIonBeamsTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.9
563 DRAFT_RTBeamsDeliveryInstructionStorage 1.2.840.10008.5.1.4.34.1
564 GenericImplantTemplateStorage 1.2.840.10008.5.1.4.43.1
565 ImplantAssemblyTemplateStorage 1.2.840.10008.5.1.4.44.1
566 ImplantTemplateGroupStorage 1.2.840.10008.5.1.4.45.1
567 \endverbatim
568 
569 The \b dcmqrscp application will propose presentation contexts for all of the
570 abovementioned supported SOP Classes using the transfer syntaxes:
571 
572 \verbatim
573 LittleEndianImplicitTransferSyntax 1.2.840.10008.1.2
574 LittleEndianExplicitTransferSyntax 1.2.840.10008.1.2.1
575 BigEndianExplicitTransferSyntax 1.2.840.10008.1.2.2
576 \endverbatim
577 
578 This default behaviour can be changed with the \e --propose options (see above).
579 Depending on these options, the following transfer syntaxes are supported:
580 
581 \verbatim
582 LittleEndianImplicitTransferSyntax 1.2.840.10008.1.2
583 LittleEndianExplicitTransferSyntax 1.2.840.10008.1.2.1
584 DeflatedExplicitVRLittleEndianTransferSyntax 1.2.840.10008.1.2.1.99
585 BigEndianExplicitTransferSyntax 1.2.840.10008.1.2.2
586 JPEGProcess1TransferSyntax 1.2.840.10008.1.2.4.50
587 JPEGProcess2_4TransferSyntax 1.2.840.10008.1.2.4.51
588 JPEGProcess14SV1TransferSyntax 1.2.840.10008.1.2.4.70
589 JPEGLSLosslessTransferSyntax 1.2.840.10008.1.2.4.80
590 JPEGLSLossyTransferSyntax 1.2.840.10008.1.2.4.81
591 JPEG2000LosslessOnlyTransferSyntax 1.2.840.10008.1.2.4.90
592 JPEG2000TransferSyntax 1.2.840.10008.1.2.4.91
593 MPEG2MainProfileAtMainLevelTransferSyntax 1.2.840.10008.1.2.4.100
594 MPEG2MainProfileAtHighLevelTransferSyntax 1.2.840.10008.1.2.4.101
595 RLELosslessTransferSyntax 1.2.840.10008.1.2.5
596 \endverbatim
597 
598 The \b dcmqrscp application does not support extended negotiation.
599 
600 \subsubsection scp_conformance SCP Conformance
601 
602 The \b dcmqrscp application supports the following SOP Classes as an SCP:
603 
604 \verbatim
605 VerificationSOPClass 1.2.840.10008.1.1
606 
607 FINDPatientRootQueryRetrieveInformationModel 1.2.840.10008.5.1.4.1.2.1.1
608 FINDPatientStudyOnlyQueryRetrieveInformationModel 1.2.840.10008.5.1.4.1.2.3.1
609 FINDStudyRootQueryRetrieveInformationModel 1.2.840.10008.5.1.4.1.2.2.1
610 GETPatientRootQueryRetrieveInformationModel 1.2.840.10008.5.1.4.1.2.1.3
611 GETPatientStudyOnlyQueryRetrieveInformationModel 1.2.840.10008.5.1.4.1.2.3.3
612 GETStudyRootQueryRetrieveInformationModel 1.2.840.10008.5.1.4.1.2.2.3
613 MOVEPatientRootQueryRetrieveInformationModel 1.2.840.10008.5.1.4.1.2.1.2
614 MOVEPatientStudyOnlyQueryRetrieveInformationModel 1.2.840.10008.5.1.4.1.2.3.2
615 MOVEStudyRootQueryRetrieveInformationModel 1.2.840.10008.5.1.4.1.2.2.2
616 
617 RETIRED_StoredPrintStorage 1.2.840.10008.5.1.1.27
618 RETIRED_HardcopyGrayscaleImageStorage 1.2.840.10008.5.1.1.29
619 RETIRED_HardcopyColorImageStorage 1.2.840.10008.5.1.1.30
620 ComputedRadiographyImageStorage 1.2.840.10008.5.1.4.1.1.1
621 DigitalXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.1.1
622 DigitalXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.1.1.1
623 DigitalMammographyXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.1.2
624 DigitalMammographyXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.1.2.1
625 DigitalIntraOralXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.1.3
626 DigitalIntraOralXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.1.3.1
627 CTImageStorage 1.2.840.10008.5.1.4.1.1.2
628 EnhancedCTImageStorage 1.2.840.10008.5.1.4.1.1.2.1
629 RETIRED_UltrasoundMultiframeImageStorage 1.2.840.10008.5.1.4.1.1.3
630 UltrasoundMultiframeImageStorage 1.2.840.10008.5.1.4.1.1.3.1
631 MRImageStorage 1.2.840.10008.5.1.4.1.1.4
632 EnhancedMRImageStorage 1.2.840.10008.5.1.4.1.1.4.1
633 MRSpectroscopyStorage 1.2.840.10008.5.1.4.1.1.4.2
634 EnhancedMRColorImageStorage 1.2.840.10008.5.1.4.1.1.4.3
635 RETIRED_NuclearMedicineImageStorage 1.2.840.10008.5.1.4.1.1.5
636 RETIRED_UltrasoundImageStorage 1.2.840.10008.5.1.4.1.1.6
637 UltrasoundImageStorage 1.2.840.10008.5.1.4.1.1.6.1
638 EnhancedUSVolumeStorage 1.2.840.10008.5.1.4.1.1.6.2
639 SecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7
640 MultiframeSingleBitSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.1
641 MultiframeGrayscaleByteSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.2
642 MultiframeGrayscaleWordSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.3
643 MultiframeTrueColorSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.4
644 RETIRED_StandaloneOverlayStorage 1.2.840.10008.5.1.4.1.1.8
645 RETIRED_StandaloneCurveStorage 1.2.840.10008.5.1.4.1.1.9
646 DRAFT_WaveformStorage 1.2.840.10008.5.1.4.1.1.9.1
647 TwelveLeadECGWaveformStorage 1.2.840.10008.5.1.4.1.1.9.1.1
648 GeneralECGWaveformStorage 1.2.840.10008.5.1.4.1.1.9.1.2
649 AmbulatoryECGWaveformStorage 1.2.840.10008.5.1.4.1.1.9.1.3
650 HemodynamicWaveformStorage 1.2.840.10008.5.1.4.1.1.9.2.1
651 CardiacElectrophysiologyWaveformStorage 1.2.840.10008.5.1.4.1.1.9.3.1
652 BasicVoiceAudioWaveformStorage 1.2.840.10008.5.1.4.1.1.9.4.1
653 GeneralAudioWaveformStorage 1.2.840.10008.5.1.4.1.1.9.4.2
654 ArterialPulseWaveformStorage 1.2.840.10008.5.1.4.1.1.9.5.1
655 RespiratoryWaveformStorage 1.2.840.10008.5.1.4.1.1.9.6.1
656 RETIRED_StandaloneModalityLUTStorage 1.2.840.10008.5.1.4.1.1.10
657 RETIRED_StandaloneVOILUTStorage 1.2.840.10008.5.1.4.1.1.11
658 GrayscaleSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.1
659 ColorSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.2
660 PseudoColorSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.3
661 BlendingSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.4
662 XAXRFGrayscaleSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.5
663 XRayAngiographicImageStorage 1.2.840.10008.5.1.4.1.1.12.1
664 EnhancedXAImageStorage 1.2.840.10008.5.1.4.1.1.12.1.1
665 XRayRadiofluoroscopicImageStorage 1.2.840.10008.5.1.4.1.1.12.2
666 EnhancedXRFImageStorage 1.2.840.10008.5.1.4.1.1.12.2.1
667 XRay3DAngiographicImageStorage 1.2.840.10008.5.1.4.1.1.13.1.1
668 XRay3DCraniofacialImageStorage 1.2.840.10008.5.1.4.1.1.13.1.2
669 BreastTomosynthesisImageStorage 1.2.840.10008.5.1.4.1.1.13.1.3
670 RETIRED_XRayAngiographicBiPlaneImageStorage 1.2.840.10008.5.1.4.1.1.12.3
671 NuclearMedicineImageStorage 1.2.840.10008.5.1.4.1.1.20
672 RawDataStorage 1.2.840.10008.5.1.4.1.1.66
673 SpatialRegistrationStorage 1.2.840.10008.5.1.4.1.1.66.1
674 SpatialFiducialsStorage 1.2.840.10008.5.1.4.1.1.66.2
675 DeformableSpatialRegistrationStorage 1.2.840.10008.5.1.4.1.1.66.3
676 SegmentationStorage 1.2.840.10008.5.1.4.1.1.66.4
677 SurfaceSegmentationStorage 1.2.840.10008.5.1.4.1.1.66.5
678 RealWorldValueMappingStorage 1.2.840.10008.5.1.4.1.1.67
679 RETIRED_VLImageStorage 1.2.840.10008.5.1.4.1.1.77.1
680 VLEndoscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.1
681 VideoEndoscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.1.1
682 VLMicroscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.2
683 VideoMicroscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.2.1
684 VLSlideCoordinatesMicroscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.3
685 VLPhotographicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.4
686 VideoPhotographicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.4.1
687 OphthalmicPhotography8BitImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.1
688 OphthalmicPhotography16BitImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.2
689 StereometricRelationshipStorage 1.2.840.10008.5.1.4.1.1.77.1.5.3
690 OphthalmicTomographyImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.4
691 VLWholeSlideMicroscopyImageStorage 1.2.840.10008.5.1.4.1.1.77.1.6
692 RETIRED_VLMultiFrameImageStorage 1.2.840.10008.5.1.4.1.1.77.2
693 LensometryMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.1
694 AutorefractionMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.2
695 KeratometryMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.3
696 SubjectiveRefractionMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.4
697 VisualAcuityMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.5
698 SpectaclePrescriptionReportStorage 1.2.840.10008.5.1.4.1.1.78.6
699 OphthalmicAxialMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.7
700 IntraocularLensCalculationsStorage 1.2.840.10008.5.1.4.1.1.78.8
701 MacularGridThicknessAndVolumeReportStorage 1.2.840.10008.5.1.4.1.1.79.1
702 OphthalmicVisualFieldStaticPerimetryMeasurementsSt. 1.2.840.10008.5.1.4.1.1.80.1
703 DRAFT_SRTextStorage 1.2.840.10008.5.1.4.1.1.88.1
704 DRAFT_SRAudioStorage 1.2.840.10008.5.1.4.1.1.88.2
705 DRAFT_SRDetailStorage 1.2.840.10008.5.1.4.1.1.88.3
706 DRAFT_SRComprehensiveStorage 1.2.840.10008.5.1.4.1.1.88.4
707 BasicTextSRStorage 1.2.840.10008.5.1.4.1.1.88.11
708 EnhancedSRStorage 1.2.840.10008.5.1.4.1.1.88.22
709 ComprehensiveSRStorage 1.2.840.10008.5.1.4.1.1.88.33
710 ProcedureLogStorage 1.2.840.10008.5.1.4.1.1.88.40
711 MammographyCADSRStorage 1.2.840.10008.5.1.4.1.1.88.50
712 KeyObjectSelectionDocumentStorage 1.2.840.10008.5.1.4.1.1.88.59
713 ChestCADSRStorage 1.2.840.10008.5.1.4.1.1.88.65
714 XRayRadiationDoseSRStorage 1.2.840.10008.5.1.4.1.1.88.67
715 ColonCADSRStorage 1.2.840.10008.5.1.4.1.1.88.69
716 ImplantationPlanSRDocumentStorage 1.2.840.10008.5.1.4.1.1.88.70
717 EncapsulatedPDFStorage 1.2.840.10008.5.1.4.1.1.104.1
718 EncapsulatedCDAStorage 1.2.840.10008.5.1.4.1.1.104.2
719 PositronEmissionTomographyImageStorage 1.2.840.10008.5.1.4.1.1.128
720 RETIRED_StandalonePETCurveStorage 1.2.840.10008.5.1.4.1.1.129
721 EnhancedPETImageStorage 1.2.840.10008.5.1.4.1.1.130
722 BasicStructuredDisplayStorage 1.2.840.10008.5.1.4.1.1.131
723 RTImageStorage 1.2.840.10008.5.1.4.1.1.481.1
724 RTDoseStorage 1.2.840.10008.5.1.4.1.1.481.2
725 RTStructureSetStorage 1.2.840.10008.5.1.4.1.1.481.3
726 RTBeamsTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.4
727 RTPlanStorage 1.2.840.10008.5.1.4.1.1.481.5
728 RTBrachyTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.6
729 RTTreatmentSummaryRecordStorage 1.2.840.10008.5.1.4.1.1.481.7
730 RTIonPlanStorage 1.2.840.10008.5.1.4.1.1.481.8
731 RTIonBeamsTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.9
732 DRAFT_RTBeamsDeliveryInstructionStorage 1.2.840.10008.5.1.4.34.1
733 GenericImplantTemplateStorage 1.2.840.10008.5.1.4.43.1
734 ImplantAssemblyTemplateStorage 1.2.840.10008.5.1.4.44.1
735 ImplantTemplateGroupStorage 1.2.840.10008.5.1.4.45.1
736 
737 PrivateShutdownSOPClass 1.2.276.0.7230010.3.4.1915765545.18030.917282194.0
738 \endverbatim
739 
740 The \b dcmqrscp application will accept presentation contexts for all of the
741 above mentioned supported SOP Classes using any of the transfer syntaxes:
742 
743 \verbatim
744 LittleEndianImplicitTransferSyntax 1.2.840.10008.1.2
745 LittleEndianExplicitTransferSyntax 1.2.840.10008.1.2.1
746 BigEndianExplicitTransferSyntax 1.2.840.10008.1.2.2
747 \endverbatim
748 
749 The \b dcmqrscp application will prefer transfer syntaxes having an explicit
750 encoding over the default implicit transfer syntax. If \b dcmqrscp is running
751 on big-endian hardware it will prefer BigEndianExplicit to LittleEndianExplicit
752 transfer syntax (and vice versa). This behaviour can be changed with the
753 \e --prefer options (see above). Depending on these options, the following
754 transfer syntaxes are supported:
755 
756 \verbatim
757 LittleEndianImplicitTransferSyntax 1.2.840.10008.1.2
758 LittleEndianExplicitTransferSyntax 1.2.840.10008.1.2.1
759 DeflatedExplicitVRLittleEndianTransferSyntax 1.2.840.10008.1.2.1.99
760 BigEndianExplicitTransferSyntax 1.2.840.10008.1.2.2
761 JPEGProcess1TransferSyntax 1.2.840.10008.1.2.4.50
762 JPEGProcess2_4TransferSyntax 1.2.840.10008.1.2.4.51
763 JPEGProcess14SV1TransferSyntax 1.2.840.10008.1.2.4.70
764 JPEGLSLosslessTransferSyntax 1.2.840.10008.1.2.4.80
765 JPEGLSLossyTransferSyntax 1.2.840.10008.1.2.4.81
766 JPEG2000LosslessOnlyTransferSyntax 1.2.840.10008.1.2.4.90
767 JPEG2000TransferSyntax 1.2.840.10008.1.2.4.91
768 MPEG2MainProfileAtMainLevelTransferSyntax 1.2.840.10008.1.2.4.100
769 MPEG2MainProfileAtHighLevelTransferSyntax 1.2.840.10008.1.2.4.101
770 RLELosslessTransferSyntax 1.2.840.10008.1.2.5
771 \endverbatim
772 
773 The \b dcmqrscp application does not support extended negotiation.
774 
775 \subsubsection query_keys Query Keys
776 
777 The \b dcmqrscp application supports the following attributes as query keys.
778 
779 Query/Retrieve Level: PATIENT (or STUDY for the Study Root Q/R model)
780 
781 \verbatim
782 (0010,0010) PatientName
783 (0010,0020) PatientID
784 (0010,0030) PatientBirthDate
785 (0010,0032) PatientBirthTime
786 (0010,0040) PatientSex
787 (0010,1000) OtherPatientIDs
788 (0010,1001) OtherPatientNames
789 (0010,2160) EthnicGroup
790 (0010,4000) PatientComments
791 (0020,1200) NumberOfPatientRelatedStudies
792 (0020,1202) NumberOfPatientRelatedSeries
793 (0020,1204) NumberOfPatientRelatedInstances
794 \endverbatim
795 
796 Query/Retrieve Level: STUDY
797 
798 \verbatim
799 (0008,0020) StudyDate
800 (0008,0030) StudyTime
801 (0008,0050) AccessionNumber
802 (0008,0090) ReferringPhysicianName
803 (0008,1030) StudyDescription
804 (0008,1060) NameOfPhysiciansReadingStudy
805 (0008,1080) AdmittingDiagnosesDescription
806 (0010,1010) PatientAge
807 (0010,1020) PatientSize
808 (0010,1030) PatientWeight
809 (0010,2180) Occupation
810 (0010,21B0) AdditionalPatientHistory
811 (0020,000D) StudyInstanceUID
812 (0020,0010) StudyID
813 (0020,1070) RETIRED_OtherStudyNumbers
814 (0020,1206) NumberOfStudyRelatedSeries
815 (0020,1208) NumberOfStudyRelatedInstances
816 \endverbatim
817 
818 Query/Retrieve Level: SERIES
819 
820 \verbatim
821 (0008,0060) Modality
822 (0020,000E) SeriesInstanceUID
823 (0020,0011) SeriesNumber
824 \endverbatim
825 
826 Query/Retrieve Level: IMAGE
827 
828 \verbatim
829 (0008,0018) SOPInstanceUID
830 (0020,0013) InstanceNumber
831 \endverbatim
832 
833 \subsection configuration Configuration
834 
835 The \b dcmqrscp program uses the same configuration file as the \b dcmqrti
836 program. See the documentation on configuration for more information.
837 
838 \subsection access_control Access Control
839 
840 When compiled on Unix platforms with TCP wrapper support, host-based access
841 control can be enabled with the \e --access-control command line option. In
842 this case the access control rules defined in the system's host access control
843 tables for \b dcmqrscp are enforced. The default locations of the host access
844 control tables are <em>/etc/hosts.allow</em> and <em>/etc/hosts.deny</em>.
845 Further details are described in <b>hosts_access</b>(5).
846 
847 \section logging LOGGING
848 
849 The level of logging output of the various command line tools and underlying
850 libraries can be specified by the user. By default, only errors and warnings
851 are written to the standard error stream. Using option \e --verbose also
852 informational messages like processing details are reported. Option
853 \e --debug can be used to get more details on the internal activity, e.g. for
854 debugging purposes. Other logging levels can be selected using option
855 \e --log-level. In \e --quiet mode only fatal errors are reported. In such
856 very severe error events, the application will usually terminate. For more
857 details on the different logging levels, see documentation of module "oflog".
858 
859 In case the logging output should be written to file (optionally with logfile
860 rotation), to syslog (Unix) or the event log (Windows) option \e --log-config
861 can be used. This configuration file also allows for directing only certain
862 messages to a particular output stream and for filtering certain messages
863 based on the module or application where they are generated. An example
864 configuration file is provided in <em><etcdir>/logger.cfg</em>).
865 
866 \section command_line COMMAND LINE
867 
868 All command line tools use the following notation for parameters: square
869 brackets enclose optional values (0-1), three trailing dots indicate that
870 multiple values are allowed (1-n), a combination of both means 0 to n values.
871 
872 Command line options are distinguished from parameters by a leading '+' or '-'
873 sign, respectively. Usually, order and position of command line options are
874 arbitrary (i.e. they can appear anywhere). However, if options are mutually
875 exclusive the rightmost appearance is used. This behaviour conforms to the
876 standard evaluation rules of common Unix shells.
877 
878 In addition, one or more command files can be specified using an '@' sign as a
879 prefix to the filename (e.g. <em>\@command.txt</em>). Such a command argument
880 is replaced by the content of the corresponding text file (multiple
881 whitespaces are treated as a single separator unless they appear between two
882 quotation marks) prior to any further evaluation. Please note that a command
883 file cannot contain another command file. This simple but effective approach
884 allows to summarize common combinations of options/parameters and avoids
885 longish and confusing command lines (an example is provided in file
886 <em><datadir>/dumppat.txt</em>).
887 
888 \section environment ENVIRONMENT
889 
890 The \b dcmqrscp utility will attempt to load DICOM data dictionaries specified
891 in the \e DCMDICTPATH environment variable. By default, i.e. if the
892 \e DCMDICTPATH environment variable is not set, the file
893 <em><datadir>/dicom.dic</em> will be loaded unless the dictionary is built into
894 the application (default for Windows).
895 
896 The default behaviour should be preferred and the \e DCMDICTPATH environment
897 variable only used when alternative data dictionaries are required. The
898 \e DCMDICTPATH environment variable has the same format as the Unix shell
899 \e PATH variable in that a colon (":") separates entries. On Windows systems,
900 a semicolon (";") is used as a separator. The data dictionary code will
901 attempt to load each file specified in the \e DCMDICTPATH environment variable.
902 It is an error if no data dictionary can be loaded.
903 
904 \section files FILES
905 
906 <em><docdir>/dcmqrcnf.txt</em> - configuration information
907 \n<em><docdir>/dcmqrset.txt</em> - setup information
908 \n<em><etcdir>/dcmqrscp.cfg</em> - example configuration file
909 
910 \section see_also SEE ALSO
911 
912 <b>dcmqrti</b>(1)
913 
914 \section copyright COPYRIGHT
915 
916 Copyright (C) 1993-2010 by OFFIS e.V., Escherweg 2, 26121 Oldenburg, Germany.
917 
918 */


Generated on Wed Dec 14 2016 for OFFIS DCMTK Version 3.6.0 by Doxygen 1.8.11