sacadm(1M) sacadm(1M)
NAME
sacadm - Service Access Controller verwalten
SYNTAX
sacadm -a -p pmtag -t type -c cmd -v ver [-f dx] [-n count]
[-y comment] [-z script]
sacadm -r -p pmtag
sacadm -s -p pmtag
sacadm -k -p pmtag
sacadm -e -p pmtag
sacadm -d -p pmtag
sacadm -l [-p pmtag | -t type]
sacadm -L [-p pmtag | -t type]
sacadm -g -p pmtag [-z script]
sacadm -G [-z script]
sacadm -x [-p pmtag]
BESCHREIBUNG
sacadm ist das Verwaltungskommando für die obere Hierarchiestufe der
Service Access Facility, d. h. für die Verwaltung von Anschlußüberwa-
chungsprogrammen. sacadm führt die folgenden Funktionen aus:
- Anschlußüberwachungsprogramm hinzufügen oder entfernen
- Anschlußüberwachungsprogramm starten oder beenden
- Anschlußüberwachungsprogramm aktivieren oder deaktivieren
- Für ein System angelegtes Konfigurationsskript installieren oder
ersetzen
- Für ein Anschlußüberwachungsprogramm angelegtes Konfigurations-
skript installieren oder ersetzen
- Informationen über ein Anschlußüberwachungsprogramm ausgeben
Jeder Systembenutzer kann den Zustand von Anschlußüberwachungsprogram-
men (mit -l und -L) abrufen und sich für ein Anschlußüberwachungspro-
gramm und für ein System angelegte Konfigurationsskripts (mit -g und
-G ohne die Option -z) ausgeben lassen. Andere sacadm-Kommandos dürfen
nur von einem dazu berechtigten Benutzer ausgeführt werden.
Seite 1 Reliant UNIX 5.44 Gedruckt 11/98
sacadm(1M) sacadm(1M)
OPTIONEN
-a Fügt ein Anschlußüberwachungsprogramm hinzu. Dabei
erzeugt sacadm die zugehörige Verzeichnisstruktur in
/etc/saf und /var/saf und fügt einen Eintrag für das neue
Anschlußüberwachungsprogramm in /etc/saf/sactab ein. Die
Datei sactab ist auf einem neu gelieferten System
bereits angelegt. Zunächst enthält sie nur eine Zeile mit
der Versionsnummer des Service Access Controller.
Das neue Anschlußüberwachungsprogramm wird gestartet, es
sei denn in der Kommandozeile, mit der das Anschlußüber-
wachungsprogramm hingefügt wird, steht auch die Option -f
mit dem Argument x. Die Optionen und Argumente, die auf
die Option -a folgen können, sind sehr komplex. Es ist
daher ratsam, ein Kommandoskript oder das Menüsystem zum
Hinzufügen von Anschlußüberwachungsprogrammen zu verwen-
den. Wenn Sie das Menüsystem verwenden, geben Sie "sysadm
Anschlüsse" ein und wählen dann den Menüpunkt "Anschluß-
überwachungsprogramme" aus.
-c cmd Führt die Kommandozeichenkette cmd aus, um ein Anschluß-
überwachungsprogramm zu starten. Die Option -c darf nur
zusammen mit der Option -a verwendet werden. Die Option
-a erfordert die Option -c.
-d Deaktiviert das Anschlußüberwachungsprogramm pmtag.
-e Aktiviert das Anschlußüberwachungsprogramm pmtag.
-f dx Hiermit kann eines oder beide der folgenden Flags angege-
ben werden, die dann in das Flagfeld des sactab-Eintrags
für das neue Anschlußüberwachungsprogramm geschrieben
werden. Kommt die Option -f nicht in der Kommandozeile
vor, werden keine Flags gesetzt und die Standardbedingun-
gen bleiben gültig. Standardmäßig wird ein Anschlußüber-
wachungsprogramm gestartet. Angabe der Option -f ohne ein
Argument ist nicht zulässig.
d Neues Anschlußüberwachungsprogramm nicht aktivieren.
x Neues Anschlußüberwachungsprogramm nicht starten.
Seite 2 Reliant UNIX 5.44 Gedruckt 11/98
sacadm(1M) sacadm(1M)
-g Hiermit wird das für ein Anschlußüberwachungsprogramm
erstellte Konfigurationsskript /etc/saf/pmtag/config
ausgegeben, installiert oder ersetzt. -g erfordert die
Option -p. Wird die Option -g nur zusammen mit der Option
-p angegeben, so wird nur das Konfigurationsskript für
das Anschlußüberwachungsprogramm pmtag ausgegeben. Wird
die Option -g zusammen mit der Option -p und -z angege-
ben, so wird die Datei script als Konfigurationsskript
für das Anschlußüberwachungsprogramm pmtag installiert.
Andere Kombinationen von Optionen mit -g sind ungültig.
-G Hiermit wird das für ein System erstellte Konfigurations-
skript /etc/saf/sysconfig ausgegeben, installiert oder
ersetzt. Wird nur -G angegeben, so wird das für ein
System erstellte Konfigurationsskipt ausgegeben. Wird die
Option -G zusammen mit der Option -z angegeben, so wird
die Datei script als für das System erstellte Konfigura-
tionsskript installiert. Andere Kombinationen von Optio-
nen mit -G sind ungültig.
-k Beendet das Anschlußüberwachungsprogramm pmtag.
-l Hiermit werden Informationen über das Anschlußüberwa-
chungsprogramm angefordert. Wird nur -l angegeben, so
werden alle Anschlußüberwachungsprogramme des Systems
ausgegeben. Wird die Option -l zusammen mit der Option -p
angegeben, so wird nur das durch pmtag angegebene
Anschlußüberwachungsprogramm aufgelistet. Wird -l zusam-
men mit der Option -t angegeben, so werden alle Anschluß-
überwachungsprogramme des Typs type aufgelistet. Andere
Kombinationen von Optionen mit -l sind ungültig.
-L Die Option -L stimmt mit der Option -l überein, abgesehen
davon, daß bei -L die Ausgabe komprimiert wird.
-n count Setzt den Zähler für Neustarts auf count. Ist kein Zähler
für Neustarts angegeben, wird er auf 0 gesetzt. Der Zäh-
ler 0 bedeutet, daß das Anschlußüberwachungsprogramm
nicht neu gestartet wird, wenn bei ihm ein Fehler auf-
tritt.
-p pmtag Gibt die Marke an, die zu einem Anschlußüberwachungspro-
gramm gehört.
Seite 3 Reliant UNIX 5.44 Gedruckt 11/98
sacadm(1M) sacadm(1M)
-r Löscht das Anschlußüberwachungsprogramm pmtag. sacadm
löscht den entsprechenden Eintrag für das Anschlußüberwa-
chungsprogramm aus /etc/saf/sactab. Wenn das gelöschte
Anschlußüberwachungsprogramm nicht läuft, werden keine
weiteren Schritte durchgeführt. Wenn das gelöschte
Anschlußüberwachungsprogramm läuft, sendet der Service
Access Controller (SAC) ihm ein SIGTERM-Signal, damit es
heruntergefahren wird. Beachten Sie, daß die Verzeichnis-
struktur des Anschlußüberwachungsprogramms erhalten
bleibt.
-s Startet ein Anschlußüberwachungsprogramm. Der SAC startet
das Anschlußüberwachungsprogramm pmtag.
-t type Gibt den Typ des Anschlußüberwachungsprogramms an.
-v ver Gibt die Versionsnummer des Anschlußüberwachungsprogramms
an. Die Versionsnummer kann folgendermaßen angegeben wer-
den:
-v `pmspec -V`
Hierbei ist pmspec das spezielle Verwaltungskommando für
das Anschlußüberwachungsprogramm pmtag. Dieses spezielle
Kommando ist ttyadm für ttymon bzw. nlsadmin für listen.
Das Kommando kennt den Versionsstempel des Anschlußüber-
wachungsprogramms. Dieser Versionsstempel wird zurückge-
geben, wenn pmspec mit der Option -V aufgerufen wird.
-x Wird nur die Option -x angegeben, so liest der SAC die
zugehörige Datenbasis-Datei (sactab). Wird die Option -x
zusammen mit der Option -p angegeben, liest das Anschlußüber-
wachungsprogramm pmtag seine Verwaltungsdatei.
-y comment Fügt den unter comment angegebenen Kommentar in den
sactab-Eintrag für das Anschlußüberwachungsprogramm
pmtag ein.
-z script Diese Option wird zusammen mit den Optionen -g und -G
benutzt, um den Namen einer Datei anzugeben, die ein Kon-
figurationsskript enthält. Bei Angabe der Option -g han-
delt es sich bei script um ein für ein Anschlußüberwa-
chungsprogramm erstelltes Konfigurationsskript; bei
Angabe von -G um ein für ein System erstelltes Konfigura-
tionsskript. Wollen Sie ein Konfigurationsskript ändern,
so gehen Sie in drei Schritten vor. Zuerst kopieren Sie
das vorhandene Skript (mit -g ohne weitere Optionen).
Dann editieren Sie die Kopie. Schließlich überschreiben
Sie das vorhandene Skript mit der geänderten Kopie (mit
-g bzw. -G zusammen mit -z).
Seite 4 Reliant UNIX 5.44 Gedruckt 11/98
sacadm(1M) sacadm(1M)
DIAGNOSE
Wenn sacadm seine Aufgabe erfolgreich beendet hat, so hat es den Rück-
kehrcode 0. Liegt bei sacadm aus einem beliebigen Grund ein Fehler
vor, hat es einen Rückkehrcode ungleich Null.
Optionen, die Informationen anfordern, schreiben diese Informationen
in die Standardausgabe. Werden Informationen über Anschlußüberwa-
chungsprogramme mit der Option -L in komprimiertem Format angefordert,
so werden sie in Feldern ausgegeben, die durch Doppelpunkte voneinan-
der getrennt sind; zwei aufeinanderfolgende Doppelpunkte zeigen dann
an, daß ein Feld fehlt. Werden Informationen im Standardformat (mit
Hilfe der Option -l) angefordert, so werden auch Spaltentitel ausgege-
ben und die Informationen über Anschlußüberwachungsprogramme unter den
entsprechenden Titeln ausgerichtet. In diesem Format steht ein Binde-
strich für ein fehlendes Feld. # ist das Kommentarzeichen.
BEISPIELE
Die folgende Kommandozeile fügt ein Anschlußüberwachungsprogramm
hinzu. Die Marke des Anschlußüberwachungsprogramms lautet npack; es
hat den Typ listen; falls notwendig, wird das Anschlußüberwachungspro-
gramm dreimal neu gestartet, bevor es endgültig fehlschlägt; das zuge-
hörige Verwaltungskommando ist nlsadmin; das Konfigurationsskript, das
gelesen werden soll, steht in der Datei script:
sacadm -a -p npack -t listen -c /usr/lib/saf/listen npack \
-v `nlsadmin -V` -n 3 -z script
Das folgende Beispiel löscht ein Anschlußüberwachungsprogramm mit der
Marke pmtag:
sacadm -r -p pmtag
Das folgende Beispiel startet das Anschlußüberwachungsprogramm mit der
Marke pmtag:
sacadm -s -p pmtag
Das folgende Beispiel beendet das Anschlußüberwachungsprogramm mit der
Marke pmtag:
sacadm -k -p pmtag
Das folgende Beispiel aktiviert das Anschlußüberwachungsprogramm mit
der Marke pmtag:
sacadm -e -p pmtag
Seite 5 Reliant UNIX 5.44 Gedruckt 11/98
sacadm(1M) sacadm(1M)
Das folgende Beispiel deaktiviert das Anschlußüberwachungsprogramm mit
der Marke pmtag:
sacadm -d -p pmtag
Das folgende Beispiel listet Informationen über die Zustände aller
Anschlußüberwachungsprogramme auf:
sacadm -l
Das folgende Beispiel listet Informationen über den Zustand des
Anschlußüberwachungsprogramms mit der Marke pmtag auf:
sacadm -l -p pmtag
Das folgende Beispiel listet dieselben Informationen wie im vorange-
henden Beispiel in komprimiertem Format auf:
sacadm -L -p pmtag
Das folgende Beispiel listet Informationen über die Zustände aller
Anschlußüberwachungsprogramme mit dem Typ listen auf:
sacadm -l -t listen
Das folgende Beispiel ersetzt das Konfigurationsskript für das
Anschlußüberwachungsprogramm mit der Marke pmtag, durch den Inhalt der
Datei file.config:
sacadm -g -p pmtag -z file.config
INTERNATIONALE UMGEBUNG
Die Umgebungsvariable LCMESSAGES bestimmt die Sprache der Meldungs-
texte.
Wenn LCMESSAGES nicht oder als leere Zeichenkette definiert ist, wird
der Wert von LANG als Standardwert herangezogen. Ist auch LANG nicht
oder als leere Zeichenkette definiert, verhält sich das System so, als
wäre es nicht internationalisiert.
Hat eine der Variablen für die internationale Umgebung einen ungülti-
gen Wert, verhält sich das System so, als wäre keine Variable gesetzt.
Die Umgebungsvariable LCALL bestimmt die gesamte internationale Umge-
bung. LCALL hat Vorrang vor allen anderen Umgebungsvariablen im
Bereich der Internationalisierung.
DATEIEN
/etc/saf/sactab
/etc/saf/sysconfig
Seite 6 Reliant UNIX 5.44 Gedruckt 11/98
sacadm(1M) sacadm(1M)
/etc/saf/pmtag/config
SIEHE AUCH
listen(1M), nlsadmin(1M), pmadm(1M), sac(1M), ttyadm(1M), ttymon(1M),
doconfig(3C).
Seite 7 Reliant UNIX 5.44 Gedruckt 11/98