echoscu¶

$ python -m pynetdicom echoscu [options] addr port

Description¶

The echoscu application implements a Service Class User (SCU) for the Verification service class. It establishes an association with a peer Application Entity (AE), sends a C-ECHO request and waits for a response. The application can be used to verify basic DICOM connectivity.

The source code for the application can be found here

Usage¶

The following example shows what happens when it’s succesfully run on an SCP at IP 127.0.0.1 and listen port 11112 that supports the Verification service:

$ python -m pynetdicom echoscu 127.0.0.1 11112

When attempting to send a C-ECHO request to an SCP that doesn’t support the Verification service:

$ python -m pynetdicom echoscu 127.0.0.1 11112
E: No accepted presentation contexts

When the association request is rejected by the SCP (in this case because the called AE title wasn’t recognised):

$ python -m pynetdicom echoscu 127.0.0.1 11112
E: Association Rejected
E: Result: Rejected Permanent, Source: Service User
E: Reason: Called AE title not recognised

When attempting to associate with a non-DICOM peer:

$ python -m pynetdicom echoscu 127.0.0.1 11112
E: Association request failed: unable to connect to remote
E: TCP Initialisation Error: Connection refused

More information is available with the -d flag:

$ python -m pynetdicom echoscu 127.0.0.1 11112 -d
D: echoscu.py v0.7.0
D:
I: Requesting Association
D: Request Parameters:
D: ======================= OUTGOING A-ASSOCIATE-RQ PDU ========================
...
D: ========================== END A-ASSOCIATE-AC PDU ==========================
I: Association Accepted
I: Sending Echo Request: MsgID 1
D: pydicom.read_dataset() TransferSyntax="Little Endian Implicit"
I: Received Echo Response (Status: Success)
I: Releasing Association

Parameters¶

addr: TCP/IP address or hostname of DICOM peer
port: TCP/IP port number of peer

Options¶

General Options¶

-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 lower

Network Options¶

-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)
-ta --acse-timeout [s]econds (float): timeout for ACSE messages (default: 30)
-td --dimse-timeout [s]econds (float): timeout for DIMSE messages (default: 30)
-tn --network-timeout [s]econds (float): timeout for the network (default: 30)
-pdu --max-pdu [n]umber of bytes (int): set maximum receive PDU bytes to n bytes (default: 16382)

Transfer Syntax Options¶

-xe --request-little: request explicit VR little endian TS only
-xb --request-big: request explicit VR big endian TS only
-xi --request-implicit: request implicit VR little endian TS only

Miscellaneous Options¶

--repeat [n]umber (int): repeat echo request n times
--abort: abort association instead of releasing it

DICOM Conformance¶

The echoscu application supports the Verification service as an SCU. The following SOP classes are supported:

Verification Service¶

SOP Classes¶

UID	SOP Class
1.2.840.10008.1.1	Verification SOP Class

Transfer Syntaxes¶

UID	Transfer Syntax
1.2.840.10008.1.2	Implicit VR Little Endian
1.2.840.10008.1.2.1	Explicit VR Little Endian
1.2.840.10008.1.2.1.99	Deflated Explicit VR Little Endian
1.2.840.10008.1.2.2	Explicit VR Big Endian