DICOM retrieve (C-MOVE, SCU), BETA

DICOM retrieve is added and released for testing purposes. For now, retrieval is only possible via the command line.

The retrieve tool allows you to connect to your DICOM server if it supports retrieve as a service class provider (C-MOVE, SCU). You will need the IP address or DNS of your server, the port number and a study UID at least to start retrieving. Query is not available yet.

Retrieving window

Command line options

• -host
  Host name, mandatory. Specify IP address or DNS of the DICOM server. F.e. "-host 192.168.1.12" or "-host dicomserver.univ.com"
  
• -port
  TCP/IP Port number, mandatory. Enter the port number on which the DICOM server is listening. F.e. "-port 104"
  
• -stuid
  Study UID, mandatory. The unique ID of the study you're retrieving from. F.e. "-stuid 1.2.450.200102.34.2.5.20100107.164255".
  To retrieve a full study, do not set the series UID.
  
• -seuid
  Series UID, optional. The unique ID of the series to retrieve. F.e. "-seuid 1.2.450.200102.34.2.5.20100107.164255.554"
  Study UID is required.
• -lae
  Local AE, optional. Local (your) Application Entity title. May not exceed 16 characters. F.e. "-lae RUBOVIEWER"
  
• -rae
  Remote AE, optional. Remote (DICOM servers') Application Entity title. May not exceed 16 characters. F.e. "-rae DICOMSERVER"
  
• -log
  Logging settings, optional. '0' - default logging. '1' - log incoming HEX data. '2' - log outgoing HEX data. '3' - log incoming and outgoing HEX data. F.e. "-log 1"
  
• -mhx
  HEX data logging limit, optional. Set the maximum number of bytes to be logged with each HEX dump in log file. Default value is 256. Increasing this number may lead to huge log files. F.e. "-mhx 1024"
  

Command line examples

• "dicomviewer.exe -host 192.168.1.43 -port 104 -stuid 1.2.450.200102.34.2.5.20100107.164255"
  Retrieve a full study from host 192.168.1.43 via port 104.


• "dicomviewer.exe -host dicomserver.univ.com -port 11112 -stuid 1.2.35651.102.164255 -seuid 1.2.35651.102.164255.4"
  Retrieve a series from host dicomserver.univ.com via port 11112.


• "dicomviewer.exe -host 192.168.1.100 -port 104 -stuid 1.2.450.200101 -lae RUBOVIEWER -rae DICOMSERVER"
  The local and remote AE's are specified.


• "dicomviewer.exe -host 192.168.2.102 -port 11112 -stuid 1.2.450.200101 -log 3 -mhx 2048"
  Logging is set to log in and out hex data, limited to 2048 bytes.

Retrieved DICOM files

To store the retrieved DICOM files, folder 'QRetrieve' is created in the 'My Documents' folder. If this fails, the temp.folder is used. For each retrieval, a folder with a date- and timestamp is created, in which all files are stored. When the viewer is closed and restarted, the retrieve files will be deleted.



Log files

Log files are stored in the installation folder of the viewer, subfolder 'Log'. Log files older than 24 hours are automatically deleted.



Firewall

When you first use the retrieve tool, click 'Allow access' to unblock the retrieve tool. Other firewalls (f.e. routers) may be blocking communications as well.

Firewall warning

Error reporting, debugging

If the communication with the server fails, we are more than happy to have a look at the log files. When you detect a problem in communications, restart the viewer as you did before and add the commandline options '-log 3 -mhx 4096'. This creates a log file which should hold all relevant communications. Please sent us the log file via email and a description of the problem.