Jdicom Manual v1 0

8VLQJ-',&20
,QWURGXFWLRQ
JDICOM is a summary of DICOM applications which are very useful for troubleshooting. Our best
appreciation to Mr. Gunter Zeilinger which created this great tool.
If you have any questions or problems, do not hesitate to contact us. The e-mail addresses are
[email protected] or [email protected].
The description is valid for the actual version of JDICOM 1.7.5. It was installed on the following operating
systems Win98, WinNT, Win2000, Linux (RedHat 6.1 and Suse 7.0). Required is a java2 runtime
environment for the used hardware architecture.
)XQFWLRQDOLW\RIFRQWDLQHGDSSOLFDWLRQV
ImageServer
Supports Image related DICOM Services Classes:
Receives images over network and stores them on (local) disk
(= SCP of Storage SOP classes + FSC+FSU of Media Storage SOP classes).
Dispatches received query/retrieve requests by transmitting information about stored images or
images themselves to specified destination.
(= SCP of Query/Retrieve SOP classes + FSR of Media Storage SOP classes).
Notifies specified peer application about received images
(= SCU of Study Content Notification SOP class).
Sends requested commitments back about received images.
(=SCU of Storage Commitment SOP class)
StorageSCU
Load images from (local) disk and send them over network.
(= SCU of Storage SOP classes).
Receives commitments back about transmitted images.
(=SCP of Storage Commitment SOP class)
QueryRetrieveSCU
Queries image archives and controls remote retrieve of images to specified destination.
(= SCU of Query/Retrieve SOP classes).
RisServer
Supports RIS related DICOM Services Classes:
Receives worklist requests over the network
(= SCP of Basic Worklist SOP class).
Receives notifications about the (image) content of studies over network
(= SCP of Study Content Notification SOP class).
Receives performed procedure steps about the patient from the network
(= SCU of Performed Procedure Step SOP class).
ModalitySCU
Supports RIS related DICOM Services Classes:
Sends worklist requests over the network
(= SCU of Basic Worklist SOP class).
Receives notifications about the (image) content of studies over network
(= SCP of Study Content Notification SOP class).
Sends performed procedure steps about the patient over the network to the RisServer.
(= SCP of Performed Procedure Step SOP class).
JDICOM manual v1-0.doc 21.09.2001 Seite 1 von 32 Klaus Gartner TDPS 23

PrintServer
Supports Basic Print related DICOM Services Classes:
Receives printable images over network
(= SCP Basic Print SOP class).
3ULQW6&8 (not yet described)
EditDicomObject
Administration tool for DICOM File to:
Display and modify the DICOM files tags.
EditDicomDir
Administration tool for DICOM File-sets to:
Display and modify the DICOMDIR file containing the Media Storage Directory information (=
FSC+FSU of Media Storage SOP classes). Delete images from the File-sets, by deleting the image
files and updating the DICOMDIR file accordingly. Import images into the File-sets, by updating the
DICOMDIR file with Directory information extracted from the new added images.
Validate
Checks DICOM files - containing Composite Information Objects - for its DICOM conformance.
Lists attribute names and values of contained Data Elements.

*HWWLQJVWDUWHG
,QVWDOODWLRQ
The JDicom applications runs on Java Platform 2. So you can either download the JDicom version which
already includes the Java virtual machine from the following location :
http://www.tiani.com/JDicom/install/
Use the link for Windows "Windows including a JVM" and for Linux "Linux including a JVM" in order
to download the corresponding JDicom package.
If the file is successfully downloaded use following the installation instruction

for Windows:
for Linux:
to install JDicom on your PC.

After the successful installation of JDicom you find this menu structure in "START -> PROGRAMS"
The important entries are:
(GLW'LFRP'LU
(GLW'LFRP2EMHFWV
,PDJH6HUYHU
,PDJH6HUYHU*8,
0RGDOLW\6&8
3ULQW6&8
3ULQW6HUYHU
3ULQW6HUYHU*8,
4XHU\5HWLHYH6&8
5LV6HUYHU
5LV6HUYHU*8,
6WRUDJH6&8
9DOLGDWH
The files are installed by using the default settings in the directory: "C:\Program Files\jdicom"
Automatically subfolders are created in the default installation directory. In the subdirectory applet you can
find the available applet version of JDicom. These applets are running in a Web Browser which supports
Java.
4XLFNWRXU
7KHIROORZLQJ',&20VHUYLFHVDUHQRW\HWGHVFULEHGLQWKLVGXFXPHQW
♦ Storage Commitment SCU/SCP

♦ Query/Retrieve SCP
♦ Print SCU

6WRUDJH6&8
With the JDICOM application StorageSCU you can simulate the behaviour of the DICOM service Storage
as Service Class User. An Association can be opened, a DICOM Verification can be made and DICOM
images can be transferred to a remode DICOM destination.
05&RQVROH6WRUDJH6&36\QJREDVHG
-',&206WRUDJH6&8
6WRUDJH6&3
AET: $1B7'6,0
6WRUDJH6&8 C_Store; C_Echo CalledTitle
AET: 6WRUDJHB6&8 Port:
CallingTitle Host (name resolution of the IP address)

File
System
6HQG or File
6HQG System
The DICOM application StorageSCU runs with a graphical user interface (GUI). Select the entry
in the JDicom menu.
Here are the minimum entries which sould be
modified before you can use StorageSCU:
Host:
Enter here the IP address or hostname of the
StorageSCP (DICOM partner for receiving the
image)
If a host name is used, an entry in the hosts file is
required or DNS has to be enabled.
Port:
Portnumber of the StorageSCP (DICOM partner for
receiving the image)
Called Title:
DICOM AET of the StorageSCP (DICOM partner for
receiving the image)
Calling Title:
Own DICOM AET
Transfer Syntax:
This are the possible values:
,PSOLFLW95/LWWOH(QGLDQ
([SOLFLW95/LWWOH(QGLDQ
([SOLFLW95%LJ(QGLDQ
-3(*/RVVOHVV
-3(*%DVHOLQH(lossy for 8 bit images)

If you are using a wrong entry for the TransferSyntax a message is displayed in the log tab when you try to
open the association with "&RQQHFW":
TransferSyntax: java.lang.IllegalArgumentException: not one of

{ImplicitVRLittleEndian,ExplicitVRLittleEndian,ExplicitVRBigEndian,JPEGLossless,JPEGBaseline}
With the following properties it is possible to Verbose:
change the Patient Name and Patient ID during Specifies the log level. The value which can be used starts
the image transfer to the new values: with
Anoymize: IDOVH (no change is done) "" no output in the log tab window
WUXH (change the name and ID) ""
"" decode of DIMSE (DICOM Message Service Element)
Anoymize.NewName: new PatientName "" decode of data elements
Anoymize.NewID : new PatientID
Note: ,I\RXFKDQJHDQHQWU\LQWKH3URSVWDE\RXKDYHWRFRQILUPLWE\SUHVVLQJWKH(17(5!NH\
RQ\RXUNH\ERDUG,I\RXKDYHFKDQJHGDSURSHUW\YDOXH\RXKDYHWR&/26(23(1WKHDVVRFLDWLRQLQ
RUGHUWRDFWLYDWHWKHPDGHFKDQJHV
In this example the DICOM partner for receiving images (StorageSCP) has the parameters:
Hostname:
Portnumber of the StoreSCP process:
AET of the StoreSCP process: $1B7'6,0B
The local (own) DICOM AET of the StorageSCU JDICOM program: 6WRUDJHB6&8
Transfer Syntax: ,PSOLFLW95/LWWOH(QGLDQ
Anoymize: IDOVH
Verbose mode:
Start the Association by clicking the "&RQQHFW" button.
With "(FKR" you start a Verification (C_Echo).
With "6HQG" only one selected image can be transferred.
With "6HQG " multiple images can be transferred.
With "&DQFHO" the started image transfer can be interrupted.
Close the Association by clicking the "5HOHDVH" button.

,PDJH6HUYHU
With the JDICOM application ImageServer you can simulate the behaviour of the DICOM service Storage
as Service Class Provider. DICOM Verification is supported, DICOM images can be received and stored
into a specified directory. The ImageServer simulates also the DICOM services Query/Retieve and Storage
Commitment as Provider.
-',&20,PDJH6HUYHU
6WRUDJH6&3
05&RQVROH6WRUDJH6&3
4XHU\5HWULHYH6&3
6\QJREDVHG
6WRUH456&3
AET: 6WRUDJHB6&3
C_Store; C_Echo 6WRUDJH6&8
AET: $1B7'6,0B
CalledTitles
CallingTitles
Port:
File File
System System
Fileset: WUXH
Fileset.Path:
GGLFRPMGLFRPLPDJH
The DICOM application ImageServer can be run either with a graphical user interface (GUI) or in command
line mode.
To run it with a GUI select in the JDicom menu.
To run it in command line mode select from the JDicom menu (recommended only for
advanced users).

In the ImageServerGUI you find three tab cards.
3URSV tabcard for changing the properties of the
Imageserver
$(7
V tabcard only requiered for using the Retrieve
and Storage Commitment function (destinations entries
for it: AET, IP address and Port)
/RJ tabcard for the log output area
The following entries in the Props tabcard are the

minimum once which should be modified before you
can use the ImageServer:
Port:
Own Portnumber of the ImageServer (for DICOM
services StoreSCP and Q/R SCP)
Called Title:
Own DICOM AET of the ImageServer (for DICOM
services StoreSCP and Q/R SCP)
Calling Title:
If no entry was made here, all AET’s from the
StoreSCU’s and Q/R SCU’s are accepted. If you want
to restrict the access to the Imageserver you can put in
here the allowed AET’s. The AET’s should be
separated by comma.
Verification:
Specifices wether the Imageserver accepts a
Verification DIMSE (C_Echo). Possible values are:
WUXH Verification is supported
IDOVH Verification is not supported
Fileset:
This value should be set to "WUXH", in order to save the
received images in the fileset.path directory. Possible
values are true and false.
Fileset.path:
Exisiting directory for storing the received images. If
this directory doesn’t exist on your PC you will get an
error message after starting your ImagesServer.
Example for the entry : GGLFRP-'LFRPLPDJH
You can also use the ? to separate the subdirectories.
Verbose:
Specifies the log level. The value which can be used
starts with
Fileset.TransferSyntax:
"" no output in the log tab window
Used Transfer Syntax for storing the images to
harddisc. Possible values: ""
$FU1HPD "" decode of DIMSE (DICOM Message Service
,PSOLFLW95/LWWOH(QGLDQ Element)
([SOLFLW95/LWWOH(QGLDQ "" decode of data elements
([SOLFLW95%LJ(QGLDQ
-3(*BB6HOHFWLRQ9DOXH(lossless)

If you are using an wrong entry for the Fileset.TransferSyntax a message is displayed in the log tab when
you try to start the ImageServer with "6WDUW":
java.lang.IllegalArgumentException: Fileset.TransferSyntax:
java.lang.IllegalArgumentException: not one of
{AcrNema,ImplicitVRLittleEndian,ExplicitVRLittleEndian,ExplicitVRBigEndian,
JPEG_14_SelectionValu1}
In this example the following properties are used for the ImageServer:
3URSHUW\ 9DOXH
Portnumber of the ImageServer process: Port
AET of the ImageServer process: CalledTitles 6WRUDJHB6&3
AET’s accepted StoreSCU’s: CallingTitles
Save images on hard disc enabled: Fileset WUXH
Path on the hard disc: Fileset.Path GGLFRP-'LFRPLPDJH
Image store syntax Fileset.TransferSyntax: ,PSOLFLW95/LWWOH(QGLDQ
Mode of the output log: Verbose
RQ\RXUNH\ERDUG,I\RXKDYHFKDQJHGDSURSHUW\YDOXH\RXKDYHWR672367$57WKH-',&20
,PDJH6HUYHULQRUGHUWRDFWLYDWHWKHPDGHFKDQJHV
Save the made changes in the property tab card by pressing the "$SSO\" button. The property values are than
saved in the properties file for the ImageServer (ImageServer.properties).
Start the ImageServer by clicking the "6WDUW" button.
With "6WRS" the ImageServer will be stopped.

5LV6HUYHU
With the JDICOM application RisServer you can simulate the behaviour of the RIS or HIS system. The
JDICOM RisServer supports the DICOM Services Modality Worklist, Modality Performed Procedure Step
and Study Content Notification. The JDICOM RisServer is for all mentioned services Service Class
Provider. The JDICOM RisServer supports DICOM Verification and can be used to generate worklist
entries.
-',&20 5LV6HUYHU
:RUNOLVW6&3 05&RQVROH:RUNOLVW6&8
6\QJREDVHG
:RUNOLVW6&3
AET: :RUNOLVWB6&3
C_Find; C_Echo :RUNOLVW6&8
CalledTitle AET: +5,B7'6,0B
Port: CallingTitle
File File
System System
WL File Patient/Worklist
Repositiory.Path:
GGLFRPMGLFRPULVVHUYHU
Subdirectories created:
0RGDOLW\336
0RGDOLW\:RUNOLVW (WL File directory)
6WXG\&RQWHQW1RWLILFDWLRQ
The DICOM application RisServer can be run either with a graphical user interface (GUI) or in command
line mode.
advanced users).

In the RisServerGUI you find three tab cards.
3URSV tabcard for for changing the properties of
the RisServer
5HVXOW tabcard for creating/listing worklist
entries
The following entries in the Props tabcard are the

minimum once which should be modified before
you can use the ImageServer:
Port:
Own Portnumber of the RisServer (for DICOM
Basic Worklist SCP )
Called Title:
Own DICOM AET of the RisServer (for DICOM
Basic Worklist SCP)
Calling Title:
If no entry was made here, all AET’s from the Basic
Worklist SCU’s are accepted. If you want to restrict
the access to the Imageserver you can put in here
the allowed AET’s. The AET’s should be separated
by comma.
Verification:
Specifices wether the Risserver accepts a
Verification DIMSE (C_Echo). Possible values are:
WUXH Verification is supported
ModalityWorklist: IDOVH Verification is not supported
Specifices whether the Risserver acts as a Basic
Worklist SCP. Possible values are: Repository.path:
WUXH Basic Worklist support is enabled. Exisiting directory for storing the created WL entries. If this
IDOVH Basic Worklist support is disenabled directory doesn’ exists on your PC you will get an error
ModalityPPS: message after starting your RisServer. Example for the
Specifices whether the Risserver acts as a Modality entry : GGLFRPMGLFRPULVVHUYHU
Performed Procedure Step SCP. Possible values are: You can also use the ? to separate the subdirectories.
WUXH ModalityPPS support is enabled.
IDOVH ModalityPPS support is disenabled Verbose:
StudyContentNotification: Specifies the log level. The value which can be used starts
Specifices whether the Risserver acts as a Study with
Content Notification SCP. Possible values are: "" no output in the log tab window
WUXH Study Content Notification support is ""
enabled. "" decode of DIMSE (DICOM Message Service Element)
IDOVH Study Content Notification support is "" decode of data elements
disenabled
Save the made changes in the property tab card by pressing the "6DYH" button. The property values are than
saved in the properties file for the RisServer (RisServer.properties). You have to do it once after the
installation because this file doesn’t exist directly after the installation. You can choose a different name for
the RisServer.properties file. With "ORDG" you can load a different named RisServer.properties file which
you have created before.

In this example the following properties are used for the RisServer:
3URSHUW\ 9DOXH
Portnumber of the RisServer process: Port
AET of the RisServer process: CalledTitles :RUNOLVWB6&3
AET’s accepted Worklist SCU’s: CallingTitles
Path on the hard disc: Repository.Path GGLFRPMGLFRPZRUNOLVW
5LV6HUYHULQRUGHUWRDFWLYDWHWKHPDGHFKDQJHV
Start the RisServer by clicking the "6WDUW" button.
With "6WRS" the RisServer will be stopped.
&UHDWLRQRIDQHZ:RUNOLVWHQWU\
♦ Select the "5HVXOWtab card in the RisServerGUI
Double click the folder icon Repository and the

tree with the following entries is expanded (see
image on the right side):
0RGDOLW\:RUNOLVW
Select entry for generation of Basic Worklist data
sets.
0RGDOLW\336
Select entry for displaying received Modality
Perfored Procedure Steps data sets.
Select entry for generation of Study Content
Notification data sets.
In order to generate an Basic Worklist data set entry select "ModalityWorklist" in the Repository tree and
press the button. With the button an data set entry can be deleted.
The button you can refresh the Repository tree.

Automatically a worklist entry is
generated and saved. It has default
values for each DICOM tag which
are generated.
The values can be modified under
the RisServerGUI platform. For
adding additional WL tag’s, select
the appropriate Worklist entry in the
Repository/ModalityWorklist tree
and click on the button.

Modify the values of the
corresponding tag’s and save the
made modifications by clicking on
the button.
Important worklist tags which should match for the worklist request from the modality (WL SCU):
Modality: ScheduledProcedureStepStartDate:
Insert here your modality abbreviation (e.g. MR, CT, Default date when the WL entry is generated. Change
AX, US, OT, ...) [in this example: 05] it when the WL entry is not generated today to the date
of today.
ScheduledStationAETitle:
Insert here the AET for which the worklist entry is.
Only for this AET it is possible to get this specific
worklist entry. Is this tag empty all Worklist SCU’s
from the same modality can retrieve this Worklist
entry. [in this example: +5,B7'6,0B]
Note: ,I\RXFKDQJHDWDJYDOXH\RXKDYHWRFRQILUPLWE\SUHVVLQJWKH(17(5!NH\RQ\RXU
NH\ERDUG
To check if your made changes are OK, select the folder ModalityWorklist and then again the WL
entry. Now the modified WL file should be loaded into the RisServerGUI.
Start the RisServer by clicking the "6WDUW" button if not already done. Check in the log tab card whether the
RisServer is successfully started or not.
The messages " Waiting for invocations from clients... " indicates an successful start of
the RisServer.
If you get the following message "java.io.IOException: d:\dicom\jdicom\risserver224

is not a writeable directory!" the RisServer is not started. Check the entry for the
5HSRVLWRU\3DWK whether this directory exists on your hard disc.

0RGDOLW\6&8:/6&8
With the JDICOM application ModalitySCU you can simulate the behaviour of the DICOM services
Modality Worklist and Modality Performed Procedure Step, both as Service Class User. An Association can
be opened, a DICOM Verification can be made and Worklist information can be retrieved. From the
retrieved Worklist a performed procedure step can be created and transferred to the RisSystem. In this case
the RisSystem must support MPPS.
-',&20 5LV6HUYHU
:RUNOLVW 0RGDOLG\336 6&3
-',&20 :RUNOLVW6&8
:RUNOLVW03366&3
AET: :RUNOLVW B6&3
:RUNOLVW6&8 C_Find; C_Echo
CalledTitle
AET: :RUNOLVW B6&8
CallingTitle N_Create ; N_Set Port:
Host (name resolution of the IP address)

File File
System System
Patient File System:
MPPS
Worklist WL File
MPPS File
C_Echo: (FKR
C_Find: 4XHU\:/ 3URSHUWLHVWDEFDUG
N_Create: &UHDWH336 Verification : WUXH
N_Set: 8SGDWH336 ModalityWorklist : WUXH
ModalityPPS : WUXH
Repositiory .Path:
GGLFRP MGLFRP ULVVHUYHU
Subdirectories created :
0RGDOLW\336 (MPPS File directory )
0RGDOLW\:RUNOLVW (WL File directory )
The DICOM application ModalitySCU runs with a graphical user interface (GUI). Select the entry
in the JDicom menu.

Here are the minimum entries which should
be modified in the Property tabcard before
you can use ModalitySCU:
Host:
Enter here the IP address or hostname of the
RisServer (Worklist SCP)
Port:
Portnumber of the Worklist SCP
Called Title:
DICOM AET of the Worklist SCP
(RisServer or HisServer)
Calling Title:
Own DICOM AET
Verbose:
Specifies the log level. The value which can
be used starts with
""
"" decode of DIMSE (DICOM Message
Service Element)
"" decode of data elements
There are three more tabcards available:

)LOWHU tabcard for setting the requested WL tags
5HVXOW tabcard shows the received worklist entries
/RJ tabcard shows the log of the DICOM session
RQ\RXUNH\ERDUG,I\RXKDYHFKDQJHGDSURSHUW\YDOXH\RXKDYHWR&/26(23(1WKHDVVRFLDWLRQLQ
RUGHUWRDFWLYDWHWKHPDGHFKDQJHV
In this example the DICOM RisServer (Worklist SCP) has the parameters:
Hostname:
Portnumber of the Worklist SCP process:
AET of the Worklist SCP process: :RUNOLVWB6&3
The local (own) DICOM AET of the ModalitySCU JDICOM program: :RUNOLVWB6&8
Verbose mode:
Start the Association by clicking the "2SHQ" button.
With "4XHU\:/" request the worklist entries from the RisServer (C-FIND).
With "&ORVH" you can close the association to the RisServer.

Setting filter in the JDICOM ModalitySCU:
For setting a WL query filter select

the Filter tabcard and choose the
tag group by selectin one of the
tabcards:
SPS (Scheduled Procedure Step)

PROCEDURE
SERVICE REQUEST
PATIENT
VISIT
The marked (with á) tags are

default set. If you want to add tags
just mark them. This is done by
clicking on .
Removing the tag from the WL
query just click on the mark á and
the is empty.
Displaying the WL Query result in JDICOM ModalitySCU:
In the Worklist tree you can find the received worklist data sets

Function of the buttons are:
with this button you can generate an PPS (Performed Procedure Step) entry for the selected worklist
entry. In order to do it select first the desired selected worklist entry and click button. The PPS data
set is stored under the folder "3HUIRUPHG3URFHGXUH6WHSV".
with this button you can remove an selected data set entry from the folder ":RUNOLVW" or "3HUIRUPHG
3URFHGXUH6WHSV".
with this button you can add PPS DICOM tags from the selected PPS entry in the PPS folder.
with this button you can save the made changes in the selected PPS entry.

3ULQW6HUYHU'XPP\3ULQW6&3
With the JDICOM application PrintServerDummy you can simulate the behaviour of a DICOM Camera.
DICOM Verification is supported and a hardcopy file can be received. This file is stored into a specified
directory and can be displayed by any DICOM viewer.
-',&203ULQW6HUYHU'XPP\
3ULQW6&3
056\QJR1XPDULV9$%
3ULQW6&3
AET: 3B3&B.ODXV
C_Echo 3ULQW6&8
AET: 7'6,0B
CalledTitles
Port: N_Create; N_Set CallingTitles
N_Delete
File
File System
System Exposure
function
3URSHUWL\WDEFDUG
Verification: WUXH
BasicGrayscalePrintManagement: WUXH
StoreHC : WUXH
StoreHC.Path: GGLFRPMGLFRPSULQW
The JDICOM application PrintServerDummy can be run either with a graphical user interface (GUI) or in
command line mode.
advanced users).

In the PrintServerDummy GUI you find two
tab cards.
3URSV tabcard for for chaning the properties
of the PrintServerDummy.
The following entries in the Props tabcard are

the minimum once which should be modified
before you can use the PrintServerDummy.
Port:
Own Portnumber of the PrintServerDummy
(for DICOM service Basic Print SCP)
Called Title:
Own DICOM AET of the PrintServerDummy
(for DICOM servicesBasic Print SCP)
Calling Title:
If no entry was made here, all AET’s from the
PrintSCU’s are acceped. If you want to restrict
the access to the PrintServerDummy you can
put in here the allowed AET’s. The AET’s
should be separated by comma.
Verbose:
Specifies the log level. The value which can be
used starts with
""
"" decode of DIMSE (DICOM Message
Service Element)
In this example the following properties are used for the PrintServerDummy:
3URSHUW\ 9DOXH
Portnumber of the PrintServerDummy process: Port
AET of the PrintServerDummy process: CalledTitles 3B3&B.ODXV
AET’s accepted PrintSCU’s: CallingTitles
3ULQW6HUYHU'XPP\LQRUGHUWRDFWLYDWHWKHPDGHFKDQJHV
Save the made changes in the property tab card by pressing the "$SSO\" button. The property values are than
saved in the properties file for the PrintServerDummy (PrintServerDummy.properties).
Start the PrintServerDummy by clicking the "6WDUW" button.
With "6WRS" the PrintServerDummy will be stopped.

It is possible to save the received DICOM Basic Print data to hard disc. Therefore you have to modify the
following entries in the property tab card.
3URSHUW\ 9DOXH
StoreHC true
StoreHC.Path Existing path on PC
In this example the values for this store functionality are :

3URSHUW\ 9DOXH
Enable hardcopy store to hard disc: StoreHC WUXH
Directory for the stored hardcopy files: StoreHC.Path GGLFRPMGLFRPSULQW
You can also use the ? to separate the subdirectories.
The stored files which you can find under the StoreHC.Path can be loaded and viewed in any DICOM
viewer (e.g. eFilm, DICOMscope, Osiris ..)

9DOLGDWH
With the JDICOM application Validate you can check DICOM files according the conformity to the
DICOM standard.
The JDICOM application Validate runs with a graphical user interface (GUI). Select the entry
in the JDicom menu.
In the JDICOM Validate application you find

serveral tab cards. The tab cards are related to
the IOD definitions.
With "9DOLGDWH" only one selected dicom file

can be checked.
With "9DOLGDWH " multible dicom file can be

checked.
With "+70/" you can export from the validated

DICOM file the attributs in an HTML file.
In the log area you will get informations about

the valitation.
In the window part "2SWLRQV" you can select

(mark á) optional DICOM modules for your
IOD to be checked.

Example for the validation of a MR image. To display the DICOM tags of the selected image the
"$WWULEXWV" tab card needs to be selected.
In the log you get the following information :
Validate file D:\Gartner\DICOM\mr22076\mr22076_5.0.9133179.img

No error detected for MR Image Storage SOP Class
This indicates that the DICOM file was successfully checked.

4XHU\5HWULHYH6&8
With the JDICOM application QueryRetrieveSCU you can simulate the behaviour of the DICOM service
Query Retrieve as Service Class User. An Association can be opened, a DICOM Verification can be made.
The image database of a QueryRetrieveSCP can be queried and images can be retrieved.
-',&204XHU\5HWULHYH6&8 05&RQVROH056\QJR1XPDULV
6WRUDJH4XHU\5HWULHYH6&3
456&8
AET: 64B6&8
CallingTitle
6WRUH456&3
AET: $1B7'6,0
C_Echo: (FKR
CalledTitle
C_Find: 4XHU\
C_Move: 5HWULHYH
Port:
Host (name resolution of the IP address)
3URSHUWL\WDEFDUG
InfoModel: 3DWLHQW5RRW
File
-',&20,PDJH6HUYHU System
6WRUDJH6&3 (Patient
4XHU\5HWULHYH6&3 database)
6WRUDJH456&3
AET: 6WRUDJHB6&3
MoveDestination
Port:
File
System
Fileset: WUXH
Fileset.Path:
GGLFRPMGLFRPLPDJH
The DICOM application QueryRetrieveSCU runs with a graphical user interface (GUI). Therefore select the
entry in the JDicom menu.

This are the minimum entries which should be modified before you can use QueryRetrieveSCU:
Host:
Enter here the hostname or IP address of the QueryRetrieveSCP (DICOM partner for querying the
database and retrieving images)
If a host name is used, an entry in the hosts file is required or DNS has to be enabled.
Port:
Port number of the QueryRetrieveSCP (DICOM partner querying the database and retrieving images)
Called Title:
DICOM AET of the QueryRetrieveSCP (querying the database and retrieving images)
Calling Title:
Own DICOM AET
MoveDestionation:
DICOM AET of the StoreSCP which should receive the retrieved images
InfoModel:
Used information model. Possible entries are: 3DWLHQW5RRW
6WXG\5RRW
3DWLHQW6WXG\2QO\
Verbose:
Specifies the log level. The value which can be used starts with
""
"" decode of DIMSE (DICOM Message Service Element)
RQ\RXUNH\ERDUG
,I\RXFKDQJHDSURSHUW\YDOXH\RXKDYHWR&/26(23(1WKHDVVRFLDWLRQLQRUGHUWRDFWLYDWHWKH
PDGHFKDQJHV
In this example the DICOM partner for receiving the Query/Retrieve requests (Q/R SCP) has the following
parameters:
Hostname:
Port number of the QueryRetrieveSCP process:
AET of the QueryRetrieveSCP process: $1B7'6,0
MoveDestination AET of the StoreSCP process: 45B6&8
(AET of the JDICOM ImageServer on the local PC)
The local (own) DICOM AET of the QueryRetrieveSCU JDICOM program: 6WRUDJHB6&3
Used QueryRetrieve information model: 3DWLHQW5RRW
Verbose mode:
Start the Association by clicking the "&RQQHFW" button.
With "4XHU\" sends an query (C_Find) request to the QueryRetrieveSCP.
With "5HWULHYH" you can retrieve the selected Patient/Study/images according the used information model.

)LOWHUWDEFDUGRIWKH-',&204XHU\5HWULHYH6&8DSSOLFDWLRQ
In this filter tabcard you can
select the tags which shall be used
in the query request. Characters
entered in under Value will be
sent in the Query request as
searching (matching) criteria.
You can do this for the DICOM
tag groups Patient, Study,
Series and Image by selecting
the tab card for the corresponding
tag group.
5HVXOWWDEFDUGRIWKH-',&204XHU\5HWULHYH6&8DSSOLFDWLRQ
After sending an query request (C_Find) to the QueryRetrieveSCP the feedback is displayed in the result tab
card. In this example the information model 3DWLHQW5RRW was used.

Selecting the Patient name in the Query Result tree you get DICOM tags displayed for the patient. To query
the database for study information you can do this either by double clicking on the patient name or by
pressing the "4XHU\" button . The study level information are than visible.
Selecting the study (folder icon) you get then the study DICOM tags displayed. In order to get the
information of the image level you can do this either by double clicking on the study folder or by pressing
the "4XHU\" button. The image level information are than visible.
Selecting the image in the Query tree you get the image DICOM tags displayed.

You can retrieve the images by selecting in
♦ the patient level the patient name and click the "5HWULHYH" button.
♦ the study level the study folder and click the "5HWULHYH" button.
♦ the image level the image and click the "5HWULHYH" button.
Be sure that the StoreSCP (e.g. JDICOM ImageServer) is running, otherwise the retrieve will fail.
With you can remove the selected entry in the Query Results tree and
with you can clear the Query Results tree.

(GLW'LFRP2EMHFWV
With the JDICOM application EditDicomObject you can create new or modify DICOM files. This files can
be DICOM images, worklist entries or mpps files.
The JDICOM application EditDicomObjects runs with a graphical user interface (GUI). Select the entry
in the JDicom menu.
Description of the following buttons:
With the "1HZ" button you can create a new DICOM file.
With "/RDG" you can load an existing DICOM file (image file or worklist file from JDICOM WL)
With "6DYH" you can save the modified file.
With "+70/" you can create a dump of the used DICOM tags from the loaded DICOM file in HTML
format.
1RWH
&KHFNYDOXHRIWKH3URSHUW\6DYH)LOH0HWD,QIR
,IWKH9DOXHHQWU\RIWKLVSURSHUW\LVWUXH\RXKDYHWRILOORXWWKHIROORZLQJ)LOH0HWD,QIRUPDWLRQ
7DJ
7DJ $WWULEXWH1DPH 95 90 9DOXH

(0002,0012) ImplementationClassUID UI 1 nnn.nnn.nnn

If this entry isn’t made you will get the error message "com.archimed.dicom.DicomException:
Missing ImplementationClassUID" wen you try to save the file. In order to avoid this you can
modify the value entry in the property "6DYH)LOH0HWD,QIR" to IDOVH. This change can not be saved
from the GUI EditDicomObjects. When you start the JDicom program EditDicomObjects the value for the
tag "Save.FileMetaInfo" is set back to the original one. But there is a way to modify the tag by
changing the value in the EditDicomObjects.properties file. You will find this file in the installation
directory of JDicom. Use an text editor (e.g. notepad) in order to do the necessary modification.
Contents of the "EditDicomObjects.properties" file.
#Properties for EditDicomObject

#Thu Jul 19 16:22:40 GMT+02:00 2001
Save.UndefSeqLen=false
Load.PixelData=true
Save.FileMetaInfo=true (property which should be set to IDOVH)
Load.Append=false
Save.TransferSyntax=ImplicitVRLittleEndian
Show.FileMetaInfo=true
Show.SequenceItem=true
Verbose=1
3URFHGXUHKRZWRLQVHUWRUUHPRYHWDJV
♦ Load the DICOM file into the EditDicomObjects editor

♦ Choose from the IOD’s window the part which you want to insert
For inserting the tags select the entry in the IOD’s tree with the
mouse and use the button to add the tags. If you want
to remove the tags, select first the entry in the IOD’s tree and
use the to remove the selected IOD’s tag group.
By double clicking on the folder

icon of the IOD’s tree you can
expand the tree for the required
selection (e.g. IOD’s for MR).
Use again the buttons
To add or to remove MR IOD’s

from the loaded DICOM file.

For example if you want to add the group Patient from the IOD’s MR you have to expand the folder MR in
the IOD’s tree select the entry "Patient" and use the add button to get the Patient MR IOD tags. You
will get than the following output:
Select the tag which you want to use and instert
the correct value. Automatically the tag gets
marked with á after confirming the made entry
with the <ENTER> key on the keyboard.
For resetting the value remove the mark á by
clicking on it.
Note: ,I\RXFKDQJHRUPDNHDQ,2'HQWU\\RXKDYHWRFRQILUPLWE\SUHVVLQJWKH(17(5!NH\RQ
\RXUNH\ERDUG
If all changes were made on the DICOM file, save it.

(GLW'LFRP'LU
The JDICOM application EditDicomDir runs with a graphical user interface (GUI). Select the entry
in the JDicom menu.
Description of the buttons:
with the new button an empty DICOMDIR is generated, but not save to disc.
with the load button you can load an existing DICOMDIR file into the JDICOM
application EditDicomDir.
with the save button you can save the DICOMDIR file to disc.

Example for a loaded DICOMDIR file:

Jdicom Manual v1 0

Uploaded by

Copyright:

Available Formats

Jdicom Manual v1 0

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Jdicom Manual v1 0

Uploaded by

Copyright:

Available Formats

What are the main components/applications of JDICOM?

What are the main components/applications of JDICOM?

What are some of the functions of the ImageServer application?

What are some of the functions of the ImageServer application?

8VLQJ-',&20

JDICOM manual v1-0.doc 21.09.2001 Seite 1 von 32 Klaus Gartner TDPS 23

3ULQW6&8 (not yet described)

JDICOM manual v1-0.doc 21.09.2001 Seite 2 von 32 Klaus Gartner TDPS 23

If the file is successfully downloaded use following the installation instruction

to install JDicom on your PC.

JDICOM manual v1-0.doc 21.09.2001 Seite 3 von 32 Klaus Gartner TDPS 23

The important entries are:

♦ Storage Commitment SCU/SCP

JDICOM manual v1-0.doc 21.09.2001 Seite 4 von 32 Klaus Gartner TDPS 23

JDICOM manual v1-0.doc 21.09.2001 Seite 5 von 32 Klaus Gartner TDPS 23

TransferSyntax: java.lang.IllegalArgumentException: not one of

Anoymize.NewID : new PatientID

Start the Association by clicking the "&RQQHFW" button.

With "(FKR" you start a Verification (C_Echo).

With "6HQG" only one selected image can be transferred.

With "6HQG " multiple images can be transferred.

With "&DQFHO" the started image transfer can be interrupted.

Close the Association by clicking the "5HOHDVH" button.

JDICOM manual v1-0.doc 21.09.2001 Seite 6 von 32 Klaus Gartner TDPS 23

To run it with a GUI select in the JDicom menu.

JDICOM manual v1-0.doc 21.09.2001 Seite 7 von 32 Klaus Gartner TDPS 23

The following entries in the Props tabcard are the

JDICOM manual v1-0.doc 21.09.2001 Seite 8 von 32 Klaus Gartner TDPS 23

Start the ImageServer by clicking the "6WDUW" button.

With "6WRS" the ImageServer will be stopped.

JDICOM manual v1-0.doc 21.09.2001 Seite 9 von 32 Klaus Gartner TDPS 23

To run it with a GUI select in the JDicom menu.

JDICOM manual v1-0.doc 21.09.2001 Seite 10 von 32 Klaus Gartner TDPS 23

The following entries in the Props tabcard are the

JDICOM manual v1-0.doc 21.09.2001 Seite 11 von 32 Klaus Gartner TDPS 23

Start the RisServer by clicking the "6WDUW" button.

With "6WRS" the RisServer will be stopped.

♦ Select the "5HVXOWtab card in the RisServerGUI

Double click the folder icon Repository and the

The button you can refresh the Repository tree.

JDICOM manual v1-0.doc 21.09.2001 Seite 12 von 32 Klaus Gartner TDPS 23

and click on the button.

If you get the following message "java.io.IOException: d:\dicom\jdicom\risserver224

JDICOM manual v1-0.doc 21.09.2001 Seite 13 von 32 Klaus Gartner TDPS 23

in the JDicom menu.

JDICOM manual v1-0.doc 21.09.2001 Seite 14 von 32 Klaus Gartner TDPS 23

There are three more tabcards available:

Start the Association by clicking the "2SHQ" button.

With "(FKR" you start a Verification (C_Echo).

With "&ORVH" you can close the association to the RisServer.

JDICOM manual v1-0.doc 21.09.2001 Seite 15 von 32 Klaus Gartner TDPS 23

For setting a WL query filter select

SPS (Scheduled Procedure Step)

The marked (with á) tags are

 Displaying the WL Query result in JDICOM ModalitySCU:

JDICOM manual v1-0.doc 21.09.2001 Seite 16 von 32 Klaus Gartner TDPS 23

JDICOM manual v1-0.doc 21.09.2001 Seite 17 von 32 Klaus Gartner TDPS 23

To run it with a GUI select in the JDicom menu.

JDICOM manual v1-0.doc 21.09.2001 Seite 18 von 32 Klaus Gartner TDPS 23

The following entries in the Props tabcard are

♦ Select the "5HVXOWtab card in the RisServerGUI

Displaying the WL Query result in JDICOM ModalitySCU: