18.12.2012 Views

Configuration - Merge Healthcare

Configuration - Merge Healthcare

Configuration - Merge Healthcare

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

<strong>Merge</strong> DICOM Toolkit Reference Manual<br />

Remarks<br />

MC_Send_Response_Message allows the caller to respond to a message<br />

received from the remote application. MC_Send_Response_Message is called<br />

after receiving a request message using MC_Read_Message.<br />

ResponseStatus must be set to a valid response code for the service involved.<br />

Response codes for standard DICOM services are defined in the “mergecom.h”<br />

file.<br />

ResponseMessageID must be set to an identifier returned by<br />

MC_Open_Message. Many DICOM services do not require a response of more<br />

than just a status. Others, however, (e.g. C_FIND_RSP) require the setting of<br />

several message attributes.<br />

Note: Some DICOM services require that values for certain “command level”<br />

message attributes (i.e. group 0 attributes) be set. (<strong>Merge</strong> DICOM<br />

Toolkit automatically adds command level attributes to the message<br />

when MC_Open_Message is called. With the exceptions listed below,<br />

the caller must set any command level attribute values before sending<br />

the message. MC_Send_Response_Message does, however, set the<br />

following attribute values for you - if you have not set them:<br />

• The group length attribute (0000,0000) value is always set by <strong>Merge</strong><br />

DICOM Toolkit.<br />

• If the message command requires it, the Affected SOP Class UID<br />

attribute (0000,0002) value is set to the service’s abstract syntax UID.<br />

• The command attribute (0000,0100) value is always set by <strong>Merge</strong><br />

DICOM Toolkit.<br />

• The Response Message ID attribute (0000,0120) value is set to the<br />

Message ID value of the last received Request message.<br />

• The Data Set Type attribute (0000,0800) value is always set by <strong>Merge</strong><br />

DICOM Toolkit.<br />

If MC_Send_Response_Message returns MC_ASSOCIATION_ABORTED, no<br />

further calls may be made for that association.<br />

Return Value<br />

One of the enumerated MC_STATUS codes defined in “mcstatus.h”:<br />

Value Meaning<br />

MC_NORMAL_COMPLETION The function completed normally.<br />

MC_INVALID_ASSOC_ID AssociationID is not a valid association<br />

object ID.<br />

MC_INVALID_MESSAGE_ID The MessageID value is not a valid<br />

message object ID.<br />

229

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!