1storescu(1) OFFIS DCMTK storescu(1)
2
6 storescu - DICOM storage (C-STORE) SCU
7
10 storescu [options] peer port dcmfile-in...
11
13 The storescu application implements a Service Class User (SCU) for the
14 Storage Service Class. For each DICOM file on the command line it sends
15 a C-STORE message to a Storage Service Class Provider (SCP) and waits
16 for a response. The application can be used to transmit DICOM images
17 and other DICOM composite objects.
18
20 peer hostname of DICOM peer
21 port tcp/ip port number of peer
23 dcmfile-in DICOM file or directory to be transmitted
25
27 general options
28 -h --help
29 print this help text and exit
30 --version
32 print version information and exit
33 --arguments
35 print expanded command line arguments
36 -q --quiet
38 quiet mode, print no warnings and errors
39 -v --verbose
41 verbose mode, print processing details
42 -d --debug
44 debug mode, print debug information
45 -ll --log-level [l]evel: string constant
47 (fatal, error, warn, info, debug, trace)
48 use level l for the logger
49 -lc --log-config [f]ilename: string
51 use config file f for the logger
52 +v --verbose-pc
54 show presentation contexts in verbose mode
55 input options
57 input file format:
58 +f --read-file
60 read file format or data set (default)
61 +fo --read-file-only
63 read file format only
64 -f --read-dataset
66 read data set without file meta information
67 input files:
69 +sd --scan-directories
71 scan directories for input files (dcmfile-in)
72 +sp --scan-pattern [p]attern: string (only with --scan-directories)
74 pattern for filename matching (wildcards)
75 # possibly not available on all systems
77 -r --no-recurse
79 do not recurse within directories (default)
80 +r --recurse
82 recurse within specified directories
83 network options
85 application entity titles:
86 -aet --aetitle [a]etitle: string
88 set my calling AE title (default: STORESCU)
89 -aec --call [a]etitle: string
91 set called AE title of peer (default: ANY-SCP)
92 association negotiation profile from configuration file:
94 -xf --config-file [f]ilename, [p]rofile: string
96 use profile p from config file f
97 proposed transmission transfer syntaxes (not with --config-file):
99 -x= --propose-uncompr
101 propose all uncompressed TS, explicit VR
102 with local byte ordering first (default)
103 -xe --propose-little
105 propose all uncompressed TS, explicit VR little endian first
106 -xb --propose-big
108 propose all uncompressed TS, explicit VR big endian first
109 -xi --propose-implicit
111 propose implicit VR little endian TS only
112 -xs --propose-lossless
114 propose default JPEG lossless TS
115 and all uncompressed transfer syntaxes
116 -xy --propose-jpeg8
118 propose default JPEG lossy TS for 8 bit data
119 and all uncompressed transfer syntaxes
120 -xx --propose-jpeg12
122 propose default JPEG lossy TS for 12 bit data
123 and all uncompressed transfer syntaxes
124 -xv --propose-j2k-lossless
126 propose JPEG 2000 lossless TS
127 and all uncompressed transfer syntaxes
128 -xw --propose-j2k-lossy
130 propose JPEG 2000 lossy TS
131 and all uncompressed transfer syntaxes
132 -xt --propose-jls-lossless
134 propose JPEG-LS lossless TS
135 and all uncompressed transfer syntaxes
136 -xu --propose-jls-lossy
138 propose JPEG-LS lossy TS
139 and all uncompressed transfer syntaxes
140 -xm --propose-mpeg2
142 propose MPEG2 Main Profile @ Main Level TS only
143 -xh --propose-mpeg2-high
145 propose MPEG2 Main Profile @ High Level TS only
146 -xn --propose-mpeg4
148 propose MPEG4 AVC/H.264 High Profile / Level 4.1 TS only
149 -xl --propose-mpeg4-bd
151 propose MPEG4 AVC/H.264 BD-compatible HP / Level 4.1 TS only
152 -x2 --propose-mpeg4-2-2d
154 propose MPEG4 AVC/H.264 HP / Level 4.2 TS for 2D Videos only
155 -x3 --propose-mpeg4-2-3d
157 propose MPEG4 AVC/H.264 HP / Level 4.2 TS for 3D Videos only
158 -xo --propose-mpeg4-2-st
160 propose MPEG4 AVC/H.264 Stereo HP / Level 4.2 TS only
161 -x4 --propose-hevc
163 propose HEVC H.265 Main Profile / Level 5.1 TS only
164 -x5 --propose-hevc10
166 propose HEVC H.265 Main 10 Profile / Level 5.1 TS only
167 -xr --propose-rle
169 propose RLE lossless TS
170 and all uncompressed transfer syntaxes
171 -xd --propose-deflated
173 propose deflated explicit VR little endian TS
174 and all uncompressed transfer syntaxes
175 -R --required
177 propose only required presentation contexts
178 (default: propose all supported)
179 +C --combine
181 combine proposed transfer syntaxes
182 (default: separate presentation context for each TS)
183 post-1993 value representations:
185 +u --enable-new-vr
187 enable support for new VRs (UN/UT) (default)
188 -u --disable-new-vr
190 disable support for new VRs, convert to OB
191 deflate compression level (only with --propose-deflated or --config-file):
193 +cl --compression-level [l]evel: integer (default: 6)
195 0=uncompressed, 1=fastest, 9=best compression
196 user identity negotiation:
198 -usr --user [u]ser name: string
200 authenticate using user name u
201 -pwd --password [p]assword: string (only with --user)
203 authenticate using password p
204 -epw --empty-password
206 send empty password (only with --user)
207 -kt --kerberos [f]ilename: string
209 read kerberos ticket from file f
210 --saml [f]ilename: string
212 read SAML request from file f
213 -rsp --pos-response
215 expect positive response
216 other network options:
218 -to --timeout [s]econds: integer (default: unlimited)
220 timeout for connection requests
221 -ts --socket-timeout [s]econds: integer (default: 60)
223 timeout for network socket (0 for none)
224 -ta --acse-timeout [s]econds: integer (default: 30)
226 timeout for ACSE messages
227 -td --dimse-timeout [s]econds: integer (default: unlimited)
229 timeout for DIMSE messages
230 -pdu --max-pdu [n]umber of bytes: integer (4096..131072)
232 set max receive pdu to n bytes (default: 16384)
233 --max-send-pdu [n]umber of bytes: integer (4096..131072)
235 restrict max send pdu to n bytes
236 --repeat [n]umber: integer
238 repeat n times
239 --abort
241 abort association instead of releasing it
242 -nh --no-halt
244 do not halt if unsuccessful store encountered
245 (default: do halt)
246 -up --uid-padding
248 silently correct space-padded UIDs
249 +II --invent-instance
251 invent a new SOP instance UID for every image sent
252 +IR --invent-series [n]umber: integer (implies --invent-instance)
254 invent a new series UID after n images have been sent
255 (default: 100)
256 +IS --invent-study [n]umber: integer (implies --invent-instance)
258 invent a new study UID after n series have been sent
259 (default: 50)
260 +IP --invent-patient [n]umber: integer (implies --invent-instance)
262 invent a new patient ID and name after n studies have been sent
263 (default: 25)
264 transport layer security (TLS) options
266 transport protocol stack:
267 -tls --disable-tls
269 use normal TCP/IP connection (default)
270 +tls --enable-tls [p]rivate key file, [c]ertificate file: string
272 use authenticated secure TLS connection
273 +tla --anonymous-tls
275 use secure TLS connection without certificate
276 private key password (only with --enable-tls):
278 +ps --std-passwd
280 prompt user to type password on stdin (default)
281 +pw --use-passwd [p]assword: string
283 use specified password
284 -pw --null-passwd
286 use empty string as password
287 key and certificate file format:
289 -pem --pem-keys
291 read keys and certificates as PEM file (default)
292 -der --der-keys
294 read keys and certificates as DER file
295 certification authority:
297 +cf --add-cert-file [c]ertificate filename: string
299 add certificate file to list of certificates
300 +cd --add-cert-dir [c]ertificate directory: string
302 add certificates in d to list of certificates
303 ciphersuite:
305 +cs --cipher [c]iphersuite name: string
307 add ciphersuite to list of negotiated suites
308 +dp --dhparam [f]ilename: string
310 read DH parameters for DH/DSS ciphersuites
311 pseudo random generator:
313 +rs --seed [f]ilename: string
315 seed random generator with contents of f
316 +ws --write-seed
318 write back modified seed (only with --seed)
319 +wf --write-seed-file [f]ilename: string (only with --seed)
321 write modified seed to file f
322 peer authentication:
324 -rc --require-peer-cert
326 verify peer certificate, fail if absent (default)
327 -vc --verify-peer-cert
329 verify peer certificate if present
330 -ic --ignore-peer-cert
332 don't verify peer certificate
333
335 Scanning Directories
336 Adding directories as a parameter to the command line only makes sense
337 if option --scan-directories is also given. If the files in the
338 provided directories should be selected according to a specific name
339 pattern (e.g. using wildcard matching), option --scan-pattern has to be
340 used. Please note that this file pattern only applies to the files
341 within the scanned directories, and, if any other patterns are
342 specified on the command line outside the --scan-pattern option (e.g.
343 in order to select further files), these do not apply to the specified
344 directories.
345 DICOM Conformance
347 The storescu application supports the following Storage SOP Classes as
348 an SCU:
349 ComputedRadiographyImageStorage 1.2.840.10008.5.1.4.1.1.1
351 DigitalXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.1.1
352 DigitalXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.1.1.1
353 DigitalMammographyXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.1.2
354 DigitalMammographyXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.1.2.1
355 DigitalIntraOralXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.1.3
356 DigitalIntraOralXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.1.3.1
357 CTImageStorage 1.2.840.10008.5.1.4.1.1.2
358 EnhancedCTImageStorage 1.2.840.10008.5.1.4.1.1.2.1
359 UltrasoundMultiframeImageStorage 1.2.840.10008.5.1.4.1.1.3.1
360 MRImageStorage 1.2.840.10008.5.1.4.1.1.4
361 EnhancedMRImageStorage 1.2.840.10008.5.1.4.1.1.4.1
362 MRSpectroscopyStorage 1.2.840.10008.5.1.4.1.1.4.2
363 UltrasoundImageStorage 1.2.840.10008.5.1.4.1.1.6.1
364 SecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7
365 MultiframeSingleBitSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.1
366 MultiframeGrayscaleByteSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.2
367 MultiframeGrayscaleWordSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.3
368 MultiframeTrueColorSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.4
369 TwelveLeadECGWaveformStorage 1.2.840.10008.5.1.4.1.1.9.1.1
370 GeneralECGWaveformStorage 1.2.840.10008.5.1.4.1.1.9.1.2
371 AmbulatoryECGWaveformStorage 1.2.840.10008.5.1.4.1.1.9.1.3
372 HemodynamicWaveformStorage 1.2.840.10008.5.1.4.1.1.9.2.1
373 CardiacElectrophysiologyWaveformStorage 1.2.840.10008.5.1.4.1.1.9.3.1
374 BasicVoiceAudioWaveformStorage 1.2.840.10008.5.1.4.1.1.9.4.1
375 GrayscaleSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.1
376 ColorSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.2
377 PseudoColorSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.3
378 BlendingSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.4
379 XRayAngiographicImageStorage 1.2.840.10008.5.1.4.1.1.12.1
380 EnhancedXAImageStorage 1.2.840.10008.5.1.4.1.1.12.1.1
381 XRayRadiofluoroscopicImageStorage 1.2.840.10008.5.1.4.1.1.12.2
382 EnhancedXRFImageStorage 1.2.840.10008.5.1.4.1.1.12.2.1
383 NuclearMedicineImageStorage 1.2.840.10008.5.1.4.1.1.20
384 RawDataStorage 1.2.840.10008.5.1.4.1.1.66
385 SpatialRegistrationStorage 1.2.840.10008.5.1.4.1.1.66.1
386 SpatialFiducialsStorage 1.2.840.10008.5.1.4.1.1.66.2
387 RealWorldValueMappingStorage 1.2.840.10008.5.1.4.1.1.67
388 VLEndoscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.1
389 VLMicroscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.2
390 VLSlideCoordinatesMicroscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.3
391 VLPhotographicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.4
392 OphthalmicPhotography8BitImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.1
393 OphthalmicPhotography16BitImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.2
394 StereometricRelationshipStorage 1.2.840.10008.5.1.4.1.1.77.1.5.3
395 OphthalmicTomographyImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.4
396 BasicTextSRStorage 1.2.840.10008.5.1.4.1.1.88.11
397 EnhancedSRStorage 1.2.840.10008.5.1.4.1.1.88.22
398 ComprehensiveSRStorage 1.2.840.10008.5.1.4.1.1.88.33
399 ProcedureLogStorage 1.2.840.10008.5.1.4.1.1.88.40
400 MammographyCADSRStorage 1.2.840.10008.5.1.4.1.1.88.50
401 KeyObjectSelectionDocumentStorage 1.2.840.10008.5.1.4.1.1.88.59
402 ChestCADSRStorage 1.2.840.10008.5.1.4.1.1.88.65
403 XRayRadiationDoseSRStorage 1.2.840.10008.5.1.4.1.1.88.67
404 ColonCADSRStorage 1.2.840.10008.5.1.4.1.1.88.69
405 EncapsulatedPDFStorage 1.2.840.10008.5.1.4.1.1.104.1
406 PositronEmissionTomographyImageStorage 1.2.840.10008.5.1.4.1.1.128
407 RTImageStorage 1.2.840.10008.5.1.4.1.1.481.1
408 RTDoseStorage 1.2.840.10008.5.1.4.1.1.481.2
409 RTStructureSetStorage 1.2.840.10008.5.1.4.1.1.481.3
410 RTBeamsTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.4
411 RTPlanStorage 1.2.840.10008.5.1.4.1.1.481.5
412 RTBrachyTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.6
413 RTTreatmentSummaryRecordStorage 1.2.840.10008.5.1.4.1.1.481.7
414 The default behavior of storescu is to propose two presentation
416 contexts for each supported SOP class (abstract syntax) - one with the
417 preferred transfer syntax and one with all other uncompressed transfer
418 syntaxes. The default preferred transfer syntax is explicit VR with
419 byte ordering corresponding to the local byte ordering of the machine
420 on which storescu is running. This behavior can be changed with the
421 --propose, --combine and --required options, see above. Depending on
422 these options, the following transfer syntaxes are supported:
423 LittleEndianImplicitTransferSyntax 1.2.840.10008.1.2
425 LittleEndianExplicitTransferSyntax 1.2.840.10008.1.2.1
426 DeflatedExplicitVRLittleEndianTransferSyntax 1.2.840.10008.1.2.1.99
427 BigEndianExplicitTransferSyntax 1.2.840.10008.1.2.2
428 JPEGProcess1TransferSyntax 1.2.840.10008.1.2.4.50
429 JPEGProcess2_4TransferSyntax 1.2.840.10008.1.2.4.51
430 JPEGProcess14SV1TransferSyntax 1.2.840.10008.1.2.4.70
431 JPEGLSLosslessTransferSyntax 1.2.840.10008.1.2.4.80
432 JPEGLSLossyTransferSyntax 1.2.840.10008.1.2.4.81
433 JPEG2000LosslessOnlyTransferSyntax 1.2.840.10008.1.2.4.90
434 JPEG2000TransferSyntax 1.2.840.10008.1.2.4.91
435 MPEG2MainProfileAtMainLevelTransferSyntax 1.2.840.10008.1.2.4.100
436 MPEG2MainProfileAtHighLevelTransferSyntax 1.2.840.10008.1.2.4.101
437 MPEG4HighProfileLevel4_1TransferSyntax 1.2.840.10008.1.2.4.102
438 MPEG4BDcompatibleHighProfileLevel4_1TransferSyntax 1.2.840.10008.1.2.4.103
439 MPEG4HighProfileLevel4_2_For2DVideoTransferSyntax 1.2.840.10008.1.2.4.104
440 MPEG4HighProfileLevel4_2_For3DVideoTransferSyntax 1.2.840.10008.1.2.4.105
441 MPEG4StereoHighProfileLevel4_2TransferSyntax 1.2.840.10008.1.2.4.106
442 HEVCMainProfileLevel5_1TransferSyntax 1.2.840.10008.1.2.4.107
443 HEVCMain10ProfileLevel5_1TransferSyntax 1.2.840.10008.1.2.4.108
444 RLELosslessTransferSyntax 1.2.840.10008.1.2.5
445 Additional Storage SOP Classes and Transfer Syntaxes can be used with
447 the so-called 'association negotiation profiles' (see below).
448 The storescu application does not support extended negotiation by
450 default. However, using an appropriate association negotiation profile
451 (see below) the optional support for extended negotiation can be added
452 to particular SOP classes.
453 Association Negotiation Profiles and Configuration Files
455 storescu supports a flexible mechanism for specifying the DICOM network
456 association negotiation behavior, based on so-called 'association
457 negotiation profiles' which may be read from a configuration file. The
458 format and semantics of this configuration file are documented in
459 asconfig.txt.
460
462 The level of logging output of the various command line tools and
463 underlying libraries can be specified by the user. By default, only
464 errors and warnings are written to the standard error stream. Using
465 option --verbose also informational messages like processing details
466 are reported. Option --debug can be used to get more details on the
467 internal activity, e.g. for debugging purposes. Other logging levels
468 can be selected using option --log-level. In --quiet mode only fatal
469 errors are reported. In such very severe error events, the application
470 will usually terminate. For more details on the different logging
471 levels, see documentation of module 'oflog'.
472 In case the logging output should be written to file (optionally with
474 logfile rotation), to syslog (Unix) or the event log (Windows) option
475 --log-config can be used. This configuration file also allows for
476 directing only certain messages to a particular output stream and for
477 filtering certain messages based on the module or application where
478 they are generated. An example configuration file is provided in
479 <etcdir>/logger.cfg.
480
482 All command line tools use the following notation for parameters:
483 square brackets enclose optional values (0-1), three trailing dots
484 indicate that multiple values are allowed (1-n), a combination of both
485 means 0 to n values.
486 Command line options are distinguished from parameters by a leading '+'
488 or '-' sign, respectively. Usually, order and position of command line
489 options are arbitrary (i.e. they can appear anywhere). However, if
490 options are mutually exclusive the rightmost appearance is used. This
491 behavior conforms to the standard evaluation rules of common Unix
492 shells.
493 In addition, one or more command files can be specified using an '@'
495 sign as a prefix to the filename (e.g. @command.txt). Such a command
496 argument is replaced by the content of the corresponding text file
497 (multiple whitespaces are treated as a single separator unless they
498 appear between two quotation marks) prior to any further evaluation.
499 Please note that a command file cannot contain another command file.
500 This simple but effective approach allows one to summarize common
501 combinations of options/parameters and avoids longish and confusing
502 command lines (an example is provided in file <datadir>/dumppat.txt).
503
505 The storescu utility will attempt to load DICOM data dictionaries
506 specified in the DCMDICTPATH environment variable. By default, i.e. if
507 the DCMDICTPATH environment variable is not set, the file
508 <datadir>/dicom.dic will be loaded unless the dictionary is built into
509 the application (default for Windows).
510 The default behavior should be preferred and the DCMDICTPATH
512 environment variable only used when alternative data dictionaries are
513 required. The DCMDICTPATH environment variable has the same format as
514 the Unix shell PATH variable in that a colon (':') separates entries.
515 On Windows systems, a semicolon (';') is used as a separator. The data
516 dictionary code will attempt to load each file specified in the
517 DCMDICTPATH environment variable. It is an error if no data dictionary
518 can be loaded.
519
521 <docdir>/asconfig.txt - configuration file documentation
522 <etcdir>/storescu.cfg - example association negotiation profile
523
525 storescp(1)
526
528 Copyright (C) 1996-2017 by OFFIS e.V., Escherweg 2, 26121 Oldenburg,
529 Germany.
530Version 3.6.2 Fri Jul 14 2017 storescu(1)