Welcome to Jive documentation!¶

Jive is a standalone JAVA application designed to browse and edit the static TANGO database. Jive has been written using Swing and need a JVM higher than 1.6.0. You will find in this documents the way to manage and create devices, properties and classes. Jive also offers advanced search/selection features.

Jive: A Tango Database browser

Contents:

Manage Servers¶

Creating a Tango server¶

To Create a server , Open the server creation dialog within the Edit menu.

Enter the server name including its instance name:
Ex: Modbus/tra1 where Modbus is the name of the process (the executable name) and tra1 its instance name.Then you can run your server by launching “Modbus tra1”.
Enter the class name
Enter all devices of this class
Click on Register server

Adding or Removing device to/from an existing server¶

Select the class in the server you want to add a device, then right click on it and select “Add a device”. This will ask you for a device name. Select “Delete” if you want to remove the device. Note that when you remove a device all its properties are also removed.

Adding or Removing class to/from an existing server¶

Select the server you want to add a class, then right click on it and select “Add class”. This will show you the Create/Edit server window with the server name locked. Enter the class and devices name and click “Register Server”.

Renaming a server¶

This is a global rename of a server (executable name), all instances are affected.

This allows to rename the instance of one specific server.

This allows to rename the server name and instance name of one specific server.

Manage Properties¶

Creating a Property¶

Go in the device tree and select the Properties node, then click on the “New property” button. This will prompt an input dialog where you can enter the property name.

Rename a Property¶

Rigth click on the property name in the property table and select “Rename”, This will allow you to give a new name to your property.

Delete a Property¶

You can select “Delete” (right click on the property item) to remove one propery. You can also right click on the device node and select “Delete”. This will erase all properties (including attribute properties) for the device. Note that if you want to remove the device itself, you have to remove it from its class in the server definition.

History of a Property¶

You can access to the change history of a property by selecting “View History”. This opens the history dialog.

Tango Database History dialog

Advanced Editing¶

Multiple Editing¶

You can select several property nodes by holding the CTRL key down. Then if you edit one or more properties, all properties will be affected in all selected nodes. If several nodes are selected a confirmation dialog will appear as shown below.

Multiple Selection¶

You can by rigth clicking on a domain or family node select a type of node to select. Then a dialog will ask you which class you want to select. All classes present in the tree under the selection root will be selectable as shown below.

Multiple Selection in a table¶

You can select multiple properties by using a filter. Select “Multiple selection” from the tools menu to display the multiple selection table.

Enter a selection filter using wildcard ‘*’ to get the list of desired properties.
You can edit a single propery in the talbe or Apply a global value to all the selection by clicking on the “Apply to all” button. “Apply to all” will first ask for the value to be applied.

Filtering the nodes in trees¶

It is possible to filter some nodes in selection trees. Select which tree you want to be filtered then enter a filter (using wildcard) in the input dialog.

Then the device tree will be displayed as below:

Displaying collection¶

It is possible to display the servers tree organized as host collection (Astor view). To enable this, you can use the -p option (see command line options). To configure host collection, you have to follow the Astor configuration process and to configure Starter properties.

Command line¶

Dependencies (CLASSPATH)¶

ASTOR=$TANGO_JAVA_APPLIS/Astor.jar
JSSHTERMINAL=$TANGO_JAVA_APPLIS/JSSHTerminal.jar
LOGVIEWER=$TANGO_JAVA_APPLIS/LogViewer.jar
LOG4J=$TANGO_JAVA_LIBS/log4j.jar
TANGO=$TANGO_JAVA_LIBS/JTango.jar
TANGOATK=$TANGO_JAVA_LIBS/ATKCore.jar:$TANGO_JAVA_LIBS/ATKWidget.jar
ATKPANEL=$TANGO_JAVA_APPLIS/atkpanel.jar
JIVE=$TANGO_JAVA_APPLIS/Jive.jar

CLASSPATH=$TANGO:$TACO:$TANGOATK:$ATKPANEL:$JIVE:$LOGVIEWER:$LOG4J:$ASTOR

Note: Astor.jar is needed for “Polling thread manager” and “Device dependencies” features.

Command line¶

java -DTANGO_HOST=host:port jive3.MainPanel

Command line options¶

Usage: jive [-r] [-s server] [-d device] [-fxx filter] [-p panel]
 -r        Read only mode (No write access to database allowed)
 -s server Open jive and show specified server node (server=ServerName/instance)
 -d device Open jive and show specified device node (device=domain/family/member)
 -fs filter Default server filter
 -fd filter Default device filter
 -fc filter Default class filter
 -fa filter Default alias filter
 -faa filter Default attribute alias filter
 -fp filter Default property filter
 -p panelmask (1=Collection 2=Server 4=Device 8=Class 16=DevAlias 32=AttAlias 64=FreeProperty)