echoscp

echoscp [options] port

Description

The echoscp application implements a Service Class Provider (SCP) for the Verification SOP Class (UID 1.2.840.10008.1.1) [1]. It establishes an Association with peer Application Entities (AEs) and listens for DICOM C-ECHO-RQ [2] messages to which it responds with a DICOM C-ECHO-RSP message. The application can be used to verify basic DICOM connectivity.

The following example shows what happens when it is started and receives a C-ECHO request from a peer:

user@host: echoscp 11112

More information is available when a connection is received while running with the -v option:

user@host: echoscp 11112 -v
I: Association Received
I: Association Accepted
I: Received Echo Request (MsgID 1)
I: Association Released

When a peer AE attempts to send non C-ECHO message:

user@host: echoscu 192.168.2.1 11112 -v
I: Association Received
I: Association Accepted
I: Aborting Association

Much more information is available when a connection is received while running with the -d option:

user@host: echoscp 11112 -d
D: $echosco.py v0.4.1
D:
I: Association Received
D: Request Parameters:
D: ====================== BEGIN A-ASSOCIATE-RQ =============================
D: Their Implementation Class UID: 1.2.826.0.1.3680043.9.381.0.9.0
...
I: Received Echo Request (MsgID 1)
...
I: Association Released

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 l or higher
-lc   --log-config [f]ilename (str)
use python logging config [3] file f for the logger

Application Entity Titles

-aet  --aetitle [a]etitle (str)
set my AE title (default: ECHOSCP)

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]econdsr (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)

Preferred Transfer Syntaxes

-x=   --prefer-uncompr
prefer explicit VR local byte order (default)
-xe   --prefer-little
prefer explicit VR little endian transfer syntax
-xb   --prefer-big
prefer explicit VR big endian transfer syntax
-xi   --implicit
accept implicit VR little endian transfer syntax only

DICOM Conformance

The echoscp application supports the following SOP Class as an SCP:

UID SOP Class
1.2.840.10008.1.1 Verification SOP Class

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