echoscu¶
echoscu [options] peer port
Description¶
The echoscu
application implements a Service Class User (SCU) for the
Verification SOP Class (UID 1.2.840.10008.1.1) [1]. It establishes an Association
with a peer Application Entity (AE) which it then sends a DICOM C-ECHO-RQ
message [2] and waits for a response. The application can be used to verify
basic DICOM connectivity.
The following simple example shows what happens when it is succesfully run on an SCP that supports the Verification SOP Class:
user@host: echoscu 127.0.0.1 11112
user@host:
When attempting to send a C-ECHO to an SCP that doesn’t support the Verification SOP Class:
user@host: echoscu 127.0.0.1 11112
E: No Acceptable Presentation Contexts
user@host:
When attempting to associate with a non-DICOM peer
user@host: echoscu 127.0.0.1 11112
E: Association Request Failed: Failed to establish association
E: Peer aborted Association (or never connected)
E: TCP Initialisation Error: Connection refused
user@host:
Options¶
Logging¶
-q --quiet
- quiet mode, prints no warnings or errors
-v --verbose
- verbose mode, prints processing details
-d --debug
- debug mode, prints debugging information
-ll --log-level [l]evel (str)
- One of [‘critical’, ‘error’, ‘warning’, ‘info’, ‘debug’], prints logging messages with corresponding level or higher
-lc --log-config [f]ilename (str)
- use python logging config [3] file f for the logger
Application Entity Titles¶
-aet --calling-aet [a]etitle (str)
- set the local AE title (default: ECHOSCU)
-aec --called-aet [a]etitle (str)
- set the called AE title for the peer AE (default: ANY-SCP)
Association Negotiation Debugging¶
-pts --propose-ts [n]umber (int)
- propose n transfer syntaxes (1-3)
Miscellaneous DICOM¶
-to --timeout [s]econds (int)
- timeout for connection requests (default: unlimited)
-ta --acse-timeout [s]econds (int)
- timeout for ACSE messages (default: 30)
-td --dimse-timeout [s]econds (int)
- timeout for DIMSE messages (default: unlimited)
-pdu --max-pdu [n]umber of bytes (int)
- set maximum receive PDU bytes to n bytes (default: 16384)
--repeat [n]umber (int)
- repeat echo n times
--abort
- abort association instead of releasing it
DICOM Conformance¶
The echoscu application supports the following SOP Class as an SCU:
UID | SOP Class |
---|---|
1.2.840.10008.1.1 | Verification SOP Class |
Unless the --propose-ts
option is used, the echoscu application will only
propose the Little Endian Implicit VR Transfer Syntax (UID 1.2.840.10008.1.2).
The supported Transfer Syntaxes [4] are:
UID | Transfer Syntax |
---|---|
1.2.840.10008.1.2 | Little Endian Implicit VR |
1.2.840.10008.1.2.1 | Little Endian Explicit VR |
1.2.840.10008.1.2.2 | Big Endian Explicit VR |
Footnotes
[1] | DICOM Standard, Part 6, Table A-1 |
[2] | DICOM Standard, Part 7, Sections 9.1.5 and 9.3.5 |
[3] | The Python documentation |
[4] | DICOM Standard, Part 5, Section 10 and Annex A |