DCMTK Version 3.7.0 OFFIS DICOM Toolkit

dcmnet: a networking library and utility apps

This module contains a collection of functions that implement DICOM network communication, i.e. the DICOM Upper Layer Finite State Machine, the Association Control Service Element (ACSE) and the DICOM Message Service Element (DIMSE).

The main interfaces are the structs and functions declared in file assoc.h and dimse.h.

There are also two experimental classes for implementing a DICOM Service Class User and Provider:

- DcmSCU
- DcmSCP

The following classes are derived from the above experimental classes and provide a particular DICOM Service:

- DcmStorageSCU
- DcmStorageSCP

# Tools

This module contains the following command line tools:

- dcmrecv: Simple DICOM storage SCP (receiver)
- dcmsend: Simple DICOM storage SCU (sender)
- echoscu: DICOM verification (C-ECHO) SCU
- findscu: DICOM query (C-FIND) SCU
- getscu: DICOM retrieve (C-GET) SCU
- movescu: DICOM retrieve (C-MOVE) SCU
- storescp: DICOM storage (C-STORE) SCP
- storescu: DICOM storage (C-STORE) SCU
- termscu: DICOM termination SCU

# Files

The following files provide further documentation:

- asconfig.txt file
- testing.txt file

# Examples

The following example shows a very simple Echo SCU (Verification Service Class SCU). Most error handling code has been omitted for brevity, also OS specific code such as WinSock initialization on Win32 is not shown.

T_ASC_Network *net; // network struct, contains DICOM upper layer FSM etc.
ASC_initializeNetwork(NET_REQUESTOR, 0, 1000 /* timeout */, &net);
T_ASC_Parameters *params; // parameters of association request
ASC_createAssociationParameters(&params, ASC_DEFAULTMAXPDU);
// set calling and called AE titles
ASC_setAPTitles(params, "ECHOSCU", "ANY-SCP", NULL);
// the DICOM server accepts connections at server.nowhere.com port 104
ASC_setPresentationAddresses(params, "localhost", "server.nowhere.com:104");
// list of transfer syntaxes, only a single entry here
const char* ts[] = { UID_LittleEndianImplicitTransferSyntax };
// add presentation context to association request
ASC_addPresentationContext(params, 1, UID_VerificationSOPClass, ts, 1);
// request DICOM association
T_ASC_Association *assoc;
if (ASC_requestAssociation(net, params, &assoc).good())
{
if (ASC_countAcceptedPresentationContexts(params) == 1)
{
// the remote SCP has accepted the Verification Service Class
DIC_US id = assoc->nextMsgID++; // generate next message ID
DIC_US status; // DIMSE status of C-ECHO-RSP will be stored here
DcmDataset *sd = NULL; // status detail will be stored here
// send C-ECHO-RQ and handle response
DIMSE_echoUser(assoc, id, DIMSE_BLOCKING, 0, &status, &sd);
delete sd; // we don't care about status detail
}
}
ASC_releaseAssociation(assoc); // release association
ASC_destroyAssociation(&assoc); // delete assoc structure
ASC_dropNetwork(&net); // delete net structure
DcmDataset
a class handling the DICOM dataset format (files without meta header)
Definition: dcdatset.h:42
UID_LittleEndianImplicitTransferSyntax
#define UID_LittleEndianImplicitTransferSyntax
Implicit VR Little Endian: Default Transfer Syntax for DICOM.
Definition: dcuid.h:430
T_ASC_Association
Definition: assoc.h:252
T_ASC_Network
Definition: assoc.h:132
T_ASC_Parameters
Definition: assoc.h:230

Generated on Mon Dec 15 2025 for DCMTK Version 3.7.0 by Doxygen 1.9.1