Starting the Network Services Utility

The DICOM Network Services utility allows you to create and store Application Entity definitions in a local configuration file or a system configuration file. This distinction is only required when you define an Application Entity associated with the Storage SCP service, or configure properties of this service. This information must be stored in the system configuration file, which requires starting the utility with a special SYSTEM keyword. Application Entities using other service types are typically defined in the local configuration file (available when the utility is started without any keywords). When started in this manner, the utility also provides access to query, retrieve and send operations. See the following section for details on local and system modes.

Local Versus System Configuration

There are two modes of configuration available; local configuration and system configuration. Underlying each set of user-defined settings is an .xml file. Changes made to Application Entities (AEs) defined in the system configuration and local configuration mode of the DICOM Network Services utility are reflected in these files.

Note
Always use the DICOM Network Services utility to make changes to the configuration files. The raw .xml files should never be modified directly.

The system configuration portion of the DICOM Network Services utility corresponds to a single system configuration file that is used by the Storage SCP service. The Storage SCP service listens for incoming files and is typically started at boot time, which means the service is not associated with a specific user. The properties of the Storage SCP service can only be set when the DICOM Network Service utility is started in system configuration mode.

When you share a single installation of IDL among a number of users, changes made in the system configuration file are visible to all users. In such a network, it is likely that only system-wide configuration information will be entered in system mode, and you will enter individual Application Entity definitions in your local configuration file by starting the utility in local mode. Each user has a local configuration file.

It is important to understand when changes made in system configuration mode are propagated to each user's local configuration file:

The first time the DICOM Network Services utility is accessed in IDL, the local configuration file is populated with AEs defined in the system configuration file.

After the first time the utility is started, the local file is only overwritten with system configuration information if the local directory is deleted. In such a case, the local configuration settings will be recreated from the system configuration settings.

If having locally configured AEs that are not duplicated in the system file is acceptable, then there is no need to modify the system file except to define Storage SCP service parameters. This must be done in the system configuration file. See Configuring Your System to Receive Files for details.

Tip
You can use the DICOMEX_GETCONFIGFILEPATH function to return the location of either configuration file. See DICOMEX_GETCONFIGFILEPATH for details.

Starting the DICOM Network Services Utility in Local Mode

Enter the following at the IDL command prompt to launch the DICOM Network Services utility in local configuration mode:

DICOMEX_NET

This provides access to the local Configuration tab, the Query Retrieve SCU tab and the Storage SCU tab.

Note
On Windows, you can also select Start → Programs → IDL x.x → DICOM Network Services and click the Local button to start the utility in local configuration mode. On Macintosh, double-click DicomExNetStartup in the root IDL folder.

Starting the DICOM Network Services Utility in System Mode

Use the SYSTEM keyword to launch the DICOM Network Services utility in system configuration mode:

DICOMEX_NET, /SYSTEM

This provides access to the system Configuration tab.

Note
On Windows, you can also select Start → Programs → IDL x.x → DICOM Network Services and click the System button to start the utility in system configuration mode. On Macintosh, double-click DicomExNetStartup in the root IDL folder.