4 \page dcmqrscp DICOM image archive (central test node)
6 \page dcmqrscp dcmqrscp: DICOM image archive (central test node)
9 \section synopsis SYNOPSIS
12 dcmqrscp [options] [port]
15 \section description DESCRIPTION
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
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.
29 \section parameters PARAMETERS
32 port tcp/ip port number to listen on (default: in config file)
35 \section options OPTIONS
37 \subsection general_options general options
40 print this help text and exit
43 print version information and exit
46 print expanded command line arguments
49 quiet mode, print no warnings and errors
52 verbose mode, print processing details
55 debug mode, print debug information
57 -ll --log-level [l]evel: string constant
58 (fatal, error, warn, info, debug, trace)
59 use level l for the logger
61 -lc --log-config [f]ilename: string
62 use config file f for the logger
64 -c --config [f]ilename: string
65 use specific configuration file
66 (default: /usr/local/etc/dcmtk/dcmqrscp.cfg)
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).
78 \subsection multiprocess_options multi-process options
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
90 fork child process for each association (default)
93 \subsection database_options database options
95 association negotiation:
98 reject all MOVE/GET presentation contexts for
99 which no corresponding FIND context is proposed
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.
108 reject multiple simultaneous STORE presentation
109 contexts for one application entity title
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
119 disable C-GET support
122 allow external shutdown via a private SOP class
124 checking identifier validity:
127 check C-FIND identifier validity
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.
135 do not check C-FIND identifier validity (default)
138 check C-MOVE identifier validity
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.
147 do not check C-MOVE identifier validity (default)
149 restriction of move targets:
152 do not restrict move destination (default)
155 restrict move destination to requesting AE title
158 restrict move destination to requesting host
161 restrict move destination to requesting vendor
163 restriction of query/retrieve models:
165 -QP --no-patient-root
166 do not support Patient Root Q/R models
169 do not support Study Root Q/R models
171 -QO --no-patient-study
172 do not support Patient/Study Only Q/R models
175 \subsection network_options network options
177 preferred network transfer syntaxes (incoming associations):
180 prefer explicit VR local byte order (default)
183 prefer explicit VR little endian TS
186 prefer explicit VR big endian TS
188 +xs --prefer-lossless
189 prefer default JPEG lossless TS
192 prefer default JPEG lossy TS for 8 bit data
195 prefer default JPEG lossy TS for 12 bit data
197 +xv --prefer-j2k-lossless
198 prefer JPEG 2000 lossless TS
200 +xw --prefer-j2k-lossy
201 prefer JPEG 2000 lossy TS
203 +xt --prefer-jls-lossless
204 prefer JPEG-LS lossless TS
206 +xu --prefer-jls-lossy
207 prefer JPEG-LS lossy TS
210 prefer MPEG2 Main Profile @ Main Level TS
212 +xh --prefer-mpeg2-high
213 prefer MPEG2 Main Profile @ High Level TS
216 prefer RLE lossless TS
218 +xd --prefer-deflated
219 prefer deflated explicit VR little endian TS
222 accept implicit VR little endian TS only
224 proposed transmission transfer syntaxes (outgoing associations):
226 -x= --propose-uncompr
227 propose all uncompressed TS, explicit VR
228 with local byte ordering first (default)
231 propose all uncompressed TS, explicit VR little endian first
234 propose all uncompressed TS, explicit VR big endian first
236 -xi --propose-implicit
237 propose implicit VR little endian TS only
239 -xs --propose-lossless
240 propose default JPEG lossless TS
241 and all uncompressed transfer syntaxes
244 propose default JPEG lossy TS for 8 bit data
245 and all uncompressed transfer syntaxes
248 propose default JPEG lossy TS for 12 bit data
249 and all uncompressed transfer syntaxes
251 -xv --propose-j2k-lossless
252 propose JPEG 2000 lossless TS
253 and all uncompressed transfer syntaxes
255 -xw --propose-j2k-lossy
256 propose JPEG 2000 lossy TS
257 and all uncompressed transfer syntaxes
259 -xt --propose-jls-lossless
260 propose JPEG-LS lossless TS
261 and all uncompressed transfer syntaxes
263 -xu --propose-jls-lossy
264 propose JPEG-LS lossy TS
265 and all uncompressed transfer syntaxes
268 propose MPEG2 Main Profile @ Main Level TS only
270 -xh --propose-mpeg2-high
271 propose MPEG2 Main Profile @ High Level TS only
274 propose RLE lossless TS
275 and all uncompressed transfer syntaxes
277 -xd --propose-deflated
278 propose deflated explicit VR little endian TS
279 and all uncompressed transfer syntaxes
281 network host access control (tcp wrapper):
284 accept connections from any host (default)
287 enforce host access control rules
289 other network options:
291 -to --timeout [s]econds: integer (default: unlimited)
292 timeout for connection requests
294 -ta --acse-timeout [s]econds: integer (default: 30)
295 timeout for ACSE messages
297 -td --dimse-timeout [s]econds: integer (default: unlimited)
298 timeout for DIMSE messages
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)
304 -dhl --disable-host-lookup
305 disable hostname lookup
311 reject association if no implementation class UID
314 ignore store data, receive but do not store
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.
322 silently correct space-padded UIDs
325 \subsection encoding_options encoding options
327 post-1993 value representations:
330 enable support for new VRs (UN/UT) (default)
333 disable support for new VRs, convert to OB
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.
341 \subsection output_options output options
346 allow implicit format conversions (default)
349 write data exactly as read
354 write file format (default)
357 write data set without file meta information
359 output transfer syntax:
360 (not with --bit-preserving or compressed transmission)
362 +t= --write-xfer-same
363 write with same TS as input (default)
365 +te --write-xfer-little
366 write with explicit VR little endian TS
369 write with explicit VR big endian TS
371 +ti --write-xfer-implicit
372 write with implicit VR little endian TS
374 +td --write-xfer-deflated
375 write with deflated explicit VR little endian TS
377 group length encoding (not with --bit-preserving):
379 +g= --group-length-recalc
380 recalculate group lengths if present (default)
382 +g --group-length-create
383 always write with group length elements
385 -g --group-length-remove
386 always write without group length elements
388 length encoding in sequences and items (not with --bit-preserving):
391 write with explicit lengths (default)
393 -e --length-undefined
394 write with undefined lengths
396 data set trailing padding (not with --write-dataset or --bit-preserving):
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
405 deflate compression level (only with --propose-deflated or
406 --write-xfer-deflated/same):
408 +cl --compression-level [l]evel: integer (default: 6)
409 0=uncompressed, 1=fastest, 9=best compression
414 \subsection operation Operation
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
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.
436 Under normal operations \b dcmqrscp will never exit, it keeps on waiting for
437 new associations until killed.
439 \subsection dicom_conformance DICOM Conformance
441 \subsubsection scu_conformance SCU Conformance
443 The \b dcmqrscp application supports the following SOP Classes as an SCU:
446 VerificationSOPClass 1.2.840.10008.1.1
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
569 The \b dcmqrscp application will propose presentation contexts for all of the
570 abovementioned supported SOP Classes using the transfer syntaxes:
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
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:
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
598 The \b dcmqrscp application does not support extended negotiation.
600 \subsubsection scp_conformance SCP Conformance
602 The \b dcmqrscp application supports the following SOP Classes as an SCP:
605 VerificationSOPClass 1.2.840.10008.1.1
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
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
737 PrivateShutdownSOPClass 1.2.276.0.7230010.3.4.1915765545.18030.917282194.0
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:
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
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:
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
773 The \b dcmqrscp application does not support extended negotiation.
775 \subsubsection query_keys Query Keys
777 The \b dcmqrscp application supports the following attributes as query keys.
779 Query/Retrieve Level: PATIENT (or STUDY for the Study Root Q/R model)
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
796 Query/Retrieve Level: STUDY
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
813 (0020,1070) RETIRED_OtherStudyNumbers
814 (0020,1206) NumberOfStudyRelatedSeries
815 (0020,1208) NumberOfStudyRelatedInstances
818 Query/Retrieve Level: SERIES
822 (0020,000E) SeriesInstanceUID
823 (0020,0011) SeriesNumber
826 Query/Retrieve Level: IMAGE
829 (0008,0018) SOPInstanceUID
830 (0020,0013) InstanceNumber
833 \subsection configuration Configuration
835 The \b dcmqrscp program uses the same configuration file as the \b dcmqrti
836 program. See the documentation on configuration for more information.
838 \subsection access_control Access Control
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).
847 \section logging LOGGING
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".
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>).
866 \section command_line COMMAND LINE
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.
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.
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>).
888 \section environment ENVIRONMENT
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).
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.
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
910 \section see_also SEE ALSO
914 \section copyright COPYRIGHT
916 Copyright (C) 1993-2010 by OFFIS e.V., Escherweg 2, 26121 Oldenburg, Germany.