NET$MGMT_HELP.HLB  —  EVD
   The Event Dispatcher is an integral component of the Digital Network
   Architecture that processes events generated by entities in the network.
   Each component layer architecture of the Phase V DNA architecture, such
   as Routing, NSP, and OSI Transport, may define certain occurrences,
   actions, transitions, or conditions as events that are reported and may
   be logged to assist network or system management.  The Event Dispatcher
   module allows these conditions to be logged and monitored to allow a
   system manager to view the state of the network.

   The hierarchical relationship of the entities that constitute the Event
   Dispatcher module are:

           Event Dispatcher
             Outbound Stream
             Relay
               Logging
             Sink
               Inbound Stream

   The Event Dispatcher entity is the top-level entity in the hierarchy of
   entities belonging to the Event Dispatcher module.

1  –  character

     DNA VERSION

         Version number of the DNA event-logging architecture specification
         to which the implementation conforms. You cannot modify this
         characteristic.

2  –  counters

     EVENTS LOST

         Number of events lost at the Event Dispatcher queue.

3  –  status

     STATE

         Status of the Event Dispatcher Entity.

         OFF - The Event Dispatcher entity is disabled.

         ON  - The Event Dispatcher entity is enabled.

4  –  outbound

   An Event Dispatcher Outbound Stream entity represents an outgoing
   connection to a sink on a local or remote node. An Outbound Stream
   entity manages the connection to the sink, and it filters, processes,
   and transmits events to the sink.

4.1  –  character

     CATCH ALL FILTER
         Default: Pass                         Value: Pass or Block

         Action to take if neither the specific filter nor the global filter
         contains an entry that matches an event.

         PASS  - Report the event.

         BLOCK - Discard the event.

     CONNECT RETRY TIMER
         Default: 120                          Value: 0-65535

         Number of seconds to wait after a disconnect or connection reject
         before reattempting a connection. Connection attempts continue
         until a connection is made or until the connect timer enabled
         attribute is set to false or the Outbound Stream is disabled. If
         the Outbound Stream is already connected to the sink when the
         timer expires, no connection is attempted at that time. The timer
         resets and connection attempts continue whenever the timer expires.

     ENABLE CONNECT TIMER
         Default: True                         Value: True or False

         Specifies whether the connect timer is operational see connect
         retry timer.

     DISCONNECT TIMER
         Default: 0                             Value: 0-4294967295

         Number of seconds to wait before disconnecting an idle connection.
         Zero indicates that there is no disconnect timer and connections
         are never automatically disconnected.

     SINK END USER
         Default: Number=82                     Value: end-user-specification

         Sink session control end user specification for this stream.

     SINK NODE
         Default: Local Node                    Value: Full-name

         Full DNS node name of the sink for this stream. Modifying this
         characteristic affects only subsequent connect requests; existing
         connections are unaffected. This fullname is used in combination
         with the sink end user characteristic to establish the sink
         connection.

     SINK OBJECT
         Default: No Sink Object                 Value: Full-name

        Full DNS object name of the sink for this stream. Modifying this
         characteristic affects only subsequent connect requests; existing
         connections are unaffected. This fullname should match the  object
         name characteristic of the target sink.

4.2  –  counters

     CONFIDENCE CHANGES

         Number of times the confidence variable has changed while
         connections were in the open state.

     CONNECT REQUESTS

         Number of times a connection to a remote node was requested by this
         stream, either by an explicit command or by the connection timer.

     CONNECTIONS ACCEPTED

         Number of times an outbound connection request was accepted by the
         sink partner.

     DISABLED

         Number of disable events for this stream.

     ENABLED

         Number of enable events for this stream.

     EVENTS LOST

         Number of events lost because of Outbound Stream buffer overrun.

     FILTER CHANGES

         Number of times the filter has changed.

     SHUTDOWNS

         Number of times a shutdown command or operation was issued.

4.3  –  status

     BUFFER SIZE

         Maximum number of octets allowed for event processing of this
         stream. This value is defined in the create command for the stream.

     STATE

         Status of the Outbound Stream.

         OFF -                 The stream is disabled.

         ON -                  The stream is enabled.

         ONCONNECTED -         The stream is enabled and has an established
                               connection.

         ONCONNECTING -        The stream is enabled and is in the process
                               of establishing a connection.

         ONDISCONNECTING -     The stream is enabled, but is in the process
                               of disconnecting from a connection.

         ONSHUTDOWNREQUESTED - The stream is enabled and has an established
                               connection, but is in the process of shutting
                               down; the stream will disconnect after it
                               transmits all events that were outstanding
                               when the shutdown command was issued.

5  –  relay

   The Event Dispatcher Relay entity processes events from Phase IV
   DECnet-Plus systems.  It receives Phase IV format events and posts them
   into the DECnet-Plus logging system.

5.1  –  status

     STATE

         Status of the Event Dispatcher Relay entity.

         ON  - The Event Dispatcher Relay entity is enabled.

         OFF - The Event Dispatcher Relay entity is disabled.

6  –  relay_log

   Three Event Dispatcher Relay Logging entities are created and enabled
   automatically whenever an Event Dispatcher relay entity is enabled. The
   logging entities console, file, and monitor control the destination of
   Phase IV events. Each logging entity can be disabled and reenabled
   individually. All three logging entities are deleted automatically when
   the Phase IV relay entity is disabled.

6.1  –  counters

     EVENTS RELAYED

         Number of Phase IV events relayed for this logging type.

6.2  –  status

     STATE

         Status of the Event Dispatcher relay logging entity.

         ON  - The Event Dispatcher logging entity is enabled.

         OFF - The Event Dispatcher logging entity is disabled.

7  –  sink

   An Event Dispatcher Sink entity represents a Sink. A Sink manages
   incoming connections and filters incoming events. Each Sink maintains
   a filter that is applied to all streams that are assigned to that Sink.

7.1  –  character

     CATCH ALL FILTER
         Default: Pass                             Value: Pass or Block

         Specifies the action to take if neither the specific filter setting
         nor the global filter setting matches an event or if a filter
         setting that does match an event is set to Ignore.

         PASS  - Report the event.

         BLOCK - Discard the event.

     CLIENT TYPE
         Default: Console                          Value: See below

         Specifies the application to accept the events received by the sink.
         This can only be set when the Event Dispatcher sink entity is
         disabled when the sink state is off.

         CONSOLE - Events go to the operator's console.

         DEVICE -  Events go to a device referred to by the device name
                   characteristic.

         FILE -    Events go to a file referred to by the filename
                   characteristic.

     DESCRIPTION
         Default: Null                             Value: Latin1String

         Application description string.

     DEVICE NAME
         Default: Null                             Value: Latin1String

         Name of the device to which events are going to be logged, if the
         client type of the sink is device.

     DISPLAYUIDS
         Default: True                             Value: Boolean

         A boolean value indicating whether to include the UIDs when
         displaying an event.

     END USER
         Default: Number=82                        Value: End-user-specified

         Sink session control end user specification for this sink.

     FILE NAME
          Default: SYS$MANAGER:NET$EVD_SINK_(sinkname).LOG
          Value:   File specificaiton

         Name of the file to which events are going to be logged if the
         client type of the sink is file.

     OBJECT NAME
         Default: No Sink object                      Value: full-name

         Full DNS object name of the sink. Modifying this characteristic
         affects only subsequent connect requests; existing connections
         are unaffected.

     TEMPLATE
         Default: No Template                         Value: Simple-name

         Transport template for this sink's connections.

     USER CLIENT
         Default: Null                     Value: end-user specification

         Session control end user specification for a user program that
         has been set to receive events.

7.2  –  counters

     CONNECTIONS ACCEPTED

         Number of times a sink connection request was accepted by the sink
         partner.

     EVENTS FILTERED

         Number of events for this sink that were filtered by its sink
         filter.

     EVENTS LOST

         Number of events lost due to sink queue overflow.

     FILTER CHANGES

         Number of times the filter has changed.

7.3  –  status

     BUFFER SIZE

         Maximum number of octets allowed for event processing of this
         sink.  This value is defined in the create command for the sink.
         This value is limited by the value specified in the maximum
         buffer size argument of the create command.

     STATE

         Status of the sink.

         OFF - The sink is disabled.

         ON  - The sink is enabled.

8  –  sink_inb

   The Event Dispatcher Sink Inbound Stream entity is the sink-side end
   of the communication between an Event Dispatcher and a sink. An inbound
   stream entity is dynamically created, enabled, disabled, and deleted in
   tandem with the connection it represents.

8.1  –  counters

     CONFIDENCE CHANGES

         Number of times the confidence variable has changed while
         connections were in the on state.

8.2  –  status

     SOURCE END USER

         Source end user specification, as provided by session control.

     SOURCE NODE NAME

         Name of the source node, as provided by session control.

     STATE

         Status of the inbound event stream.

         OFF -          The stream is disabled.

         ON CONNECTED - The stream is enabled and connected to the outbound
                        stream.
Close Help