1storescp(1) OFFIS DCMTK storescp(1)
2
3
4
6 storescp - DICOM storage (C-STORE) SCP
7
9 storescp [options] [port]
10
12 The storescp application implements a Service Class Provider (SCP) for
13 the Storage Service Class. It listens on a specific TCP/IP port for
14 incoming association requests from a Storage Service Class User (SCU)
15 and can receive both DICOM images and other DICOM composite objects.
16 The storescp application also supports the Verification Service Class
17 as an SCP.
18
20 port tcp/ip port number to listen on
21 (this parameter is required unless the --inetd option is specified)
22
24 general options
25 -h --help
26 print this help text and exit
27
28 --version
29 print version information and exit
30
31 --arguments
32 print expanded command line arguments
33
34 -q --quiet
35 quiet mode, print no warnings and errors
36
37 -v --verbose
38 verbose mode, print processing details
39
40 -d --debug
41 debug mode, print debug information
42
43 -ll --log-level [l]evel: string constant
44 (fatal, error, warn, info, debug, trace)
45 use level l for the logger
46
47 -lc --log-config [f]ilename: string
48 use config file f for the logger
49
50 +v --verbose-pc
51 show presentation contexts in verbose mode
52
53 multi-process options
54 --single-process
55 single process mode (default)
56
57 --fork
58 fork child process for each association
59
60 network options
61 association negotiation profile from configuration file:
62
63 -xf --config-file [f]ilename [p]rofile: string
64 use profile p from config file f
65
66 preferred network transfer syntaxes (not with --config-file):
67
68 +x= --prefer-uncompr
69 prefer explicit VR local byte order (default)
70
71 +xe --prefer-little
72 prefer explicit VR little endian TS
73
74 +xb --prefer-big
75 prefer explicit VR big endian TS
76
77 +xs --prefer-lossless
78 prefer default JPEG lossless TS
79
80 +xy --prefer-jpeg8
81 prefer default JPEG lossy TS for 8 bit data
82
83 +xx --prefer-jpeg12
84 prefer default JPEG lossy TS for 12 bit data
85
86 +xv --prefer-j2k-lossless
87 prefer JPEG 2000 lossless TS
88
89 +xw --prefer-j2k-lossy
90 prefer JPEG 2000 lossy TS
91
92 +xt --prefer-jls-lossless
93 prefer JPEG-LS lossless TS
94
95 +xu --prefer-jls-lossy
96 prefer JPEG-LS lossy TS
97
98 +xm --prefer-mpeg2
99 prefer MPEG2 Main Profile @ Main Level TS
100
101 +xh --prefer-mpeg2-high
102 prefer MPEG2 Main Profile @ High Level TS
103
104 +xr --prefer-rle
105 prefer RLE lossless TS
106
107 +xd --prefer-deflated
108 prefer deflated explicit VR little endian TS
109
110 +xi --implicit
111 accept implicit VR little endian TS only
112
113 +xa --accept-all
114 accept all supported transfer syntaxes
115
116 network host access control (tcp wrapper):
117
118 -ac --access-full
119 accept connections from any host (default)
120
121 +ac --access-control
122 enforce host access control rules
123
124 other network options:
125
126 -id --inetd
127 run from inetd super server (not with --fork)
128 (this option is available only on Posix platforms)
129
130 -ta --acse-timeout [s]econds: integer (default: 30)
131 timeout for ACSE messages
132
133 -td --dimse-timeout [s]econds: integer (default: unlimited)
134 timeout for DIMSE messages
135
136 -aet --aetitle [a]etitle: string
137 set my AE title (default: STORESCP)
138
139 -pdu --max-pdu [n]umber of bytes: integer (4096..131072)
140 set max receive pdu to n bytes (default: 16384)
141
142 -dhl --disable-host-lookup
143 disable hostname lookup
144
145 --refuse
146 refuse association
147
148 --reject
149 reject association if no implementation class UID
150
151 --ignore
152 ignore store data, receive but do not store
153
154 --sleep-after [s]econds: integer
155 sleep s seconds after store (default: 0)
156
157 --sleep-during [s]econds: integer
158 sleep s seconds during store (default: 0)
159
160 --abort-after
161 abort association after receipt of C-STORE-RQ
162 (but before sending response)
163
164 --abort-during
165 abort association during receipt of C-STORE-RQ
166
167 -pm --promiscuous
168 promiscuous mode, accept unknown SOP classes
169 (not with --config-file)
170
171 -up --uid-padding
172 silently correct space-padded UIDs
173
175 general:
176
177 -od --output-directory [d]irectory: string (default: ".")
178 write received objects to existing directory d
179
180 bit preserving mode:
181
182 -B --normal
183 allow implicit format conversions (default)
184
185 +B --bit-preserving
186 write data exactly as read
187
188 output file format:
189
190 +F --write-file
191 write file format (default)
192
193 -F --write-dataset
194 write data set without file meta information
195
196 output transfer syntax
197 (not with --bit-preserving or compressed transmission):
198
199 +t= --write-xfer-same
200 write with same TS as input (default)
201
202 +te --write-xfer-little
203 write with explicit VR little endian TS
204
205 +tb --write-xfer-big
206 write with explicit VR big endian TS
207
208 +ti --write-xfer-implicit
209 write with implicit VR little endian TS
210
211 +td --write-xfer-deflated
212 write with deflated explicit VR little endian TS
213
214 post-1993 value representations (not with --bit-preserving):
215
216 +u --enable-new-vr
217 enable support for new VRs (UN/UT) (default)
218
219 -u --disable-new-vr
220 disable support for new VRs, convert to OB
221
222 group length encoding (not with --bit-preserving):
223
224 +g= --group-length-recalc
225 recalculate group lengths if present (default)
226
227 +g --group-length-create
228 always write with group length elements
229
230 -g --group-length-remove
231 always write without group length elements
232
233 length encoding in sequences and items (not with --bit-preserving):
234
235 +e --length-explicit
236 write with explicit lengths (default)
237
238 -e --length-undefined
239 write with undefined lengths
240
241 data set trailing padding
242 (not with --write-dataset or --bit-preserving):
243
244 -p --padding-off
245 no padding (default)
246
247 +p --padding-create [f]ile-pad [i]tem-pad: integer
248 align file on multiple of f bytes and items on
249 multiple of i bytes
250
251 deflate compression level (only with --write-xfer-deflated/same):
252
253 +cl --compression-level [l]evel: integer (default: 6)
254 0=uncompressed, 1=fastest, 9=best compression
255
256 sorting into subdirectories (not with --bit-preserving):
257
258 -ss --sort-conc-studies [p]refix: string
259 sort studies using prefix p and a timestamp
260
261 -su --sort-on-study-uid [p]refix: string
262 sort studies using prefix p and the Study Instance UID
263
264 -sp --sort-on-patientname
265 sort studies using the Patient's Name and a timestamp
266
267 filename generation:
268
269 -uf --default-filenames
270 generate filename from instance UID (default)
271
272 +uf --unique-filenames
273 generate unique filenames
274
275 -tn --timenames
276 generate filename from creation time
277
278 -fe --filename-extension [e]xtension: string
279 append e to all filenames
280
281 event options
282 -xcr --exec-on-reception [c]ommand: string
283 execute command c after having received and processed
284 one C-STORE-RQ message
285
286 -xcs --exec-on-eostudy [c]ommand: string
287 execute command c after having received and processed
288 all C-STORE-RQ messages that belong to one study
289
290 -rns --rename-on-eostudy
291 having received and processed all C-STORE-RQ messages
292 that belong to one study, rename output files according
293 to a certain pattern
294
295 -tos --eostudy-timeout [t]imeout: integer
296 specifies a timeout of t seconds for end-of-study
297 determination
298
299 -xs --exec-sync
300 execute command synchronously in foreground
301
302 transport layer security (TLS) options
303 transport protocol stack:
304
305 -tls --disable-tls
306 use normal TCP/IP connection (default)
307
308 +tls --enable-tls [p]rivate key file, [c]ertificate file: string
309 use authenticated secure TLS connection
310
311 private key password (only with --enable-tls):
312
313 +ps --std-passwd
314 prompt user to type password on stdin (default)
315
316 +pw --use-passwd [p]assword: string
317 use specified password
318
319 -pw --null-passwd
320 use empty string as password
321
322 key and certificate file format:
323
324 -pem --pem-keys
325 read keys and certificates as PEM file (default)
326
327 -der --der-keys
328 read keys and certificates as DER file
329
330 certification authority:
331
332 +cf --add-cert-file [c]ertificate filename: string
333 add certificate file to list of certificates
334
335 +cd --add-cert-dir [c]ertificate directory: string
336 add certificates in d to list of certificates
337
338 ciphersuite:
339
340 +cs --cipher [c]iphersuite name: string
341 add ciphersuite to list of negotiated suites
342
343 +dp --dhparam [f]ilename: string
344 read DH parameters for DH/DSS ciphersuites
345
346 pseudo random generator:
347
348 +rs --seed [f]ilename: string
349 seed random generator with contents of f
350
351 +ws --write-seed
352 write back modified seed (only with --seed)
353
354 +wf --write-seed-file [f]ilename: string (only with --seed)
355 write modified seed to file f
356
357 peer authentication:
358
359 -rc --require-peer-cert
360 verify peer certificate, fail if absent (default)
361
362 -vc --verify-peer-cert
363 verify peer certificate if present
364
365 -ic --ignore-peer-cert
366 don't verify peer certificate
367
369 The semantic impacts of the above mentioned options is clear for the
370 majority of options. Some particular options, however, are so specific
371 that they need detailed descriptions which will be given in this
372 passage.
373
374 Option --sort-conc-studies enables a user to sort all received DICOM
375 objects into different subdirectories. The sorting will be done with
376 regard to the studies the individual objects belong to, i.e. objects
377 that belong to the same study will be stored in the same subdirectory.
378 In general, a DICOM object d_n+1 is considered to belong to the same
379 study as a DICOM object d_n if and only if d_n and d_n+1 show the exact
380 same values in attribute Study Instance UID. The names of the resulting
381 subdirectories always start with a prefix p which was passed to this
382 option as a parameter. In addition to this prefix, the subdirectory
383 names contain time stamp information with regard to the date and time
384 of reception of this particular study's first DICOM object. In detail,
385 the determination of the subdirectory names pertains to the pattern
386
387 [prefix]_[YYYYMMDD]_[HHMMSSPPP]
388
389 where YYYY refers to year (4 digits), MM to month (01-12), DD to day
390 (01-31), HH to hour (00-23), MM to minute (00-59), SS to second (00-59)
391 and PPP to milliseconds (000-999). If the prefix is an empty string,
392 the first '_' is omitted.
393
394 The other --sort-xxx options work in a similar manner, only the
395 subdirectory names are created differently. For option --sort-on-study-
396 uid the pattern is
397
398 [prefix]_[StudyInstanceUID]
399
400 and for option --sort-on-patientname
401
402 [PatientName]_[YYYYMMDD]_[HHMMSSPPP]
403
404 where 'PatientName' is replaced by 'ANONYMOUS' if the data element is
405 empty or absent in the data set. Please note, however, that for option
406 --sort-on-study-uid the same subdirectory will be used for all DICOM
407 objects that belong to the same study, i.e. in contrast to the other
408 --sort-xxx options there is no guarantee that a study directory is ever
409 completed.
410
411 Option --timenames creates filenames from timestamps corresponding to
412 the time, storescp writes a file to disk. The format is
413
414 [YYYYMMDDHHMMSSPPP]_[SERIALNO].[MD]
415
416 where YYYY, MM, DD, HH, MM, SS, PPP are interpreted as described above.
417 If more files are created at the same time, SERIALNO is inserted. It
418 consists of a 4-digit, consecutive number (0000 to 9999). For the first
419 file, that exists for a specific time, no number (and no '_') is
420 inserted at all. MD represents an identification code (2 letters) for
421 the kind of object stored in the file (see notes on --rename-on-
422 eostudy).
423
424 Option --filename-extension appends a specified suffix to each filename
425 (a dot '.' is not added automatically). This suffix is not appended to
426 the filenames created by --rename-on-eostudy to maintain the length of
427 8 characters.
428
429 Option --exec-on-reception allows to execute a certain command line
430 after having received and processed one DICOM object (through a C-
431 STORE-RQ message). The command line to be executed is passed to this
432 option as a parameter. The specified command line may contain a number
433 of placeholders which will be replaced at run time:
434
435 · #p: complete path to the output directory into which the last DICOM
436 object was stored (not available with option --ignore though)
437 · #f: filename of the current output file (not available with option
438 --ignore though)
439 · #a: calling application entity title of the peer Storage SCU
440 · #c: called application entity title used by the peer Storage SCU to
441 address storescp
442 · #r: calling presentation address, i.e. hostname or IP address of the
443 peer Storage SCU
444 The specified command line is executed as a separate process, so that
445 the execution of storescp will not be held back.
446 Option --exec-on-eostudy allows to execute a certain command line when
447 all DICOM objects that belong to one study have been received by
448 storescp. The same placeholders as with --exec-on-reception may be
449 used, except for '#f', which is not supported. A study is considered
450 complete by storescp when an object belonging to a different study is
451 received or the timeout specified with --eostudy-timeout takes place.
452 If option --rename-on-eostudy is in force, the renaming takes place
453 before the external command is executed.
454 Option --rename-on-eostudy refers to the above mentioned --sort-xxx
455 options and can only be used in combination with one of these options.
456 If a user specifies option --rename-on-eostudy and storescp determines
457 that all DICOM objects that belong to a certain study have been
458 received, all DICOM files that belong to the last study will be renamed
459 in the corresponding output directory. The filenames into which the
460 files are being renamed will be calculated using the pattern
461 [prefix][consecutive numbering]
462 where [prefix] is a 2 character prefix that reveals the kind of DICOM
463 object stored in the file and [consecutive numbering] is a
464 consecutively numbered, 6-digit number, starting at '000001'. In
465 general, the question if all DICOM objects that belong to one study
466 have been received by storescp will be answered positively if and only
467 if two consecutively received DICOM objects d_n and d_n+1 do not show
468 the same values in attribute Study Instance UID; in such a case, d_n+1
469 is considered to belong to a new study.
470 Using option --eostudy-timeout a user can modify the determination
471 process to figure out if all DICOM objects that belong to one study
472 have already been received by storescp. With regard to this fact, it is
473 clear that this option can only be used in combination with at least
474 one of the following options: --sort-xxx, --exec-on-eostudy and
475 --rename-on-eostudy. If option --eostudy-timeout is specified, the end
476 of a study is considered to have occurred not only if two consecutively
477 received DICOM objects d_n and d_n+1 do not show the same values in
478 attribute Study Instance UID, but also if whithin a time span of x
479 seconds after the reception of a DICOM object d_n, no other DICOM
480 object was received over the network. Note that the amount x of seconds
481 (which determines the length of this time span) has to be passed to
482 this option as a parameter.
483 DICOM Conformance
484 The storescp application supports the following SOP Classes as an SCP:
485 VerificationSOPClass 1.2.840.10008.1.1
486
487 RETIRED_StoredPrintStorage 1.2.840.10008.5.1.1.27
488 RETIRED_HardcopyGrayscaleImageStorage 1.2.840.10008.5.1.1.29
489 RETIRED_HardcopyColorImageStorage 1.2.840.10008.5.1.1.30
490 ComputedRadiographyImageStorage 1.2.840.10008.5.1.4.1.1.1
491 DigitalXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.1.1
492 DigitalXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.1.1.1
493 DigitalMammographyXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.1.2
494 DigitalMammographyXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.1.2.1
495 DigitalIntraOralXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.1.3
496 DigitalIntraOralXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.1.3.1
497 CTImageStorage 1.2.840.10008.5.1.4.1.1.2
498 EnhancedCTImageStorage 1.2.840.10008.5.1.4.1.1.2.1
499 RETIRED_UltrasoundMultiframeImageStorage 1.2.840.10008.5.1.4.1.1.3
500 UltrasoundMultiframeImageStorage 1.2.840.10008.5.1.4.1.1.3.1
501 MRImageStorage 1.2.840.10008.5.1.4.1.1.4
502 EnhancedMRImageStorage 1.2.840.10008.5.1.4.1.1.4.1
503 MRSpectroscopyStorage 1.2.840.10008.5.1.4.1.1.4.2
504 EnhancedMRColorImageStorage 1.2.840.10008.5.1.4.1.1.4.3
505 RETIRED_NuclearMedicineImageStorage 1.2.840.10008.5.1.4.1.1.5
506 RETIRED_UltrasoundImageStorage 1.2.840.10008.5.1.4.1.1.6
507 UltrasoundImageStorage 1.2.840.10008.5.1.4.1.1.6.1
508 EnhancedUSVolumeStorage 1.2.840.10008.5.1.4.1.1.6.2
509 SecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7
510 MultiframeSingleBitSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.1
511 MultiframeGrayscaleByteSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.2
512 MultiframeGrayscaleWordSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.3
513 MultiframeTrueColorSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.4
514 RETIRED_StandaloneOverlayStorage 1.2.840.10008.5.1.4.1.1.8
515 RETIRED_StandaloneCurveStorage 1.2.840.10008.5.1.4.1.1.9
516 DRAFT_WaveformStorage 1.2.840.10008.5.1.4.1.1.9.1
517 TwelveLeadECGWaveformStorage 1.2.840.10008.5.1.4.1.1.9.1.1
518 GeneralECGWaveformStorage 1.2.840.10008.5.1.4.1.1.9.1.2
519 AmbulatoryECGWaveformStorage 1.2.840.10008.5.1.4.1.1.9.1.3
520 HemodynamicWaveformStorage 1.2.840.10008.5.1.4.1.1.9.2.1
521 CardiacElectrophysiologyWaveformStorage 1.2.840.10008.5.1.4.1.1.9.3.1
522 BasicVoiceAudioWaveformStorage 1.2.840.10008.5.1.4.1.1.9.4.1
523 GeneralAudioWaveformStorage 1.2.840.10008.5.1.4.1.1.9.4.2
524 ArterialPulseWaveformStorage 1.2.840.10008.5.1.4.1.1.9.5.1
525 RespiratoryWaveformStorage 1.2.840.10008.5.1.4.1.1.9.6.1
526 RETIRED_StandaloneModalityLUTStorage 1.2.840.10008.5.1.4.1.1.10
527 RETIRED_StandaloneVOILUTStorage 1.2.840.10008.5.1.4.1.1.11
528 GrayscaleSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.1
529 ColorSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.2
530 PseudoColorSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.3
531 BlendingSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.4
532 XAXRFGrayscaleSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.5
533 XRayAngiographicImageStorage 1.2.840.10008.5.1.4.1.1.12.1
534 EnhancedXAImageStorage 1.2.840.10008.5.1.4.1.1.12.1.1
535 XRayRadiofluoroscopicImageStorage 1.2.840.10008.5.1.4.1.1.12.2
536 EnhancedXRFImageStorage 1.2.840.10008.5.1.4.1.1.12.2.1
537 XRay3DAngiographicImageStorage 1.2.840.10008.5.1.4.1.1.13.1.1
538 XRay3DCraniofacialImageStorage 1.2.840.10008.5.1.4.1.1.13.1.2
539 BreastTomosynthesisImageStorage 1.2.840.10008.5.1.4.1.1.13.1.3
540 RETIRED_XRayAngiographicBiPlaneImageStorage 1.2.840.10008.5.1.4.1.1.12.3
541 NuclearMedicineImageStorage 1.2.840.10008.5.1.4.1.1.20
542 RawDataStorage 1.2.840.10008.5.1.4.1.1.66
543 SpatialRegistrationStorage 1.2.840.10008.5.1.4.1.1.66.1
544 SpatialFiducialsStorage 1.2.840.10008.5.1.4.1.1.66.2
545 DeformableSpatialRegistrationStorage 1.2.840.10008.5.1.4.1.1.66.3
546 SegmentationStorage 1.2.840.10008.5.1.4.1.1.66.4
547 SurfaceSegmentationStorage 1.2.840.10008.5.1.4.1.1.66.5
548 RealWorldValueMappingStorage 1.2.840.10008.5.1.4.1.1.67
549 RETIRED_VLImageStorage 1.2.840.10008.5.1.4.1.1.77.1
550 VLEndoscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.1
551 VideoEndoscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.1.1
552 VLMicroscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.2
553 VideoMicroscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.2.1
554 VLSlideCoordinatesMicroscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.3
555 VLPhotographicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.4
556 VideoPhotographicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.4.1
557 OphthalmicPhotography8BitImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.1
558 OphthalmicPhotography16BitImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.2
559 StereometricRelationshipStorage 1.2.840.10008.5.1.4.1.1.77.1.5.3
560 OphthalmicTomographyImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.4
561 VLWholeSlideMicroscopyImageStorage 1.2.840.10008.5.1.4.1.1.77.1.6
562 RETIRED_VLMultiFrameImageStorage 1.2.840.10008.5.1.4.1.1.77.2
563 LensometryMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.1
564 AutorefractionMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.2
565 KeratometryMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.3
566 SubjectiveRefractionMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.4
567 VisualAcuityMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.5
568 SpectaclePrescriptionReportStorage 1.2.840.10008.5.1.4.1.1.78.6
569 OphthalmicAxialMeasurementsStorage 1.2.840.10008.5.1.4.1.1.78.7
570 IntraocularLensCalculationsStorage 1.2.840.10008.5.1.4.1.1.78.8
571 MacularGridThicknessAndVolumeReportStorage 1.2.840.10008.5.1.4.1.1.79.1
572 OphthalmicVisualFieldStaticPerimetryMeasurementsSt. 1.2.840.10008.5.1.4.1.1.80.1
573 DRAFT_SRTextStorage 1.2.840.10008.5.1.4.1.1.88.1
574 DRAFT_SRAudioStorage 1.2.840.10008.5.1.4.1.1.88.2
575 DRAFT_SRDetailStorage 1.2.840.10008.5.1.4.1.1.88.3
576 DRAFT_SRComprehensiveStorage 1.2.840.10008.5.1.4.1.1.88.4
577 BasicTextSRStorage 1.2.840.10008.5.1.4.1.1.88.11
578 EnhancedSRStorage 1.2.840.10008.5.1.4.1.1.88.22
579 ComprehensiveSRStorage 1.2.840.10008.5.1.4.1.1.88.33
580 ProcedureLogStorage 1.2.840.10008.5.1.4.1.1.88.40
581 MammographyCADSRStorage 1.2.840.10008.5.1.4.1.1.88.50
582 KeyObjectSelectionDocumentStorage 1.2.840.10008.5.1.4.1.1.88.59
583 ChestCADSRStorage 1.2.840.10008.5.1.4.1.1.88.65
584 XRayRadiationDoseSRStorage 1.2.840.10008.5.1.4.1.1.88.67
585 ColonCADSRStorage 1.2.840.10008.5.1.4.1.1.88.69
586 ImplantationPlanSRDocumentStorage 1.2.840.10008.5.1.4.1.1.88.70
587 EncapsulatedPDFStorage 1.2.840.10008.5.1.4.1.1.104.1
588 EncapsulatedCDAStorage 1.2.840.10008.5.1.4.1.1.104.2
589 PositronEmissionTomographyImageStorage 1.2.840.10008.5.1.4.1.1.128
590 RETIRED_StandalonePETCurveStorage 1.2.840.10008.5.1.4.1.1.129
591 EnhancedPETImageStorage 1.2.840.10008.5.1.4.1.1.130
592 BasicStructuredDisplayStorage 1.2.840.10008.5.1.4.1.1.131
593 RTImageStorage 1.2.840.10008.5.1.4.1.1.481.1
594 RTDoseStorage 1.2.840.10008.5.1.4.1.1.481.2
595 RTStructureSetStorage 1.2.840.10008.5.1.4.1.1.481.3
596 RTBeamsTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.4
597 RTPlanStorage 1.2.840.10008.5.1.4.1.1.481.5
598 RTBrachyTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.6
599 RTTreatmentSummaryRecordStorage 1.2.840.10008.5.1.4.1.1.481.7
600 RTIonPlanStorage 1.2.840.10008.5.1.4.1.1.481.8
601 RTIonBeamsTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.9
602 DRAFT_RTBeamsDeliveryInstructionStorage 1.2.840.10008.5.1.4.34.1
603 GenericImplantTemplateStorage 1.2.840.10008.5.1.4.43.1
604 ImplantAssemblyTemplateStorage 1.2.840.10008.5.1.4.44.1
605 ImplantTemplateGroupStorage 1.2.840.10008.5.1.4.45.1
606 The storescp application will accept presentation contexts for all of
607 the abovementioned supported SOP Classes using any of the following
608 transfer syntaxes:
609 LittleEndianImplicitTransferSyntax 1.2.840.10008.1.2
610 LittleEndianExplicitTransferSyntax 1.2.840.10008.1.2.1
611 BigEndianExplicitTransferSyntax 1.2.840.10008.1.2.2
612 The default behaviour of the storescp application is to prefer transfer
613 syntaxes having an explicit encoding over the default implicit transfer
614 syntax. If storescp is running on big-endian hardware it will prefer
615 BigEndianExplicit to LittleEndianExplicit transfer syntax (and vice
616 versa). This behaviour can be changed with the --prefer options (see
617 above). Using option --accept-all any of the following transfer
618 syntaxes is supported:
619 LittleEndianImplicitTransferSyntax 1.2.840.10008.1.2
620 LittleEndianExplicitTransferSyntax 1.2.840.10008.1.2.1
621 DeflatedExplicitVRLittleEndianTransferSyntax 1.2.840.10008.1.2.1.99
622 BigEndianExplicitTransferSyntax 1.2.840.10008.1.2.2
623 JPEGProcess1TransferSyntax 1.2.840.10008.1.2.4.50
624 JPEGProcess2_4TransferSyntax 1.2.840.10008.1.2.4.51
625 JPEGProcess14SV1TransferSyntax 1.2.840.10008.1.2.4.70
626 JPEGLSLosslessTransferSyntax 1.2.840.10008.1.2.4.80
627 JPEGLSLossyTransferSyntax 1.2.840.10008.1.2.4.81
628 JPEG2000LosslessOnlyTransferSyntax 1.2.840.10008.1.2.4.90
629 JPEG2000TransferSyntax 1.2.840.10008.1.2.4.91
630 MPEG2MainProfileAtMainLevelTransferSyntax 1.2.840.10008.1.2.4.100
631 MPEG2MainProfileAtHighLevelTransferSyntax 1.2.840.10008.1.2.4.101
632 RLELosslessTransferSyntax 1.2.840.10008.1.2.5
633 Additional Storage SOP Classes and Transfer Syntaxes can be used with
634 the so-called 'association negotiation profiles' (see below).
635 The storescp application does not support extended negotiation by
636 default. However, using an appropriate association negotiation profile
637 (see below) the optional support for extended negotiation can be added
638 to particular SOP classes.
639 Access Control
640 When compiled on Unix platforms with TCP wrapper support, host-based
641 access control can be enabled with the --access-control command line
642 option. In this case the access control rules defined in the system's
643 host access control tables for storescp are enforced. The default
644 locations of the host access control tables are /etc/hosts.allow and
645 /etc/hosts.deny. Further details are described in hosts_access(5).
646 Running storescp from inetd
647 On Posix platforms, storescp can be initiated through the inetd(8)
648 super server. This requires that storescp be configured in the
649 /etc/inetd.conf configuration file. A typical configuration line could
650 look like this:
651 acr-nema stream tcp nowait root /usr/sbin/storescp -id +ac -od /tmp/storescp
652 where -id (--inetd) activates the inetd mode in which the DICOM
653 association is actually accepted by inetd and passed to storescp, +ac
654 (--access-control) activates the TCP wrapper based access control
655 described above and -od (--output-directory) defines the directory in
656 which storescp stores incoming DICOM objects. Note that the service
657 name ('acr-nema' in this example) determines the port number on which
658 DICOM associations are accepted and must be defined in /etc/services.
659 When runnning from inetd, the stdout and stderr streams are redirected
660 to files in the /tmp filesystem which can be identified by the filename
661 starting with the prefix 'storescp_'.
662 Please note that when run through inetd, storescp is executed with root
663 privileges, which may be a security risk.
664 Association Negotiation Profiles and Configuration Files
665 storescp supports a flexible mechanism for specifying the DICOM network
666 association negotiation behaviour, based on so-called 'association
667 negotiation profiles' which may be read from a configuration file. The
668 format and semantics of this configuration file are documented in
669 asconfig.txt.
671 The level of logging output of the various command line tools and
672 underlying libraries can be specified by the user. By default, only
673 errors and warnings are written to the standard error stream. Using
674 option --verbose also informational messages like processing details
675 are reported. Option --debug can be used to get more details on the
676 internal activity, e.g. for debugging purposes. Other logging levels
677 can be selected using option --log-level. In --quiet mode only fatal
678 errors are reported. In such very severe error events, the application
679 will usually terminate. For more details on the different logging
680 levels, see documentation of module 'oflog'.
681 In case the logging output should be written to file (optionally with
682 logfile rotation), to syslog (Unix) or the event log (Windows) option
683 --log-config can be used. This configuration file also allows for
684 directing only certain messages to a particular output stream and for
685 filtering certain messages based on the module or application where
686 they are generated. An example configuration file is provided in
687 <etcdir>/logger.cfg).
689 All command line tools use the following notation for parameters:
690 square brackets enclose optional values (0-1), three trailing dots
691 indicate that multiple values are allowed (1-n), a combination of both
692 means 0 to n values.
693 Command line options are distinguished from parameters by a leading '+'
694 or '-' sign, respectively. Usually, order and position of command line
695 options are arbitrary (i.e. they can appear anywhere). However, if
696 options are mutually exclusive the rightmost appearance is used. This
697 behaviour conforms to the standard evaluation rules of common Unix
698 shells.
699 In addition, one or more command files can be specified using an '@'
700 sign as a prefix to the filename (e.g. @command.txt). Such a command
701 argument is replaced by the content of the corresponding text file
702 (multiple whitespaces are treated as a single separator unless they
703 appear between two quotation marks) prior to any further evaluation.
704 Please note that a command file cannot contain another command file.
705 This simple but effective approach allows to summarize common
706 combinations of options/parameters and avoids longish and confusing
707 command lines (an example is provided in file <datadir>/dumppat.txt).
709 The storescp utility will attempt to load DICOM data dictionaries
710 specified in the DCMDICTPATH environment variable. By default, i.e. if
711 the DCMDICTPATH environment variable is not set, the file
712 <datadir>/dicom.dic will be loaded unless the dictionary is built into
713 the application (default for Windows).
714 The default behaviour should be preferred and the DCMDICTPATH
715 environment variable only used when alternative data dictionaries are
716 required. The DCMDICTPATH environment variable has the same format as
717 the Unix shell PATH variable in that a colon (':') separates entries.
718 On Windows systems, a semicolon (';') is used as a separator. The data
719 dictionary code will attempt to load each file specified in the
720 DCMDICTPATH environment variable. It is an error if no data dictionary
721 can be loaded.
723 <docdir>/asconfig.txt - configuration file documentation
724 <etcdir>/storescp.cfg - example association negotiation profile
726 storescu(1)
728 Copyright (C) 1996-2010 by OFFIS e.V., Escherweg 2, 26121 Oldenburg,
729 Germany.
730
731
732
733Version 3.6.0 6 Jan 2011 storescp(1)