NAME storescu SYNOPSIS storescu [options] peer port dcmfile_in... SUMMARY The storescu application implements an SCU for the Storage Service Class. For each image file command line parameter it sends a C-STORE message to a Storage SCP and waits for a response. The application can be used to transmit DICOM images. USAGE storescu: DICOM storage (C-STORE) SCU usage: storescu [options] peer port dcmfile_in... parameters: peer hostname of DICOM peer port tcp/ip port number of peer dcmfile_in DICOM file(s) to be transmitted general options: -h --help print this help text and exit --version print version information and exit -v --verbose verbose mode, print processing details +v --verbose-pc verbose mode and show presentation contexts -d --debug debug mode, print debug information network options: application entity titles: -aet --aetitle aetitle: string set my calling AE title (default: STORESCU) -aec --call aetitle: string set called AE title of peer (default: ANY-SCP) proposed transmission transfer syntaxes: -x= --propose-uncompr propose all uncompressed TS, explicit VR with local byte ordering first (default) -xe --propose-little propose all uncompressed TS, explicit VR little endian first -xb --propose-big propose all uncompressed TS, explicit VR big endian first -xi --propose-implicit propose implicit VR little endian TS only -xs --propose-lossless propose default JPEG lossless TS and all uncompressed transfer syntaxes -xy --propose-jpeg8 propose default JPEG lossy TS for 8 bit data and all uncompressed transfer syntaxes -xx --propose-jpeg12 propose default JPEG lossy TS for 12 bit data and all uncompressed transfer syntaxes -xr --propose-rle propose RLE lossless TS and all uncompressed transfer syntaxes -xd --propose-deflated propose deflated expl. VR little endian TS and all uncompressed transfer syntaxes -R --required propose only required presentation contexts (default: propose all supported) +C --combine combine proposed transfer syntaxes (default: separate pres. context for each TS) post-1993 value representations: +u --enable-new-vr enable support for new VRs (UN/UT) (default) -u --disable-new-vr disable support for new VRs, convert to OB deflate compression level (only with --propose-deflated): +cl --compression-level compression level: 0-9 (default 6) 0=uncompressed, 1=fastest, 9=best compression other network options: -to --timeout [s]econds: integer (default: unlimited) timeout for connection requests -pdu --max-pdu [n]umber of bytes: integer [4096..131072] set max receive pdu to n bytes (default: 16384) --max-send-pdu [n]umber of bytes: integer [4096..131072] restrict max send pdu to n bytes --repeat [n]umber: integer repeat n times --abort abort association instead of releasing it --no-halt do not halt if unsuccessful store encountered (default: do halt) -up --uid-padding silently correct space-padded UIDs +II --invent-instance invent a new SOP instance UID for every image sent +IR --invent-series [n]umber: integer (implies --invent-instance) invent a new series UID after n images have been sent (default: 100) +IS --invent-study [n]umber: integer (implies --invent-instance) invent a new study UID after n series have been sent (default: 50) +IP --invent-patient [n]umber: integer (implies --invent-instance) invent a new patient ID and name after n studies have been sent (default: 25) transport layer security (TLS) options: transport protocol stack options: -tls --disable-tls use normal TCP/IP connection (default) +tls --enable-tls [p]rivate key file, [c]ertificate file: string use authenticated secure TLS connection +tla --anonymous-tls use secure TLS connection without certificate private key password options (only with --enable-tls): +ps --std-passwd prompt user to type password on stdin (default) +pw --use-passwd [p]assword: string use specified password -pw --null-passwd use empty string as password key and certificate file format options: -pem --pem-keys read keys and certificates as PEM file (default) -der --der-keys read keys and certificates as DER file certification authority options: +cf --add-cert-file [c]ertificate filename: string add certificate file to list of certificates +cd --add-cert-dir [c]ertificate directory: string add certificates in d to list of certificates ciphersuite options: +cs --cipher [c]iphersuite name: string add ciphersuite to list of negotiated suites +dp --dhparam [f]ilename: string read DH parameters for DH/DSS ciphersuites pseudo random generator options: +rs --seed [f]ilename: string seed random generator with contents of f +ws --write-seed write back modified seed (only with --seed) +wf --write-seed-file [f]ilename: string (only with --seed) write modified seed to file f peer authentication options: -rc --require-peer-cert verify peer certificate, fail if absent (default) -vc --verify-peer-cert verify peer certificate if present -ic --ignore-peer-cert don't verify peer certificate DICOM CONFORMANCE The storescu application supports the following Storage SOP Classes as an SCU: StoredPrintStorage "1.2.840.10008.5.1.1.27" HardcopyGrayscaleImageStorage "1.2.840.10008.5.1.1.29" HardcopyColorImageStorage "1.2.840.10008.5.1.1.30" ComputedRadiographyImageStorage "1.2.840.10008.5.1.4.1.1.1" DigitalXRayImageStorageForPresentation "1.2.840.10008.5.1.4.1.1.1.1" DigitalXRayImageStorageForProcessing "1.2.840.10008.5.1.4.1.1.1.1.1" DigitalMammographyXRayImageStorageForPresentation "1.2.840.10008.5.1.4.1.1.1.2" DigitalMammographyXRayImageStorageForProcessing "1.2.840.10008.5.1.4.1.1.1.2.1" DigitalIntraOralXRayImageStorageForPresentation "1.2.840.10008.5.1.4.1.1.1.3" DigitalIntraOralXRayImageStorageForProcessing "1.2.840.10008.5.1.4.1.1.1.3.1" CTImageStorage "1.2.840.10008.5.1.4.1.1.2" RETIRED_UltrasoundMultiframeImageStorage "1.2.840.10008.5.1.4.1.1.3" UltrasoundMultiframeImageStorage "1.2.840.10008.5.1.4.1.1.3.1" MRImageStorage "1.2.840.10008.5.1.4.1.1.4" EnhancedMRImageStorage "1.2.840.10008.5.1.4.1.1.4.1" MRSpectroscopyStorage "1.2.840.10008.5.1.4.1.1.4.2" RETIRED_NuclearMedicineImageStorage "1.2.840.10008.5.1.4.1.1.5" RETIRED_UltrasoundImageStorage "1.2.840.10008.5.1.4.1.1.6" UltrasoundImageStorage "1.2.840.10008.5.1.4.1.1.6.1" SecondaryCaptureImageStorage "1.2.840.10008.5.1.4.1.1.7" MultiframeSingleBitSecondaryCaptureImageStorage "1.2.840.10008.5.1.4.1.1.7.1" MultiframeGrayscaleByteSecondaryCaptureImageStorage "1.2.840.10008.5.1.4.1.1.7.2" MultiframeGrayscaleWordSecondaryCaptureImageStorage "1.2.840.10008.5.1.4.1.1.7.3" MultiframeTrueColorSecondaryCaptureImageStorage "1.2.840.10008.5.1.4.1.1.7.4" StandaloneOverlayStorage "1.2.840.10008.5.1.4.1.1.8" StandaloneCurveStorage "1.2.840.10008.5.1.4.1.1.9" TwelveLeadECGWaveformStorage "1.2.840.10008.5.1.4.1.1.9.1.1" GeneralECGWaveformStorage "1.2.840.10008.5.1.4.1.1.9.1.2" AmbulatoryECGWaveformStorage "1.2.840.10008.5.1.4.1.1.9.1.3" HemodynamicWaveformStorage "1.2.840.10008.5.1.4.1.1.9.2.1" CardiacElectrophysiologyWaveformStorage "1.2.840.10008.5.1.4.1.1.9.3.1" BasicVoiceAudioWaveformStorage "1.2.840.10008.5.1.4.1.1.9.4.1" StandaloneModalityLUTStorage "1.2.840.10008.5.1.4.1.1.10" StandaloneVOILUTStorage "1.2.840.10008.5.1.4.1.1.11" GrayscaleSoftcopyPresentationStateStorage "1.2.840.10008.5.1.4.1.1.11.1" XRayAngiographicImageStorage "1.2.840.10008.5.1.4.1.1.12.1" XRayFluoroscopyImageStorage "1.2.840.10008.5.1.4.1.1.12.2" RETIRED_XRayAngiographicBiPlaneImageStorage "1.2.840.10008.5.1.4.1.1.12.3" NuclearMedicineImageStorage "1.2.840.10008.5.1.4.1.1.20" RawDataStorage "1.2.840.10008.5.1.4.1.1.66" VLEndoscopicImageStorage "1.2.840.10008.5.1.4.1.1.77.1.1" VLMicroscopicImageStorage "1.2.840.10008.5.1.4.1.1.77.1.2" VLSlideCoordinatesMicroscopicImageStorage "1.2.840.10008.5.1.4.1.1.77.1.3" VLPhotographicImageStorage "1.2.840.10008.5.1.4.1.1.77.1.4" BasicTextSR "1.2.840.10008.5.1.4.1.1.88.11" EnhancedSR "1.2.840.10008.5.1.4.1.1.88.22" ComprehensiveSR "1.2.840.10008.5.1.4.1.1.88.33" MammographyCADSR "1.2.840.10008.5.1.4.1.1.88.50" KeyObjectSelectionDocument "1.2.840.10008.5.1.4.1.1.88.59" PETImageStorage "1.2.840.10008.5.1.4.1.1.128" PETCurveStorage "1.2.840.10008.5.1.4.1.1.129" RTImageStorage "1.2.840.10008.5.1.4.1.1.481.1" RTDoseStorage "1.2.840.10008.5.1.4.1.1.481.2" RTStructureSetStorage "1.2.840.10008.5.1.4.1.1.481.3" RTBeamsTreatmentRecordStorage "1.2.840.10008.5.1.4.1.1.481.4" RTPlanStorage "1.2.840.10008.5.1.4.1.1.481.5" RTBrachyTreatmentRecordStorage "1.2.840.10008.5.1.4.1.1.481.6" RTTreatmentSummaryRecordStorage "1.2.840.10008.5.1.4.1.1.481.7" The default behaviour of storescu is to propose two presentation contexts for each supported SOP class (abstract syntax) - one with the preferred transfer syntax and one with all other uncompressed transfer syntaxes. The default preferred transfer syntax is explicit VR with byte ordering corresponding to the local byte ordering of the machine on which storescu is running. This behaviour can be changed with the --propose, --combine and --required options, see above. The storescu application does not support extended negotiation. ENVIRONMENT The storescu application will attempt to load DICOM data dictionaries specified in the DCMDICTPATH environment variable. By default, if the DCMDICTPATH environment variable is not set, the file /usr/local/dicom/lib/dicom.dic will be loaded. The default behaviour should be preferred and the DCMDICTPATH environment variable only used when alternative data dictionaries are required. The DCMDICTPATH environment variable has the same format as the shell PATH variable in that a colon (":") separates entries. The data dictionary code will attempt to load each file specified in the DCMDICTPATH environment variable. It is an error if no data dictionary can be loaded.