!
!   30.12.88 R. Goeth
!
1 HELP
  Das Programm SERMON (SERver MONitor) ermoeglicht Terminalserver u.a.
  Ethernetknoten zu ueberwachen, konfigurieren und testen.
1 Mailadresse
  Anregungen, Wuensche und Fehler im SERMON koennen dem Autor per MAIL
  mitgeteilt werden. Ein Anspruch auf Beantwortung bzw. Fehlerbehebung
  kann leider nicht garantiert werden.
 
  Auf DECUS-VAX von DECUS Muenchen e.V. an User GOETH
  Im EARN/BITNET an XBR1YD14@DDATHD21.BITNET
  Ueber PSI-MAIL an PSI%026245615133234::BR1::YD14
1 Aufruf_SERMON
  Das Kommando "SERMON" muss in den "DCLTABLES" eingetragen sein.
  Die Kommandodefinition steht in der Datei "SERMON.CLD" mit dem Befehl
 
      $ SET COM SERMON
 
  kann die Definition aktiviert werden.
  Es ist auch moeglich das Kommando in die DCLTABLES oder eine andere
  Kommandotabelle einzubinden.
 
  Format:
 
     SERMON [sermon-befehl]
2 /KNOTEN
  /KNOTEN=knoten
 
    Auswahl eines Knotens oder einer Gruppe von Knoten.
    Siehe Befehl "KNOTEN".
2 /MAINT_PASSWORD
  /MAINT_PASSWORD=maintenance-passwort
 
    Angabe des Maintenance-Passworts.
    Siehe Befehl "MAINT_PASSWORD".
2 /LOGIN_PASSWORD
  /LOGIN_PASSWORD=login-passwort
 
    Angabe des LOGIN-Passworts.
    Siehe Befehl "LOGIN_PASSWORD".
2 /PRIV_PASSWORD
  /PRIV_PASSWORD=privilegierungs-passwort
 
    Angabe des Privilegierungs-Passworts.
    Siehe Befehl "PRIV_PASSWORD".
2 sermon-befehl
  Angabe eines SERMON-Befehls. Mit Kommando "HELP" werden die verfuegbaren
  Befehle angezeigt.
2 Beispiel
 
  1. SERMON
 
     Aufruf des Programmes SERMON.
     Die SERMON-Befehl werden anschliessend von SYS$INPUT abgefragt.
 
  2. SERMON /KNOTEN=DS200
 
     Wie 1., es werden zunaechst nur die DECserver 200 ausgewaehlt.
 
  3. SERMON /LOGIN=LPWD
 
     Wie 1., es wird zunaechst als Login-Passwort "LPWD" angenommen.
 
  4. SERMON /KNOTEN=XYZ /MAINT=4711 /LOGIN=LPWD /PRIV=PPWD BEFEHL SHOW USER
 
     Der Knoten "XYZ" wird ausgewaehlt. Er hat das Maintenance-Passwort
     "4711", das Login-Passwort "LPWD" sowie das Privilegierungs-Passwort
     "PPWD". Anschliessend wird der Sermon-Befehl "BEFEHL" ausgefuehrt,
     d.h. der nachfolgende Befehl "SHOW USER" wird ueber die Remote-Konsole
     des Knotens "XYZ" ausgefuehrt.
1 Serverdatei
  Die Ethernetadressen der Knoten werden aus der Datei
  "MOM$LOAD:DSVCONFIG.DAT" gelesen.
  Es kann durch Definition des logischen Namens DSVCONFIG eine andere
  Datei ausgewaehlt werden, bzw. durch Definition des logischen
  Namens MOM$LOAD ein anderes Directory ausgewahlt werden.
  Es koennen auch Knoten eingetragen werden, die keine Terminalserver
  sind. Fuer diese Knoten steht, dann nur ein Teil der Befehle zur
  Verfuegung.
 
  Dateiformat:
             Name  Typ  Adresse                                    Device
     1234567890123456789012345678901234567890123456789012345678901234567
     XXXXXXXXNNNNNNTTTTTAAAAAAAAAAAAAAAAA                          DDDDD
        45   DSV001DS20008-00-2B-05-C3-87PR0801ENG.SYSDS2DSV001.DMPBNT-0
             KOINZ VAX  AA-00-04-00-1E-04                          BNT-0
1 DATEI
  Die in einer Datei stehenden Befehle werden ueber die Remote Konsole
  zu dem/den ausgewaehlten Knoten geschickt.
 
  Es koennen mit dem "KNOTEN" Kommando mehrere Knoten ausgewaehlt werden.
 
  Vor der Ausfuehrung dieses Befehls muessen das Maintenance- und Login-
  Passwort angegeben werden. Bei Angabe des Qualifiers /PRIVILEG muss
  muss vorher auch das Privilegierungs-Passwort angegeben werden.
 
  Format:
 
     DATEI dateiname
2 /PRIVILEG
  Vor Ausfuehrung der Befehle wird das Privilegierungspasswort
  uebertragen
2 Parameter
  dateiname
 
    Name der Befehlsdatei
2 Beispiel
  DATEI SHOW
 
  Die Befehle aus der Datei SHOW.KMD werden uebertragen.
2 Alias=FILE
  Anstelle des Kommandos "DATEI" kann auch das Synonym "FILE" verwendet
  werden.
1 KONFIGURATION
  Die Konfiguration zu dem ausgewaehlten Knoten wird uebertragen.
  Die Befehle werden aus der Datei "knotenname.KONFIG" gelesen.
 
  Es kann mit dem "KNOTEN" Kommando nur ein Knoten ausgewaehlt werden.
 
  Vor der Ausfuehrung dieses Befehls muessen das Maintenance-, Login-
  und Privilegierungs-Passwort angegeben werden.
 
  Format:
 
     KONFIGURATION
1 BEFEHL
  Schickt einen Befehl ueber die Remote Konsole zu dem/den ausgewaehlten
  Knoten.
 
  Es koennen mit dem "KNOTEN" Kommando mehrere Knoten ausgewaehlt werden.
 
  Vor der Ausfuehrung dieses Befehls muessen das Maintenance- und Login-
  Passwort angegeben werden. Bei Angabe des Qualifiers /PRIVILEG muss
  muss vorher auch das Privilegierungs-Passwort angegeben werden.
 
  Format:
 
     BEFEHL remote-konsol-kommando
2 /PRIVILEG
  Vor Ausfuehrung des Befehls wird das Privilegierungspasswort
  uebertragen.
2 remote-konsol-kommando
 
    Der Rest der Befehlszeile wird als Befehl uebertragen.
2 Beispiele
  1. BEFEHL SHOW USER
 
     Es wird der nicht privilegierte Befehl SHOW USER auf dem/den
     ausgewaehlten Knoten ausgefuehrt.
 
  2. BEFEHL/PRIVILEG DEFINE SERVER IDENT "ABCD-1234"
 
     Es wird der privilegierte Befehl DEFINE SERVER auf dem/den
     ausgewaehlten Knoten ausgefuehrt.
1 AENDERN
  Mit dem Kommando AENDERN kann ein Parameter auf einem Server und
  in der zu diesem Server gehoerenden Konfigurationsdatei geaendert
  werden.
  Der angegebe Parameter wird mit zunaechst mit dem Remote-Konsol-Kommando
  DEFINE in die permanente, danach mit SET in die temporaere
  Server-Datenbasis eingetragen und schliesslich wird der Parameter als
  DEFINE-Befehl in der Konfigurationsdatei "knotenname.KONFIG"
  eingetragen.
 
  Es kann mit dem "KNOTEN" Kommando nur ein Knoten ausgewaehlt werden.
 
  Vor der Ausfuehrung dieses Befehls muessen das Maintenance-, Login-
  und Privilegierungs-Passwort angegeben werden.
 
  Format:
 
     AENDERN remote-konsol-parameter
2 remote-konsol-parameter
 
    Der Rest der Befehlszeile wird als Parameter interpretiert.
2 Beispiele
  1. KNOTEN  XYZ
     AENDERN PORT 1 NAME HUGO
 
     Auf dem Server XYZ werden die Befehle
 
       DEFINE PORT 1 NAME HUGO
       SET    PORT 1 NAME HUGO
 
     ausgefuehrt. An die Datei "XYZ.KONFIG" wird die Zeile
 
       DEFINE PORT 1 NAME HUGO
 
     angehaengt.
 
  2. KNOTEN XYZ
     AENDERN SERVER IDENT "XYZ-Bau 1"
 
     Auf dem Server XYZ werden die Befehle
 
       DEFINE SERVER IDENT "XYZ-Bau 1"
       SET    SERVER IDENT "XYZ-Bau 1"
 
     ausgefuehrt. An die Datei "XYZ.KONFIG" wird die Zeile
 
       DEFINE SERVER IDENT "XYZ-Bau 1"
 
     angehaengt.
1 KNOTEN
  Auswahl eines Knotens oder einer Gruppe von Knoten.
  Die Knoten muessen in der Datei "MOM$LOAD:DSVCONFIG.DAT"
  eingetragen sein.
 
  Die Auswahl einer Gruppe von Knoten ist aus Sicherheitsgruenden
  nicht bei allen Kommandos erlaubt.
 
  Die mit diesem Kommando getroffene Auswahl wird im Prompt angezeigt.
 
  Format:
 
     KNOTEN {knotenname|knotentyp|devicename|*}
2 knotenname
  Name eines Ethernetknotens.
2 knotentyp
  Typ eines Ethernetknotens.
2 devicename
  Ethernetdeivcename (DECnet-Notation).
2 *
  Alle eingetragenen Knoten werden ausgewaehlt.
  Wenn der Parameter weggelassen wird, ist dies die Voreinstellung
2 Beispiele
  1. KNOTEN SRV1     der Knoten SRV1 wird ausgewaehlt
  2. KNOTEN DS100    alle DECserver 100 werde ausgewaehlt
  3. KNOTEN UNA-0    alle Knoten am UNA-0 werden ausgewaehlt
  4. KNOTEN          alle Knoten werden ausgewaehlt
2 Alias=SERVER
  Anstelle des Kommandos "KNOTEN" kann auch das Synonym "SERVER" verwendet
  werden.
1 LOGIN_PASSWORT
  Login-Passwort fuer den Remote-Konsol-Kommando-Modus angeben.
 
  Format:
 
     LOGIN_PASSWORT [passwort]
2 passwort
 
    Login-Passwort fuer Remote Konsole des/der ausgewaehlten Knoten
 
    Voreineinstellung = access
1 MAINT_PASSWORT
  Maintenance-Passwort fuer die Remote-Konsole angeben.
 
  Format:
 
     MAINT_PASSWORT passwort
2 passwort
 
    Maintenance-Passwort fuer Remote Konsole des/der ausgewaehlten Knoten
 
    Voreineinstellung = 0      d.h. kein Maintenance-Passwort
1 PRIV_PASSWORT
  Privilegierungs-Passwort angeben
 
  Format:
 
     PRIV_PASSWORT passwort
2 passwort
 
    Privilegierungs-Passwort fuer privilegierte Befehle auf der
    Remote Konsole des/der ausgewaehlten Knoten
 
    Voreineinstellung = system
1 ENDE
  Das Programm wird beendet.
 
  Format:
 
     ENDE
2 Alias=EXIT,QUIT,BYE,Control-Z
  Anstelle des Kommandos "ENDE" koennen auch die Synonyme "EXIT", "QUIT"
  oder BYE verwendet werden. Durch die Eingabe von "Control-Z" kann
  ebenfalls das Programm beendet werden.
1 BOOT
  Ueber Remote Konsole eine Bootanforderung abschicken.
 
  Diese Funktion wird nicht von allen Knoten unterstuetzt.
 
  Es kann mit dem "KNOTEN" Kommando nur ein Knoten ausgewaehlt werden.
 
  Vor der Ausfuehrung dieses Befehls muss das Maintenance-Passwort
  angegeben werden.
 
  Format:
 
     BOOT
1 SYSTEM_ID
  System-Id der/des ausgewaehlten Knoten abfragen und anzeigen.
 
  Diese Funktion wird von allen aktiven DEC-Knoten unterstuetzt.
 
  Es koennen mit dem "KNOTEN" Kommando mehrere Knoten ausgewaehlt werden.
 
  Dieser Befehl benoetigt keine Passwoerter, da die Counterabfrage
  ueber eine Basis-Funktion realisiert wird.
 
  Format:
 
     SYSTEM_ID
2 Erlaeuterungen_zur_Ausgabe
  Die System-Id eines Knotens enthaelt je nach Knotentyp verschiedene
  Angaben.
3 Knotenname
  Name des Knotens gemaess der DSVCONFIG-Datei.
3 Maintenance_Version
  Version des Maintenance Operation Protocols (MOP).
3 Functions
  In einer 2-Byte Bitmaske werden verschiedene Operationen, Funktionen
  bzw. Statusangabe eines Knotens angezeigt.
 
  Bit  Bez.       Bedeutung
 
  0001 Loop       Ethernet-Loopback-Funktion verfuegbar
  0002 Dump       Dump verfuegbar
  0004 Prim-Load  Primary Loader verfuegbar
  0008 Mult-Load  Multiblock Loader verfuegbar
  0010 Boot       Boot verfuegbar
  0020 Cons       Remote Console vorhanden
  0040 Coun       Ethernet Counter abrufbar
  0080 Reserv     Remote Console reserviert
3 Consol_User
  Wenn die Remote Console belegt ist (siehe Functions Reserv) wird
  die Ethernet-Adresse des Knoten angezeigt, der die Remote Console
  reserviert hat.
3 Reservation_Timer
  Anzahl der Sekunden nach denen die Remote Console freigeben wird,
  wenn keine Daten uebertragen wurden.
3 Console_Command_Size
  Groesse des Befehlspuffers (in Byte) der Remote Console.
3 Console_Response_Size
  Maximale Groesse der Datenpakete (in Byte) mit den Antworten der
  Remote Console.
3 Physical_Address
  Physikalische Ethernet Adresse des Knotens.
3 Hardware_Address
  Hardware Ethernet Adresse des Knotens.
3 System_Time
  Systemzeit des Knotens.
3 Communication_Device
  Interface oder Geraetetyp des Knotens.
3 System_Processor
  Typ des System Processors des Knotens.
3 Communication_Dev_1
  ???
3 Microcode_Version
  Version des Microcodes (Boot-ROM) des Knotens.
3 Software_Version
  Version der (Download) Software des Knoten.
3 Server_Number
  Nummer des Servers (DEFINE SERVER NUMBER).
3 Server_Name
  Name des Servers (DEFINE SERVER NAME).
3 Server_Ident
  Identification des Servers (DEFINE SERVER IDENT).
3 Datalinktyp
  Typ der Datenverbindung.
3 Datalinkbuffersize
  Maximale Datenpuffergroesse der Datenverbindung.
1 STATUS
  Einzeilige Zusammenfassung der System-Id der/des ausgewaehlten Knoten
  abfragen und anzeigen.
 
  Diese Funktion wird von allen aktiven DEC-Knoten unterstuetzt.
 
  Es koennen mit dem "KNOTEN" Kommando mehrere Knoten ausgewaehlt werden.
 
  Dieser Befehl benoetigt keine Passwoerter, da die Counterabfrage
  ueber eine Basis-Funktion realisiert wird.
 
  Format:
 
     STATUS
2 Erlaeuterungen_zur_Ausgabe
  Die System-Id eines Knotens enthaelt je nach Knotentyp verschiedene
  Angaben. Die genaue Beschreibung der System-Id ist unter HELP SYSTEM_ID
  verfuegbar.
  Die Statusmeldung setzt sich je nach Knoten Typ aus verschiedenen
  Informationen zusammen.
3 DECserver_100/200
    Knotenname
    Geraetetyp
    Funktionen
    Microcode Version
    Software Version
    Server Name
    Server Identifikation
    Server Nummer
3 Sonstige_Knoten
    Knotenname
    Geraetetyp
    Funktionen
1 COUNTER
  Abfragen der Ethernetcounter auf dem/den ausgewaehlten Knoten.
 
  Diese Funktion wird nicht von allen Knoten unterstuetzt.
 
  Es koennen mit dem "KNOTEN" Kommando mehrere Knoten ausgewaehlt werden.
 
  Dieser Befehl benoetigt keine Passwoerter, da die Counterabfrage
  ueber eine Basis-Funktion realisiert wird.
 
  Format:
 
     COUNTER
1 WAECHTER
  Auf von den Ethernetknoten abgeschickte System-Ids warten und diese bei
  Eintreffen mit Uhrzeit auf dem Bildschirm ausgeben.
 
  Das Verlassen des Kommandos "WAECHTER" ist zur Zeit nur mit CONTROL-Y
  moeglich.
 
  Format:
 
     WAECHTER ethernet-device-name
2 ethernet-device-name
  Name des Ethernet-Devices. Es kann die DECnet-Notation (xxx-n) oder die
  VMS-Notation (xxc0) verwendet werden.
2 Beispiele
  1. WAECHTER XEA0  oder  WAECHTER UNA-0      bei DEUNA/DELUA
  2. WAECHTER XQA0  oder  WAECHTER QNA-0      bei DEQNA
  3. WAECHTER ETA0  oder  WAECHTER BNT-0      bei DEBNT/DEBNA
  4. WAECHTER ESA0  oder  WAECHTER SVA-0      bei DESVA
  5. WAECHTER XXA0  oder  WAECHTER UE-0       bei 3COM UE
2 Alias=WATCH
  Anstelle des Kommandos "WAECHTER" kann auch das Synonym "WATCH" verwendet
  werden.
2 Erlaeuterungen_zur_Ausgabe
  Die System-Id eines Knotens enthaelt je nach Knotentyp verschiedene
  Angaben. Die genaue Beschreibung der System-Id ist unter HELP SYSTEM_ID
  verfuegbar.
  Die Statusmeldung setzt sich je nach Knoten Typ aus verschiedenen
  Informationen zusammen.
3 DECserver_100/200
    Uhrzeit
    Geraetetyp
    Physikalische Adresse
    Funktionen
    Server Name
    Server Identifikation
    Server Nummer
3 Sonstige_Knoten
    Uhrzeit
    Geraetetyp
    Physikalische Adresse
    Funktionen
3 Nicht_System_Id
    Es ist moeglich, dass Meldungen empfangen werden, die keine System-Ids
    beinhalten. Die Ausgabe sieht dann folgendermassen aus:
 
    Uhrzeit
    Physikalische Adresse
    Meldungstyp
    Meldungslaenge
1 EDIT
  Datei mit dem EDT-Editor bearbeiten. Mit dem Editor koennen
  Konfigrations- und Kommandodateien erstellt, veraendert und angezeigt
  werden.
 
  Format:
 
     EDIT [dateiname]
     EDIT/KONFIG
2 Dateiname
  Wenn eine Kommandodatei bearbeitet werden soll, muss der Dateiname
  angegeben werden.
2 /KONFIGURATION
  Durch die Angabe dieses Qualifiers kann die Konfigurationsdatei
  "knotenname.KONFIG" des ausgewaehlten Servers editiert werden.
2 Beispiele
  1. KNOTEN XYZ
     EDIT/KONFIG
 
       Die Konfigurationsdatei "XYZ.KONFIG" des Servers XYZ wird editiert.
 
  2. EDIT ABC
 
       Die Kommandodatei "ABC.KMD" wird editiert.
1 TRACE
  Mit diesem Kommando wird die Protokollierung der Ethernet-I/O-Operationen
  gesteuert. Die I/O-Operationen werden zunaechst in einer binaeren Datei
  abgelegt und koennen nach Beendigung der Protokollierung aufgelistet werden.
 
  Format:
 
     TRACE option [dateiname]
2 option
  AN,EIN oder ON = Trace wird aktiviert
  AUS oder OFF   = Trace wird deaktiviert
  LIST           = Trace wird deaktiviert und ausgegeben
2 dateiname
  Name der Tracedatei. Voreinstellung = "SERMON.TRACE".
1 PROMISCUOUS
  Der Promiscuous Mode ermoeglicht es alle Ethernet-Datenpakete von
  anderen Knoten zu empfaengen und in einer binaeren Datei abzulegen.
  Fuer den Promiscuous Mode wird das Privileg PHY_IO benoetigt.
  Es kann nur ein Benutzer auf einem Rechner den Promiscuous Mode
  verwenden.
  Der Promiscuous Mode wird nicht von allen Ethernet-Interfaces
  unterstuetzt.
  Das Verlassen des Kommando "PROMISCUOUS" ist zur Zeit nur mit CONTROL-Y
  moeglich.
 
  Mit dem Kommando TRACE LIST kann die vom PROMISCUOUS-Kommando
  erzeugte Datei gelesen werden.
 
  Format:
 
     PROMISCUOUS ethernet-device-name [dateiname]
2 ethernet-device-name
  Name des Ethernet-Devices. Es kann die DECnet-Notation (xxx-n) oder die
  VMS-Notation (xxc0) verwendet werden.
2 dateiname
  Name der Tracedatei. Voreinstellung = "SERMON.TRACE".
2 Beispiele
  1. PROM XEA0  oder  PROM UNA-0      bei DEUNA/DELUA
  2. PROM XQA0  oder  PROM QNA-0      bei DEQNA
  3. PROM ETA0  oder  PROM BNT-0      bei DEBNT/DEBNA
  4. PROM ESA0  oder  PROM SVA-0      bei DESVA
  5. PROM XXA0  oder  PROM UE-0       bei 3COM UE
1 VERSION
  Ausgabe der Versionsnummer des Programmes und des Versionsdatums
