Note on usage
Function: Call the openFT Monitor for displaying measurement data
User group: FT user and FT administrator
Functional description
The ftmonitor command calls the openFT Monitor in which the monitoring data collected during openFT operation is displayed. openFT can be running on the local system or on a remote system. The openFT Monitor can only be called if monitoring has been explicitly activated by the administrator on the relevant system (e.g. using the ftmodo -mon=n command) and the asynchronous openFT has been started.
Note for Unix systems
Note that you require a graphics-capable terminal to use the ftmonitor command.
Format
ftmonitor -h |
[ -lay=<monitor layout file name 1..512> ]
[ -po=<polling interval 1..600> ]
[ <partner 1..200> [
<transfer admission 8..67> |
<user ID 1..67>[,[<account 1..64>][,[<password 1..64>]]] ]]
Description
-h
Outputs the command syntax. Any specifications after -h are ignored.
On Windows systems, the command syntax is output in a separate message box.
-lay=monitor layout file name
Name of the Monitor layout file. This file describes what monitoring data is output and how it is presented.
The name of the layout file must be specified with the suffix .ftmc. This suffix is automatically assigned by the monitor when the file is saved if it was not explicitly specified there.
The content of the layout file is also generated by the Monitor. You must not change the content of the layout file.
After the default Monitor window has been opened for the first time (without specifying -lay), you can create and save your own layout file. To do this, choose a different layout from the View menu of the Monitor window, for instance, or set a different value using the selection icon on the top right and store the setting under a name of your choice. Refer to the online Help system of the openFT Monitor window for details.
-lay not specified
If you do not specify -lay, the default Monitor window is opened. This contains a chart showing the monitoring value Networkb/sec of all Requests (corresponds to the parameter ThNetbTtl in the command ftshwm).
-po=polling interval
Polling interval in seconds.
Possible values: 1 through 600.
Default value: 1
partner
Name or address of the partner system for which monitoring data is to be shown. The partner must be an openFT partner (i.e. communication via the openFT protocol) and must support the collection of monitoring data, i.e. the openFT version of the partner must be at least V11.
In addition, the partner's asynchronous openFT server must be started and monitoring must be activated in its operating parameters.
partner not specified
If you do not specify a partner, the monitoring data of the openFT instance on the local computer is output.
transfer admission | user ID[,[account][,[password]]]
Transfer admission for the partner system. File transfer and preprocessing/postprocessing must be permitted under the specified transfer admission.
You can specify this transfer admission
as an FTAC transfer admission if FTAC is used in the remote system or destination instance. For this purpose, a special admission profile with the filename prefix "|*FTMONITOR " can be set up on the partner system that only permits monitoring data to be collected. You will find an example under ftcrep .
or as a login/LOGON authorization using the syntax of the remote system (user ID, where necessary with account and/or password).
transfer admission not specified
If you do not specify a transfer admission for a remote partner system, the system prompts you for it in a dialog box. The entry made for the password or the FTAC transfer admission remains invisible. Asterisks (*****) are displayed as replacement characters.
Messages from the openFT Monitor
The openFT Monitor issues error messages in the form of a dialog box. It terminates automatically if an error occurs or if monitoring is terminated in the system being monitored.
If the layout of the Monitor window is changed and if openFT is terminated before the changed layout is saved, the openFT Monitor issues a message and queries whether the layout is to be saved.