JDIS Tool User Interface

JDIS Tool has a Swing front end. It has the following functionality:

  1. play prerecorded DIS files through Multicast and HLA mode,
  2. save(to file) DIS Packages coming from Multicast channel or HLA,
  3. save(to database) DIS Packages coming from Multicast channel or HLA, For this, you need a servlet written by Tom Pulikal. PDUs are XMLazed and submitted to the servlet which has a DB connection.
  4. display DIS Packages coming from Multicast channel or HLA,
  5. submit a pre-recorded file to the DB,
  6. a bridge between DIS multicast channel and HLA RTI.
There are two menus: Menu and Action.

Figure 1 : JDIS Tool Main Window

Upper-left window displays the PDU traffic. Their length and color are coded based on the PDU number. Upper-right window displays the PDU number, its name, and the assigned color. Lower-right window catches the Entity information from EntityState PDU and displays the identity and position of an entity. Detail button gives extra information about the entity.

Menu

Figure 2 : A Menu

DIS

Use DIS for the communication mode.

HLA

Use HLA for the communication mode.

DIS Settings

allows to set the Multicast Channel and Port number.

Figure 3 : DIS Settings.

HLA Settings

allows to set the location of JWORB server containg OWRTI.

Figure 4 : HLA Settings.

Logger Settings

allows to set the location of server which contains the Database logger servlet.

Figure 5 : Logger Settings.

Exit

terminates the program.

Action

Figure 6 : Action Menu

Play

allows to play a prerecorded file.

actual1.pdu: Original Bridge Operation
test_knox1.pdu: A first half of the 4 tank and 3-4 minefield scenario.
test_knox2.pdu: A 4 tank and 3-4 minefield scenario.
These files are dumped while ModSAF and CMS are running on the DIS Mode.

Figure 7 : Play brings a file browser to select the name of the PDU file.

Stop

Stops the current action.

Receive Save

displays the PDUs on the upper left window and saves them to the file. The name of the file is obtained with a file dialog window. Color and height are correlated with the DIS PDU Type Number which is an IEEE standard(IEEE 1278.1) except the Mine related definitions.

Receive Display

displays the on the upper left window.

Receive SaveDB

receives the PDUs and submits them to the DB.

Submit File To DB

submits the prerecorded DIS PDU file to the DB. It asks the file name and the size of each package in terms of number

DIS-to-HLA

Takes from Multicast DIS channel and publishes through HLA by using OWRTI.

Set Frequency

How many pdus will be produced in 1000 ms. Default is 10, to keep the distance between consecutive DIS PDUs at 100 ms level.

Figure 8 : Setting the frequency.

Default Settings

Settings can be done through: a file and command line options.

default.properties file

This file contains the following keywords

mcast: DIS Multicast Channel Address
mport: DIS Multicast Channel Port Number
cport: UDP Port Number to collect the Parallel CMS Stats
nserver: JWORB Server running on OWRTI
nport: Port Number of JWORB Server running on OWRTI
dbserver: An address of HTTP server containg database servlet.
dbpackagesize: Size of the packages to submit to the HTTP Servlet.
playfrequency: How many PDUs per sec?
disfedexname: DIS HLA Federation Execution Name
disinteraction: DIS HLA Interaction Class Name
disparameter: DIS HLA Parameter Name
browsepath: Default Browsing Directory
playfile: Default File name to play
savefile: Default File name to save

An example default.properties file looks like the following:

# DIS Multicast Channel Address
mcast=230.0.0.2
# DIS Multicast Channel Port Number
mport=4447
# UDP Port Number to collect the Parallel CMS Stats 
cport=3030
# JWORB Server running on OWRTI 
nserver=127.0.0.1
# Port Number of JWORB Server running on OWRTI 
nport=4004
# An address of HTTP server containg database servlet.
dbserver=http://gandalf.npac.syr.edu:4004
# Size of the packages to submit to the HTTP Servlet
dbpackagesize=3
# 
playfrequency=10
# DIS HLA Federation Execution Name 
disfedexname=HelloWorld
# DIS HLA Interaction Class Name
disinteraction=Communication
# DIS HLA Parameter Name
disparameter=Message
# Default Browsing Directory
browsepath=..
# Default File name to play 
playfile=test_knox1.pdu
# Default File name to save 
savefile=t1.pdu

command line options.

All the keywords mentioned in default.properties file can be given from the command line with

-keyword_name keyword_value

The command line option overwrites the settings given in default.properties file.


Updated on : January 9, 1999