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

NOTES

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

LOGGING

782       The level of logging output of  the  various  command  line  tools  and
783       underlying  libraries  can  be  specified by the user. By default, only
784       errors and warnings are written to the  standard  error  stream.  Using
785       option  --verbose  also  informational messages like processing details
786       are reported. Option --debug can be used to get  more  details  on  the
787       internal  activity,  e.g.  for debugging purposes. Other logging levels
788       can be selected using option --log-level. In --quiet  mode  only  fatal
789       errors  are reported. In such very severe error events, the application
790       will usually terminate. For  more  details  on  the  different  logging
791       levels, see documentation of module 'oflog'.
792       In  case  the logging output should be written to file (optionally with
793       logfile rotation), to syslog (Unix) or the event log  (Windows)  option
794       --log-config  can  be  used.  This  configuration  file also allows for
795       directing only certain messages to a particular output stream  and  for
796       filtering  certain  messages  based  on the module or application where
797       they are generated.  An  example  configuration  file  is  provided  in
798       <etcdir>/logger.cfg.

COMMAND LINE

800       All  command  line  tools  use  the  following notation for parameters:
801       square brackets enclose optional  values  (0-1),  three  trailing  dots
802       indicate  that multiple values are allowed (1-n), a combination of both
803       means 0 to n values.
804       Command line options are distinguished from parameters by a leading '+'
805       or  '-' sign, respectively. Usually, order and position of command line
806       options are arbitrary (i.e. they  can  appear  anywhere).  However,  if
807       options  are  mutually exclusive the rightmost appearance is used. This
808       behavior conforms to the  standard  evaluation  rules  of  common  Unix
809       shells.
810       In  addition,  one  or more command files can be specified using an '@'
811       sign as a prefix to the filename (e.g. @command.txt).  Such  a  command
812       argument  is  replaced  by  the  content of the corresponding text file
813       (multiple whitespaces are treated as a  single  separator  unless  they
814       appear  between  two  quotation marks) prior to any further evaluation.
815       Please note that a command file cannot contain  another  command  file.
816       This  simple  but  effective  approach  allows  one to summarize common
817       combinations of options/parameters and  avoids  longish  and  confusing
818       command lines (an example is provided in file <datadir>/dumppat.txt).

ENVIRONMENT

820       The  storescp  utility  will  attempt  to  load DICOM data dictionaries
821       specified in the DCMDICTPATH environment variable. By default, i.e.  if
822       the   DCMDICTPATH   environment   variable   is   not   set,  the  file
823       <datadir>/dicom.dic will be loaded unless the dictionary is built  into
824       the application (default for Windows).
825       The   default   behavior   should  be  preferred  and  the  DCMDICTPATH
826       environment variable only used when alternative data  dictionaries  are
827       required.  The  DCMDICTPATH environment variable has the same format as
828       the Unix shell PATH variable in that a colon (':')  separates  entries.
829       On  Windows systems, a semicolon (';') is used as a separator. The data
830       dictionary code will  attempt  to  load  each  file  specified  in  the
831       DCMDICTPATH  environment variable. It is an error if no data dictionary
832       can be loaded.

FILES

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

SEE ALSO

837       storescu(1)
839       Copyright (C) 1996-2018 by OFFIS e.V., Escherweg  2,  26121  Oldenburg,
840       Germany.
841
842
843
844Version 3.6.4                   Thu Nov 29 2018                    storescp(1)
Impressum