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