Enterprise RTView® 
User Guide


Define System Command

From the Object Properties window you can access the Define System Command dialog. This dialog is used to assign system commands allowing you to issue commands from within an Enterprise RTView display. 

To bring up the Define System Command dialog, right-click on the appropriate command property in the Object Properties window and select Define Command>SYSTEM. The Define System Command dialog provides a drop down menu with available commands. Argument fields vary based on the selected command type. See the Object Commands section for information on how to execute a command.
 

Command Types

 
Command Type Description
Beep Plays the system default audio beep. This command does not work in the Display Server. If you execute this command from one of the Served Data deployments, this command will execute on the client.
Close Window Closes the window specified in the Window Name argument.  If no Window Name is given it closes the window containing the object that generated the command. This command cannot be used to close the main window. If you execute this command from a Thin Client with Direct Data Connection or any Served Data deployment, this command will execute on the client.
Drill Down or Set Substitution Drill down to a new display or set substitutions on the current display. Click on Edit Drill Down Target to define your drill down or substitution. If you execute this command from a Thin Client with Direct Data Connection or any Served Data deployment, this command will execute on the client.
NOTE: Substitutions are not applied to this command before it is executed. 
Execute Custom Command Executes the custom command in the Command Name field with the specified Command Value. You may define your own custom commands in the Custom Command Handler. The specified Command Name and Command Value will be passed into the invokeCommand method in the Custom Command Handler. If you execute this command in a Thin Client deployment, it will execute on the server if implemented in Java and on the client if implemented in JavaScript. If you execute this command from from one of the Served Data deployments, this command will execute on the server. Otherwise, this command executes on the client.
Execute URL Executes the specified URL String. This can be used to execute JSP, ASP or CGI scripts. This command will not open the specified URL in a browser. If you execute this command from a Thin Client with Direct Data Connection or any Served Data deployment, this command will execute on the client.
Open Browser Opens the specified URL in a browser window. Select Current, Parent, Top, New, or Named in the Browser Window property to set which window the page will come up in. New is the default setting. If you execute this command from a Thin Client with Direct Data Connection or any Served Data deployment, this command will execute on the client.
Play Audio File Plays the specified audio file. The File Name should include a relative path from your Enterprise RTView display to the audio file. This command does not work in the Display Server. If you execute this command from one of the Served Data deployments, this command will execute on the client.
Run DOS Command or UNIX Shell Executes the specified DOS command or UNIX Shell. This will be executed in the directory where you started Enterprise RTView. This command does not work in the Display Viewer Applet or in the Display Server.
Send Email Sends the specified email message. Contact your system administrator for SMTP Host detail. Separate multiple addresses or attachments with spaces or commas. User and Password fields are optional, unless authenticated mail sever access is required. This command executes on the server.

NOTE: This command requires additional setup when used with the Display Viewer Applet. Email attachments are not supported in the Display Viewer Applet.   

Send SNMP Trap Enables a display to send an SNMP Trap message, such as would be sent from an SNMP Agent to a SNMP Management Station. Requires outgoing access to UDP port 162 (or a different port as specified in your command). NOTE: If you execute this command from a thin-client deployment it will execute on the server, otherwise it will execute on the client.

Use the following fields to define your SNMP Trap Message:

  Field Name Description
  Trap Type SNMP version of the trap.
  Destination Address System name or IP address of the receiving system.  Default value is 127.0.0.1 (localhost).
  Destination Port UDP port on the receiving system.  Default value is 162.  Value must be an integer greater than 0.
  Community Name SNMPv2 Community Name string.  Default value is public.
  Enterprise OID SNMP Object ID to be used as the sender's Enterprise.  Default value is 1.3.6.1.6.3.1.1.5.
  Generic Trap List of generic traps.
  Specific Trap If Generic Trap is EnterpriseSpecific, enter an integer value.

 


Substitutions
Substitutions allow you to build open-ended displays in which commands depend on values defined at the time the display is run. Generic names are used instead of arguments for specific commands. Later when the display is running, these generic values are defined by the actual arguments. In this way, a single display can be reused to issue a number of different commands. Substitutions are not applied to Drill Down or Set Substitution commands. For more information on creating displays using substitution values, see Substitutions.


Special Values
 
$value When an actionCommand is executed $value is replaced with the value from the control. This value may be used in any field in the Define System Command dialog. NOTE: This value may only only be used for Action Commands


The following describes Define System Command dialog commands:
 
Command Description
OK Applies values and closes the dialog.
Apply Applies values without closing the dialog.
Reset Resets all fields to last values applied.
Clear Clears all fields. Detaches object from assigned command (once Apply or OK is selected).
Cancel Closes the dialog with last values applied.
 


 
Enterprise RTView contains components licensed under the Apache License Version 2.0.

 

Treemap Algorithms v1.0  is used without modifications and licensed by MPL Version 1.1. Copyright © 2001 University of Maryland, College Park, MD

 

Datejs is licensed under MIT. Copyright © Coolite Inc.

 

JCalendar 1.3.2 is licensed under LGPL. Copyright © Kai Toedter.

 

jQuery is licensed under MIT. Copyright © John Resig,

 
JMS, JMX and Java are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries. They are mentioned in this document for identification purposes only. 

 
SL, SL-GMS, GMS, Enterprise RTView, SL Corporation, and the SL logo are trademarks or registered trademarks of Sherrill-Lubinski Corporation in the United States and other countries. Copyright © 1998-2009 Sherrill-Lubinski Corporation. All Rights Reserved.