sihadm(1M) (Nur RM400) sihadm(1M)
NAME
sihadm - SIH-Monitor verwalten
SYNTAX
/usr/sbin/sihadm -d admdev -a adjust [-l ttylab -k linklab] [-p 'cmd']
/usr/sbin/sihadm -I [svctag] pmtag
/usr/sbin/sihadm -R [svctag] pmtag
/usr/sbin/sihadm -S [svctag] pmtag
/usr/sbin/sihadm -T level pmtag
/usr/sbin/sihadm -v type
/usr/sbin/sihadm -V
/usr/sbin/sihadm -h|-?
BESCHREIBUNG
Das Kommando sihadm soll das Verwalten von SIH-Monitoren [siehe
sihmon(1M)] erleichtern. Die Service Access Facility (SAF) fordert,
daß für jeden Monitor solch ein Kommando bereitgestellt wird. Die
Administrationstabelle des SIH-Monitors (pmtab) wird durch die
Service-Access-Controller-Kommandos (SAC-Kommandos) sacadm(1M) und
pmadm(1M) verwaltet. sihadm erzeugt neben zusätzlichen Funktionen eine
formatierte Ausgabe für diese Kommandos.
Unter einem Port im Sinne von SAF soll im folgenden ein Link des SIH-
Treibers verstanden werden. Die Konfiguration eines Links wird durch
einen Eintrag in der pmtab-Datei festgelegt. Ein solcher Eintrag wird
durch einen eindeutigen Namen (SIH-Monitor-Service-Kennung) identifi-
ziert.
Das sihadm-Kommando beinhaltet folgende Funktionen:
- formatierte, SIH-Monitor-spezifische Ausgabe
- Lade-Modus im SIH-Treiber setzen (-I)
- Lade-Modus im SIH-Treiber zurücksetzen (-R)
- Statusausgabe der vom SIH-Monitor überwachten Links (-S)
- Einstellen des SIH-Monitor-Trace-Levels (-T)
- Ausgabe der erwarteten Versionskennungen der für ein korrektes
Zusammenspiel beteiligten Programme und Konfigurationsdateien (-V
und -v)
- Ausgabe des Gebrauchs (-h und -?)
Seite 1 Reliant UNIX 5.44 Gedruckt 11/98
sihadm(1M) (Nur RM400) sihadm(1M)
Bei korrekter Bedienung werden alle Ausgaben auf stdout ausgegeben.
Fehlermeldungen bzw. der Gebrauch des Kommandos werden auf stderr aus-
gegeben.
Die Verwendung der Optionen -I, -R, -S und -T ist nur mit root-Berech-
tigung möglich.
OPTIONEN
-d admdev
Diese Option legt den absoluten oder relativen Pfadnamen des
Link-spezifischen Admin-Devices des SIH-Treibers fest.
-a adjust
Diese Option legt den Zeitpunkt und die Art und Weise der Parame-
tereinstellung durch den SIH-Monitor fest. Für das Argument
adjust ist genau eines der folgenden Zeichen erlaubt:
c Nach jedem Wiedereinschalten eines HDLC-Gerätes, sowie beim
Übergang des SIH-Monitors in den Zustand enabled werden
zunächst die aktuell eingestellten HDLC-Parameter aus dem
SIH-Treiber gelesen und gespeichert.
Anschließend werden die Standard-HDLC-Parameter eingestellt
und das Ladeprogramm 'cmd' aufgerufen. Nach erfolgreicher
Beendigung des Ladevorganges werden die zuvor gespeicherten
HDLC-Parameter im SIH-Treiber zurückgestellt (current).
Die Standard-HDLC-Parameter werden also nur für den Ladevor-
gang eingestellt. Die aktuellen HDLC-Parameter bleiben erhal-
ten. Diese Einstellung ist nur für ladbare HDLC-Geräte sinn-
voll.
e Die Standard-HDLC-Parameter werden nach jedem Wiedereinschal-
ten eines HDLC-Gerätes sowie beim Übergang des SIH-Monitors in
den Zustand enabled eingestellt (ever).
o Die Standard-HDLC-Parameter werden beim Übergang des SIH-
Monitors in den Zustand enabled eingestellt. Im Normalbetrieb
tritt dieser Fall nur einmalig nach dem Start des SIH-Monitors
auf (once).
n Die Standard-HDLC-Parameter werden nie eingestellt (never). In
diesem Fall ist die Angabe der Optionen -l und -k überflüssig.
-l ttylab
Mit dieser Option wird eine Marke angegeben, die auf einen Ein-
trag in /etc/ttydefs verweist. Aus dem Eintrag ermittelt der
SIH-Monitor die Leitungsgeschwindigkeit. Die Angabe der Option
ist zwingend, wenn die Optionen -ac, -ae oder -ao verwendet wer-
den.
Seite 2 Reliant UNIX 5.44 Gedruckt 11/98
sihadm(1M) (Nur RM400) sihadm(1M)
-k linklab
Mit dieser Option wird eine Link-Marke angegeben, die auf einen
Eintrag für Link-spezifische HDLC-Parameter in /etc/hdlcdefs ver-
weist. Die Angabe der Option ist zwingend, wenn die Optionen -ac,
-ae oder -ao verwendet werden.
-p 'cmd'
Mit dieser Option wird der vollständige Aufruf eines Ladepro-
gramms für angeschlossene HDLC-Geräte angegeben. Da die Optionen
und Argumente des Ladeprogrammes von den sihadm-Optionen unter-
schieden werden müssen, muß das Argument cmd in einfache Hochkom-
mata (') eingeschlossen werden.
Die Angabe der Option ist zwingend, wenn die Option -ac verwendet
wird.
-I [svctag] pmtag
Mit dieser Option wird der Lade-Modus eines Admin-Devices des
SIH-Treibers eingestellt. Das gewünschte Admin-Device wird aus
der pmtab-Tabelle des SIH-Monitors pmtag mit dem SIH-Monitor-
Service-Kennung svctag ermittelt.
Wird svctag weggelassen, so werden alle Einträge in der pmtab-
Tabelle berücksichtigt.
Der Lade-Modus wird nicht gesetzt, wenn der entsprechende Link
bereits von einem SIH-Monitor überwacht wird. In diesem Fall wird
eine Warnung auf stderr ausgegeben.
-R [svctag] pmtag
Mit dieser Option wird der Lade-Modus eines Admin-Devices des
SIH-Treibers zurückgesetzt. Das gewünschte Admin-Device wird aus
der pmtab-Tabelle des SIH-Monitors pmtag mit dem SIH-Monitor-
Service-Kennung svctag ermittelt.
Wird svctag weggelassen, so werden alle Einträge in der pmtab-
Tabelle berücksichtigt.
Der Lade-Modus wird nicht zurückgesetzt, wenn der entsprechende
Link bereits von einem SIH-Monitor überwacht wird. In diesem Fall
wird eine Warnung auf stderr ausgegeben.
-S [svctag] pmtag
Mit dieser Option wird der Status des vom SIH-Monitor pmtag über-
wachten Links svctag auf stdout ausgegeben. Wird svctag weggelas-
sen, so wird der Status vom SIH-Monitor selbst sowie der Status
von allen Links ausgegeben, die dem SIH-Monitor bekannt sind.
Durch das Kommando wird der entsprechende SIH-Monitor aufgefor-
dert, die Statusdatei /var/saf/pmtag/state zu schreiben. Die
genannten Informationen werden dieser Datei entnommen.
Seite 3 Reliant UNIX 5.44 Gedruckt 11/98
sihadm(1M) (Nur RM400) sihadm(1M)
-T level pmtag
Mit dieser Option kann der Trace-Level des SIH-Monitors mit dem
Namen pmtag verändert werden. Das Argument level gibt den Trace-
Level an:
0 keine Ausgaben (Trace ausgeschaltet, Standard)
1 Ausgabe von Fehlermeldungen und wichtigen Ablaufmeldungen
2 zusätzliche Ausgabe von detaillierten Ablaufmeldungen
-V Diese Option gibt die Versionskennung des Formates der pmtab-
Datei aus, die für die entsprechende Version des sihadm-Kommandos
und des sihmon(1M)-Kommandos erwartet wird (siehe die Optionen
-va und -vm).
Die Ausgabe erfolgt auf stdout ohne Zeilenvorschub. Sie ist mit
der Ausgabe des Kommandos sihadm -vp identisch.
-v type
Diese Option gibt die Versionskennungen der beteiligten Programme
und Konfigurationsdateien aus, die für ein korrektes Zusammen-
spiel erwartet werden. Das Argument type darf einen der folgenden
Werte annehmen:
a Ausgabe der sihadm-Versionskennung
m Ausgabe der erwarteten sihmon-Versionskennung
p Ausgabe der erwarteten pmtab-Versionskennung
t Ausgabe der erwarteten ttydefs-Versionskennung
d Ausgabe der erwarteten hdlcdefs-Versionskennung
l Ausgabe der erwarteten hdlclabs-Versionskennung
x Ausgabe der oben aufgeführten Versionskennungen in einem Block
Die sihadm- und sihmon-Versionskennung ist mit der Versionsken-
nung des entsprechenden SIsih-Pakets identisch.
Bis auf die Option -vx erfolgen alle Ausgaben ohne Zeilenvorschub
auf stdout.
-h | -?
Liefert Informationen über den Gebrauch des sihadm-Kommandos auf
stderr.
pmtag
ist der Name einer SIH-Monitor-Ausprägung.
Seite 4 Reliant UNIX 5.44 Gedruckt 11/98
sihadm(1M) (Nur RM400) sihadm(1M)
svctag
ist der Name eines SIH-Monitor-pmtab-Eintrages, mit dem ein Link
beschrieben wird, den der SIH-Monitor überwacht (SIH-Monitor-
Service-Kennung).
HINWEISE
Die formatierte, SIH-Monitor-spezifische Ausgabe sowie die Ausgabe des
-V-Kommandos erfolgen ohne Zeilenvorschub. Sie eignen sich insbeson-
dere für das Anlegen einer SIH-Monitor-Ausprägung mittels sacadm -a
und für die Erzeugung von pmtab-Einträgen mittels pmadm -a. Wird beim
Aufruf pmadm -a die Option -p des sihadm-Kommandos nicht verwendet, so
sorgt der aktivierte SIH-Monitor nur für die entsprechende HDLC-Para-
metereinstellung, veranlaßt aber keinen Ladevorgang.
Die Optionen -S und -T kommunizieren mit der aktuellen SIH-Monitor-
Ausprägung pmtag. Der zugehörige SIH-Monitor-Prozeß muß deshalb
gestartet sein.
Die Optionen -I und -R beeinflussen die spätere Kommunikation einer
SIH-Monitorausprägung mit dem SIH-Treiber. Ein entsprechender SIH-
Monitor-Prozeß darf nicht gestartet sein.
Die Option -I sollte beim Hochfahren des Systems vor dem Start des SAC
für alle zu überwachenden Links aufgerufen werden. Dadurch wird
sichergestellt, daß sich der SIH-Treiber im Lade-Modus befindet, bevor
ein Benutzerkanal (Multi-Device) am SIH-Treiber eröffnet wird.
Die Standard-HDLC-Parameter bestehen aus Line- und Link-spezifischen
HDLC-Parametern aus der hdlcdefs-Datei und werden mit Hilfe der Link-
Marke, des Admin-Devices und der hdlclabs-Datei ermittelt.
DIAGNOSE
Die Ausgabe des Aufrufs sihadm -S svctag pmtag hat folgendes Format:
service tag svctag -- internalstate [reason]
Das Feld internalstate gibt den internen Zustand des Links svctag an.
Folgende Einträge sind möglich:
ENABLED Der Link wird überwacht. Es ist kein Fehler aufgetreten
(Normalfall).
LOADING Für den Link ist zur Zeit ein Ladevorgang aktiv.
ONRETRY Für den Link ist ein Vorgang fehlgeschlagen (z. B. das Laden
eines HDLC-Gerätes mit einem Platzprogramm) und wird nach
Ablauf eines Zeitintervalls wiederholt [siehe sihmon(1M)].
Der Grund dafür kann dem nachfolgenden Fehlertext reason
entnommen werden.
DISABLED Für den Link wurde die Überwachung beendet. Der Grund dafür
kann dem nachfolgenden Fehlertext reason entnommen werden.
Seite 5 Reliant UNIX 5.44 Gedruckt 11/98
sihadm(1M) (Nur RM400) sihadm(1M)
Ein solcher Link kann durch den Aufruf sacadm -x -ppmtag
erneut aktiviert werden, wenn die Fehlerursache beseitigt
wurde.
Bei Verwendung des Aufrufs sihadm -S pmtag wird zusätzlich der Zustand
der SIH-Monitorausprägung mit den aktuell eingestellten Optionen aus-
gegeben. Alle gefundenen SIH-Monitor-Service-Kennungs werden durchnu-
meriert.
Falls kein Fehler auftritt, beendet sich sihadm mit dem Rückgabewert
0. Im Fehlerfall haben die Rückgabewerte folgende Bedeutung:
1 = falsches Argument zu einer Option benutzt (AWRARG)
2 = falsche Kombination von Optionen (AILLOPT)
3 = unbekannter SIH-Monitor-Name pmtag (AUPMTAG)
4 = SIH-Monitor pmtag ist nicht gestartet (ANOTRUN)
5 = Kommando nicht als root ausgeführt (ANOROOT)
6 = unbekanntes admdev bzw. keine Zugriffsrechte (ANODEV)
7 = SIH-Monitor hat keine state-Datei geschrieben (ANOSTATE)
8 = svctag in pmtab nicht enthalten bzw. disabled (ANOSERV)
9 = pmtab kann nicht eröffnet werden (ANOPMTAB)
10 = falsche pmtab-Version (AWPMTAB)
11 = SIH-Monitor pmtag ist aktiv (AISRUN)
12 = falscher SIH-Monitor-Programmname (AWRPNAME)
50 = interner Fehler (AINTERNAL)
DATEIEN
/usr/lib/saf/sihmon
/etc/saf/pmtag/pmtab
/etc/ttydefs
/etc/hdlcdefs
/var/sadm/terms/hdlclabs
/var/saf/pmtag/state
Seite 6 Reliant UNIX 5.44 Gedruckt 11/98
sihadm(1M) (Nur RM400) sihadm(1M)
SIEHE AUCH
pmadm(1M), sac(1M), sacadm(1M), sihmon(1M).
Seite 7 Reliant UNIX 5.44 Gedruckt 11/98