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  [c]ertificate filename: string
231                 add certificate file to list of certificates
232
233         +cd   --add-cert-dir  [c]ertificate directory: string
234                 add certificates in d to list of certificates
235
236       ciphersuite:
237
238         +cs   --cipher  [c]iphersuite name: string
239                 add ciphersuite to list of negotiated suites
240
241         +dp   --dhparam  [f]ilename: string
242                 read DH parameters for DH/DSS ciphersuites
243
244       pseudo random generator:
245
246         +rs   --seed  [f]ilename: string
247                 seed random generator with contents of f
248
249         +ws   --write-seed
250                 write back modified seed (only with --seed)
251
252         +wf   --write-seed-file  [f]ilename: string (only with --seed)
253                 write modified seed to file f
254
255       peer authentication:
256
257         -rc   --require-peer-cert
258                 verify peer certificate, fail if absent (default)
259
260         -vc   --verify-peer-cert
261                 verify peer certificate if present
262
263         -ic   --ignore-peer-cert
264                 don't verify peer certificate
265
266   output options
267       general:
268
269         -od   --output-directory  [d]irectory: string (default: ".")
270                 write received objects to existing directory d
271
272       bit preserving mode:
273
274         -B    --normal
275                 allow implicit format conversions (default)
276
277         +B    --bit-preserving
278                 write data exactly as read
279
280       output file format:
281
282         +F    --write-file
283                 write file format (default)
284
285         -F    --write-dataset
286                 write data set without file meta information
287
288       output transfer syntax
289       (not with --bit-preserving or compressed transmission):
290
291         +t=   --write-xfer-same
292                 write with same TS as input (default)
293
294         +te   --write-xfer-little
295                 write with explicit VR little endian TS
296
297         +tb   --write-xfer-big
298                 write with explicit VR big endian TS
299
300         +ti   --write-xfer-implicit
301                 write with implicit VR little endian TS
302
303         +td   --write-xfer-deflated
304                 write with deflated explicit VR little endian TS
305
306       post-1993 value representations (not with --bit-preserving):
307
308         +u    --enable-new-vr
309                 enable support for new VRs (UN/UT) (default)
310
311         -u    --disable-new-vr
312                 disable support for new VRs, convert to OB
313
314       group length encoding (not with --bit-preserving):
315
316         +g=   --group-length-recalc
317                 recalculate group lengths if present (default)
318
319         +g    --group-length-create
320                 always write with group length elements
321
322         -g    --group-length-remove
323                 always write without group length elements
324
325       length encoding in sequences and items (not with --bit-preserving):
326
327         +e    --length-explicit
328                 write with explicit lengths (default)
329
330         -e    --length-undefined
331                 write with undefined lengths
332
333       data set trailing padding
334       (not with --write-dataset or --bit-preserving):
335
336         -p    --padding-off
337                 no padding (default)
338
339         +p    --padding-create  [f]ile-pad [i]tem-pad: integer
340                 align file on multiple of f bytes and items on
341                 multiple of i bytes
342
343       deflate compression level (only with --write-xfer-deflated/same):
344
345         +cl   --compression-level  [l]evel: integer (default: 6)
346                 0=uncompressed, 1=fastest, 9=best compression
347
348       sorting into subdirectories (not with --bit-preserving):
349
350         -ss   --sort-conc-studies  [p]refix: string
351                 sort studies using prefix p and a timestamp
352
353         -su   --sort-on-study-uid  [p]refix: string
354                 sort studies using prefix p and the Study Instance UID
355
356         -sp   --sort-on-patientname
357                 sort studies using the Patient's Name and a timestamp
358
359       filename generation:
360
361         -uf   --default-filenames
362                 generate filename from instance UID (default)
363
364         +uf   --unique-filenames
365                 generate unique filenames
366
367         -tn   --timenames
368                 generate filename from creation time
369
370         -fe   --filename-extension  [e]xtension: string
371                 append e to all filenames
372
373   event options
374         -xcr  --exec-on-reception  [c]ommand: string
375                 execute command c after having received and processed
376                 one C-STORE-RQ message
377
378         -xcs  --exec-on-eostudy  [c]ommand: string
379                 execute command c after having received and processed
380                 all C-STORE-RQ messages that belong to one study
381
382         -rns  --rename-on-eostudy
383                 having received and processed all C-STORE-RQ messages
384                 that belong to one study, rename output files according
385                 to a certain pattern
386
387         -tos  --eostudy-timeout  [t]imeout: integer
388                 specifies a timeout of t seconds for end-of-study
389                 determination
390
391         -xs   --exec-sync
392                 execute command synchronously in foreground
393

NOTES

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

LOGGING

761       The level of logging output of  the  various  command  line  tools  and
762       underlying  libraries  can  be  specified by the user. By default, only
763       errors and warnings are written to the  standard  error  stream.  Using
764       option  --verbose  also  informational messages like processing details
765       are reported. Option --debug can be used to get  more  details  on  the
766       internal  activity,  e.g.  for debugging purposes. Other logging levels
767       can be selected using option --log-level. In --quiet  mode  only  fatal
768       errors  are reported. In such very severe error events, the application
769       will usually terminate. For  more  details  on  the  different  logging
770       levels, see documentation of module 'oflog'.
771       In  case  the logging output should be written to file (optionally with
772       logfile rotation), to syslog (Unix) or the event log  (Windows)  option
773       --log-config  can  be  used.  This  configuration  file also allows for
774       directing only certain messages to a particular output stream  and  for
775       filtering  certain  messages  based  on the module or application where
776       they are generated.  An  example  configuration  file  is  provided  in
777       <etcdir>/logger.cfg.

COMMAND LINE

779       All  command  line  tools  use  the  following notation for parameters:
780       square brackets enclose optional  values  (0-1),  three  trailing  dots
781       indicate  that multiple values are allowed (1-n), a combination of both
782       means 0 to n values.
783       Command line options are distinguished from parameters by a leading '+'
784       or  '-' sign, respectively. Usually, order and position of command line
785       options are arbitrary (i.e. they  can  appear  anywhere).  However,  if
786       options  are  mutually exclusive the rightmost appearance is used. This
787       behavior conforms to the  standard  evaluation  rules  of  common  Unix
788       shells.
789       In  addition,  one  or more command files can be specified using an '@'
790       sign as a prefix to the filename (e.g. @command.txt).  Such  a  command
791       argument  is  replaced  by  the  content of the corresponding text file
792       (multiple whitespaces are treated as a  single  separator  unless  they
793       appear  between  two  quotation marks) prior to any further evaluation.
794       Please note that a command file cannot contain  another  command  file.
795       This  simple  but  effective  approach  allows  one to summarize common
796       combinations of options/parameters and  avoids  longish  and  confusing
797       command lines (an example is provided in file <datadir>/dumppat.txt).

ENVIRONMENT

799       The  storescp  utility  will  attempt  to  load DICOM data dictionaries
800       specified in the DCMDICTPATH environment variable. By default, i.e.  if
801       the   DCMDICTPATH   environment   variable   is   not   set,  the  file
802       <datadir>/dicom.dic will be loaded unless the dictionary is built  into
803       the application (default for Windows).
804       The   default   behavior   should  be  preferred  and  the  DCMDICTPATH
805       environment variable only used when alternative data  dictionaries  are
806       required.  The  DCMDICTPATH environment variable has the same format as
807       the Unix shell PATH variable in that a colon (':')  separates  entries.
808       On  Windows systems, a semicolon (';') is used as a separator. The data
809       dictionary code will  attempt  to  load  each  file  specified  in  the
810       DCMDICTPATH  environment variable. It is an error if no data dictionary
811       can be loaded.

FILES

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

SEE ALSO

816       storescu(1)
818       Copyright (C) 1996-2017 by OFFIS e.V., Escherweg  2,  26121  Oldenburg,
819       Germany.
820
821
822
823Version 3.6.2                   Fri Jul 14 2017                    storescp(1)
Impressum