Einsatzhinweis
Funktion: Messwerte anzeigen
Benutzergruppe: FT-Benutzer und FT-Verwalter
Aliasname: FTSHWMON
Funktionsbeschreibung
Mit dem Kommando SHOW-FT-MONITOR-VALUES können Sie sich auf dem lokalen System die Messwerte des FT-Betriebs ausgeben lassen. Dazu muss die Messdatenermittlung eingeschaltet sein (siehe MODIFY-FT-OPTIONS-Kommando) und openFT aktiviert sein.
Format
SHOW-FT-MONITOR-VALUES / FTSHWMON |
NAME = *STD / *ALL /<list-poss(100): alphanum-name 1..12> ,POLLING = *NONE / *PARAMETERS(...) *PARAMETERS(...) INTERVAL= 1 /<integer 1..600> ,NUMBER= *UNLIMITED / <integer 1..3600> ,INFORMATION= *VALUES (...) / *TYPE *VALUES(...) DATA= *FORMATTED / *RAW ,OUTPUT= *SYSOUT (...) / *SYSLST(...) *SYSOUT(...) / *SYSLST(...) LAYOUT = *STD / *CSV |
Beschreibung der Operanden
NAME =
Gibt an, welche Messwerte ausgegeben werden sollen.
NAME = *STD
Es wird eine vordefinierte Standardmenge von Messwerten ausgegeben, siehe Beispiele für Messwerte.
NAME = *ALL
Es werden alle Messwerte ausgegeben.
NAME = <list-poss(100): alphanum-name 1..12>
Hier können Sie eine Liste von bis zu 100 Namen von Messwerten angeben, die ausgegeben werden sollen. Der Name muss einer der Kurznamen sein, siehe Tabelle im Abschnitt Beschreibung der Messwerte.
POLLING =
Gibt an, wie oft die Abfrage der Messwerte wiederholt werden soll.
POLLING = *NONE
Die Messwerte werden nur einmal abgefragt.
POLLING =*PARAMETERS
Mit dieser Struktur geben Sie ein Zeitintervall und einen Wiederholungsfaktor für die Abfrage der Messwerte an. Führt eine Abfrage zu einem Fehler, dann wird die wiederholte Ausgabe abgebrochen.
INTERVAL = 1
Das Zeitintervall für die Abfrage der Messwerte beträgt 1 Sekunde.
INTERVAL = <integer 1..600>
Zeitintervall in Sekunden für die Abfrage der Messwerte.
NUMBER = *UNLIMITED
Die Messwerte sollen beliebig oft abgefragt werden. Durch Abbrechen der Ausgabe mit K2 beenden Sie das Kommando.
NUMBER = <integer 1..3600>
Hier geben Sie an, wie oft die Messwerte abgefragt werden sollen.
INFORMATION =
Gibt an, ob die Messwerte selbst oder der Typ der Messwerte ausgegeben werden sollen.
INFORMATION = *VALUES(...)
Der gemessene Wert wird ausgegeben. Sie können angeben, ob die Messwerte aufbereitet oder als Rohdaten ausgegeben werden sollen.
DATA = *FORMATTED
Die Messwerte werden zur Darstellung aufbereitet, z.B. als Durchsatz, Maximum oder Durchschnitt.
DATA =*RAW
Es werden unaufbereitete Rohdaten ausgegeben. Messwerte zur Dauer einer Aktion werden nicht ausgegeben.
INFORMATION = *TYPE
Gibt den Typ und ggf. Skalierungsfaktor des Messwertes bzw. den Typ der Metadaten aus.
Der Skalierungsfaktor ist nur bei einigen Messwerten und im CSV-Format ohne Angabe von *RAW von Belang. Dort muss der ausgegebene Wert durch den Skalierungsfaktor geteilt werden, um die echte Größe zu ermitteln. Bei aufbereiteten Daten im Tabellenformat gibt der Skalierungsfaktor 100 an, dass die Zahl mit 2 Stellen hinter dem Dezimalpunkt ausgegeben wird.
Folgende Ausgabewerte sind bei *TYPE möglich:
*BOOL | Schalterwert |
*PERCENT | Prozentsatz |
*INT | Zahlenwert (entspricht *INT(1)) |
*INT(100) | Zahlenwert mit Skalierungsfaktor 100 |
*TIME | Zeitstempel |
*STRING | Textausgabe der gewählten Selektion |
OUTPUT =
Ausgabemedium.
OUTPUT = *SYSOUT (...)
Die Ausgabe erfolgt auf SYSOUT.
OUTPUT = *SYSLST(...)
Die Ausgabe erfolgt auf SYSLST.
LAYOUT = *STD
Die Ausgabe wird in eine vom Anwender lesbare Form gebracht.
Wechselt die Konfiguration der Messwerterfassung (Filterung), dann wird im Standardausgabeformat eine neue Überschrift mit einer neuen Startzeit der Erfassung ausgegeben.
LAYOUT = *CSV
Die Ausgabe erfolgt im Character Separated Values Format. Dies ist ein speziell im PC-Umfeld weit verbreitetes, tabellenartiges Format, bei dem die einzelnen Felder durch das Separatorenzeichen Semikolon “;“ getrennt sind (siehe Abschnitt SHOW-FT-MONITOR-VALUES).
Wechselt die Konfiguration der Messwerterfassung (Filterung), dann können Sie im CSV-Format die neue Startzeit der Erfassung aus einer eigenen Spalte entnehmen.
Kommando-Returncodes
(SC2) | SC1 | Maincode | Bedeutung |
51 | 32 | CMD0221 | Interner Fehler. |
88 | 32 | CMD0221 | Fehler bei OPS-Ausgabe. |
1 | 0 | FTR1039 | openFT nicht aktiv |
59 | 64 | FTR1059 | Monitoring ist nicht aktiv. |
2 | 0 | FTR2225 | Informationsausgabe abgebrochen. |
SC1/2 = Subcode 1/2 in Dezimal-Darstellung Zusätzliche Informationen finden Sie im Abschnitt „Kommando-Returncodes“. | |||
OPS-Variablen
Die folgende Tabelle zeigt die OPS-Variablen des Kommandos SHOW-FT-MONITOR-VALUES, die mit dem Operanden NAME = *ALL ausgegeben werden. Die fett gedruckten Werte gelten auch für die Ausgabe mit dem Operanden NAME = *STD.
Element | Typ | Ausgabe |
CURRENT | Struct | |
.DATE | String | yyyy-mm-dd |
.TIME | String | hh:mm:ss |
MON-START | Struct | |
.DATE | String | yyyy-mm-dd |
.TIME | String | hh:mm:ss |
PARTNER-SEL | Struct | |
.OPENFT | String | *YES / *NO |
.FTAM | String | *YES / *NO |
.FTP | String | *YES / *NO |
REQUEST-SEL | Struct | |
.ASYNC | String | *YES / *NO |
.SYNC | String | *YES / *NO |
.LOCAL | String | *YES / *NO |
.REMOTE | String | *YES / *NO |
THROUGHPUT | Struct | |
.NET-BYTES-TOTAL | String | Wert |
.NET-BYTES-SEND | String | Wert |
.NET-BYTES-RCV | String | Wert |
.NET-BYTES-TEXT | String | Wert |
.NET-BYTES-BIN | String | Wert |
.DISK-TOTAL | String | Wert |
.DISK-SEND | String | Wert |
.DISK-RCV | String | Wert |
.DISK-TEXT | String | Wert |
.DISK-BIN | String | Wert |
.REQ-TOTAL | String | Wert |
.REQ-F-TRANS | String | Wert |
.REQ-F-MANAG | String | Wert |
.REQ-SUCC | String | Wert |
.REQ-ABORT | String | Wert |
.REQ-INTR | String | Wert |
.ADMIS-FAIL | String | Wert |
.FOLLOWUP | String | Wert |
.CONN-SUCC | String | Wert |
.CONN-FAIL | String | Wert |
.CONN-ABORT | String | Wert |
DURATION | Struct | |
.REQ-TOTAL-OUTB | String | Wert |
.REQ-TOTAL-INB | String | Wert |
.REQ-F-TRANS-OUTB | String | Wert |
.REQ-F-TRANS-INB | String | Wert |
.REQ-F-MANAG-OUTB | String | Wert |
.REQ-F-MANAG-INB | String | Wert |
.REQ-WAIT | String | Wert |
.DNS-OUTB | String | Wert |
.DNS-INB | String | Wert |
.CONN-ESTABL | String | Wert |
.F-OPEN-OUTB | String | Wert |
.F-OPEN-INB | String | Wert |
.F-CLOS-OUTB | String | Wert |
.F-CLOS-INB | String | Wert |
.ADMIS-CHECK-OUTB | String | Wert |
.ADMIS-CHECK-INB | String | Wert |
STATE | Struct | |
.NUM-REQ-ACT-ASYN | String | Wert |
.NUM-REQ-ACT-SYN | String | Wert |
.NUM-REQ-WAIT | String | Wert |
.NUM-REQ-HOLD | String | Wert |
.NUM-REQ-SUSPEND | String | Wert |
.NUM-REQ-LOCK | String | Wert |
.NUM-REQ-FINISH | String | Wert |
.CONN-LIM | String | Wert |
.NUM-CONN-ACT | String | Wert |
.REQ-LIM | String | Wert |
.NUM-REQ-QUEUE | String | Wert |
.OPENFT-ACT | String | Wert |
.FTAM-ACT | String | Wert |
.FTP-ACT | String | Wert |
.TRACE | String | Wert |