!
!   30.12.88 R. Goeth
!
1 HELP
  Program SERMON (SERver MONitor) enables Terminalservers and other
  Ethernet nodes to be monitored, configured and tested.
1 Mail_address
  Ideas, wishes and bugs im SERMON can be reported to the author via MAIL.
  An answer or bug fix can however not be guaranteed.
 
  On EARN/BITNET at XBR1YD14@DDATHD21.BITNET
  On PSI-MAIL at PSI%026245615133234::BR1::YD14
1 Invoking_SERMON
  The command SERMON must be entered in the DCLTABLES.
  The command is defined in the file SERMON.CLD and can be activated via the
  DCL command:
 
      $ SET COMMAND SERMON
 
  It also possible to install the command in the systemwide DCLTABLES or
  any other tables.
 
  Format:
 
     SERMON [sermon_command]
2 /NODES
  /NODES=nodes
 
    Select a node or a group of nodes.
    See the command NODES.
2 /MAINT_PASSWORD
  /MAINT_PASSWORD=maintenance_password
 
    Set the maintenance password.
    See the command MAINT_PASSWORD.
2 /LOGIN_PASSWORD
  /LOGIN_PASSWORD=login_password
 
    Sets the login password.
    See the command LOGIN_PASSWORD.
2 /PRIV_PASSWORD
  /PRIV_PASSWORD=privileged_password
 
    Sets the privileged password.
    See the command PRIV_PASSWORD.
2 sermon_command
  Specifies SERMON commands. Available commands can be listed using the
  HELP command.
2 Example
 
  1. SERMON
 
     Invokes the SERMON program.
     SERMON commands are entered via SYS$INPUT.
 
  2. SERMON /NODES=DS200
 
     Same as example 1, however only the DECservers 200 are selected.
 
  3. SERMON /LOGIN=LPWD
 
     Same as example 1 but the Login Password is taken as "LPWD".
 
  4. SERMON /NODES=XYZ /MAINT=4711 /LOGIN=LPWD /PRIV=PPWD DO SHOW USER
 
     Node "XYZ" is selected, the maintenance password will be "4711", the
     login password will be "LPWD" and the privileged password will be
     "PPWD". Connection will be established with the Sermon command "DO"
     and the command "SHOW USER" will be executed on remote console of
     node "XYZ".
1 Server_data
  The node ethernet addresses will be read from "MOM$LOAD:DSVCONFIG.DAT".
  The database can in be located in a different directory by redefining
  logical names DSVCONFIG or MOM$LOAD.
!  Es koennen auch Nodes eingetragen werden, die keine Terminalserver
!  sind. Fuer diese Nodes steht, dann nur ein Teil der Befehle zur
!  Verfuegung.
 
  Data format:
             Name  Type Addresse                                   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 DATA
  The commands xcontained in the command file are sent to the curently
  selected nodes.

  More than one node may may be enabled via the "NODES" command.
 
  Vor der Ausfuehrung dieses Befehls muessen das maintenance and login
  password angegeben werden. Bei Angabe des Qualifiers /PRIVILEG muss
  muss vorher auch das Privilegierungs Passwort angegeben werden.
 
  Format:
 
     DATA data_name
2 /PRIVILEGE
  The privileged password will be used for this command.
2 Parameter
  data_name
 
    Name of the command data.
2 Example
  DATA SHOW
 
  Will execute the commands from SHOW.KMD.
2 Alias=FILE
  The FILE command is synonomous with DATA.
  werden.
1 CONFIGURATION
  Will reconfigure all the currently enabled nodes
  Commands are read from the file node_name.KONFIG.
 
  Only one node be selected for this command using the NODES command.
 
  For this command the Maintenance, Login and Privileged Passwords must
  have been specified.
 
  Format:
 
     CONFIGURATION
1 DO
  Executes the specified command on the currently enabled node(s).
 
  The nodes can be selected via the "NODES" command
 
  The maintenance and the Login passwords must have been specified.
  Furthermore the privileged password must be specified
  when the /PRIVILEGE qualifier is used.
 
  Format:
 
     DO remote_console_command
2 /PRIVILEGE
    The privileged password will be used for this command.
2 remote_console_command
 
    The rest of the command line will be interpreted as a DO command.
2 Example
  1. DO SHOW USER
 
     This will execute the non privilged command SHOW USER on the selected
     node(s).
 
  2. DO/PRIVILEG DEFINE SERVER IDENT "ABCD-1234"
 
     This will execute the privileged command DEFINE SERVER on the selected
     node(s).
1 CHANGE
  Via the CHANGE command a parameter can be changed on a server and
  in its corresponding configuration file.
  The specified parameter will be changed firstly via the remote console command
  DEFINE in the permanent database, secondly via the SET command in the
  temporary database and finally the command will be entered as a
  DEFINE command in the configurations file "node_name.KONFIG".
 
  Nodes can be selected via the "NODES" command.
 
  For this command the maintenance, login and priviled passwords must be
  specified.
 
  Format:
 
     CHANGE remote_console_parameter
2 remote_console_parameter
 
    The remainder of the command line is interpeted as a parameter.
2 Examplee
  1. NODES  XYZ
     CHANGE PORT 1 NAME HUGO
 
     The following commands will be executed on server XYZ:

       DEFINE PORT 1 NAME HUGO
       SET    PORT 1 NAME HUGO
 
     and the command
 
       DEFINE PORT 1 NAME HUGO
 
     will be appended to the file XYZ.KONFIG
 
  2. NODES XYZ
     CHANGE SERVER IDENT "XYZ-Bau 1"
 
     The following commands will be executed on server XYZ:
 
       DEFINE SERVER IDENT "XYZ-Bau 1"
       SET    SERVER IDENT "XYZ-Bau 1"
 
     and the command
 
       DEFINE SERVER IDENT "XYZ-Bau 1"
 
     will be appended the file XYZ.KONFIG.
1 NODES
  Specifies a node or a group of nodes.
  The nodes must exist in the file MOM$LOAD:DSVCONFIG.DAT.
 
  For safety reasons, specifying a group of nodes is not allowed on all
  commands.
 
  If the node is not specified a pompt will be issued.
 
  Format:
 
     NODES {node_name|node_type|device_name|*}
2 node_name
  An Ethernet nodename.
2 noden_type
  Ethernet node type.
2 device_name
  Ethernet deivce name in DECnet notation.
2 *
  All currently avalaible nodes will be selected.
  This is the default if the parameter is omitted.
2 Examplee
  1. NODES SRV1     node SRV1 will be selected
  2. NODES DS100    all DECserver 100 will be selected
  3. NODES UNA-0    all nodes on UNA-0 will be selected
  4. NODES          all nodes will be selected
2 Alias=SERVER
  The command SEVER is synonomous with NODES.
1 LOGIN_PASSWORD
  Specifies the login password for the remote console.
 
  Format:
 
     LOGIN_PASSWORD [password]
2 password
 
    Login password for the Remote Console of the selected node(s).
 
    Default = access
1 MAINT_PASSWORD
  Specifies the maintenance password for the remote console.
 
  Format:
 
     MAINT_PASSWORD password
2 password
 
    Specifies the Maintenance Password for the Remote Console of the
    selected node(s).
 
    Default = 0      e.g.. no Maintenance Password
1 PRIV_PASSWORD
  Specifies the Privileged Password.
 
  Format:
 
     PRIV_PASSWORD password
2 password
 
    Privileged Password for privileged commands at the
    Remote Console of the selected node(s).
 
    Default = system
1 EXIT
  Exits from the program.
 
  Format:
 
     EXIT
2 Alias=EXIT,QUIT,BYE,Control-Z
  The EXIT command can replaced withe the synonyms "ENDE", "QUIT"
  or BYE. Typing a Control-Z will also terminate the program.
1 BOOT
  Will issue a boot request to the remote console.
 
  This command is not supported on all nodes.
 
  Only one node may be specified for this command via the NODE command.
 
  The maintenance password must have been specified for this command.
 
  Format:
 
     BOOT
1 SYSTEM_ID
  Display the system-ID of all the selected nodes.
 
  This command is supported on all active DEC nodes.
 
  More than one node can be specified using the NODES command.
 
  This command requires no password as it is executed as a basic function.
 
  Format:
 
     SYSTEM_ID
2 Output_format
  The system ID of a node contains the node type and other data.
3 Node_name
  Name of the node corresponding to the DSVCONFIG file.
3 Maintenance_version
  Maintenance Operation Protocols (MOP) version.
3 Functions
  Various operations, functions are indicated in a 2 byte bitmask 
  bzw. Statusangabe eines Nodes angezeigt.
 
  Bit  Bez.       Meaning
 
  0001 Loop       Ethernet loopback function enabled
  0002 Dump       Dump enabled
  0004 Prim-Load  Primary loader enabled
  0008 Mult-Load  Multiblock loader enabled
  0010 Boot       Boot enabled
  0020 Cons       Remote console vorhanden
  0040 Coun       Ethernet Counter abrufbar
  0080 Reserv     Remote Console reserviert
3 Console_user
  When the remote console is in use (see Functions Reserv) the Ethernet
  address of the owner nodes is displayed.
3 Reservation_timer
  Anzahl der Sekunden nach denen die Remote Console freigeben wird,
  wenn keine Daten uebertragen wurden.
3 Console_command_size
  Size of the remote console command buffer in bytes.
3 Console_response_size
  Maximum size of the reply data packets in bytes from the remote console.
3 Physical_address
  Node physical Ethernet address.
3 Hardware_address
  Node hardware ethernet address.
3 System_time
  Node system time.
3 Communication_device
  Node Interface or hardware tetype.
3 System_processor
  Node system processor type.
3 Communication_dev_1
  ???
3 Microcode_version
  Node microcode version (boot ROM).
3 Software_version
  Node (Download) software version.
3 Server_number
  Server number (DEFINE SERVER NUMBER).
3 Server_name
  Server name (DEFINE SERVER NAME).
3 Server_ident
  Server identification (DEFINE SERVER IDENT).
3 Data_link_type
  Data link type.
3 Data_link_buffer_size
  Maximum data link buffer size.
1 STATUS
  One line Zusammenfassung of the system ID of the selected nodes.
 
  This function is supported on all active DEC nodes.
 
  More than one node may be selected via the NODES command.
 
  This command requires no password as it is executed as a basic function.
 
  Format:
 
     STATUS
2 Erlaeuterungen_zur_Ausgabe
  The node system ID contains the node type and other information.
  The description of the system ID is available with the HELP SYSTEM_ID
  command.
  The status consists of the type and other information.
3 DECserver_100/200
    Node name
    Server type
    Functions
    Microcode version
    Software version
    Server name
    Server identification
    Server number
3 Other_nodes
    Node name
    Hardware type
    Functions
1 COUNTER
  Display the Ethernet counters of the selected node(s).
 
  This function is not supported on all nodes.
 
  Es koennen mit dem "NODES" Kommando mehrere Nodes ausgewaehlt werden.
 
  This command requires no password as it is executed as a basis function.
 
  Format:
 
     COUNTER
1 WATCH
  Wait for the specified Ethernet node and display it with time stamp on
  the screen.

  Currently it only possible to exit from "WATCH" via CONTROL-Y.
 
  Format:
 
     WATCH ethernet_device_name
2 ethernet_device_name
  Ethernet Device name. It can be sepcified DECnet notation (xxx-n) or in
  VMS notation (xxc0).
2 Examplee
  1. WATCH XEA0  or  WATCH UNA-0      on a DEUNA/DELUA
  2. WATCH XQA0  or  WATCH QNA-0      on a DEQNA
  3. WATCH ETA0  or  WATCH BNT-0      on a DEBNT/DEBNA
  4. WATCH ESA0  or  WATCH SVA-0      on a DESVA
  5. WATCH XXA0  or  WATCH UE-0       on a 3COM UE
2 Alias=WAECHTER
  The command "WAECHTER" is Synonymous with "WATCH".
  werden.
2 Output_format
  The node system ID not only contains the node type but also other data.
  Description of the System ID is available under HELP SYSTEM_ID.
  The output depends on the on the node type.
3 DECserver_100/200
    Time
    Server type
    Physical Address
    Function
    Server Name
    Server Identification
    Server Nummer
3 Other_nodes
    Time
    Hardware type
    Physical Address
    Functions
3 Not_system_ID
    It is poosible to receive messages which do not contain a system ID.
    The output will then be as follows:
 
    Time
    Physical address
    Message type
    Message length
1 EDIT
  Will edit files using EDT. Both configuaration and command files can
  be created or amended.

  Format:
 
     EDIT [file_name]
     EDIT/CONFIG
2 File_name
  Must be specified when editing a command file.
2 /CONFIGURATION
  Will edit the configuration files,"node_name.KONFIG", of all the 
  currently selected nodes.
2 Examplee
  1. NODES XYZ
     EDIT/CONFIG
 
       Configuraton file of node XYZ, "XYZ.KONFIG". will be edited.
 
  2. EDIT ABC
 
       Will edit command file "ABC.KMD".
1 TRACE
  Monitors the Ethernet protocol.
  The I/O Operations are recorded as binary data and can be listed when TRACE
  has been swithed off.
 
  Format:
 
     TRACE option [file_name]
2 option
  AN,EIN or ON = Switches trace on
  AUS or OFF   = Switches trace off
  LIST         = Switches trace off and displays the trace data
2 file_name
  Name of the trace file. Default = "SERMON.TRACE".
1 PROMISCUOUS
  In the promiscuous mode it is possible to receive Ethernet data packets
  from other nodes and to create binary file.
  This mode requires PHY_IO privilege.
  Only one user at a time can be in promiscuous mode.
  Promiscuous mode is not supportesd on all Ethernet interfaces.
  Das Verlassen des Kommando "PROMISCUOUS" ist zur Zeit nur mit CONTROL-Y
  moeglich.
 
  Data can be read using the TRACE LIST command.
 
  Format:
 
     PROMISCUOUS etherner_device_name [file_name]
2 ethernet_device_name
  Ethernet Device name. Can be specified either in DECnet notation (xxx-n) or
  VMS notation (xxc0).
2 file_name
  Name of the trace data file. Default = "SERMON.TRACE".
2 Examplee
  1. PROM XEA0  or  PROM UNA-0      on a DEUNA/DELUA
  2. PROM XQA0  or  PROM QNA-0      on a DEQNA
  3. PROM ETA0  or  PROM BNT-0      on a DEBNT/DEBNA
  4. PROM ESA0  or  PROM SVA-0      on a DESVA
  5. PROM XXA0  or  PROM UE-0       on a 3COM UE
1 VERSION
  Displays the program version number.
