1storescp(1) OFFIS DCMTK storescp(1)
2
6 storescp - DICOM storage (C-STORE) SCP
7
10 storescp [options] [port]
11
13 The storescp application implements a Service Class Provider (SCP) for
14 the Storage Service Class. It listens on a specific TCP/IP port for
15 incoming association requests from a Storage Service Class User (SCU)
16 and can receive both DICOM images and other DICOM composite objects.
17 The storescp application also supports the Verification Service Class
18 as an SCP.
19
21 port tcp/ip port number to listen on
22 (this parameter is required unless the --inetd option is specified)
23
25 general options
26 -h --help
27 print this help text and exit
28 --version
30 print version information and exit
31 --arguments
33 print expanded command line arguments
34 -q --quiet
36 quiet mode, print no warnings and errors
37 -v --verbose
39 verbose mode, print processing details
40 -d --debug
42 debug mode, print debug information
43 -ll --log-level [l]evel: string constant
45 (fatal, error, warn, info, debug, trace)
46 use level l for the logger
47 -lc --log-config [f]ilename: string
49 use config file f for the logger
50 +v --verbose-pc
52 show presentation contexts in verbose mode
53 multi-process options
55 --single-process
56 single process mode (default)
57 --fork
59 fork child process for each association
60 network options
62 association negotiation profile from configuration file:
63 -xf --config-file [f]ilename [p]rofile: string
65 use profile p from config file f
66 preferred network transfer syntaxes (not with --config-file):
68 +x= --prefer-uncompr
70 prefer explicit VR local byte order (default)
71 +xe --prefer-little
73 prefer explicit VR little endian TS
74 +xb --prefer-big
76 prefer explicit VR big endian TS
77 +xs --prefer-lossless
79 prefer default JPEG lossless TS
80 +xy --prefer-jpeg8
82 prefer default JPEG lossy TS for 8 bit data
83 +xx --prefer-jpeg12
85 prefer default JPEG lossy TS for 12 bit data
86 +xv --prefer-j2k-lossless
88 prefer JPEG 2000 lossless TS
89 +xw --prefer-j2k-lossy
91 prefer JPEG 2000 lossy TS
92 +xt --prefer-jls-lossless
94 prefer JPEG-LS lossless TS
95 +xu --prefer-jls-lossy
97 prefer JPEG-LS lossy TS
98 +xm --prefer-mpeg2
100 prefer MPEG2 Main Profile @ Main Level TS
101 +xh --prefer-mpeg2-high
103 prefer MPEG2 Main Profile @ High Level TS
104 +xn --prefer-mpeg4
106 prefer MPEG4 AVC/H.264 High Profile / Level 4.1 TS
107 +xl --prefer-mpeg4-bd
109 prefer MPEG4 AVC/H.264 BD-compatible HP / Level 4.1 TS
110 +x2 --prefer-mpeg4-2-2d
112 prefer MPEG4 AVC/H.264 HP / Level 4.2 TS for 2D Videos
113 +x3 --prefer-mpeg4-2-3d
115 prefer MPEG4 AVC/H.264 HP / Level 4.2 TS for 3D Videos
116 +xo --prefer-mpeg4-2-st
118 prefer MPEG4 AVC/H.264 Stereo HP / Level 4.2 TS
119 +x4 --prefer-hevc
121 prefer HEVC H.265 Main Profile / Level 5.1 TS
122 +x5 --prefer-hevc10
124 prefer HEVC H.265 Main 10 Profile / Level 5.1 TS
125 +xr --prefer-rle
127 prefer RLE lossless TS
128 +xd --prefer-deflated
130 prefer deflated explicit VR little endian TS
131 +xi --implicit
133 accept implicit VR little endian TS only
134 +xa --accept-all
136 accept all supported transfer syntaxes
137 network host access control (tcp wrapper):
139 -ac --access-full
141 accept connections from any host (default)
142 +ac --access-control
144 enforce host access control rules
145 other network options:
147 -id --inetd
149 run from inetd super server (not with --fork)
150 # not available on all systems (e.g. not on Windows)
152 -ts --socket-timeout [s]econds: integer (default: 60)
154 timeout for network socket (0 for none)
155 -ta --acse-timeout [s]econds: integer (default: 30)
157 timeout for ACSE messages
158 -td --dimse-timeout [s]econds: integer (default: unlimited)
160 timeout for DIMSE messages
161 -aet --aetitle [a]etitle: string
163 set my AE title (default: STORESCP)
164 -pdu --max-pdu [n]umber of bytes: integer (4096..131072)
166 set max receive pdu to n bytes (default: 16384)
167 -dhl --disable-host-lookup
169 disable hostname lookup
170 --refuse
172 refuse association
173 --reject
175 reject association if no implementation class UID
176 --ignore
178 ignore store data, receive but do not store
179 --sleep-after [s]econds: integer
181 sleep s seconds after store (default: 0)
182 --sleep-during [s]econds: integer
184 sleep s seconds during store (default: 0)
185 --abort-after
187 abort association after receipt of C-STORE-RQ
188 (but before sending response)
189 --abort-during
191 abort association during receipt of C-STORE-RQ
192 -pm --promiscuous
194 promiscuous mode, accept unknown SOP classes
195 (not with --config-file)
196 -up --uid-padding
198 silently correct space-padded UIDs
199 transport layer security (TLS) options
201 transport protocol stack:
202 -tls --disable-tls
204 use normal TCP/IP connection (default)
205 +tls --enable-tls [p]rivate key file, [c]ertificate file: string
207 use authenticated secure TLS connection
208 private key password (only with --enable-tls):
210 +ps --std-passwd
212 prompt user to type password on stdin (default)
213 +pw --use-passwd [p]assword: string
215 use specified password
216 -pw --null-passwd
218 use empty string as password
219 key and certificate file format:
221 -pem --pem-keys
223 read keys and certificates as PEM file (default)
224 -der --der-keys
226 read keys and certificates as DER file
227 certification authority:
229 +cf --add-cert-file [f]ilename: string
231 add certificate file to list of certificates
232 +cd --add-cert-dir [d]irectory: string
234 add certificates in d to list of certificates
235 +crl --add-crl-file [f]ilename: string
237 add certificate revocation list file
238 (implies --enable-crl-vfy)
239 +crv --enable-crl-vfy
241 enable leaf CRL verification
242 +cra --enable-crl-all
244 enable full chain CRL verification
245 security profile:
247 +py --profile-bcp195-nd
249 Non-downgrading BCP 195 TLS Profile (default)
250 +px --profile-bcp195
252 BCP 195 TLS Profile
253 +pz --profile-bcp195-ex
255 Extended BCP 195 TLS Profile
256 +pb --profile-basic
258 Basic TLS Secure Transport Connection Profile (retired)
259 +pa --profile-aes
261 AES TLS Secure Transport Connection Profile (retired)
262 +pn --profile-null
264 Authenticated unencrypted communication
265 (retired, was used in IHE ATNA)
266 ciphersuite:
268 +cc --list-ciphers
270 show list of supported TLS ciphersuites and exit
271 +cs --cipher [c]iphersuite name: string
273 add ciphersuite to list of negotiated suites
274 +dp --dhparam [f]ilename: string
276 read DH parameters for DH/DSS ciphersuites
277 pseudo random generator:
279 +rs --seed [f]ilename: string
281 seed random generator with contents of f
282 +ws --write-seed
284 write back modified seed (only with --seed)
285 +wf --write-seed-file [f]ilename: string (only with --seed)
287 write modified seed to file f
288 peer authentication:
290 -rc --require-peer-cert
292 verify peer certificate, fail if absent (default)
293 -vc --verify-peer-cert
295 verify peer certificate if present
296 -ic --ignore-peer-cert
298 don't verify peer certificate
299 output options
301 general:
302 -od --output-directory [d]irectory: string (default: ".")
304 write received objects to existing directory d
305 bit preserving mode:
307 -B --normal
309 allow implicit format conversions (default)
310 +B --bit-preserving
312 write data exactly as read
313 output file format:
315 +F --write-file
317 write file format (default)
318 -F --write-dataset
320 write data set without file meta information
321 output transfer syntax
323 (not with --bit-preserving or compressed transmission):
324 +t= --write-xfer-same
326 write with same TS as input (default)
327 +te --write-xfer-little
329 write with explicit VR little endian TS
330 +tb --write-xfer-big
332 write with explicit VR big endian TS
333 +ti --write-xfer-implicit
335 write with implicit VR little endian TS
336 +td --write-xfer-deflated
338 write with deflated explicit VR little endian TS
339 post-1993 value representations (not with --bit-preserving):
341 +u --enable-new-vr
343 enable support for new VRs (UN/UT) (default)
344 -u --disable-new-vr
346 disable support for new VRs, convert to OB
347 group length encoding (not with --bit-preserving):
349 +g= --group-length-recalc
351 recalculate group lengths if present (default)
352 +g --group-length-create
354 always write with group length elements
355 -g --group-length-remove
357 always write without group length elements
358 length encoding in sequences and items (not with --bit-preserving):
360 +e --length-explicit
362 write with explicit lengths (default)
363 -e --length-undefined
365 write with undefined lengths
366 data set trailing padding
368 (not with --write-dataset or --bit-preserving):
369 -p --padding-off
371 no padding (default)
372 +p --padding-create [f]ile-pad [i]tem-pad: integer
374 align file on multiple of f bytes and items on
375 multiple of i bytes
376 handling of defined length UN elements:
378 -uc --retain-un
380 retain elements as UN (default)
381 +uc --convert-un
383 convert to real VR if known
384 deflate compression level (only with --write-xfer-deflated/same):
386 +cl --compression-level [l]evel: integer (default: 6)
388 0=uncompressed, 1=fastest, 9=best compression
389 sorting into subdirectories (not with --bit-preserving):
391 -ss --sort-conc-studies [p]refix: string
393 sort studies using prefix p and a timestamp
394 -su --sort-on-study-uid [p]refix: string
396 sort studies using prefix p and the Study Instance UID
397 -sp --sort-on-patientname
399 sort studies using the Patient's Name and a timestamp
400 filename generation:
402 -uf --default-filenames
404 generate filename from instance UID (default)
405 +uf --unique-filenames
407 generate unique filenames
408 -tn --timenames
410 generate filename from creation time
411 -fe --filename-extension [e]xtension: string
413 append e to all filenames
414 event options
416 -xcr --exec-on-reception [c]ommand: string
417 execute command c after having received and processed
418 one C-STORE-RQ message
419 -xcs --exec-on-eostudy [c]ommand: string
421 execute command c after having received and processed
422 all C-STORE-RQ messages that belong to one study
423 -rns --rename-on-eostudy
425 having received and processed all C-STORE-RQ messages
426 that belong to one study, rename output files according
427 to a certain pattern
428 -tos --eostudy-timeout [t]imeout: integer
430 specifies a timeout of t seconds for end-of-study
431 determination
432 -xs --exec-sync
434 execute command synchronously in foreground
435
437 The semantic impacts of the above mentioned options is clear for the
438 majority of options. Some particular options, however, are so specific
439 that they need detailed descriptions which will be given in this
440 passage.
441 Option --sort-conc-studies enables a user to sort all received DICOM
443 objects into different subdirectories. The sorting will be done with
444 regard to the studies the individual objects belong to, i.e. objects
445 that belong to the same study will be stored in the same subdirectory.
446 In general, a DICOM object d_n+1 is considered to belong to the same
447 study as a DICOM object d_n if and only if d_n and d_n+1 show the exact
448 same values in attribute Study Instance UID. The names of the resulting
449 subdirectories always start with a prefix p which was passed to this
450 option as a parameter. In addition to this prefix, the subdirectory
451 names contain time stamp information with regard to the date and time
452 of reception of this particular study's first DICOM object. In detail,
453 the determination of the subdirectory names pertains to the pattern
454 [prefix]_[YYYYMMDD]_[HHMMSSPPP]
456 where YYYY refers to year (4 digits), MM to month (01-12), DD to day
458 (01-31), HH to hour (00-23), MM to minute (00-59), SS to second (00-59)
459 and PPP to milliseconds (000-999). If the prefix is an empty string,
460 the first '_' is omitted.
461 The other --sort-xxx options work in a similar manner, only the
463 subdirectory names are created differently. For option --sort-on-study-
464 uid the pattern is
465 [prefix]_[StudyInstanceUID]
467 and for option --sort-on-patientname
469 [PatientName]_[YYYYMMDD]_[HHMMSSPPP]
471 where 'PatientName' is replaced by 'ANONYMOUS' if the data element is
473 empty or absent in the data set. Any existing patient name is
474 transformed in order to use only ASCII characters. Please note that in
475 this context only the DICOM default character set (ASCII, i.e. no entry
476 in attribute Specific Character Set) and Latin-1 (Specific Character
477 Set valued 'ISO_IR 100') are supported. If another character set is
478 found and the patient name contains non-ASCII characters, a warning is
479 printed and the transformation is performed as if Latin-1 character set
480 would be set in the file. This may lead to unreadable or unexpected
481 patient name directories and behaviour. Thus, it is advisable to use
482 --sort-on-patientname only if Latin-1 or ASCII patient names are
483 expected to be received.
484 For option --sort-on-study-uid the same subdirectory will be used for
486 all DICOM objects that belong to the same study, i.e. in contrast to
487 the other --sort-xxx options there is no guarantee that a study
488 directory is ever completed.
489 Option --timenames creates filenames from timestamps corresponding to
491 the time, storescp writes a file to disk. The format is
492 [YYYYMMDDHHMMSSPPP]_[SERIALNO].[MD]
494 where YYYY, MM, DD, HH, MM, SS, PPP are interpreted as described above.
496 If more files are created at the same time, SERIALNO is inserted. It
497 consists of a 4-digit, consecutive number (0000 to 9999). For the first
498 file, that exists for a specific time, no number (and no '_') is
499 inserted at all. MD represents an identification code (2 letters) for
500 the kind of object stored in the file (see notes on --rename-on-
501 eostudy).
502 Option --filename-extension appends a specified suffix to each filename
504 (a dot '.' is not added automatically). This suffix is not appended to
505 the filenames created by --rename-on-eostudy to maintain the length of
506 8 characters.
507 Option --exec-on-reception allows one to execute a certain command line
509 after having received and processed one DICOM object (through a C-
510 STORE-RQ message). The command line to be executed is passed to this
511 option as a parameter. The specified command line may contain a number
512 of placeholders which will be replaced at run time:
513 • #p: complete path to the output directory into which the last DICOM
515 object was stored (not available with option --ignore though)
516 • #f: filename of the current output file (not available with option
517 --ignore though)
518 • #a: calling application entity title of the peer Storage SCU
519 • #c: called application entity title used by the peer Storage SCU to
520 address storescp
521 • #r: calling presentation address, i.e. hostname or IP address of the
522 peer Storage SCU
523 The specified command line is executed as a separate process, so that
524 the execution of storescp will not be held back. This behavior can be
525 influenced with the --exec-sync option.
526 Option --exec-on-eostudy allows one to execute a certain command line
527 when all DICOM objects that belong to one study have been received by
528 storescp. The same placeholders as with --exec-on-reception may be
529 used, except for '#f', which is not supported. A study is considered
530 complete by storescp when an object belonging to a different study is
531 received or the timeout specified with --eostudy-timeout takes place.
532 If option --rename-on-eostudy is in force, the renaming takes place
533 before the external command is executed.
534 Option --rename-on-eostudy refers to the above mentioned --sort-xxx
535 options and can only be used in combination with one of these options.
536 If a user specifies option --rename-on-eostudy and storescp determines
537 that all DICOM objects that belong to a certain study have been
538 received, all DICOM files that belong to the last study will be renamed
539 in the corresponding output directory. The filenames into which the
540 files are being renamed will be calculated using the pattern
541 [prefix][consecutive numbering]
542 where [prefix] is a 2 character prefix that reveals the kind of DICOM
543 object stored in the file and [consecutive numbering] is a
544 consecutively numbered, 6-digit number, starting at '000001'. In
545 general, the question if all DICOM objects that belong to one study
546 have been received by storescp will be answered positively if and only
547 if two consecutively received DICOM objects d_n and d_n+1 do not show
548 the same values in attribute Study Instance UID; in such a case, d_n+1
549 is considered to belong to a new study.
550 Using option --eostudy-timeout a user can modify the determination
551 process to figure out if all DICOM objects that belong to one study
552 have already been received by storescp. With regard to this fact, it is
553 clear that this option can only be used in combination with at least
554 one of the following options: --sort-xxx, --exec-on-eostudy and
555 --rename-on-eostudy. If option --eostudy-timeout is specified, the end
556 of a study is considered to have occurred not only if two consecutively
557 received DICOM objects d_n and d_n+1 do not show the same values in
558 attribute Study Instance UID, but also if within a time span of x
559 seconds after the reception of a DICOM object d_n, no other DICOM
560 object was received over the network. Note that the amount x of seconds
561 (which determines the length of this time span) has to be passed to
562 this option as a parameter.
563 Please note that two consecutive network connections can transfer
564 objects for the same study. The study will only be considered complete
565 when an object of a different study is received or the --eostudy-
566 timeout is reached. For this reason, the options --fork and --inet are
567 incompatible with --exec-on-eostudy, --rename-on-eostudy and --sort-
568 conc-studies.
569 DICOM Conformance
570 The storescp application supports the following SOP Classes as an SCP:
571 VerificationSOPClass 1.2.840.10008.1.1
572 RETIRED_StoredPrintStorage 1.2.840.10008.5.1.1.27
574 RETIRED_HardcopyGrayscaleImageStorage 1.2.840.10008.5.1.1.29
575 RETIRED_HardcopyColorImageStorage 1.2.840.10008.5.1.1.30
576 ComputedRadiographyImageStorage 1.2.840.10008.5.1.4.1.1.1
577 DigitalXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.1.1
578 DigitalXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.1.1.1
579 DigitalMammographyXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.1.2
580 DigitalMammographyXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.1.2.1
581 DigitalIntraOralXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.1.3
582 DigitalIntraOralXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.1.3.1
583 CTImageStorage 1.2.840.10008.5.1.4.1.1.2
584 EnhancedCTImageStorage 1.2.840.10008.5.1.4.1.1.2.1
585 LegacyConvertedEnhancedCTImageStorage 1.2.840.10008.5.1.4.1.1.2.2
586 RETIRED_UltrasoundMultiframeImageStorage 1.2.840.10008.5.1.4.1.1.3
587 UltrasoundMultiframeImageStorage 1.2.840.10008.5.1.4.1.1.3.1
588 MRImageStorage 1.2.840.10008.5.1.4.1.1.4
589 EnhancedMRImageStorage 1.2.840.10008.5.1.4.1.1.4.1
590 MRSpectroscopyStorage 1.2.840.10008.5.1.4.1.1.4.2
591 EnhancedMRColorImageStorage 1.2.840.10008.5.1.4.1.1.4.3
592 LegacyConvertedEnhancedMRImageStorage 1.2.840.10008.5.1.4.1.1.4.4
593 RETIRED_NuclearMedicineImageStorage 1.2.840.10008.5.1.4.1.1.5
594 RETIRED_UltrasoundImageStorage 1.2.840.10008.5.1.4.1.1.6
595 UltrasoundImageStorage 1.2.840.10008.5.1.4.1.1.6.1
596 EnhancedUSVolumeStorage 1.2.840.10008.5.1.4.1.1.6.2
597 SecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7
598 MultiframeSingleBitSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.1
599 MultiframeGrayscaleByteSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.2
600 MultiframeGrayscaleWordSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.3
601 MultiframeTrueColorSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.4
602 RETIRED_StandaloneOverlayStorage 1.2.840.10008.5.1.4.1.1.8
603 RETIRED_StandaloneCurveStorage 1.2.840.10008.5.1.4.1.1.9
604 DRAFT_WaveformStorage 1.2.840.10008.5.1.4.1.1.9.1
605 TwelveLeadECGWaveformStorage 1.2.840.10008.5.1.4.1.1.9.1.1
606 GeneralECGWaveformStorage 1.2.840.10008.5.1.4.1.1.9.1.2
607 AmbulatoryECGWaveformStorage 1.2.840.10008.5.1.4.1.1.9.1.3
608 HemodynamicWaveformStorage 1.2.840.10008.5.1.4.1.1.9.2.1
609 CardiacElectrophysiologyWaveformStorage 1.2.840.10008.5.1.4.1.1.9.3.1
610 BasicVoiceAudioWaveformStorage 1.2.840.10008.5.1.4.1.1.9.4.1
611 GeneralAudioWaveformStorage 1.2.840.10008.5.1.4.1.1.9.4.2
612 ArterialPulseWaveformStorage 1.2.840.10008.5.1.4.1.1.9.5.1
613 RespiratoryWaveformStorage 1.2.840.10008.5.1.4.1.1.9.6.1
614 MultichannelRespiratoryWaveformStorage 1.2.840.10008.5.1.4.1.1.9.6.2
615 RoutineScalpElectroencephalogramWaveformStorage 1.2.840.10008.5.1.4.1.1.9.7.1
616 ElectromyogramWaveformStorage 1.2.840.10008.5.1.4.1.1.9.7.2
617 ElectrooculogramWaveformStorage 1.2.840.10008.5.1.4.1.1.9.7.3
618 SleepElectroencephalogramWaveformStorage 1.2.840.10008.5.1.4.1.1.9.7.4
619 BodyPositionWaveformStorage 1.2.840.10008.5.1.4.1.1.9.8.1
620 RETIRED_StandaloneModalityLUTStorage 1.2.840.10008.5.1.4.1.1.10
621 RETIRED_StandaloneVOILUTStorage 1.2.840.10008.5.1.4.1.1.11
622 GrayscaleSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.1
623 ColorSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.2
624 PseudoColorSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.3
625 BlendingSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.4
626 XAXRFGrayscaleSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.5
627 GrayscalePlanarMPRVolumetricPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.6
628 CompositingPlanarMPRVolumetricPresent.StateStorage 1.2.840.10008.5.1.4.1.1.11.7
629 AdvancedBlendingPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.8
630 VolumeRenderingVolumetricPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.9
631 SegmentedVolumeRenderingVolumetricPres.StateStorage 1.2.840.10008.5.1.4.1.1.11.10
632 MultipleVolumeRenderingVolumetricPres.StateStorage 1.2.840.10008.5.1.4.1.1.11.11
633 XRayAngiographicImageStorage 1.2.840.10008.5.1.4.1.1.12.1
634 EnhancedXAImageStorage 1.2.840.10008.5.1.4.1.1.12.1.1
635 XRayRadiofluoroscopicImageStorage 1.2.840.10008.5.1.4.1.1.12.2
636 EnhancedXRFImageStorage 1.2.840.10008.5.1.4.1.1.12.2.1
637 RETIRED_XRayAngiographicBiPlaneImageStorage 1.2.840.10008.5.1.4.1.1.12.3
638 XRay3DAngiographicImageStorage 1.2.840.10008.5.1.4.1.1.13.1.1
639 XRay3DCraniofacialImageStorage 1.2.840.10008.5.1.4.1.1.13.1.2
640 BreastTomosynthesisImageStorage 1.2.840.10008.5.1.4.1.1.13.1.3
641 BreastProjectionXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.13.1.4
642 BreastProjectionXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.13.1.5
643 IntravascularOpt.Coh.Tom.ImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.14.1
644 IntravascularOpt.Coh.Tom.ImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.14.2
645 NuclearMedicineImageStorage 1.2.840.10008.5.1.4.1.1.20
646 ParametricMapStorage 1.2.840.10008.5.1.4.1.1.30
647 RawDataStorage 1.2.840.10008.5.1.4.1.1.66
648 SpatialRegistrationStorage 1.2.840.10008.5.1.4.1.1.66.1
649 SpatialFiducialsStorage 1.2.840.10008.5.1.4.1.1.66.2
650 DeformableSpatialRegistrationStorage 1.2.840.10008.5.1.4.1.1.66.3
651 SegmentationStorage 1.2.840.10008.5.1.4.1.1.66.4
652 SurfaceSegmentationStorage 1.2.840.10008.5.1.4.1.1.66.5
653 TractographyResultsStorage 1.2.840.10008.5.1.4.1.1.66.6
654 RealWorldValueMappingStorage 1.2.840.10008.5.1.4.1.1.67
655 SurfaceScanMeshStorage 1.2.840.10008.5.1.4.1.1.68.1
656 SurfaceScanPointCloudStorage 1.2.840.10008.5.1.4.1.1.68.2
657 RETIRED_VLImageStorage 1.2.840.10008.5.1.4.1.1.77.1
658 VLEndoscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.1
659 VideoEndoscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.1.1
660 VLMicroscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.2
661 VideoMicroscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.2.1
662 VLSlideCoordinatesMicroscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.3
663 VLPhotographicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.4
664 VideoPhotographicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.4.1
665 OphthalmicPhotography8BitImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.1
666 OphthalmicPhotography16BitImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.2
667 StereometricRelationshipStorage 1.2.840.10008.5.1.4.1.1.77.1.5.3
668 OphthalmicTomographyImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.4
669 WideFieldOphthalmicPhoto.Stereogr.Proj.ImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.5
670 WideFieldOphthalmicPhotogr.3DCoordinatesImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.6
671 OphthalmicOpticalCoherenceTomogr.EnFaceImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.7
672 OphthalmicOpticalCoh.Tomogr.BscanVolumeAnalysisStor. 1.2.840.10008.5.1.4.1.1.77.1.5.8
673 VLWholeSlideMicroscopyImageStorage 1.2.840.10008.5.1.4.1.1.77.1.6
674 DermoscopicPhotographyImageStorage 1.2.840.10008.5.1.4.1.1.77.1.7
675 RETIRED_VLMultiframeImageStorage 1.2.840.10008.5.1.4.1.1.77.2
676 LensometryMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.1
677 AutorefractionMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.2
678 KeratometryMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.3
679 SubjectiveRefractionMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.4
680 VisualAcuityMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.5
681 SpectaclePrescriptionReportStorage 1.2.840.10008.5.1.4.1.1.78.6
682 OphthalmicAxialMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.7
683 IntraocularLensCalculationsStorage 1.2.840.10008.5.1.4.1.1.78.8
684 MacularGridThicknessAndVolumeReportStorage 1.2.840.10008.5.1.4.1.1.79.1
685 OphthalmicVisualFieldStaticPerimetryMeasurementsSt. 1.2.840.10008.5.1.4.1.1.80.1
686 OphthalmicThicknessMapStorage 1.2.840.10008.5.1.4.1.1.81.1
687 CornealTopographyMapStorage 1.2.840.10008.5.1.4.1.1.82.1
688 DRAFT_SRTextStorage 1.2.840.10008.5.1.4.1.1.88.1
689 DRAFT_SRAudioStorage 1.2.840.10008.5.1.4.1.1.88.2
690 DRAFT_SRDetailStorage 1.2.840.10008.5.1.4.1.1.88.3
691 DRAFT_SRComprehensiveStorage 1.2.840.10008.5.1.4.1.1.88.4
692 BasicTextSRStorage 1.2.840.10008.5.1.4.1.1.88.11
693 EnhancedSRStorage 1.2.840.10008.5.1.4.1.1.88.22
694 ComprehensiveSRStorage 1.2.840.10008.5.1.4.1.1.88.33
695 Comprehensive3DSRStorage 1.2.840.10008.5.1.4.1.1.88.34
696 ExtensibleSRStorage 1.2.840.10008.5.1.4.1.1.88.35
697 ProcedureLogStorage 1.2.840.10008.5.1.4.1.1.88.40
698 MammographyCADSRStorage 1.2.840.10008.5.1.4.1.1.88.50
699 KeyObjectSelectionDocumentStorage 1.2.840.10008.5.1.4.1.1.88.59
700 ChestCADSRStorage 1.2.840.10008.5.1.4.1.1.88.65
701 XRayRadiationDoseSRStorage 1.2.840.10008.5.1.4.1.1.88.67
702 RadiopharmaceuticalRadiationDoseSRStorage 1.2.840.10008.5.1.4.1.1.88.68
703 ColonCADSRStorage 1.2.840.10008.5.1.4.1.1.88.69
704 ImplantationPlanSRDocumentStorage 1.2.840.10008.5.1.4.1.1.88.70
705 AcquisitionContextSRStorage 1.2.840.10008.5.1.4.1.1.88.71
706 SimplifiedAdultEchoSRStorage 1.2.840.10008.5.1.4.1.1.88.72
707 PatientRadiationDoseSRStorage 1.2.840.10008.5.1.4.1.1.88.73
708 PlannedImagingAgentAdministrationSRStorage 1.2.840.10008.5.1.4.1.1.88.74
709 PerformedImagingAgentAdministrationSRStorage 1.2.840.10008.5.1.4.1.1.88.75
710 EnhancedXRayRadiationDoseSRStorage 1.2.840.10008.5.1.4.1.1.88.76
711 ContentAssessmentResultsStorage 1.2.840.10008.5.1.4.1.1.90.1
712 MicroscopyBulkSimpleAnnotationsStorage 1.2.840.10008.5.1.4.1.1.91.1
713 EncapsulatedPDFStorage 1.2.840.10008.5.1.4.1.1.104.1
714 EncapsulatedCDAStorage 1.2.840.10008.5.1.4.1.1.104.2
715 EncapsulatedSTLStorage 1.2.840.10008.5.1.4.1.1.104.3
716 EncapsulatedOBJStorage 1.2.840.10008.5.1.4.1.1.104.4
717 EncapsulatedMTLStorage 1.2.840.10008.5.1.4.1.1.104.5
718 PositronEmissionTomographyImageStorage 1.2.840.10008.5.1.4.1.1.128
719 LegacyConvertedEnhancedPETImageStorage 1.2.840.10008.5.1.4.1.1.128.1
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 CTPerformedProcedureProtocolStorage 1.2.840.10008.5.1.4.1.1.200.2
724 XAPerformedProcedureProtocolStorage 1.2.840.10008.5.1.4.1.1.200.8
725 RTImageStorage 1.2.840.10008.5.1.4.1.1.481.1
726 RTDoseStorage 1.2.840.10008.5.1.4.1.1.481.2
727 RTStructureSetStorage 1.2.840.10008.5.1.4.1.1.481.3
728 RTBeamsTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.4
729 RTPlanStorage 1.2.840.10008.5.1.4.1.1.481.5
730 RTBrachyTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.6
731 RTTreatmentSummaryRecordStorage 1.2.840.10008.5.1.4.1.1.481.7
732 RTIonPlanStorage 1.2.840.10008.5.1.4.1.1.481.8
733 RTIonBeamsTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.9
734 RTPhysicianIntentStorage 1.2.840.10008.5.1.4.1.1.481.10
735 RTSegmentAnnotationStorage 1.2.840.10008.5.1.4.1.1.481.11
736 RTRadiationSetStorage 1.2.840.10008.5.1.4.1.1.481.12
737 CArmPhotonElectronRadiationStorage 1.2.840.10008.5.1.4.1.1.481.13
738 TomotherapeuticRadiationStorage 1.2.840.10008.5.1.4.1.1.481.14
739 RoboticArmRadiationStorage 1.2.840.10008.5.1.4.1.1.481.15
740 RTRadiationRecordSetStorage 1.2.840.10008.5.1.4.1.1.481.16
741 RTRadiationSalvageRecordStorage 1.2.840.10008.5.1.4.1.1.481.17
742 TomotherapeuticRadiationRecordStorage 1.2.840.10008.5.1.4.1.1.481.18
743 CArmPhotonElectronRadiationRecordStorage 1.2.840.10008.5.1.4.1.1.481.19
744 RoboticRadiationRecordStorage 1.2.840.10008.5.1.4.1.1.481.20
745 RTRadiationSetDeliveryInstructionStorage 1.2.840.10008.5.1.4.1.1.481.21
746 RTTreatmentPreparationStorage 1.2.840.10008.5.1.4.1.1.481.22
747 DICOS_CTImageStorage 1.2.840.10008.5.1.4.1.1.501.1
748 DICOS_DigitalXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.501.2.1
749 DICOS_DigitalXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.501.2.2
750 DICOS_ThreatDetectionReportStorage 1.2.840.10008.5.1.4.1.1.501.3
751 DICOS_2DAITStorage 1.2.840.10008.5.1.4.1.1.501.4
752 DICOS_3DAITStorage 1.2.840.10008.5.1.4.1.1.501.5
753 DICOS_QuadrupoleResonanceStorage 1.2.840.10008.5.1.4.1.1.501.6
754 DICONDE_EddyCurrentImageStorage 1.2.840.10008.5.1.4.1.1.601.1
755 DICONDE_EddyCurrentMultiframeImageStorage 1.2.840.10008.5.1.4.1.1.601.2
756 DRAFT_RTBeamsDeliveryInstructionStorage 1.2.840.10008.5.1.4.34.1
757 RTBeamsDeliveryInstructionStorage 1.2.840.10008.5.1.4.34.7
758 RTBrachyApplicationSetupDeliveryInstructionStorage 1.2.840.10008.5.1.4.34.10
759 The storescp application will accept presentation contexts for all of
760 the abovementioned supported SOP Classes using any of the following
761 transfer syntaxes:
762 LittleEndianImplicitTransferSyntax 1.2.840.10008.1.2
763 LittleEndianExplicitTransferSyntax 1.2.840.10008.1.2.1
764 BigEndianExplicitTransferSyntax 1.2.840.10008.1.2.2
765 The default behavior of the storescp application is to prefer transfer
766 syntaxes having an explicit encoding over the default implicit transfer
767 syntax. If storescp is running on big-endian hardware it will prefer
768 BigEndianExplicit to LittleEndianExplicit transfer syntax (and vice
769 versa). This behavior can be changed with the --prefer options (see
770 above). Using option --accept-all any of the following transfer
771 syntaxes is supported:
772 LittleEndianImplicitTransferSyntax 1.2.840.10008.1.2
773 LittleEndianExplicitTransferSyntax 1.2.840.10008.1.2.1
774 DeflatedExplicitVRLittleEndianTransferSyntax 1.2.840.10008.1.2.1.99
775 BigEndianExplicitTransferSyntax 1.2.840.10008.1.2.2
776 JPEGProcess1TransferSyntax 1.2.840.10008.1.2.4.50
777 JPEGProcess2_4TransferSyntax 1.2.840.10008.1.2.4.51
778 JPEGProcess14SV1TransferSyntax 1.2.840.10008.1.2.4.70
779 JPEGLSLosslessTransferSyntax 1.2.840.10008.1.2.4.80
780 JPEGLSLossyTransferSyntax 1.2.840.10008.1.2.4.81
781 JPEG2000LosslessOnlyTransferSyntax 1.2.840.10008.1.2.4.90
782 JPEG2000TransferSyntax 1.2.840.10008.1.2.4.91
783 MPEG2MainProfileAtMainLevelTransferSyntax 1.2.840.10008.1.2.4.100
784 MPEG2MainProfileAtHighLevelTransferSyntax 1.2.840.10008.1.2.4.101
785 MPEG4HighProfileLevel4_1TransferSyntax 1.2.840.10008.1.2.4.102
786 MPEG4BDcompatibleHighProfileLevel4_1TransferSyntax 1.2.840.10008.1.2.4.103
787 MPEG4HighProfileLevel4_2_For2DVideoTransferSyntax 1.2.840.10008.1.2.4.104
788 MPEG4HighProfileLevel4_2_For3DVideoTransferSyntax 1.2.840.10008.1.2.4.105
789 MPEG4StereoHighProfileLevel4_2TransferSyntax 1.2.840.10008.1.2.4.106
790 HEVCMainProfileLevel5_1TransferSyntax 1.2.840.10008.1.2.4.107
791 HEVCMain10ProfileLevel5_1TransferSyntax 1.2.840.10008.1.2.4.108
792 RLELosslessTransferSyntax 1.2.840.10008.1.2.5
793 Additional Storage SOP Classes and Transfer Syntaxes can be used with
794 the so-called 'association negotiation profiles' (see below).
795 The storescp application does not support extended negotiation by
796 default. However, using an appropriate association negotiation profile
797 (see below) the optional support for extended negotiation can be added
798 to particular SOP classes.
799 Access Control
800 When compiled on Unix platforms with TCP wrapper support, host-based
801 access control can be enabled with the --access-control command line
802 option. In this case the access control rules defined in the system's
803 host access control tables for storescp are enforced. The default
804 locations of the host access control tables are /etc/hosts.allow and
805 /etc/hosts.deny. Further details are described in hosts_access(5).
806 Running storescp from inetd
807 On Posix platforms, storescp can be initiated through the inetd(8)
808 super server. This requires that storescp be configured in the
809 /etc/inetd.conf configuration file. A typical configuration line could
810 look like this:
811 acr-nema stream tcp nowait root /usr/sbin/storescp -id +ac -od /tmp/storescp
812 where -id (--inetd) activates the inetd mode in which the DICOM
813 association is actually accepted by inetd and passed to storescp, +ac
814 (--access-control) activates the TCP wrapper based access control
815 described above and -od (--output-directory) defines the directory in
816 which storescp stores incoming DICOM objects. Note that the service
817 name ('acr-nema' in this example) determines the port number on which
818 DICOM associations are accepted and must be defined in /etc/services.
819 When running from inetd, the stdout and stderr streams are discarded.
820 However, you can still configure logging via the --log-config option
821 (see below).
822 Please note that when run through inetd, storescp is executed with root
823 privileges, which may be a security risk.
824 Association Negotiation Profiles and Configuration Files
825 storescp supports a flexible mechanism for specifying the DICOM network
826 association negotiation behavior, based on so-called 'association
827 negotiation profiles' which may be read from a configuration file. The
828 format and semantics of this configuration file are documented in
829 asconfig.txt.
831 The level of logging output of the various command line tools and
832 underlying libraries can be specified by the user. By default, only
833 errors and warnings are written to the standard error stream. Using
834 option --verbose also informational messages like processing details
835 are reported. Option --debug can be used to get more details on the
836 internal activity, e.g. for debugging purposes. Other logging levels
837 can be selected using option --log-level. In --quiet mode only fatal
838 errors are reported. In such very severe error events, the application
839 will usually terminate. For more details on the different logging
840 levels, see documentation of module 'oflog'.
841 In case the logging output should be written to file (optionally with
842 logfile rotation), to syslog (Unix) or the event log (Windows) option
843 --log-config can be used. This configuration file also allows for
844 directing only certain messages to a particular output stream and for
845 filtering certain messages based on the module or application where
846 they are generated. An example configuration file is provided in
847 <etcdir>/logger.cfg.
849 All command line tools use the following notation for parameters:
850 square brackets enclose optional values (0-1), three trailing dots
851 indicate that multiple values are allowed (1-n), a combination of both
852 means 0 to n values.
853 Command line options are distinguished from parameters by a leading '+'
854 or '-' sign, respectively. Usually, order and position of command line
855 options are arbitrary (i.e. they can appear anywhere). However, if
856 options are mutually exclusive the rightmost appearance is used. This
857 behavior conforms to the standard evaluation rules of common Unix
858 shells.
859 In addition, one or more command files can be specified using an '@'
860 sign as a prefix to the filename (e.g. @command.txt). Such a command
861 argument is replaced by the content of the corresponding text file
862 (multiple whitespaces are treated as a single separator unless they
863 appear between two quotation marks) prior to any further evaluation.
864 Please note that a command file cannot contain another command file.
865 This simple but effective approach allows one to summarize common
866 combinations of options/parameters and avoids longish and confusing
867 command lines (an example is provided in file <datadir>/dumppat.txt).
869 The storescp utility will attempt to load DICOM data dictionaries
870 specified in the DCMDICTPATH environment variable. By default, i.e. if
871 the DCMDICTPATH environment variable is not set, the file
872 <datadir>/dicom.dic will be loaded unless the dictionary is built into
873 the application (default for Windows).
874 The default behavior should be preferred and the DCMDICTPATH
875 environment variable only used when alternative data dictionaries are
876 required. The DCMDICTPATH environment variable has the same format as
877 the Unix shell PATH variable in that a colon (':') separates entries.
878 On Windows systems, a semicolon (';') is used as a separator. The data
879 dictionary code will attempt to load each file specified in the
880 DCMDICTPATH environment variable. It is an error if no data dictionary
881 can be loaded.
883 <docdir>/asconfig.txt - configuration file documentation
884 <etcdir>/storescp.cfg - example association negotiation profile
886 storescu(1)
888 Copyright (C) 1996-2022 by OFFIS e.V., Escherweg 2, 26121 Oldenburg,
889 Germany.
890Version 3.6.7 Fri Apr 22 2022 storescp(1)