3.1.3 Client Programs

The following paragraphs list the command line invocation syntax and options for the sat-nms client software. Being pure Java applications, the sat-nms clients may be run on severals operating systems. The explanations given in the following are mostly independent from the operating system you are using. For all examples given below, we assume that the file "client.jar" is located in your current working directory.

M&C Client

The M&C client program is invoked by a command line looking like this:

java -cp client.jar satnms3.gui.MCFrame [options ...] <IP address of the server>

The IP address of the M&C server may be replaced by a host name if your network installation provides name resolution for this address.

The following command line options may be used with the program:

• -u <user-name> --- Specifies the user name for autologin. Must be used together with -p

• -p <password> --- Specifies the password for autologin. Must be used together with -u

• -l <look-and-feel> --- Lets you set the "look and feel" of the user interface to one of several definitions. Accepted values are: Aero, Fast, Aluminium, McWin, Luna, Pulsar, Noire, Mint, Graphite, Smart, Bernstein, Acryl and HiFi.

• -m x0,y0,x1,x2,xc,yc --- Specifies the (overall) bounds of a multi monitor setup. When operated on a single monitor PC, the client automatically determines the screen size and ensures that automatically placed windows remain within the bounds of the screen. The -m option is not necessary in this case. With multiple monitors, the abolute bounds of the rectangle enclosing all monitors must be specified with the -m option. -m must be followed by a space character and 6 numbers separated by comma characters: x0 = x coordinate of the top left corner y0 = y coordinate of the top left corner x1 = x coordinate of the bottom right corner y1 = y coordinate of the bottom right corner xc = x coordinate of center position yc = y coordinate of center position Example: 0,0,3840,1080,2880,540 describes a layout with two full HD monitors located side by side. The center position is defined as the center of the right monitor (the splash screen and some other windows are shown centered at this point.

• -f 0 -f 1 --- Starts the client in full screen mode. The main window covers the complete screen, no window decorations are shown. -f 1 shows the satnms toolbar (to launch the event log for example) -f 0 suppresses the tool bar.The full screen mode is intended to be used with touch screen panels. There are limited capabilities to handle child windows in -f 0 mode, depending on the operating system of the client pc.

• -t --- Starts the client without the toolbar.

• -n 1 -n 2 -n 3 --- Tells the client how to treat "new faults". Without the -n option, new faults are not reported separately. The fault indicator in the main window's toolbar ia active while the server's summary fault is active.

  • n1 --- The program treats new faults separately. A fault is new until an operator acknowledges it by clicking into the fault indicator or by acknowledging the fault in the event log or event report window. The new fault is displayed as a red mark labeled "NEW FAULT". If the fault disappears without being acknowledged, a gray "NEW FAULT" mark is shown.
  • n2 --- Behaves like -n 1 , but makes the program ring the keyboard bell while a new fault is pending.
  • n3 --- Works like the previous, but suppresses the very first "NEW FAULT" after the start of the client. New faults which occurred while the client program did not run are not signalled, nor are gray "NEW FAULT" conditions. Only new faults recognized while the client program runs are shown.

• -s <screen-name> --- Tells the program to load the given screen definition file instead of the "default" screen on startup. Screen definition files are expected in the "screens" subdirectory of the server. The -s also suppresses the display of the applications's splash screen on startup.

• -v --- Suppresses the program version match check on startup

• -d <r,g,b> --- Sets the foreground color of disabled texts / elements in the GUI. r,g,b are numbers in the range 0..255, comma separated, specifying the RGB components of the color.

• -V --- Tells the program to be verbose on the command line. This option is for debugging only, never set it for operational use.

• -y <layout-name> --- Tells the program to load the given window layout instead of the layour "default".

TreeView Client

The TreeView version of the M&C client program is invoked by a command line looking like this:

java -cp client.jar satnms3.gui.TreeView [options ...] <IP address of the server>

The IP address of the M&C server may be replaced by a host name if your network installation provides name resolution for this address.

The following command line options may be used with the program:

• -u <user-name> --- Specifies the user name for autologin. Must be used together with -p

• -p <password> --- Specifies the password for autologin. Must be used together with -u

• -l <look-and-feel> --- Lets you set the "look and feel" of the user interface to one of several definitions. Accepted values are: Aero, Fast, Aluminium, McWin, Luna, Pulsar, Noire, Mint, Graphite, Smart, Bernstein, Acryl and HiFi.

• -m x0,y0,x1,x2,xc,yc --- Specifies the (overall) bounds of a multi monitor setup. When operated on a single monitor PC, the client automatically determines the screen size and ensures that automatically placed windows remain within the bounds of the screen. The -m option is not necessary in this case. With multiple monitors, the abolute bounds of the rectangle enclosing all monitors must be specified with the -m option. -m must be followed by a space character and 6 numbers separated by comma characters: x0 = x coordinate of the top left corner y0 = y coordinate of the top left corner x1 = x coordinate of the bottom right corner y1 = y coordinate of the bottom right corner xc = x coordinate of center position yc = y coordinate of center position Example: 0,0,3840,1080,2880,540 describes a layout with two full HD monitors located side by side. The center position is defined as the center of the right monitor (the splash screen and some other windows are shown centered at this point.

• -f 0 -f 1 --- Starts the client in full screen mode. The main window covers the complete screen, no window decorations are shown. -f 1 shows the sat-nms toolbar (to launch the event log for example) -f 0 suppresses the tool bar. The full screen mode is intended to be used with touch screen panels. There are limited capabilities to handle child windows in -f 0 mode, depending on the operating system of the client pc.

• -t --- Starts the client without the toolbar.

• -o --- Enables automatic pop ups of the fault list window with every new fault.

• -n 1 -n 2 -n 3 --- Tells the client how to treat "new faults". Without the -n option, new faults are not reported separately. The fault indicator in the main window's toolbar ia active while the server's summary fault is active.

  • n1 --- The program treats new faults separately. A fault is new until an operator acknowledges it by clicking into the fault indicator or by acknowledging the fault in the event log or event report window. The new fault is displayed as a red mark labeled "NEW FAULT". If the fault disappears without being acknowledged, a gray "NEW FAULT" mark is shown.
  • n2 --- Behaves like -n 1 , but makes the program ring the keyboard bell while a new fault is pending.
  • n3 --- Works like the previous, but suppresses the very first "NEW FAULT" after the start of the client. New faults which occurred while the client program did not run are not signalled, nor are gray "NEW FAULT" conditions. Only new faults recognized while the client program runs are shown.

• -s <screen-name> --- Tells the program to load the given screen definition file instead of the "default" screen on startup. Screen definition files are expected in the "screens" subdirectory of the server. The -s also suppresses the display of the applications's splash screen on startup.

• -v --- Suppresses the program version match check on startup

• -d <r,g,b> --- Sets the foreground color of disabled texts / elements in the GUI. r,g,b are numbers in the range 0..255, comma separated, specifying the RGB components of the color.

• -V --- Tells the program to be verbose on the command line. This option is for debugging only, never set it for operational use.

Tabbed View Client

The Tabbed View NMS client program is invoked by a command line looking like this:

java -cp client.jar satnms3.gui.TabbedView [options ...] <IP address of the server>

The IP address of the NMS server may be replaced by a host name if your network installation provides name resolution for this address.

The following command line options may be used with the program:

• -u <user-name> --- Specifies the user name for autologin. Must be used together with -p
• -p <password> --- Specifies the password for autologin. Must be used together with -u
• -l <look-and-feel> --- Lets you set the "look and feel" of the user interface to one of several definitions. Accepted values are: Aero, Fast, Aluminium, McWin, Luna, Pulsar, Noire, Mint, Graphite, Smart, Bernstein, Acryl and HiFi.
• -m x0,y0,x1,x2,xc,yc --- Specifies the (overall) bounds of a multi monitor setup. When operated on a single monitor PC, the client automatically determines the screen size and ensures that automatically placed windows remain within the bounds of the screen. The -m option is not necessary in this case. With multiple monitors, the abolute bounds of the rectangle enclosing all monitors must be specified with the -m option. -m must be followed by a space character and 6 numbers separated by comma characters: x0 = x coordinate of the top left corner y0 = y coordinate of the top left corner x1 = x coordinate of the bottom right corner y1 = y coordinate of the bottom right corner xc = x coordinate of center position yc = y coordinate of center position Example: 0,0,3840,1080,2880,540 describes a layout with two full HD monitors located side by side. The center position is defined as the center of the right monitor (the splash screen and some other windows are shown centered at this point.
• -s --- Suppresses the beeper ("silent").
• -t <tab-definition> --- Tells the program to load the given tab definition file instead of the "default" definition on startup. Tab definition files are expected in the "tviews" subdirectory of the NMS server.
• -d <r,g,b> --- Sets the foreground color of disabled texts / elements in the GUI. r,g,b are numbers in the range 0..255, comma separated, specifying the RGB components of the color.
• -v --- Suppresses the program version match check on startup
• -V --- Tells the program to be verbose on the command line. This option is for debugging only, never set it for operational use.

Service Client

The ServiceClient client program is invoked by a command line looking like this:

java -cp client.jar satnms3.sclient.ServiceClient [options ...] <IP address of the server>

The IP address of the M&C server may be replaced by a host name if your network installation provides name resolution for this address.

The following command line options may be used with the program:

• -u <user-name> --- Specifies the user name for autologin. Must be used together with -p

• -p <password> --- Specifies the password for autologin. Must be used together with -u

• -l <look-and-feel> --- Lets you set the "look and feel" of the user interface to one of several definitions. Accepted values are: Aero, Fast, Aluminium, McWin, Luna, Pulsar, Noire, Mint, Graphite, Smart, Bernstein, Acryl and HiFi.

• -n 1 -n 2 -n 3 --- Tells the client how to treat "new faults". Without the -n option, new faults are not reported separately. The fault indicator in the main window's toolbar ia active while the server's summary fault is active.

  • n1 --- The program treats new faults separately. A fault is new until an operator acknowledges it by clicking into the fault indicator or by acknowledging the fault in the event log or event report window. The new fault is displayed as a red mark labeled "NEW FAULT". If the fault disappears without being acknowledged, a gray "NEW FAULT" mark is shown.
  • n2 --- Behaves like -n 1 , but makes the program ring the keyboard bell while a new fault is pending.
  • n3 --- Works like the previous, but suppresses the very first "NEW FAULT" after the start of the client. New faults which occurred while the client program did not run are not signalled, nor are gray "NEW FAULT" conditions. Only new faults recognized while the client program runs are shown.

• -s <service-definition> --- Tells the client to use another service definition file than 'default.xml'. The service definition file must be placed in the ~/sclient directory at the M&C server

• -o --- Enables automatic pop ups of the fault list window with every new fault.

• -r <seconds> --- Enables the automatic reconnect feature. Should not be used directly, the MasterClient application makes use of this switch.

• -d <r,g,b> --- Sets the foreground color of disabled texts / elements in the GUI. r,g,b are numbers in the range 0..255, comma separated, specifying the RGB components of the color.

• -v --- Suppresses the program version match check on startup

• -V --- Tells the program to be verbose on the command line. This option is for debugging only, never set it for operational use.

VioIP Client

The VioIPClient client program is invoked by a command line looking like this:

java -cp client.jar satnms3.vioip.VioIPClient [options ...] <IP address of the server>

The IP address of the M&C server may be replaced by a host name if your network installation provides name resolution for this address.

The following command line options may be used with the program:

• -u <user-name> --- Specifies the user name for autologin. Must be used together with -p

• -p <password> --- Specifies the password for autologin. Must be used together with -u

• -g <group-ip> --- Defines the group to be displayed by this client instance. Expects the group ID (not the name) as a parameter. This parameter is mandatory to make the program work, the group ID cannot be set or changed at the GUI.

• -l <look-and-feel> --- Lets you set the "look and feel" of the user interface to one of several definitions. Accepted values are: Aero, Fast, Aluminium, McWin, Luna, Pulsar, Noire, Mint, Graphite, Smart, Bernstein, Acryl and HiFi.

• -n 1 -n 2 -n 3 --- Tells the client how to treat "new faults". Without the -n option, new faults are not reported separately. The fault indicator in the main window's toolbar ia active while the server's summary fault is active.

  • n1 --- The program treats new faults separately. A fault is new until an operator acknowledges it by clicking into the fault indicator or by acknowledging the fault in the event log or event report window. The new fault is displayed as a red mark labeled "NEW FAULT". If the fault disappears without being acknowledged, a gray "NEW FAULT" mark is shown.
  • n2 --- Behaves like -n 1 , but makes the program ring the keyboard bell while a new fault is pending.
  • n3 --- Works like the previous, but suppresses the very first "NEW FAULT" after the start of the client. New faults which occurred while the client program did not run are not signalled, nor are gray "NEW FAULT" conditions. Only new faults recognized while the client program runs are shown.

• -q --- Suppresses some alerts like 'connection broken' and others.

• -r <seconds> --- Enables the automatic reconnect feature. Should not be used directly, the MasterClient application makes use of this switch.

• -d <r,g,b> --- Sets the foreground color of disabled texts / elements in the GUI. r,g,b are numbers in the range 0..255, comma separated, specifying the RGB components of the color.

• -v --- Suppresses the program version match check on startup

• -V --- Tells the program to be verbose on the command line. This option is for debugging only, never set it for operational use.

VioIP Configurator

The VioIPConfigurator program usually is invoked with a button click from the VioIPClient program. Beside this, it also may be invoked as a stand alone program by a command line looking like this:

java -cp client.jar satnms3.vioip.VioIPConfigurator [options ...] <IP address of the server>

The IP address of the M&C server may be replaced by a host name if your network installation provides name resolution for this address.

The following command line options may be used with the program:

• -u <user-name> --- Specifies the user name for autologin. Must be used together with -p
• -p <password> --- Specifies the password for autologin. Must be used together with -u
• -s --- Suppresses the splash screen.
• -l <look-and-feel> --- Lets you set the "look and feel" of the user interface to one of several definitions. Accepted values are: Aero, Fast, Aluminium, McWin, Luna, Pulsar, Noire, Mint, Graphite, Smart, Bernstein, Acryl and HiFi.
• -q --- Suppresses some alerts like 'connection broken' and others.
• -d <r,g,b> --- Sets the foreground color of disabled texts / elements in the GUI. r,g,b are numbers in the range 0..255, comma separated, specifying the RGB components of the color.
• -v --- Suppresses the program version match check on startup
• -V --- Tells the program to be verbose on the command line. This option is for debugging only, never set it for operational use.

CDB Table Editor

The CDB Table Editor program usually is invoked with a button click from the M&C Client program. Beside this, it also may be invoked as a stand alone program by a command line looking like this:

java -cp client.jar satnms3.gui.CDBTableEditor [options ...] <IP address of the server>

The IP address of the M&C server may be replaced by a host name if your network installation provides name resolution for this address.

The following command line options may be used with the program:

• -u <user-name> --- Specifies the user name for autologin. Must be used together with -p
• -p <password> --- Specifies the password for autologin. Must be used together with -u
• -s --- Suppresses the database selector widget in the toolbar.
• -l <look-and-feel> --- Lets you set the "look and feel" of the user interface to one of several definitions. Accepted values are: Aero, Fast, Aluminium, McWin, Luna, Pulsar, Noire, Mint, Graphite, Smart, Bernstein, Acryl and HiFi.
• -db <db-name> --- Selects the database to be edited. Default is 'channels'.