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

NAME

6       storescp - DICOM storage (C-STORE) SCP
7
8

SYNOPSIS

10       storescp [options] [port]
11

DESCRIPTION

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

PARAMETERS

21       port  tcp/ip port number to listen on
22             (this parameter is required unless the --inetd option is specified)
23

OPTIONS

25   general options
26         -h    --help
27                 print this help text and exit
28
29               --version
30                 print version information and exit
31
32               --arguments
33                 print expanded command line arguments
34
35         -q    --quiet
36                 quiet mode, print no warnings and errors
37
38         -v    --verbose
39                 verbose mode, print processing details
40
41         -d    --debug
42                 debug mode, print debug information
43
44         -ll   --log-level  [l]evel: string constant
45                 (fatal, error, warn, info, debug, trace)
46                 use level l for the logger
47
48         -lc   --log-config  [f]ilename: string
49                 use config file f for the logger
50
51         +v    --verbose-pc
52                 show presentation contexts in verbose mode
53
54   multi-process options
55               --single-process
56                 single process mode (default)
57
58               --fork
59                 fork child process for each association
60
61   network options
62       association negotiation profile from configuration file:
63
64         -xf   --config-file  [f]ilename [p]rofile: string
65                 use profile p from config file f
66
67       preferred network transfer syntaxes (not with --config-file):
68
69         +x=   --prefer-uncompr
70                 prefer explicit VR local byte order (default)
71
72         +xe   --prefer-little
73                 prefer explicit VR little endian TS
74
75         +xb   --prefer-big
76                 prefer explicit VR big endian TS
77
78         +xs   --prefer-lossless
79                 prefer default JPEG lossless TS
80
81         +xy   --prefer-jpeg8
82                 prefer default JPEG lossy TS for 8 bit data
83
84         +xx   --prefer-jpeg12
85                 prefer default JPEG lossy TS for 12 bit data
86
87         +xv   --prefer-j2k-lossless
88                 prefer JPEG 2000 lossless TS
89
90         +xw   --prefer-j2k-lossy
91                 prefer JPEG 2000 lossy TS
92
93         +xt   --prefer-jls-lossless
94                 prefer JPEG-LS lossless TS
95
96         +xu   --prefer-jls-lossy
97                 prefer JPEG-LS lossy TS
98
99         +xm   --prefer-mpeg2
100                 prefer MPEG2 Main Profile @ Main Level TS
101
102         +xh   --prefer-mpeg2-high
103                 prefer MPEG2 Main Profile @ High Level TS
104
105         +xn   --prefer-mpeg4
106                 prefer MPEG4 AVC/H.264 High Profile / Level 4.1 TS
107
108         +xl   --prefer-mpeg4-bd
109                 prefer MPEG4 AVC/H.264 BD-compatible HP / Level 4.1 TS
110
111         +x2   --prefer-mpeg4-2-2d
112                 prefer MPEG4 AVC/H.264 HP / Level 4.2 TS for 2D Videos
113
114         +x3   --prefer-mpeg4-2-3d
115                 prefer MPEG4 AVC/H.264 HP / Level 4.2 TS for 3D Videos
116
117         +xo   --prefer-mpeg4-2-st
118                 prefer MPEG4 AVC/H.264 Stereo HP / Level 4.2 TS
119
120         +x4   --prefer-hevc
121                 prefer HEVC H.265 Main Profile / Level 5.1 TS
122
123         +x5   --prefer-hevc10
124                 prefer HEVC H.265 Main 10 Profile / Level 5.1 TS
125
126         +xr   --prefer-rle
127                 prefer RLE lossless TS
128
129         +xd   --prefer-deflated
130                 prefer deflated explicit VR little endian TS
131
132         +xi   --implicit
133                 accept implicit VR little endian TS only
134
135         +xa   --accept-all
136                 accept all supported transfer syntaxes
137
138       network host access control (tcp wrapper):
139
140         -ac   --access-full
141                 accept connections from any host (default)
142
143         +ac   --access-control
144                 enforce host access control rules
145
146       other network options:
147
148         -id   --inetd
149                 run from inetd super server (not with --fork)
150
151                 # not available on all systems (e.g. not on Windows)
152
153         -ts   --socket-timeout  [s]econds: integer (default: 60)
154                 timeout for network socket (0 for none)
155
156         -ta   --acse-timeout  [s]econds: integer (default: 30)
157                 timeout for ACSE messages
158
159         -td   --dimse-timeout  [s]econds: integer (default: unlimited)
160                 timeout for DIMSE messages
161
162         -aet  --aetitle  [a]etitle: string
163                 set my AE title (default: STORESCP)
164
165         -pdu  --max-pdu  [n]umber of bytes: integer (4096..131072)
166                 set max receive pdu to n bytes (default: 16384)
167
168         -dhl  --disable-host-lookup
169                 disable hostname lookup
170
171               --refuse
172                 refuse association
173
174               --reject
175                 reject association if no implementation class UID
176
177               --ignore
178                 ignore store data, receive but do not store
179
180               --sleep-after  [s]econds: integer
181                 sleep s seconds after store (default: 0)
182
183               --sleep-during  [s]econds: integer
184                 sleep s seconds during store (default: 0)
185
186               --abort-after
187                 abort association after receipt of C-STORE-RQ
188                 (but before sending response)
189
190               --abort-during
191                 abort association during receipt of C-STORE-RQ
192
193         -pm   --promiscuous
194                 promiscuous mode, accept unknown SOP classes
195                 (not with --config-file)
196
197         -up   --uid-padding
198                 silently correct space-padded UIDs
199
200   transport layer security (TLS) options
201       transport protocol stack:
202
203         -tls  --disable-tls
204                 use normal TCP/IP connection (default)
205
206         +tls  --enable-tls  [p]rivate key file, [c]ertificate file: string
207                 use authenticated secure TLS connection
208
209       private key password (only with --enable-tls):
210
211         +ps   --std-passwd
212                 prompt user to type password on stdin (default)
213
214         +pw   --use-passwd  [p]assword: string
215                 use specified password
216
217         -pw   --null-passwd
218                 use empty string as password
219
220       key and certificate file format:
221
222         -pem  --pem-keys
223                 read keys and certificates as PEM file (default)
224
225         -der  --der-keys
226                 read keys and certificates as DER file
227
228       certification authority:
229
230         +cf   --add-cert-file  [f]ilename: string
231                 add certificate file to list of certificates
232
233         +cd   --add-cert-dir  [d]irectory: string
234                 add certificates in d to list of certificates
235
236       security profile:
237
238         +px   --profile-bcp195
239                 BCP 195 TLS Profile (default)
240
241         +py   --profile-bcp195-nd
242                 Non-downgrading BCP 195 TLS Profile
243
244         +pz   --profile-bcp195-ex
245                 Extended BCP 195 TLS Profile
246
247         +pb   --profile-basic
248                 Basic TLS Secure Transport Connection Profile (retired)
249
250         +pa   --profile-aes
251                 AES TLS Secure Transport Connection Profile (retired)
252
253         +pn   --profile-null
254                 Authenticated unencrypted communication
255                 (retired, was used in IHE ATNA)
256
257       ciphersuite:
258
259         +cc   --list-ciphers
260                 show list of supported TLS ciphersuites and exit
261
262         +cs   --cipher  [c]iphersuite name: string
263                 add ciphersuite to list of negotiated suites
264
265         +dp   --dhparam  [f]ilename: string
266                 read DH parameters for DH/DSS ciphersuites
267
268       pseudo random generator:
269
270         +rs   --seed  [f]ilename: string
271                 seed random generator with contents of f
272
273         +ws   --write-seed
274                 write back modified seed (only with --seed)
275
276         +wf   --write-seed-file  [f]ilename: string (only with --seed)
277                 write modified seed to file f
278
279       peer authentication:
280
281         -rc   --require-peer-cert
282                 verify peer certificate, fail if absent (default)
283
284         -vc   --verify-peer-cert
285                 verify peer certificate if present
286
287         -ic   --ignore-peer-cert
288                 don't verify peer certificate
289
290   output options
291       general:
292
293         -od   --output-directory  [d]irectory: string (default: ".")
294                 write received objects to existing directory d
295
296       bit preserving mode:
297
298         -B    --normal
299                 allow implicit format conversions (default)
300
301         +B    --bit-preserving
302                 write data exactly as read
303
304       output file format:
305
306         +F    --write-file
307                 write file format (default)
308
309         -F    --write-dataset
310                 write data set without file meta information
311
312       output transfer syntax
313       (not with --bit-preserving or compressed transmission):
314
315         +t=   --write-xfer-same
316                 write with same TS as input (default)
317
318         +te   --write-xfer-little
319                 write with explicit VR little endian TS
320
321         +tb   --write-xfer-big
322                 write with explicit VR big endian TS
323
324         +ti   --write-xfer-implicit
325                 write with implicit VR little endian TS
326
327         +td   --write-xfer-deflated
328                 write with deflated explicit VR little endian TS
329
330       post-1993 value representations (not with --bit-preserving):
331
332         +u    --enable-new-vr
333                 enable support for new VRs (UN/UT) (default)
334
335         -u    --disable-new-vr
336                 disable support for new VRs, convert to OB
337
338       group length encoding (not with --bit-preserving):
339
340         +g=   --group-length-recalc
341                 recalculate group lengths if present (default)
342
343         +g    --group-length-create
344                 always write with group length elements
345
346         -g    --group-length-remove
347                 always write without group length elements
348
349       length encoding in sequences and items (not with --bit-preserving):
350
351         +e    --length-explicit
352                 write with explicit lengths (default)
353
354         -e    --length-undefined
355                 write with undefined lengths
356
357       data set trailing padding
358       (not with --write-dataset or --bit-preserving):
359
360         -p    --padding-off
361                 no padding (default)
362
363         +p    --padding-create  [f]ile-pad [i]tem-pad: integer
364                 align file on multiple of f bytes and items on
365                 multiple of i bytes
366
367       handling of defined length UN elements:
368
369         -uc   --retain-un
370                 retain elements as UN (default)
371
372         +uc   --convert-un
373                 convert to real VR if known
374
375       deflate compression level (only with --write-xfer-deflated/same):
376
377         +cl   --compression-level  [l]evel: integer (default: 6)
378                 0=uncompressed, 1=fastest, 9=best compression
379
380       sorting into subdirectories (not with --bit-preserving):
381
382         -ss   --sort-conc-studies  [p]refix: string
383                 sort studies using prefix p and a timestamp
384
385         -su   --sort-on-study-uid  [p]refix: string
386                 sort studies using prefix p and the Study Instance UID
387
388         -sp   --sort-on-patientname
389                 sort studies using the Patient's Name and a timestamp
390
391       filename generation:
392
393         -uf   --default-filenames
394                 generate filename from instance UID (default)
395
396         +uf   --unique-filenames
397                 generate unique filenames
398
399         -tn   --timenames
400                 generate filename from creation time
401
402         -fe   --filename-extension  [e]xtension: string
403                 append e to all filenames
404
405   event options
406         -xcr  --exec-on-reception  [c]ommand: string
407                 execute command c after having received and processed
408                 one C-STORE-RQ message
409
410         -xcs  --exec-on-eostudy  [c]ommand: string
411                 execute command c after having received and processed
412                 all C-STORE-RQ messages that belong to one study
413
414         -rns  --rename-on-eostudy
415                 having received and processed all C-STORE-RQ messages
416                 that belong to one study, rename output files according
417                 to a certain pattern
418
419         -tos  --eostudy-timeout  [t]imeout: integer
420                 specifies a timeout of t seconds for end-of-study
421                 determination
422
423         -xs   --exec-sync
424                 execute command synchronously in foreground
425

NOTES

427       The semantic impacts of the above mentioned options is  clear  for  the
428       majority  of options. Some particular options, however, are so specific
429       that they need detailed  descriptions  which  will  be  given  in  this
430       passage.
431
432       Option  --sort-conc-studies  enables  a user to sort all received DICOM
433       objects into different subdirectories. The sorting will  be  done  with
434       regard  to  the  studies the individual objects belong to, i.e. objects
435       that belong to the same study will be stored in the same  subdirectory.
436       In  general,  a  DICOM object d_n+1 is considered to belong to the same
437       study as a DICOM object d_n if and only if d_n and d_n+1 show the exact
438       same values in attribute Study Instance UID. The names of the resulting
439       subdirectories always start with a prefix p which was  passed  to  this
440       option  as  a  parameter.  In addition to this prefix, the subdirectory
441       names contain time stamp information with regard to the date  and  time
442       of  reception of this particular study's first DICOM object. In detail,
443       the determination of the subdirectory names pertains to the pattern
444
445         [prefix]_[YYYYMMDD]_[HHMMSSPPP]
446
447       where YYYY refers to year (4 digits), MM to month (01-12),  DD  to  day
448       (01-31), HH to hour (00-23), MM to minute (00-59), SS to second (00-59)
449       and PPP to milliseconds (000-999). If the prefix is  an  empty  string,
450       the first '_' is omitted.
451
452       The  other  --sort-xxx  options  work  in  a  similar  manner, only the
453       subdirectory names are created differently. For option --sort-on-study-
454       uid the pattern is
455
456         [prefix]_[StudyInstanceUID]
457
458       and for option --sort-on-patientname
459
460         [PatientName]_[YYYYMMDD]_[HHMMSSPPP]
461
462       where  'PatientName'  is replaced by 'ANONYMOUS' if the data element is
463       empty or  absent  in  the  data  set.  Any  existing  patient  name  is
464       transformed  in order to use only ASCII characters. Please note that in
465       this context only the DICOM default character set (ASCII, i.e. no entry
466       in  attribute  Specific  Character Set) and Latin-1 (Specific Character
467       Set valued 'ISO_IR 100') are supported. If  another  character  set  is
468       found  and the patient name contains non-ASCII characters, a warning is
469       printed and the transformation is performed as if Latin-1 character set
470       would  be  set  in  the file. This may lead to unreadable or unexpected
471       patient name directories and behaviour. Thus, it is  advisable  to  use
472       --sort-on-patientname  only  if  Latin-1  or  ASCII  patient  names are
473       expected to be received.
474
475       For option --sort-on-study-uid the same subdirectory will be  used  for
476       all  DICOM  objects  that belong to the same study, i.e. in contrast to
477       the other --sort-xxx  options  there  is  no  guarantee  that  a  study
478       directory is ever completed.
479
480       Option  --timenames  creates filenames from timestamps corresponding to
481       the time, storescp writes a file to disk. The format is
482
483         [YYYYMMDDHHMMSSPPP]_[SERIALNO].[MD]
484
485       where YYYY, MM, DD, HH, MM, SS, PPP are interpreted as described above.
486       If  more  files  are created at the same time, SERIALNO is inserted. It
487       consists of a 4-digit, consecutive number (0000 to 9999). For the first
488       file,  that  exists  for  a  specific  time,  no number (and no '_') is
489       inserted at all. MD represents an identification code (2  letters)  for
490       the  kind  of  object  stored  in  the  file (see notes on --rename-on-
491       eostudy).
492
493       Option --filename-extension appends a specified suffix to each filename
494       (a  dot '.' is not added automatically). This suffix is not appended to
495       the filenames created by --rename-on-eostudy to maintain the length  of
496       8 characters.
497
498       Option --exec-on-reception allows one to execute a certain command line
499       after having received and processed one  DICOM  object  (through  a  C-
500       STORE-RQ  message).  The  command line to be executed is passed to this
501       option as a parameter. The specified command line may contain a  number
502       of placeholders which will be replaced at run time:
503
504#p:  complete  path to the output directory into which the last DICOM
505         object was stored (not available with option --ignore though)
506#f: filename of the current output file (not  available  with  option
507         --ignore though)
508#a: calling application entity title of the peer Storage SCU
509#c:  called  application entity title used by the peer Storage SCU to
510         address storescp
511#r: calling presentation address, i.e. hostname or IP address of  the
512         peer Storage SCU
513       The  specified  command line is executed as a separate process, so that
514       the execution of storescp will not be held back. This behavior  can  be
515       influenced with the --exec-sync option.
516       Option  --exec-on-eostudy  allows one to execute a certain command line
517       when all DICOM objects that belong to one study have been  received  by
518       storescp.  The  same  placeholders  as  with --exec-on-reception may be
519       used, except for '#f', which is not supported. A  study  is  considered
520       complete  by  storescp when an object belonging to a different study is
521       received or the timeout specified with --eostudy-timeout  takes  place.
522       If  option  --rename-on-eostudy  is  in force, the renaming takes place
523       before the external command is executed.
524       Option --rename-on-eostudy refers to  the  above  mentioned  --sort-xxx
525       options  and can only be used in combination with one of these options.
526       If a user specifies option --rename-on-eostudy and storescp  determines
527       that  all  DICOM  objects  that  belong  to  a  certain study have been
528       received, all DICOM files that belong to the last study will be renamed
529       in  the  corresponding  output  directory. The filenames into which the
530       files are being renamed will be calculated using the pattern
531         [prefix][consecutive numbering]
532       where [prefix] is a 2 character prefix that reveals the kind  of  DICOM
533       object   stored   in   the   file  and  [consecutive  numbering]  is  a
534       consecutively  numbered,  6-digit  number,  starting  at  '000001'.  In
535       general,  the  question  if  all DICOM objects that belong to one study
536       have been received by storescp will be answered positively if and  only
537       if  two  consecutively received DICOM objects d_n and d_n+1 do not show
538       the same values in attribute Study Instance UID; in such a case,  d_n+1
539       is considered to belong to a new study.
540       Using  option  --eostudy-timeout  a  user  can modify the determination
541       process to figure out if all DICOM objects that  belong  to  one  study
542       have already been received by storescp. With regard to this fact, it is
543       clear that this option can only be used in combination  with  at  least
544       one   of  the  following  options:  --sort-xxx,  --exec-on-eostudy  and
545       --rename-on-eostudy. If option --eostudy-timeout is specified, the  end
546       of a study is considered to have occurred not only if two consecutively
547       received DICOM objects d_n and d_n+1 do not show  the  same  values  in
548       attribute  Study  Instance  UID,  but  also  if within a time span of x
549       seconds after the reception of a  DICOM  object  d_n,  no  other  DICOM
550       object was received over the network. Note that the amount x of seconds
551       (which determines the length of this time span) has  to  be  passed  to
552       this option as a parameter.
553       Please  note  that  two  consecutive  network  connections can transfer
554       objects for the same study. The study will only be considered  complete
555       when  an  object  of  a  different  study is received or the --eostudy-
556       timeout is reached. For this reason, the options --fork and --inet  are
557       incompatible  with  --exec-on-eostudy,  --rename-on-eostudy and --sort-
558       conc-studies.
559   DICOM Conformance
560       The storescp application supports the following SOP Classes as an SCP:
561       VerificationSOPClass                                 1.2.840.10008.1.1
562
563       RETIRED_StoredPrintStorage                           1.2.840.10008.5.1.1.27
564       RETIRED_HardcopyGrayscaleImageStorage                1.2.840.10008.5.1.1.29
565       RETIRED_HardcopyColorImageStorage                    1.2.840.10008.5.1.1.30
566       ComputedRadiographyImageStorage                      1.2.840.10008.5.1.4.1.1.1
567       DigitalXRayImageStorageForPresentation               1.2.840.10008.5.1.4.1.1.1.1
568       DigitalXRayImageStorageForProcessing                 1.2.840.10008.5.1.4.1.1.1.1.1
569       DigitalMammographyXRayImageStorageForPresentation    1.2.840.10008.5.1.4.1.1.1.2
570       DigitalMammographyXRayImageStorageForProcessing      1.2.840.10008.5.1.4.1.1.1.2.1
571       DigitalIntraOralXRayImageStorageForPresentation      1.2.840.10008.5.1.4.1.1.1.3
572       DigitalIntraOralXRayImageStorageForProcessing        1.2.840.10008.5.1.4.1.1.1.3.1
573       CTImageStorage                                       1.2.840.10008.5.1.4.1.1.2
574       EnhancedCTImageStorage                               1.2.840.10008.5.1.4.1.1.2.1
575       LegacyConvertedEnhancedCTImageStorage                1.2.840.10008.5.1.4.1.1.2.2
576       RETIRED_UltrasoundMultiframeImageStorage             1.2.840.10008.5.1.4.1.1.3
577       UltrasoundMultiframeImageStorage                     1.2.840.10008.5.1.4.1.1.3.1
578       MRImageStorage                                       1.2.840.10008.5.1.4.1.1.4
579       EnhancedMRImageStorage                               1.2.840.10008.5.1.4.1.1.4.1
580       MRSpectroscopyStorage                                1.2.840.10008.5.1.4.1.1.4.2
581       EnhancedMRColorImageStorage                          1.2.840.10008.5.1.4.1.1.4.3
582       LegacyConvertedEnhancedMRImageStorage                1.2.840.10008.5.1.4.1.1.4.4
583       RETIRED_NuclearMedicineImageStorage                  1.2.840.10008.5.1.4.1.1.5
584       RETIRED_UltrasoundImageStorage                       1.2.840.10008.5.1.4.1.1.6
585       UltrasoundImageStorage                               1.2.840.10008.5.1.4.1.1.6.1
586       EnhancedUSVolumeStorage                              1.2.840.10008.5.1.4.1.1.6.2
587       SecondaryCaptureImageStorage                         1.2.840.10008.5.1.4.1.1.7
588       MultiframeSingleBitSecondaryCaptureImageStorage      1.2.840.10008.5.1.4.1.1.7.1
589       MultiframeGrayscaleByteSecondaryCaptureImageStorage  1.2.840.10008.5.1.4.1.1.7.2
590       MultiframeGrayscaleWordSecondaryCaptureImageStorage  1.2.840.10008.5.1.4.1.1.7.3
591       MultiframeTrueColorSecondaryCaptureImageStorage      1.2.840.10008.5.1.4.1.1.7.4
592       RETIRED_StandaloneOverlayStorage                     1.2.840.10008.5.1.4.1.1.8
593       RETIRED_StandaloneCurveStorage                       1.2.840.10008.5.1.4.1.1.9
594       DRAFT_WaveformStorage                                1.2.840.10008.5.1.4.1.1.9.1
595       TwelveLeadECGWaveformStorage                         1.2.840.10008.5.1.4.1.1.9.1.1
596       GeneralECGWaveformStorage                            1.2.840.10008.5.1.4.1.1.9.1.2
597       AmbulatoryECGWaveformStorage                         1.2.840.10008.5.1.4.1.1.9.1.3
598       HemodynamicWaveformStorage                           1.2.840.10008.5.1.4.1.1.9.2.1
599       CardiacElectrophysiologyWaveformStorage              1.2.840.10008.5.1.4.1.1.9.3.1
600       BasicVoiceAudioWaveformStorage                       1.2.840.10008.5.1.4.1.1.9.4.1
601       GeneralAudioWaveformStorage                          1.2.840.10008.5.1.4.1.1.9.4.2
602       ArterialPulseWaveformStorage                         1.2.840.10008.5.1.4.1.1.9.5.1
603       RespiratoryWaveformStorage                           1.2.840.10008.5.1.4.1.1.9.6.1
604       MultichannelRespiratoryWaveformStorage               1.2.840.10008.5.1.4.1.1.9.6.2
605       RoutineScalpElectroencephalogramWaveformStorage      1.2.840.10008.5.1.4.1.1.9.7.1
606       ElectromyogramWaveformStorage                        1.2.840.10008.5.1.4.1.1.9.7.2
607       ElectrooculogramWaveformStorage                      1.2.840.10008.5.1.4.1.1.9.7.3
608       SleepElectroencephalogramWaveformStorage             1.2.840.10008.5.1.4.1.1.9.7.4
609       BodyPositionWaveformStorage                          1.2.840.10008.5.1.4.1.1.9.8.1
610       RETIRED_StandaloneModalityLUTStorage                 1.2.840.10008.5.1.4.1.1.10
611       RETIRED_StandaloneVOILUTStorage                      1.2.840.10008.5.1.4.1.1.11
612       GrayscaleSoftcopyPresentationStateStorage            1.2.840.10008.5.1.4.1.1.11.1
613       ColorSoftcopyPresentationStateStorage                1.2.840.10008.5.1.4.1.1.11.2
614       PseudoColorSoftcopyPresentationStateStorage          1.2.840.10008.5.1.4.1.1.11.3
615       BlendingSoftcopyPresentationStateStorage             1.2.840.10008.5.1.4.1.1.11.4
616       XAXRFGrayscaleSoftcopyPresentationStateStorage       1.2.840.10008.5.1.4.1.1.11.5
617       GrayscalePlanarMPRVolumetricPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.6
618       CompositingPlanarMPRVolumetricPresent.StateStorage   1.2.840.10008.5.1.4.1.1.11.7
619       AdvancedBlendingPresentationStateStorage             1.2.840.10008.5.1.4.1.1.11.8
620       VolumeRenderingVolumetricPresentationStateStorage    1.2.840.10008.5.1.4.1.1.11.9
621       SegmentedVolumeRenderingVolumetricPres.StateStorage  1.2.840.10008.5.1.4.1.1.11.10
622       MultipleVolumeRenderingVolumetricPres.StateStorage   1.2.840.10008.5.1.4.1.1.11.11
623       XRayAngiographicImageStorage                         1.2.840.10008.5.1.4.1.1.12.1
624       EnhancedXAImageStorage                               1.2.840.10008.5.1.4.1.1.12.1.1
625       XRayRadiofluoroscopicImageStorage                    1.2.840.10008.5.1.4.1.1.12.2
626       EnhancedXRFImageStorage                              1.2.840.10008.5.1.4.1.1.12.2.1
627       RETIRED_XRayAngiographicBiPlaneImageStorage          1.2.840.10008.5.1.4.1.1.12.3
628       XRay3DAngiographicImageStorage                       1.2.840.10008.5.1.4.1.1.13.1.1
629       XRay3DCraniofacialImageStorage                       1.2.840.10008.5.1.4.1.1.13.1.2
630       BreastTomosynthesisImageStorage                      1.2.840.10008.5.1.4.1.1.13.1.3
631       BreastProjectionXRayImageStorageForPresentation      1.2.840.10008.5.1.4.1.1.13.1.4
632       BreastProjectionXRayImageStorageForProcessing        1.2.840.10008.5.1.4.1.1.13.1.5
633       IntravascularOpt.Coh.Tom.ImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.14.1
634       IntravascularOpt.Coh.Tom.ImageStorageForProcessing   1.2.840.10008.5.1.4.1.1.14.2
635       NuclearMedicineImageStorage                          1.2.840.10008.5.1.4.1.1.20
636       ParametricMapStorage                                 1.2.840.10008.5.1.4.1.1.30
637       RawDataStorage                                       1.2.840.10008.5.1.4.1.1.66
638       SpatialRegistrationStorage                           1.2.840.10008.5.1.4.1.1.66.1
639       SpatialFiducialsStorage                              1.2.840.10008.5.1.4.1.1.66.2
640       DeformableSpatialRegistrationStorage                 1.2.840.10008.5.1.4.1.1.66.3
641       SegmentationStorage                                  1.2.840.10008.5.1.4.1.1.66.4
642       SurfaceSegmentationStorage                           1.2.840.10008.5.1.4.1.1.66.5
643       TractographyResultsStorage                           1.2.840.10008.5.1.4.1.1.66.6
644       RealWorldValueMappingStorage                         1.2.840.10008.5.1.4.1.1.67
645       SurfaceScanMeshStorage                               1.2.840.10008.5.1.4.1.1.68.1
646       SurfaceScanPointCloudStorage                         1.2.840.10008.5.1.4.1.1.68.2
647       RETIRED_VLImageStorage                               1.2.840.10008.5.1.4.1.1.77.1
648       VLEndoscopicImageStorage                             1.2.840.10008.5.1.4.1.1.77.1.1
649       VideoEndoscopicImageStorage                          1.2.840.10008.5.1.4.1.1.77.1.1.1
650       VLMicroscopicImageStorage                            1.2.840.10008.5.1.4.1.1.77.1.2
651       VideoMicroscopicImageStorage                         1.2.840.10008.5.1.4.1.1.77.1.2.1
652       VLSlideCoordinatesMicroscopicImageStorage            1.2.840.10008.5.1.4.1.1.77.1.3
653       VLPhotographicImageStorage                           1.2.840.10008.5.1.4.1.1.77.1.4
654       VideoPhotographicImageStorage                        1.2.840.10008.5.1.4.1.1.77.1.4.1
655       OphthalmicPhotography8BitImageStorage                1.2.840.10008.5.1.4.1.1.77.1.5.1
656       OphthalmicPhotography16BitImageStorage               1.2.840.10008.5.1.4.1.1.77.1.5.2
657       StereometricRelationshipStorage                      1.2.840.10008.5.1.4.1.1.77.1.5.3
658       OphthalmicTomographyImageStorage                     1.2.840.10008.5.1.4.1.1.77.1.5.4
659       WideFieldOphthalmicPhoto.Stereogr.Proj.ImageStorage  1.2.840.10008.5.1.4.1.1.77.1.5.5
660       WideFieldOphthalmicPhotogr.3DCoordinatesImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.6
661       OphthalmicOpticalCoherenceTomogr.EnFaceImageStorage  1.2.840.10008.5.1.4.1.1.77.1.5.7
662       OphthalmicOpticalCoh.Tomogr.BscanVolumeAnalysisStor. 1.2.840.10008.5.1.4.1.1.77.1.5.8
663       VLWholeSlideMicroscopyImageStorage                   1.2.840.10008.5.1.4.1.1.77.1.6
664       DermoscopicPhotographyImageStorage                   1.2.840.10008.5.1.4.1.1.77.1.7
665       RETIRED_VLMultiframeImageStorage                     1.2.840.10008.5.1.4.1.1.77.2
666       LensometryMeasurementsStorage                        1.2.840.10008.5.1.4.1.1.78.1
667       AutorefractionMeasurementsStorage                    1.2.840.10008.5.1.4.1.1.78.2
668       KeratometryMeasurementsStorage                       1.2.840.10008.5.1.4.1.1.78.3
669       SubjectiveRefractionMeasurementsStorage              1.2.840.10008.5.1.4.1.1.78.4
670       VisualAcuityMeasurementsStorage                      1.2.840.10008.5.1.4.1.1.78.5
671       SpectaclePrescriptionReportStorage                   1.2.840.10008.5.1.4.1.1.78.6
672       OphthalmicAxialMeasurementsStorage                   1.2.840.10008.5.1.4.1.1.78.7
673       IntraocularLensCalculationsStorage                   1.2.840.10008.5.1.4.1.1.78.8
674       MacularGridThicknessAndVolumeReportStorage           1.2.840.10008.5.1.4.1.1.79.1
675       OphthalmicVisualFieldStaticPerimetryMeasurementsSt.  1.2.840.10008.5.1.4.1.1.80.1
676       OphthalmicThicknessMapStorage                        1.2.840.10008.5.1.4.1.1.81.1
677       CornealTopographyMapStorage                          1.2.840.10008.5.1.4.1.1.82.1
678       DRAFT_SRTextStorage                                  1.2.840.10008.5.1.4.1.1.88.1
679       DRAFT_SRAudioStorage                                 1.2.840.10008.5.1.4.1.1.88.2
680       DRAFT_SRDetailStorage                                1.2.840.10008.5.1.4.1.1.88.3
681       DRAFT_SRComprehensiveStorage                         1.2.840.10008.5.1.4.1.1.88.4
682       BasicTextSRStorage                                   1.2.840.10008.5.1.4.1.1.88.11
683       EnhancedSRStorage                                    1.2.840.10008.5.1.4.1.1.88.22
684       ComprehensiveSRStorage                               1.2.840.10008.5.1.4.1.1.88.33
685       Comprehensive3DSRStorage                             1.2.840.10008.5.1.4.1.1.88.34
686       ExtensibleSRStorage                                  1.2.840.10008.5.1.4.1.1.88.35
687       ProcedureLogStorage                                  1.2.840.10008.5.1.4.1.1.88.40
688       MammographyCADSRStorage                              1.2.840.10008.5.1.4.1.1.88.50
689       KeyObjectSelectionDocumentStorage                    1.2.840.10008.5.1.4.1.1.88.59
690       ChestCADSRStorage                                    1.2.840.10008.5.1.4.1.1.88.65
691       XRayRadiationDoseSRStorage                           1.2.840.10008.5.1.4.1.1.88.67
692       RadiopharmaceuticalRadiationDoseSRStorage            1.2.840.10008.5.1.4.1.1.88.68
693       ColonCADSRStorage                                    1.2.840.10008.5.1.4.1.1.88.69
694       ImplantationPlanSRDocumentStorage                    1.2.840.10008.5.1.4.1.1.88.70
695       AcquisitionContextSRStorage                          1.2.840.10008.5.1.4.1.1.88.71
696       SimplifiedAdultEchoSRStorage                         1.2.840.10008.5.1.4.1.1.88.72
697       PatientRadiationDoseSRStorage                        1.2.840.10008.5.1.4.1.1.88.73
698       PlannedImagingAgentAdministrationSRStorage           1.2.840.10008.5.1.4.1.1.88.74
699       PerformedImagingAgentAdministrationSRStorage         1.2.840.10008.5.1.4.1.1.88.75
700       ContentAssessmentResultsStorage                      1.2.840.10008.5.1.4.1.1.90.1
701       EncapsulatedPDFStorage                               1.2.840.10008.5.1.4.1.1.104.1
702       EncapsulatedCDAStorage                               1.2.840.10008.5.1.4.1.1.104.2
703       EncapsulatedSTLStorage                               1.2.840.10008.5.1.4.1.1.104.3
704       EncapsulatedOBJStorage                               1.2.840.10008.5.1.4.1.1.104.4
705       EncapsulatedMTLStorage                               1.2.840.10008.5.1.4.1.1.104.5
706       PositronEmissionTomographyImageStorage               1.2.840.10008.5.1.4.1.1.128
707       LegacyConvertedEnhancedPETImageStorage               1.2.840.10008.5.1.4.1.1.128.1
708       RETIRED_StandalonePETCurveStorage                    1.2.840.10008.5.1.4.1.1.129
709       EnhancedPETImageStorage                              1.2.840.10008.5.1.4.1.1.130
710       BasicStructuredDisplayStorage                        1.2.840.10008.5.1.4.1.1.131
711       CTPerformedProcedureProtocolStorage                  1.2.840.10008.5.1.4.1.1.200.2
712       RTImageStorage                                       1.2.840.10008.5.1.4.1.1.481.1
713       RTDoseStorage                                        1.2.840.10008.5.1.4.1.1.481.2
714       RTStructureSetStorage                                1.2.840.10008.5.1.4.1.1.481.3
715       RTBeamsTreatmentRecordStorage                        1.2.840.10008.5.1.4.1.1.481.4
716       RTPlanStorage                                        1.2.840.10008.5.1.4.1.1.481.5
717       RTBrachyTreatmentRecordStorage                       1.2.840.10008.5.1.4.1.1.481.6
718       RTTreatmentSummaryRecordStorage                      1.2.840.10008.5.1.4.1.1.481.7
719       RTIonPlanStorage                                     1.2.840.10008.5.1.4.1.1.481.8
720       RTIonBeamsTreatmentRecordStorage                     1.2.840.10008.5.1.4.1.1.481.9
721       RTPhysicianIntentStorage                             1.2.840.10008.5.1.4.1.1.481.10
722       RTSegmentAnnotationStorage                           1.2.840.10008.5.1.4.1.1.481.11
723       RTRadiationSetStorage                                1.2.840.10008.5.1.4.1.1.481.12
724       CArmPhotonElectronRadiationStorage                   1.2.840.10008.5.1.4.1.1.481.13
725       TomotherapeuticRadiationStorage                      1.2.840.10008.5.1.4.1.1.481.14
726       RoboticArmRadiationStorage                           1.2.840.10008.5.1.4.1.1.481.15
727       RTRadiationRecordSetStorage                          1.2.840.10008.5.1.4.1.1.481.16
728       RTRadiationSalvageRecordStorage                      1.2.840.10008.5.1.4.1.1.481.17
729       TomotherapeuticRadiationRecordStorage                1.2.840.10008.5.1.4.1.1.481.18
730       CArmPhotonElectronRadiationRecordStorage             1.2.840.10008.5.1.4.1.1.481.19
731       RoboticRadiationRecordStorage                        1.2.840.10008.5.1.4.1.1.481.20
732       DICOS_CTImageStorage                                 1.2.840.10008.5.1.4.1.1.501.1
733       DICOS_DigitalXRayImageStorageForPresentation         1.2.840.10008.5.1.4.1.1.501.2.1
734       DICOS_DigitalXRayImageStorageForProcessing           1.2.840.10008.5.1.4.1.1.501.2.2
735       DICOS_ThreatDetectionReportStorage                   1.2.840.10008.5.1.4.1.1.501.3
736       DICOS_2DAITStorage                                   1.2.840.10008.5.1.4.1.1.501.4
737       DICOS_3DAITStorage                                   1.2.840.10008.5.1.4.1.1.501.5
738       DICOS_QuadrupoleResonanceStorage                     1.2.840.10008.5.1.4.1.1.501.6
739       DICONDE_EddyCurrentImageStorage                      1.2.840.10008.5.1.4.1.1.601.1
740       DICONDE_EddyCurrentMultiframeImageStorage            1.2.840.10008.5.1.4.1.1.601.2
741       DRAFT_RTBeamsDeliveryInstructionStorage              1.2.840.10008.5.1.4.34.1
742       RTBeamsDeliveryInstructionStorage                    1.2.840.10008.5.1.4.34.7
743       RTBrachyApplicationSetupDeliveryInstructionStorage   1.2.840.10008.5.1.4.34.10
744       The storescp application will accept presentation contexts for  all  of
745       the  abovementioned  supported  SOP  Classes using any of the following
746       transfer syntaxes:
747       LittleEndianImplicitTransferSyntax                   1.2.840.10008.1.2
748       LittleEndianExplicitTransferSyntax                   1.2.840.10008.1.2.1
749       BigEndianExplicitTransferSyntax                      1.2.840.10008.1.2.2
750       The default behavior of the storescp application is to prefer  transfer
751       syntaxes having an explicit encoding over the default implicit transfer
752       syntax. If storescp is running on big-endian hardware  it  will  prefer
753       BigEndianExplicit  to  LittleEndianExplicit  transfer  syntax (and vice
754       versa). This behavior can be changed with  the  --prefer  options  (see
755       above).  Using  option  --accept-all  any  of  the  following  transfer
756       syntaxes is 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       MPEG4HighProfileLevel4_1TransferSyntax               1.2.840.10008.1.2.4.102
771       MPEG4BDcompatibleHighProfileLevel4_1TransferSyntax   1.2.840.10008.1.2.4.103
772       MPEG4HighProfileLevel4_2_For2DVideoTransferSyntax    1.2.840.10008.1.2.4.104
773       MPEG4HighProfileLevel4_2_For3DVideoTransferSyntax    1.2.840.10008.1.2.4.105
774       MPEG4StereoHighProfileLevel4_2TransferSyntax         1.2.840.10008.1.2.4.106
775       HEVCMainProfileLevel5_1TransferSyntax                1.2.840.10008.1.2.4.107
776       HEVCMain10ProfileLevel5_1TransferSyntax              1.2.840.10008.1.2.4.108
777       RLELosslessTransferSyntax                            1.2.840.10008.1.2.5
778       Additional Storage SOP Classes and Transfer Syntaxes can be  used  with
779       the so-called 'association negotiation profiles' (see below).
780       The  storescp  application  does  not  support  extended negotiation by
781       default. However, using an appropriate association negotiation  profile
782       (see  below) the optional support for extended negotiation can be added
783       to particular SOP classes.
784   Access Control
785       When compiled on Unix platforms with TCP  wrapper  support,  host-based
786       access  control  can  be enabled with the --access-control command line
787       option. In this case the access control rules defined in  the  system's
788       host  access  control  tables  for  storescp  are enforced. The default
789       locations of the host access control tables  are  /etc/hosts.allow  and
790       /etc/hosts.deny. Further details are described in hosts_access(5).
791   Running storescp from inetd
792       On  Posix  platforms,  storescp  can  be initiated through the inetd(8)
793       super  server.  This  requires  that  storescp  be  configured  in  the
794       /etc/inetd.conf  configuration file. A typical configuration line could
795       look like this:
796       acr-nema stream tcp nowait root /usr/sbin/storescp -id +ac -od /tmp/storescp
797       where -id (--inetd)  activates  the  inetd  mode  in  which  the  DICOM
798       association  is  actually accepted by inetd and passed to storescp, +ac
799       (--access-control) activates  the  TCP  wrapper  based  access  control
800       described  above  and -od (--output-directory) defines the directory in
801       which storescp stores incoming DICOM objects.  Note  that  the  service
802       name  ('acr-nema'  in this example) determines the port number on which
803       DICOM associations are accepted and must be defined  in  /etc/services.
804       When  running  from inetd, the stdout and stderr streams are discarded.
805       However, you can still configure logging via  the  --log-config  option
806       (see below).
807       Please note that when run through inetd, storescp is executed with root
808       privileges, which may be a security risk.
809   Association Negotiation Profiles and Configuration Files
810       storescp supports a flexible mechanism for specifying the DICOM network
811       association  negotiation  behavior,  based  on  so-called  'association
812       negotiation profiles' which may be read from a configuration file.  The
813       format  and  semantics  of  this  configuration  file are documented in
814       asconfig.txt.

LOGGING

816       The level of logging output of  the  various  command  line  tools  and
817       underlying  libraries  can  be  specified by the user. By default, only
818       errors and warnings are written to the  standard  error  stream.  Using
819       option  --verbose  also  informational messages like processing details
820       are reported. Option --debug can be used to get  more  details  on  the
821       internal  activity,  e.g.  for debugging purposes. Other logging levels
822       can be selected using option --log-level. In --quiet  mode  only  fatal
823       errors  are reported. In such very severe error events, the application
824       will usually terminate. For  more  details  on  the  different  logging
825       levels, see documentation of module 'oflog'.
826       In  case  the logging output should be written to file (optionally with
827       logfile rotation), to syslog (Unix) or the event log  (Windows)  option
828       --log-config  can  be  used.  This  configuration  file also allows for
829       directing only certain messages to a particular output stream  and  for
830       filtering  certain  messages  based  on the module or application where
831       they are generated.  An  example  configuration  file  is  provided  in
832       <etcdir>/logger.cfg.

COMMAND LINE

834       All  command  line  tools  use  the  following notation for parameters:
835       square brackets enclose optional  values  (0-1),  three  trailing  dots
836       indicate  that multiple values are allowed (1-n), a combination of both
837       means 0 to n values.
838       Command line options are distinguished from parameters by a leading '+'
839       or  '-' sign, respectively. Usually, order and position of command line
840       options are arbitrary (i.e. they  can  appear  anywhere).  However,  if
841       options  are  mutually exclusive the rightmost appearance is used. This
842       behavior conforms to the  standard  evaluation  rules  of  common  Unix
843       shells.
844       In  addition,  one  or more command files can be specified using an '@'
845       sign as a prefix to the filename (e.g. @command.txt).  Such  a  command
846       argument  is  replaced  by  the  content of the corresponding text file
847       (multiple whitespaces are treated as a  single  separator  unless  they
848       appear  between  two  quotation marks) prior to any further evaluation.
849       Please note that a command file cannot contain  another  command  file.
850       This  simple  but  effective  approach  allows  one to summarize common
851       combinations of options/parameters and  avoids  longish  and  confusing
852       command lines (an example is provided in file <datadir>/dumppat.txt).

ENVIRONMENT

854       The  storescp  utility  will  attempt  to  load DICOM data dictionaries
855       specified in the DCMDICTPATH environment variable. By default, i.e.  if
856       the   DCMDICTPATH   environment   variable   is   not   set,  the  file
857       <datadir>/dicom.dic will be loaded unless the dictionary is built  into
858       the application (default for Windows).
859       The   default   behavior   should  be  preferred  and  the  DCMDICTPATH
860       environment variable only used when alternative data  dictionaries  are
861       required.  The  DCMDICTPATH environment variable has the same format as
862       the Unix shell PATH variable in that a colon (':')  separates  entries.
863       On  Windows systems, a semicolon (';') is used as a separator. The data
864       dictionary code will  attempt  to  load  each  file  specified  in  the
865       DCMDICTPATH  environment variable. It is an error if no data dictionary
866       can be loaded.

FILES

868       <docdir>/asconfig.txt - configuration file documentation
869       <etcdir>/storescp.cfg - example association negotiation profile

SEE ALSO

871       storescu(1)
873       Copyright (C) 1996-2021 e.V., Escherweg 2, 26121 Oldenburg, Germany.
874
875
876
877Version 3.6.6                   Thu Jan 14 2021                    storescp(1)
Impressum