hszterm(8) hszterm(8)
NAME
hszterm - Steuerungsprogramm für den Platten-Array-Controller
SY12/PXRC
SYNTAX
hszterm [options] [commands]
BESCHREIBUNG
Das Kommando hszterm startet entweder eine virtuelle Terminalsitzung
mit dem Controller SY12/PXRC oder sendet Kommandos an diesen Control-
ler, wobei die Ausgabe dieser Kommandos an die Standardausgabe gelei-
tet wird. Die gesamte Kommunikation zwischen hszterm und dem Control-
ler SY12/PXRC erfolgt über den SCSI-Bus.
Zur Ausführung von hszterm muß ein Gerät angegeben werden, das eine
der Einheiten auf dem SY12/PXRC darstellt. Hierzu kann über die Option
-f der Pfad für das Gerät angegeben werden.
Wenn keine zusätzlichen Argumente angegeben werden, startet hszterm
eine virtuelle Terminalsitzung für den SY12/PXRC. Die Sitzung und das
Programm können durch die Eingabe des Zeichens EOF beendet werden.
Wenn zusätzliche Argumente angegeben werden, verwendet hszterm die
verbleibenden Argumente in der Kommandozeile als Kommandos, die an den
HSZ gesendet werden sollen. Wenn das zu sendende Kommando aus mehreren
Wörtern besteht, muß es in Anführungszeichen gesetzt werden.
OPTIONEN
-f special
Zeichenorientierter Gerätename logischer Einheiten von SY12/PXRC.
Wenn keine logischen Einheiten definiert sind, können statt des-
sen die Bus- und die Zielnummer angegeben werden.
-o logfile
Den Namen einer optionalen Protokolldatei angeben. Vom SY12/PXRC
empfangene Meldungen sowie an diesen Controller gesendete Meldun-
gen werden an diese Datei angehängt.
-h Eine kurze Hilfemeldung ausgeben.
-v Die Stufe für die ausführliche Anzeige einstellen. hszterm kann
so eingestellt werden, daß seine Aktionen mit einer umfangrei-
chen, normalerweise überflüssigen, Ausgabe durchgeführt werden.
Mit dieser Option kann die Stufe für die ausführliche Anzeige der
zusätzlichen Ausgabe eingestellt werden.
-l Zeigt alle konfigurationsspezifischen Daten über RAID-Controller
bzw. Magnetplatten des PXRC an. Diese Informationen sollten nach
der erstmaligen Inbetriebnahme oder Änderung der Konfiguration
abgespeichert werden. Diese Daten werden sinnvollerweise nicht
auf dem RAID-System abgelegt, weil sie beim Verlust beider Con-
troller benötigt werden, um die aktuelle Konfiguration und damit
Seite 1 Reliant UNIX 5.44 Gedruckt 11/98
hszterm(8) hszterm(8)
die Daten wieder herzustellen.
BESCHRÄNKUNGEN
Das Kommando hszterm beschränkt den Zugriff auf die SY12/PXRC-Pro-
gramme, die mit dem Kommando run verwendet werden können. Die Gruppe
zulässiger Kommandos kann über die Umgebungsvariable HSZTERMRUN ein-
gestellt werden. Hierbei handelt es sich um eine durch Kommas
getrennte Liste der Kommandos, die der Benutzer ausführen möchte. Wenn
keine Liste angegeben ist, besteht die Standardliste aus CONFIG, FLS,
FMU, CLCP und CLONE. CFMENU, VTDPY, DILX oder TILX können selbst dann
nicht ausgeführt werden, wenn sie in der durch die Umgebungsvariable
HSZTERMRUN angegebenen Liste enthalten sind.
DIAGNOSE
Den meisten Fehlermeldungen ist die Zeichenkette HSZterm vorange-
stellt. Die Fehlermeldungen werden in drei allgemeine Kategorien
unterteilt: SCSI-Kommunikationsfehler, Fehler in Verbindung mit dem
virtuellen Terminal und andere Fehler.
Getopt got confused
Mit der Bibliotheksfunktion getopt(3C) wird die Kommandozeile
analysiert. Diese Meldung wird bei der Verwendung einer nichter-
kannten Option ausgegeben.
Can't open %s: %s.
Wenn hszterm /dev/cam bzw. die Gerätedatei des SY12/PXRC nicht
öffnen kann, wird diese Meldung ausgegeben. Darüber hinaus wird
die dem Fehler entsprechende Systemmeldung ausgegeben.
Can't open %s for logging: %s.
Wenn hszterm die Protokolldatei nicht öffnen kann, wird diese
Meldung ausgegeben.
Can't close %s: %s.
hszterm versucht alle geöffneten Dateien zu schließen, bevor es
beendet wird. Wenn eine der Dateien nicht geschlossen werden
kann, wird diese Meldung mit dem Namen der Datei sowie der ent-
sprechenden Systemfehlermeldung ausgegeben.
No device selected. Select a device and try again.
Diese Meldung wird ausgegeben, wenn kein Gerät ausgewählt wurde.
Die folgenden Meldungen kennzeichnen Fehler im Protokoll des virtuel-
len Terminals, das für die Kommunikation mit dem SY12/PXRC verwendet
wird.
Device does not support Virtual Terminal protocol.
Failed to send response to remote program.
Failed to receive message.
Seite 2 Reliant UNIX 5.44 Gedruckt 11/98
hszterm(8) hszterm(8)
BEISPIELE
Dieses Beispiel sendet das Kommando "show devices full" an den
SY12/PXRC, von dem angenommen wird, daß er der Gerätedatei
/dev/ios0/rsraid040 entspricht.
# hszterm -f /dev/ios0/rsraid040 "show devices full"
Dieses Beispiel beschränkt die Liste der ausführbaren Kommandos auf
CONFIG, CLONE und FLS.
# setenv HSZTERMRUN CONFIG,CLONE,FLS
Es kann immer nur eine hszterm-Sitzung für einen SY12/PXRC existieren.
Seite 3 Reliant UNIX 5.44 Gedruckt 11/98