1storescu(1) OFFIS DCMTK storescu(1)
2
6 storescu - DICOM storage (C-STORE) SCU
7
9 storescu [options] peer port dcmfile-in...
10
12 The storescu application implements a Service Class User (SCU) for the
13 Storage Service Class. For each DICOM file on the command line it sends
14 a C-STORE message to a Storage Service Class Provider (SCP) and waits
15 for a response. The application can be used to transmit DICOM images
16 and other DICOM composite objects.
17
19 peer hostname of DICOM peer
20 port tcp/ip port number of peer
22 dcmfile-in DICOM file or directory to be transmitted
24
26 general options
27 -h --help
28 print this help text and exit
29 --version
31 print version information and exit
32 --arguments
34 print expanded command line arguments
35 -q --quiet
37 quiet mode, print no warnings and errors
38 -v --verbose
40 verbose mode, print processing details
41 -d --debug
43 debug mode, print debug information
44 -ll --log-level [l]evel: string constant
46 (fatal, error, warn, info, debug, trace)
47 use level l for the logger
48 -lc --log-config [f]ilename: string
50 use config file f for the logger
51 +v --verbose-pc
53 show presentation contexts in verbose mode
54 input options
56 input file format:
57 +f --read-file
59 read file format or data set (default)
60 +fo --read-file-only
62 read file format only
63 -f --read-dataset
65 read data set without file meta information
66 input files:
68 +sd --scan-directories
70 scan directories for input files (dcmfile-in)
71 +sp --scan-pattern [p]attern: string (only with --scan-directories)
73 pattern for filename matching (wildcards)
74 # possibly not available on all systems
76 -r --no-recurse
78 do not recurse within directories (default)
79 +r --recurse
81 recurse within specified directories
82 network options
84 application entity titles:
85 -aet --aetitle [a]etitle: string
87 set my calling AE title (default: STORESCU)
88 -aec --call [a]etitle: string
90 set called AE title of peer (default: ANY-SCP)
91 association negotiation profile from configuration file:
93 -xf --config-file [f]ilename, [p]rofile: string
95 use profile p from config file f
96 proposed transmission transfer syntaxes (not with --config-file):
98 -x= --propose-uncompr
100 propose all uncompressed TS, explicit VR
101 with local byte ordering first (default)
102 -xe --propose-little
104 propose all uncompressed TS, explicit VR little endian first
105 -xb --propose-big
107 propose all uncompressed TS, explicit VR big endian first
108 -xi --propose-implicit
110 propose implicit VR little endian TS only
111 -xs --propose-lossless
113 propose default JPEG lossless TS
114 and all uncompressed transfer syntaxes
115 -xy --propose-jpeg8
117 propose default JPEG lossy TS for 8 bit data
118 and all uncompressed transfer syntaxes
119 -xx --propose-jpeg12
121 propose default JPEG lossy TS for 12 bit data
122 and all uncompressed transfer syntaxes
123 -xv --propose-j2k-lossless
125 propose JPEG 2000 lossless TS
126 and all uncompressed transfer syntaxes
127 -xw --propose-j2k-lossy
129 propose JPEG 2000 lossy TS
130 and all uncompressed transfer syntaxes
131 -xt --propose-jls-lossless
133 propose JPEG-LS lossless TS
134 and all uncompressed transfer syntaxes
135 -xu --propose-jls-lossy
137 propose JPEG-LS lossy TS
138 and all uncompressed transfer syntaxes
139 -xm --propose-mpeg2
141 propose MPEG2 Main Profile @ Main Level TS only
142 -xh --propose-mpeg2-high
144 propose MPEG2 Main Profile @ High Level TS only
145 -xr --propose-rle
147 propose RLE lossless TS
148 and all uncompressed transfer syntaxes
149 -R --required
151 propose only required presentation contexts
152 (default: propose all supported)
153 +C --combine
155 combine proposed transfer syntaxes
156 (default: separate presentation context for each TS)
157 post-1993 value representations:
159 +u --enable-new-vr
161 enable support for new VRs (UN/UT) (default)
162 -u --disable-new-vr
164 disable support for new VRs, convert to OB
165 deflate compression level (only with --propose-deflated or --config-file):
167 +cl --compression-level [l]evel: integer (default: 6)
169 0=uncompressed, 1=fastest, 9=best compression
170 user identity negotiation:
172 -usr --user [u]ser name: string
174 authenticate using user name u
175 -pwd --password [p]assword: string (only with --user)
177 authenticate using password p
178 -epw --empty-password
180 send empty password (only with --user)
181 -kt --kerberos [f]ilename: string
183 read kerberos ticket from file f
184 --saml [f]ilename: string
186 read SAML request from file f
187 -rsp --pos-response
189 expect positive response
190 other network options:
192 -to --timeout [s]econds: integer (default: unlimited)
194 timeout for connection requests
195 -ta --acse-timeout [s]econds: integer (default: 30)
197 timeout for ACSE messages
198 -td --dimse-timeout [s]econds: integer (default: unlimited)
200 timeout for DIMSE messages
201 -pdu --max-pdu [n]umber of bytes: integer (4096..131072)
203 set max receive pdu to n bytes (default: 16384)
204 --max-send-pdu [n]umber of bytes: integer (4096..131072)
206 restrict max send pdu to n bytes
207 --repeat [n]umber: integer
209 repeat n times
210 --abort
212 abort association instead of releasing it
213 -nh --no-halt
215 do not halt if unsuccessful store encountered
216 (default: do halt)
217 -up --uid-padding
219 silently correct space-padded UIDs
220 +II --invent-instance
222 invent a new SOP instance UID for every image sent
223 +IR --invent-series [n]umber: integer (implies --invent-instance)
225 invent a new series UID after n images have been sent
226 (default: 100)
227 +IS --invent-study [n]umber: integer (implies --invent-instance)
229 invent a new study UID after n series have been sent
230 (default: 50)
231 +IP --invent-patient [n]umber: integer (implies --invent-instance)
233 invent a new patient ID and name after n studies have been sent
234 (default: 25)
235 transport layer security (TLS) options
237 transport protocol stack:
238 -tls --disable-tls
240 use normal TCP/IP connection (default)
241 +tls --enable-tls [p]rivate key file, [c]ertificate file: string
243 use authenticated secure TLS connection
244 +tla --anonymous-tls
246 use secure TLS connection without certificate
247 private key password (only with --enable-tls):
249 +ps --std-passwd
251 prompt user to type password on stdin (default)
252 +pw --use-passwd [p]assword: string
254 use specified password
255 -pw --null-passwd
257 use empty string as password
258 key and certificate file format:
260 -pem --pem-keys
262 read keys and certificates as PEM file (default)
263 -der --der-keys
265 read keys and certificates as DER file
266 certification authority:
268 +cf --add-cert-file [c]ertificate filename: string
270 add certificate file to list of certificates
271 +cd --add-cert-dir [c]ertificate directory: string
273 add certificates in d to list of certificates
274 ciphersuite:
276 +cs --cipher [c]iphersuite name: string
278 add ciphersuite to list of negotiated suites
279 +dp --dhparam [f]ilename: string
281 read DH parameters for DH/DSS ciphersuites
282 pseudo random generator:
284 +rs --seed [f]ilename: string
286 seed random generator with contents of f
287 +ws --write-seed
289 write back modified seed (only with --seed)
290 +wf --write-seed-file [f]ilename: string (only with --seed)
292 write modified seed to file f
293 peer authentication:
295 -rc --require-peer-cert
297 verify peer certificate, fail if absent (default)
298 -vc --verify-peer-cert
300 verify peer certificate if present
301 -ic --ignore-peer-cert
303 don't verify peer certificate
304
306 DICOM Conformance
307 The storescu application supports the following Storage SOP Classes as
308 an SCU:
309 ComputedRadiographyImageStorage 1.2.840.10008.5.1.4.1.1.1
311 DigitalXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.1.1
312 DigitalXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.1.1.1
313 DigitalMammographyXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.1.2
314 DigitalMammographyXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.1.2.1
315 DigitalIntraOralXRayImageStorageForPresentation 1.2.840.10008.5.1.4.1.1.1.3
316 DigitalIntraOralXRayImageStorageForProcessing 1.2.840.10008.5.1.4.1.1.1.3.1
317 CTImageStorage 1.2.840.10008.5.1.4.1.1.2
318 EnhancedCTImageStorage 1.2.840.10008.5.1.4.1.1.2.1
319 UltrasoundMultiframeImageStorage 1.2.840.10008.5.1.4.1.1.3.1
320 MRImageStorage 1.2.840.10008.5.1.4.1.1.4
321 EnhancedMRImageStorage 1.2.840.10008.5.1.4.1.1.4.1
322 MRSpectroscopyStorage 1.2.840.10008.5.1.4.1.1.4.2
323 UltrasoundImageStorage 1.2.840.10008.5.1.4.1.1.6.1
324 SecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7
325 MultiframeSingleBitSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.1
326 MultiframeGrayscaleByteSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.2
327 MultiframeGrayscaleWordSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.3
328 MultiframeTrueColorSecondaryCaptureImageStorage 1.2.840.10008.5.1.4.1.1.7.4
329 TwelveLeadECGWaveformStorage 1.2.840.10008.5.1.4.1.1.9.1.1
330 GeneralECGWaveformStorage 1.2.840.10008.5.1.4.1.1.9.1.2
331 AmbulatoryECGWaveformStorage 1.2.840.10008.5.1.4.1.1.9.1.3
332 HemodynamicWaveformStorage 1.2.840.10008.5.1.4.1.1.9.2.1
333 CardiacElectrophysiologyWaveformStorage 1.2.840.10008.5.1.4.1.1.9.3.1
334 BasicVoiceAudioWaveformStorage 1.2.840.10008.5.1.4.1.1.9.4.1
335 GrayscaleSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.1
336 ColorSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.2
337 PseudoColorSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.3
338 BlendingSoftcopyPresentationStateStorage 1.2.840.10008.5.1.4.1.1.11.4
339 XRayAngiographicImageStorage 1.2.840.10008.5.1.4.1.1.12.1
340 EnhancedXAImageStorage 1.2.840.10008.5.1.4.1.1.12.1.1
341 XRayRadiofluoroscopicImageStorage 1.2.840.10008.5.1.4.1.1.12.2
342 EnhancedXRFImageStorage 1.2.840.10008.5.1.4.1.1.12.2.1
343 NuclearMedicineImageStorage 1.2.840.10008.5.1.4.1.1.20
344 RawDataStorage 1.2.840.10008.5.1.4.1.1.66
345 SpatialRegistrationStorage 1.2.840.10008.5.1.4.1.1.66.1
346 SpatialFiducialsStorage 1.2.840.10008.5.1.4.1.1.66.2
347 RealWorldValueMappingStorage 1.2.840.10008.5.1.4.1.1.67
348 VLEndoscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.1
349 VLMicroscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.2
350 VLSlideCoordinatesMicroscopicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.3
351 VLPhotographicImageStorage 1.2.840.10008.5.1.4.1.1.77.1.4
352 OphthalmicPhotography8BitImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.1
353 OphthalmicPhotography16BitImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.2
354 StereometricRelationshipStorage 1.2.840.10008.5.1.4.1.1.77.1.5.3
355 OphthalmicTomographyImageStorage 1.2.840.10008.5.1.4.1.1.77.1.5.4
356 BasicTextSRStorage 1.2.840.10008.5.1.4.1.1.88.11
357 EnhancedSRStorage 1.2.840.10008.5.1.4.1.1.88.22
358 ComprehensiveSRStorage 1.2.840.10008.5.1.4.1.1.88.33
359 ProcedureLogStorage 1.2.840.10008.5.1.4.1.1.88.40
360 MammographyCADSRStorage 1.2.840.10008.5.1.4.1.1.88.50
361 KeyObjectSelectionDocumentStorage 1.2.840.10008.5.1.4.1.1.88.59
362 ChestCADSRStorage 1.2.840.10008.5.1.4.1.1.88.65
363 XRayRadiationDoseSRStorage 1.2.840.10008.5.1.4.1.1.88.67
364 ColonCADSRStorage 1.2.840.10008.5.1.4.1.1.88.69
365 EncapsulatedPDFStorage 1.2.840.10008.5.1.4.1.1.104.1
366 PositronEmissionTomographyImageStorage 1.2.840.10008.5.1.4.1.1.128
367 RTImageStorage 1.2.840.10008.5.1.4.1.1.481.1
368 RTDoseStorage 1.2.840.10008.5.1.4.1.1.481.2
369 RTStructureSetStorage 1.2.840.10008.5.1.4.1.1.481.3
370 RTBeamsTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.4
371 RTPlanStorage 1.2.840.10008.5.1.4.1.1.481.5
372 RTBrachyTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.6
373 RTTreatmentSummaryRecordStorage 1.2.840.10008.5.1.4.1.1.481.7
374 The default behaviour of storescu is to propose two presentation
376 contexts for each supported SOP class (abstract syntax) - one with the
377 preferred transfer syntax and one with all other uncompressed transfer
378 syntaxes. The default preferred transfer syntax is explicit VR with
379 byte ordering corresponding to the local byte ordering of the machine
380 on which storescu is running. This behaviour can be changed with the
381 --propose, --combine and --required options, see above. Depending on
382 these options, the following transfer syntaxes are supported:
383 LittleEndianImplicitTransferSyntax 1.2.840.10008.1.2
385 LittleEndianExplicitTransferSyntax 1.2.840.10008.1.2.1
386 DeflatedExplicitVRLittleEndianTransferSyntax 1.2.840.10008.1.2.1.99
387 BigEndianExplicitTransferSyntax 1.2.840.10008.1.2.2
388 JPEGProcess1TransferSyntax 1.2.840.10008.1.2.4.50
389 JPEGProcess2_4TransferSyntax 1.2.840.10008.1.2.4.51
390 JPEGProcess14SV1TransferSyntax 1.2.840.10008.1.2.4.70
391 JPEGLSLosslessTransferSyntax 1.2.840.10008.1.2.4.80
392 JPEGLSLossyTransferSyntax 1.2.840.10008.1.2.4.81
393 JPEG2000LosslessOnlyTransferSyntax 1.2.840.10008.1.2.4.90
394 JPEG2000TransferSyntax 1.2.840.10008.1.2.4.91
395 MPEG2MainProfileAtMainLevelTransferSyntax 1.2.840.10008.1.2.4.100
396 MPEG2MainProfileAtHighLevelTransferSyntax 1.2.840.10008.1.2.4.101
397 RLELosslessTransferSyntax 1.2.840.10008.1.2.5
398 Additional Storage SOP Classes and Transfer Syntaxes can be used with
400 the so-called 'association negotiation profiles' (see below).
401 The storescu application does not support extended negotiation by
403 default. However, using an appropriate association negotiation profile
404 (see below) the optional support for extended negotiation can be added
405 to particular SOP classes.
406 Association Negotiation Profiles and Configuration Files
408 storescu supports a flexible mechanism for specifying the DICOM network
409 association negotiation behaviour, based on so-called 'association
410 negotiation profiles' which may be read from a configuration file. The
411 format and semantics of this configuration file are documented in
412 asconfig.txt.
413
415 The level of logging output of the various command line tools and
416 underlying libraries can be specified by the user. By default, only
417 errors and warnings are written to the standard error stream. Using
418 option --verbose also informational messages like processing details
419 are reported. Option --debug can be used to get more details on the
420 internal activity, e.g. for debugging purposes. Other logging levels
421 can be selected using option --log-level. In --quiet mode only fatal
422 errors are reported. In such very severe error events, the application
423 will usually terminate. For more details on the different logging
424 levels, see documentation of module 'oflog'.
425 In case the logging output should be written to file (optionally with
427 logfile rotation), to syslog (Unix) or the event log (Windows) option
428 --log-config can be used. This configuration file also allows for
429 directing only certain messages to a particular output stream and for
430 filtering certain messages based on the module or application where
431 they are generated. An example configuration file is provided in
432 <etcdir>/logger.cfg).
433
435 All command line tools use the following notation for parameters:
436 square brackets enclose optional values (0-1), three trailing dots
437 indicate that multiple values are allowed (1-n), a combination of both
438 means 0 to n values.
439 Command line options are distinguished from parameters by a leading '+'
441 or '-' sign, respectively. Usually, order and position of command line
442 options are arbitrary (i.e. they can appear anywhere). However, if
443 options are mutually exclusive the rightmost appearance is used. This
444 behaviour conforms to the standard evaluation rules of common Unix
445 shells.
446 In addition, one or more command files can be specified using an '@'
448 sign as a prefix to the filename (e.g. @command.txt). Such a command
449 argument is replaced by the content of the corresponding text file
450 (multiple whitespaces are treated as a single separator unless they
451 appear between two quotation marks) prior to any further evaluation.
452 Please note that a command file cannot contain another command file.
453 This simple but effective approach allows to summarize common
454 combinations of options/parameters and avoids longish and confusing
455 command lines (an example is provided in file <datadir>/dumppat.txt).
456
458 The storescu utility will attempt to load DICOM data dictionaries
459 specified in the DCMDICTPATH environment variable. By default, i.e. if
460 the DCMDICTPATH environment variable is not set, the file
461 <datadir>/dicom.dic will be loaded unless the dictionary is built into
462 the application (default for Windows).
463 The default behaviour should be preferred and the DCMDICTPATH
465 environment variable only used when alternative data dictionaries are
466 required. The DCMDICTPATH environment variable has the same format as
467 the Unix shell PATH variable in that a colon (':') separates entries.
468 On Windows systems, a semicolon (';') is used as a separator. The data
469 dictionary code will attempt to load each file specified in the
470 DCMDICTPATH environment variable. It is an error if no data dictionary
471 can be loaded.
472
474 <docdir>/asconfig.txt - configuration file documentation
475 <etcdir>/storescu.cfg - example association negotiation profile
476
478 storescp(1)
479
481 Copyright (C) 1996-2010 by OFFIS e.V., Escherweg 2, 26121 Oldenburg,
482 Germany.
483Version 3.6.0 6 Jan 2011 storescu(1)