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