1 EVD =title Event Dispatcher 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. 2 character =title Characteristic Attributes DNA VERSION Version number of the DNA event-logging architecture specification to which the implementation conforms. You cannot modify this characteristic. 2 counters =title Counter Attributes EVENTS LOST Number of events lost at the Event Dispatcher queue. 2 status =title Status Attributes STATE Status of the Event Dispatcher Entity. OFF - The Event Dispatcher entity is disabled. ON - The Event Dispatcher entity is enabled. 2 outbound =title Event Dispatcher Outbound Stream 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. 3 character =title Characteristic Attributes 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. ! GLOBAL FILTER !! ! Current global filter as it has been constructed by block, ignore, ! and pass commands for this stream. By default, the global filter is ! set to block all events for the following entities: Event Dispatcher, ! Event Dispatcher sink, and Event Dispatcher sink inbound stream and ! to pass all events for the Event Dispatcher Outbound Stream entity. ! ! ! SINK ADDRESS ! Default: No address Value: sink address tower set ! ! Sink address tower for this stream. Modifying this characteristic ! affects only subsequent connect requests; existing connections are ! unaffected. ! ! 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. ! SPECIFIC FILTER ! Default: No specific filter ! ! Current specific filter for this stream. 3 counters =title Counter Attributes 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. 3 status =title Status Attributes 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. 2 relay =title Event Dispatcher 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. 3 status =title Status Attributes STATE Status of the Event Dispatcher Relay entity. ON - The Event Dispatcher Relay entity is enabled. OFF - The Event Dispatcher Relay entity is disabled. 2 relay_log =title Event Dispatcher Relay Logging 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. 3 counters =title Counter Attributes EVENTS RELAYED Number of Phase IV events relayed for this logging type. 3 status =title Status Attributes 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. 2 sink =title Event Dispatcher 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. 3 character =title Characteristic Attributes 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. ! GLOBAL FILTER ! ! Current global filter as it has been constructed by block, ignore, ! and pass commands for this sink. By default, the global filter is ! set to block all events for the following entities: ! ! Event Dispatcher, Event Dispatcher sink, and Event Dispatcher ! sink inbound stream. You cannot modify this characteristic. ! ! 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. ! SPECIFIC FILTER ! Default: No specific filter ! ! Current specific filter setting as constructed by block, ignore and ! pass commands for this sink. You cannot modify this characteristic. 3 counters =title Counter Attributes 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. 3 status =title Status Attributes 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. 2 sink_inb =title Event Dispatcher Sink Inbound Stream 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. 3 counters =title Counter Attributes CONFIDENCE CHANGES Number of times the confidence variable has changed while connections were in the on state. 3 status =title Status Attributes 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.