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. |
|