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.