Contents

• Introduction
• System Requirements
• Installation
• Running the ICSGenerator Tool
• ICS USERS GUIDE
• Feedback

Thank you for downloading this release of the ICSGenerator Version 2.0. The ICSGenerator  version 2.0 is a tool designed to capture IEEE 1073 implementation conformance information as stated in the Data Information Model specification.

ICSGenerator 1.0 uses Java and XML Technologies. The following software is required:

• Java 2 SDK (Version 1.4.2)
• Xerces (Version 2_8_0)

• c:/ICS/src - top level directory for the source code
• c:/ICS/src/comparingDevices - contains the java source code for comparing two devices
• c:/ICS/src/drawing - contains the java source code for creating a UML diagram of a device
• c:/ICS/src/icsDyn - contains the java source code for creating an ICS for a device
• c:/ICS/src/icsTables - contains the java source code for creating html tables listing attributes, behaviors and notifications for a device
• c:/ICS/src/modifyIcs - contains the java source code for creating an ICS for the Service Model
• c:/ICS/jar - contains the file jama.jar(Jama is a java matrix package)
• c:/ICS/xml - contains the xml files used by the ICSGenerator tool. The default ICS XML File ICS-Tool.xml (an XML representation of the data model as specified in the IEEE 1073 DIM Document) is in this directory.
• c:/ICS/xsd - directory that contains schema files for DIM ICS, General ICS, Service Support ICS and Transport ICS
• c:/ICS/XSLT - directory that contains the transformation used by the ICSGenerator Tool.
• c:/ICS/Readme2.html - this file.

• cd C:/ICS/src
• CLASSPATH = .;c:/xerces-2_8_0/xercesImpl.jar;c:/xerces-2_8_0/xml-apis.jar;c:/ICS/jar/jama.jar

• javac icsDyn/*.java
• java icsDyn/ManagementView

The ICSGenerator main screen has six tabs at the top of the screen that allow the user to create/modify a DIM ICS, General ICS, Service Support ICS and Transport ICS. The remaining two tabs allow the user to create a UML diagram of the DIM ICS and compare two devices DIM ICS's to see what they have in common as well as the differences in the two devices. For a detailed description of the ICSGenerator Tool download the ICSGenerator Users Guide.

• DIM ICS
• General ICS
• Service Support ICS
• Transport ICS
• UML Diagram
• Compare Devices

Click on the DIM ICS tab

The generation process is driven by an input XML file containing the data information model. The default file is a complete representation of the data information model as prescribed in the IEEE 1073 DIM specification. To initiate the process select the XML file (data information model) you want to use as the initial model to specify your implementation conformance statements and support information.

The generation process is also driven by the type of Medical Device System (MDS) Object selected for the Medical Device Data Information Model, the current version of the ICSGenerator tool supports Hydra and Simple MDS.

At the top of the panel select:
"New" to start the process with the default instance of the data information model. This option is usually selected the first time you use the tool.
Or
"Reload" to start the process with a previous created version of the file.

Select the MDS type to use:

"Simple" to represent a medical device that contains a single Virtual Medical Device (VMD) instance only (single purpose device).
Or
"Hydra" to represent a device that contains multiple VMD instances (multi-purpose device).

Once you have selected one of them a JTree representation of the loaded XML file should appear on the left hand of the screen. You can now select any of the Managed Object Classes (MOC) to see information such as Object Class, Object Name, Attributes, etc.

There are also five buttons below the JTree:

"Add MOC" to add a new Managed Object Class (MOC) to the tree
"Remove MOC" to remove MOC's from the tree
"Update Attributes..."to update the attributes for the selected MOC
"Update Behaviors...."to update the behaviors for the selected MOC
"Update Notifications..."to update the notifications for the selected MOC

As you add or remove selected MOC's you should see the JTree changing to reflect the additions or removals of MOC's.

You can also add a label, Application Guidance, restrictions, etc... for a MOC by typing data into the respective boxes and clicking on "Add Changes".

Once you are done modifying the tree you can generate an XML representation of the JTree by clicking on the "Generate" button. The XML will appear at the bottom of the screen. You can also save the file by clicking on the "Export XML File" button.

Click on the General ICS tab

The General ICS process is driven by an input XML file containing the infomation for creating a General ICS. The default file is a complete representation of the General ICS data model as prescribed in the IEEE 1073 DIM specification. To initiate the process select the XML file you want to use as the initial model to specify your implementation conformance statements and support information.

At the top of the panel select:
"New" to start the process with the default instance of the General ICS model. This option is usually selected the first time you use the tool.
Or
"Reload" to start the process with a previously created General ICS.

You can modify the Support and/or Comment field for an Index by clicking on the respective boxes and typing your Support and/or Comment text and clicking on the "Add Changes"button.

Once you are done modifying the General ICS you can generate an XML representation of the General ICS by clicking on the "Generate XML File" button. The XML will appear at the bottom of the screen. You can also save the file by clicking on the "Export XML File..." button.

Click on the Service Support ICS tab

The Service Support ICS process is driven by an input XML file containing the infomation for creating a Service Support ICS. The default file is a complete representation of the Service Support ICS data model as prescribed in the IEEE 1073 DIM specification. To initiate the process select the XML file you want to use as the initial model to specify your implementation conformance statements and support information.

At the top of the panel select:
"New" to start the process with the default instance of the Service Support ICS model. This option is usually selected the first time you use the tool.
Or
"Reload" to start the process with a previously created Service Support ICS.

You can modify the Support and/or Comment field for an Index by clicking on the respective boxes and put a check in the Support column and/or type your text in the Comment field and click on the "Add Changes".

Once you are done modifying the Service Support ICS you can generate an XML representation of the Service Support ICS by clicking on the "Generate XML File" button. The XML will appear at the bottom of the screen. You can also save the file by clicking on the "Export XML File..." button.

Click on the Transport ICS tab

The Transport ICS process is driven by an input XML file containing the infomation for creating a Transport ICS. The default file is a complete representation of the General ICS data model as prescribed in the IEEE 1073 DIM specification. To initiate the process select the XML file you want to use as the initial model to specify your implementation conformance statements and support information.

At the top of the panel select:
"New" to start the process with the default instance of the Transport ICS model. This option is usually selected the first time you use the tool.
Or
"Reload" to start the process with a previously created Transport ICS.

Click on the IRDA-based Cable-Connected radio button

Select one of the following radio buttons: IrLAPICS, TinyTPICS, IrLMPICS

You can modify the Supported field for a funtion by clicking on the respective boxes and clicking on the "Add Changes"button.

Once you are done modifying the Transport ICS you can generate an XML representation of the Transport ICS by clicking on the "Generate XML File" button. The XML will appear at the bottom of the screen. You can also save the file by clicking on the "Export XML File..." button.

Click on the UML Diagram tab(After a DIM ICS is created or reloaded)

Click on the "Select a root:" drop down menu tab and pick a node as a starting point for the UML diagram.

Click on the"Draw UML Diagram"button and a UML diagram will appear starting with the root element selected.

The user can save the UML diagram by clicking on the "Export Image..."button

Click on the Compare Devices tab

Click on the "Add a device"button.

Click on the"Browser.."button and select your first file for comparison.

Click on the "Add a device"button.

Click on the"Browser.."button and select your second file for comparison.

Click on the "Compare Devices"button.

A comparison of the devices will now appear in the bottom portion of the screen. To see what Attributes, Behaviors and Notifications the two devices have in common right click on the MOC. Select one of the following from the drop down list(Attributes or Behaviors or Notifications). Also please note that more than two devices can be compared. Click on the "Add a device"button to add additional devices for comparison.

Please click on the following link for a detailed description of the ICSGENERATOR Tool.

Please send comments or recommendations directly to: Rick Rivello or Sandra I. Martinez