

			       EEvveenntt VViieewweerr HHeellpp


=============================================================================

       Event Viewer is used by any user to view stored events.

       Event Viewer is in the SysMan Menu in the Monitoring and Tuning group.

=============================================================================

  Copyright 1999 Compaq Information Technologies Group, L.P.

  Compaq, the Compaq logo and Tru64 are trademarks of Compaq Information
  Technologies Group, L.P.  in the U.S.	 and/or other countries.
  Motif, OSF/1, UNIX, and the `X Device' are trademarks of The Open Group in
  the U.S.  and/or other countries.
  All other product names mentioned herein may be the trademarks of their
  respective companies.

  Confidential computer software.  Valid license from Compaq required for
  possession, use or copying.  Consistent with FAR 12.211 and 12.212, Commer-
  cial Computer Software, Computer Software Documentation,  and Technical
  Data for Commercial Items are licensed to the U.S.  Government under
  vendor's standard commercial license.
  Compaq shall not be liable for technical or editorial errors or omissions
  contained herein.  The information in this document is provided `as is'
  without warranty of any kind and is subject to change without notice.
  The warranties for Compaq products are set forth in the express limited
  warranty statements accompanying such products.  Nothing herein shall be
  construed as constituting an additional warranty.

=============================================================================

CCoonntteennttss

EEvveenntt VViieewweerr HHeellpp

11  TTaasskkss
  1.1  Displaying Event Details
  1.2  Customizing the Event Summary Display
  1.3  Filtering Events
  1.4  Sorting Events
  1.5  Establishing the Source of Events
  1.6  Refreshing the Display
  1.7  Printing Events
  1.8  Saving Events
  1.9  Maintaining Filters

22  RReeffeerreennccee
  2.1  Event Viewer Main Window
  2.2  Advanced Filter Dialog Box
  2.3  Advanced Filter: Load Dialog Box
  2.4  Advanced Filter: Save Dialog Box
  2.5  Customize Dialog Box
  2.6  Details of Event Dialog Box
  2.7  Event Details: Print Dialog Box
  2.8  Event Details: Save Dialog Box
  2.9  File Exists Dialog Box
  2.10	Filter Dialog Box
  2.11	Get Events from Dialog Box
  2.12	Options Dialog Box
  2.13	Print Event Summaries Dialog Box
  2.14	Save Event Summaries Dialog Box
  2.15	Sort Event Summaries Dialog Box

33  TTrroouubblleesshhoooottiinngg

44  AAbboouutt EEvveenntt VViieewweerr
  4.1  Additional Trademark and Product Information

GGlloossssaarryy

=============================================================================

EEvveenntt VViieewweerr HHeellpp

  EEVVMM is an eevveenntt mmaannaaggeemmeenntt system.  Event Viewer is the portion of EVM that
  establishes a rreettrriieevviinngg cclliieenntt to view eevveennttss stored in log files.  The
  Event Viewer provides capabilities to select and view events, to refresh
  the display with new or newly selected events, and optionally to print
  events or save them in a file.  Events may be displayed, printed, or saved
  in eevveenntt ssuummmmaarryy or eevveenntt ddeettaaiill format.  See the task list for all of the
  capabilities, and the reference section for detailed information on the
  dialog boxes and main windows.

  Use Event Viewer to:

    oo++  Display Event Summaries

    oo++  Display Event Details

    oo++  Customize the Event Summary Display

    oo++  Print Events in Summary or Detail Format

    oo++  Save Events in Summary or Detail Format

OOppeenniinngg EEvveenntt VViieewweerr

  There are several ways to open the Event Viewer:

    oo++  From the SSyyssMMaann MMeennuu, select MMoonniittoorriinngg aanndd TTuunniinngg, then select VViieeww
       EEvveennttss.

    oo++  From the command line, enter sysman event_viewer.

    oo++  From the CCDDEE ffrroonntt ppaanneell if your system is running a graphics environ-
       ment with CCDDEE:

	11..  Open the AApppplliiccaattiioonn MMaannaaggeerr from the CDE front panel.

	22..  Select the SSyysstteemm AAddmmiinniissttrraattiioonn group.

	33..  Select the DDaaiillyy AAddmmiinniissttrraattiioonn group.

	44..  Select the EEvveenntt VViieewweerr icon.

EExxiittiinngg EEvveenntt VViieewweerr

  To exit the Event Viewer:

    oo++  In the Event Viewer main window, select EExxiitt..

    oo++  Prior to termination, all currently specified preferences will be
       remembered and used the next time the Event Viewer is started by the
       same user.

  The Event Viewer does not provide an eevveenntt mmoonniittoorriinngg capability.  All
  events that are displayed are read from log files.  You must refresh the
  display.  See the evmwatch(1) reference page for information on establish-
  ing a lliisstteenniinngg cclliieenntt to monitor events in real time.

SSeeee AAllssoo

    oo++  Chapter 1, Tasks

    oo++  Chapter 2, Reference

    oo++  evmget(1) reference page

    oo++  evmwatch(1) reference page

    oo++  EVM(5) reference page

    oo++  evmviewer(8) reference page

    oo++  sysman(8) reference page

=============================================================================

11  TTaasskkss

  This section lists the tasks you can perform.	 Select the task that best
  describes what you need to do and follow the detailed steps.

  For detailed field information for a window or a dialog box, see Reference.

    oo++  Section 1.1, Displaying Event Details

    oo++  Section 1.2, Customizing the Event Summary Display

    oo++  Section 1.3, Filtering Events

    oo++  Section 1.4, Sorting Events

    oo++  Section 1.5, Establishing the Source of Events

    oo++  Section 1.6, Refreshing the Display

    oo++  Section 1.7, Printing Events

    oo++  Section 1.8, Saving Events

    oo++  Section 1.9, Maintaining Filters

=============================================================================

11..11  DDiissppllaayyiinngg EEvveenntt DDeettaaiillss

  Events may be displayed in eevveenntt ddeettaaiill format one event at a time.  This
  format allows detailed analysis of all information in the event.  The event
  details also may be saved to a file or printed for record purposes or
  further analysis.

  To display the details of an event from the EEvveenntt VViieewweerr main window:

   11..  Select an event.	 The selected event is indicated by a change in back-
       ground color or a greater than symbol (>) in the first position of the
       display line, depending on the capabilities of the display in use.

   22..  Select DDeettaaiillss...... to open the Details of Event dialog box.

   33..  Select OOKK to return to the EEvveenntt VViieewweerr main window when you are fin-
       ished viewing the event.

  To change the event for which details are being displayed from the DDeettaaiillss
  ooff EEvveenntt dialog box:

    oo++  Select NNeexxtt EEvveenntt to display the event immediately following the
       current event.

    oo++  Select PPrreevviioouuss EEvveenntt to display the event immediately preceding the
       current event.

    oo++  Select FFiirrsstt EEvveenntt to display the first available event.

    oo++  Select LLaasstt EEvveenntt to display the last available event.

SSeeee AAllssoo

    oo++  Section 2.1, Event Viewer Main Window

    oo++  EvmEvent(5) reference page

=============================================================================

11..22  CCuussttoommiizziinngg tthhee EEvveenntt SSuummmmaarryy DDiissppllaayy

  The Event Summary display may be customized to choose the event data items
  displayed and the number of event summaries displayed.

  To customize the Event Summary display from the Event Viewer main window:

   11..  Select CCuussttoommiizzee...... to open the Customize dialog box.

   22..  Select the Event Data Items to be displayed.  Selected items will be
       indicated by the checkmark in the left column, or by a depressed but-
       ton appearance, depending on display capabilities.

   33..  Enter or modify the maximum number of events to be displayed.

   44..  Select OOKK.  The display is regenerated with the newly selected event
       data items displayed.

SSeeee AAllssoo

    oo++  EvmEvent(5) reference page

=============================================================================

11..33  FFiilltteerriinngg EEvveennttss

  An event filter determines the events retrieved from a log file and
  presented in the event summary display.

  To establish a filter for event selection, from the Event Viewer main win-
  dow:

   11..  Select FFiilltteerr...... to open the Filter dialog box.

   22..  Complete the filter specification.

   33..  Select OOKK.  The display is regenerated with the new event selection.

  To enter a filter string for event selection using a more flexible specifi-
  cation capability, from the Event Viewer main window:

   11..  Select OOppttiioonnss...... to open the Options dialog box.

   22..  Select AAddvvaanncceedd ffiilltteerr.......

   33..  Select OOKK to open the Advanced Filter dialog box.

   44..  Complete the filter specification.  See the EvmFilter(5) reference
       page for the syntax of the filter specification.	 It is also possible
       to save or maintain filters at this time.

   55..  Select OOKK.  The display is regenerated with the new event selection.

SSeeee AAllssoo

    oo++  Section 1.9, Maintaining Filters

=============================================================================

11..44  SSoorrttiinngg EEvveennttss

  The event summaries are displayed in a sorted manner.	 The sort key and
  sort order may be selected to present the event summaries in the order most
  appropriate to the needs of the user.

  To choose the order in which events are displayed, from the Event Viewer
  main window:

   11..  Select SSoorrtt...... to open the Sort Event Summaries dialog box.

   22..  Complete the sort specification.

   33..  Select OOKK.  The display is regenerated with the newly ordered events.

=============================================================================

11..55  EEssttaabblliisshhiinngg tthhee SSoouurrccee ooff EEvveennttss

  Events displayed may be retrieved from locally stored files or by subscrip-
  tion to either the local system or another system.  Subscription to several
  systems is allowed.  The distinctions of llooccaall hhoosstt and rreemmoottee hhoosstt are
  made with the understanding that the viewer is running on the local host.

  To choose the source of stored events, from the Event Viewer main window:

   11..  Select OOppttiioonnss...... to open the Options dialog box.

   22..  Select GGeett eevveennttss ffrroomm.......

   33..  Select OOKK to open the Get Events from dialog box.

   44..  Select ffiillee and complete the EEnntteerr nnaammee ooff ffiillee:: specification to
       retrieve events from a file stored on the local system.

   55..  Select hhoosstt and complete the host specification to retrieve events
       from an event log.

	 oo++  Select llooccaall to subscribe to events on the local host.

	 oo++  Select rreemmoottee and enter host names to subscribe to events on
	    remote hosts.

   66..  Select OOKK.  The specified event log files are read and the display is
       regenerated with the new event selection.

SSeeee AAllssoo

    oo++  evmget(1) reference page

=============================================================================

11..66  RReeffrreesshhiinngg tthhee DDiissppllaayy

  The Event Viewer does not provide an eevveenntt mmoonniittoorriinngg capability.  Events
  that have occurred since the event summary display originally was generated
  or last regenerated are not seen by the Event Viewer unless the display and
  the pool of events available for display are refreshed by performing this
  task.

  To refresh the event summary display, from the Event Viewer main window:

   11..  Select RReeffrreesshh.	The display is regenerated with the updated event
       selection.

=============================================================================

11..77  PPrriinnttiinngg EEvveennttss

  Events may be printed in eevveenntt ssuummmmaarryy format, or in eevveenntt ddeettaaiill format
  one event at a time.

  To print event summaries, from the Event Viewer main window:

   11..  Select OOppttiioonnss...... to open the Options dialog box.

   22..  Select PPrriinntt eevveenntt ssuummmmaarriieess.......

   33..  Select OOKK to open the Print Event Summaries dialog box.

   44..  Enter or modify the UNIX command to print the event summaries in the
       PPrriinntt CCoommmmaanndd field.

   55..  Select OOKK to initiate the print operation.

  To print the details of an event, from the Event Viewer main window:

   11..  Select an event.	 The selected event is indicated by a change in back-
       ground color or a greater than symbol (>) in the first position of the
       display line, depending on the capabilities of the display in use.

   22..  Select DDeettaaiillss...... to open the Details of Event dialog box.

   33..  Select PPrriinntt...... to open the Event Details: Print dialog box.

   44..  Enter or modify the UNIX command to print the event details in the
       PPrriinntt CCoommmmaanndd field.

   55..  Select OOKK to initiate the print operation.

   66..  Select OOKK to close the DDeettaaiillss ooff EEvveenntt dialog box.

SSeeee AAllssoo

    oo++  lpr(1) reference page

    oo++  lp(1) reference page

    oo++  pr(1) reference page

=============================================================================

11..88  SSaavviinngg EEvveennttss

  Events may be saved in a file, either in eevveenntt ssuummmmaarryy format, or in eevveenntt
  ddeettaaiill format one event at a time.

  To save event summaries, from the Event Viewer main window:

   11..  Select OOppttiioonnss...... to open the Options dialog box.

   22..  Select SSaavvee eevveenntt ssuummmmaarriieess ttoo aa ffiillee .. .. ...

   33..  Select OOKK to open the Save Event Summaries dialog box.

   44..  Enter or modify the name of the file to receive the event summaries in
       the SSaavvee ttoo FFiillee field.

   55..  Select OOKK to initiate the file save operation.  If the specified file
       exists, the File Exists dialog box will open to provide options to
       replace or add to the file.

       If Event Viewer cannot write the file to your specified location, it
       will attempt to write the file to your default temporary directory.

  To save the details of an event, from the Event Viewer main window:

   11..  Select an event.	 The selected event is indicated by a change in back-
       ground color or a greater than symbol (>) in the first position of the
       display line, depending on the capabilities of the display in use.

   22..  Select DDeettaaiillss...... to open the Details of Event dialog box.

   33..  Select SSaavvee...... to open the Event Details: Save dialog box.

   44..  Enter or modify the name of the file to receive the event details in
       the SSaavvee ttoo FFiillee field.

   55..  Select OOKK to initiate the file save operation.  If the specified file
       exists, the File Exists dialog box will open to provide options to
       replace or add to the file, or to select a different file name.

   66..  Select OOKK to close the DDeettaaiillss ooff EEvveenntt dialog box.

=============================================================================

11..99  MMaaiinnttaaiinniinngg FFiilltteerrss

  Filter maintenance includes the creation, storage, update, retrieval, and
  deletion of the filter strings used with the advanced filter capability.

  To perform filter maintenance, from the Event Viewer main window:

   11..  Select OOppttiioonnss...... to open the Options dialog box.

   22..  Select AAddvvaanncceedd ffiilltteerr.......

   33..  Select OOKK to open the Advanced Filter dialog box.

   44..  Enter or modify the filter string as needed.

   55..  To save the filter displayed in the FFiilltteerr field:

	aa..  Select SSaavvee...... to open the Advanced Filter: Save dialog box.

	bb..  Enter or modify the name for the filter string in the SSaavvee aass
	    field.

	cc..  Select OOKK to save the filter string.  If the filter exists, it
	    will be replaced.

   66..  To load the FFiilltteerr field with a stored filter string:

	aa..  Select LLooaadd...... to open the Advanced Filter: Load dialog box.

	bb..  Select the name of stored filter string in the SSaavveedd ffiilltteerrss
	    field.

	cc..  Select OOKK to read the filter string.

   77..  To delete a saved filter:

	aa..  Select LLooaadd...... to open the Advanced Filter: Load dialog box.

	bb..  Select the name of the filter to be deleted in the SSaavveedd ffiilltteerrss
	    field.

	cc..  Select DDeelleettee to delete the filter.

	dd..  Select OOKK to close the AAddvvaanncceedd FFiilltteerr:: LLooaadd dialog box.

   88..  Select OOKK.  The display is regenerated with the new event selection.

   99..  Select CCaanncceell to exit the AAddvvaanncceedd FFiilltteerr dialog box without changing
       the display.

SSeeee AAllssoo

    oo++  Section 1.3, Filtering Events

    oo++  Section 2.10, Filter Dialog Box

    oo++  evmget(1) reference page

    oo++  EvmFilter(5) reference page

=============================================================================

22  RReeffeerreennccee

  This section provides detailed field descriptions for the windows and dia-
  log boxes.

  For the procedures to perform specific tasks, see Tasks.

    oo++  Section 2.1, Event Viewer Main Window

    oo++  Section 2.2, Advanced Filter Dialog Box

    oo++  Section 2.3, Advanced Filter: Load Dialog Box

    oo++  Section 2.4, Advanced Filter: Save Dialog Box

    oo++  Section 2.5, Customize Dialog Box

    oo++  Section 2.6, Details of Event Dialog Box

    oo++  Section 2.7, Event Details: Print Dialog Box

    oo++  Section 2.8, Event Details: Save Dialog Box

    oo++  Section 2.9, File Exists Dialog Box

    oo++  Section 2.10, Filter Dialog Box

    oo++  Section 2.11, Get Events from Dialog Box

    oo++  Section 2.12, Options Dialog Box

    oo++  Section 2.13, Print Event Summaries Dialog Box

    oo++  Section 2.14, Save Event Summaries Dialog Box

    oo++  Section 2.15, Sort Event Summaries Dialog Box

=============================================================================

22..11  EEvveenntt VViieewweerr MMaaiinn WWiinnddooww

  Use the Event Viewer main window to display event summaries, direct the
  operation of the event viewer, and terminate operations.

  FFIIEELLDD	     DDEESSCCRRIIPPTTIIOONN

  Event Summaries from _z_z_z
	    Shows the name of the host system, _z_z_z, from which the displayed
	    events were retrieved.

  _x_x_x events matched specified filter. _y_y_y event summaries displayed.
	    Shows the number of events, _x_x_x, that matched the specified
	    filter.  The number of events displayed is _y_y_y.  The number of
	    events displayed is the lesser of the number of events that
	    matched the filter or the number of events per display specified
	    with the Customize dialog box.

  Details...
	    Opens the Details of Event dialog box to display event details.

  Refresh   Refreshes the event summary display by obtaining a new pool of
	    events.

  Filter... Opens the Filter dialog box to specify the filter to be applied
	    to select events retrieved.

  Customize...
	    Opens the Customize dialog box to select event items to be
	    displayed.

  Sort...   Opens the Sort Event Summaries dialog box to select a sort key
	    and a sort order.

  Options...
	    Opens the Options dialog box to make additional controls avail-
	    able.

  BBUUTTTTOONN     DDEESSCCRRIIPPTTIIOONN

  Exit	    Exits the Event Viewer.

  Help	    Displays help for this window.

=============================================================================

22..22  AAddvvaanncceedd FFiilltteerr DDiiaalloogg BBooxx

  Use this dialog box to select and maintain filter strings with the advanced
  user capabilities.

  FFIIEELLDD	     DDEESSCCRRIIPPTTIIOONN

  Filter    Enter a filter string to be used to select events for display.
	    See the EvmFilter(5) reference page for the full syntax of a
	    filter string.

	    When the dialog box opens, this field contains the last filter
	    string processed.  Optionally, set the filter string from a saved
	    filter.

  Save...   Opens the Advanced Filter: Save dialog box to save a filter.

  Load...   Opens the Advanced Filter: Load dialog box to select or delete a
	    stored filter.

  BBUUTTTTOONN     DDEESSCCRRIIPPTTIIOONN

  OK	    Applies the advanced filter string and closes the dialog box.

  Apply	    Applies the advanced filter string without closing the dialog
	    box.

  Cancel    Closes the dialog box without applying the advanced filter
	    string.  This allows the dialog box to be used for filter mainte-
	    nance without changing the filter string currently in effect.

  Help	    Displays help for the dialog box.

SSeeee AAllssoo

    oo++  Section 2.10, Filter Dialog Box

    oo++  EvmFilter(5) reference page

=============================================================================

22..33  AAddvvaanncceedd FFiilltteerr:: LLooaadd DDiiaalloogg BBooxx

  Use this dialog box to load the advanced filter string with a saved filter,
  or to delete a saved filter.

  FFIIEELLDD	     DDEESSCCRRIIPPTTIIOONN

  Saved filters
	    This is a list of the names of saved filters.  Select a name from
	    this list.	The background color of the selected name changes, or
	    the selected filter name is otherwise indicated, depending on
	    terminal capabilities.

  Delete    Deletes the selected filter.

  BBUUTTTTOONN     DDEESSCCRRIIPPTTIIOONN

  OK	    Loads the selected filter as the currently displayed filter
	    string and closes the dialog box.  If no filter is selected, no
	    action is taken.  This allows you to exit the dialog box after
	    deleting a saved filter without changing your filter string.

  Apply	    Loads the selected filter as the currently displayed filter
	    string without closing the dialog box.

  Cancel    Closes the dialog box without changing the currently displayed
	    filter string.

  Help	    Displays help for the dialog box.

SSeeee AAllssoo

    oo++  Section 2.2, Advanced Filter Dialog Box

    oo++  Section 2.4, Advanced Filter: Save Dialog Box

=============================================================================

22..44  AAddvvaanncceedd FFiilltteerr:: SSaavvee DDiiaalloogg BBooxx

  Use this dialog box to save the currently displayed filter string.

  FFIIEELLDD	     DDEESSCCRRIIPPTTIIOONN

  Save as   Enter or modify the name for the stored filter string.  If the
	    filter exists, it will be replaced (overwritten).

	    DDaattaa TTyyppee:: Alphanumeric
	    MMaannddaattoorryy//OOppttiioonnaall:: Mandatory
	    VVaalliidd VVaalluueess:: Any name.  Wildcard characters do not receive spe-
	    cial treatment.  Slashes are not accepted.
	    DDeeffaauulltt:: Blank

  BBUUTTTTOONN     DDEESSCCRRIIPPTTIIOONN

  OK	    Saves the currently displayed filter string and closes the dialog
	    box.

  Cancel    Closes the dialog box without saving the currently displayed
	    string.

  Help	    Displays help for the dialog box.

SSeeee AAllssoo

    oo++  Section 2.2, Advanced Filter Dialog Box

    oo++  Section 2.3, Advanced Filter: Load Dialog Box

=============================================================================

22..55  CCuussttoommiizzee DDiiaalloogg BBooxx

  When this dialog box is opened, the number of summaries to display and the
  current display specification are indicated.

  Use this dialog box to select the number of event summaries and the event
  data items shown for each event summary in the Event Summary Display.	 If
  an event data item selected is not present in the event, a dash (-) is
  displayed instead of a value.

  FFIIEELLDD	     DDEESSCCRRIIPPTTIIOONN

  EventId (Event Sequence Number)
	    The event sequence number is a number assigned to each event as
	    it is posted.

  Pri (Event Priority)
	    The eevveenntt pprriioorriittyy indicates the relative importance of the
	    event, as determined when the event was posted.

  Timestamp(Posting Timestamp)
	    The Posting Timestamp is the eevveenntt ttiimmeessttaammpp, including date and
	    time, when the event was posted.

  PID (Posting Process ID)
	    This is the process ID number of the process that posted the
	    event.

  User (Posting User)
	    This is the user name under which the ppoossttiinngg cclliieenntt was running.

  Host (Posting Host)
	    This is the name of the host on which the posting client was run-
	    ning.

  Cluster (Posting Cluster)
	    This is the name of the cluster on which the posting client was
	    running.

  Event Name
	    This is the name of the event.

  Summary (Formatted Message)
	    The summary, or event message, as derived from the format data
	    item.  If this is a repeated message, the number of instances of
	    this message is shown in brackets ([]) at the beginning of this
	    field.

  Set Number of Events to Display
	    Enter or modify the maximum number of events to be displayed.
	    The display shows events from the sorted pool until this count is
	    reached, or all events available, whichever is less.  The larger
	    the value you enter in this field, the longer it takes for sum-
	    mary information to be displayed.

	    DDaattaa TTyyppee:: Numeric
	    MMaannddaattoorryy//OOppttiioonnaall:: Mandatory
	    VVaalliidd VVaalluueess:: 1 to 100000
	    DDeeffaauulltt:: 500

  BBUUTTTTOONN     DDEESSCCRRIIPPTTIIOONN

  OK	    Updates the Event Summary display and closes the dialog box.

  Apply	    Updates the Event Summary display without closing the dialog box.

  Cancel    Closes the dialog box without changing the Event Summary display.

  Help	    Displays help for the dialog box.

SSeeee AAllssoo

    oo++  Section 2.6, Details of Event Dialog Box

    oo++  EvmEvent(5) reference page

=============================================================================

22..66  DDeettaaiillss ooff EEvveenntt DDiiaalloogg BBooxx

  Use this dialog box to display the details of an event.

  FFIIEELLDD	     DDEESSCCRRIIPPTTIIOONN

  Details of Event
	    Shows the details of the selected event.  The display includes
	    all data items in the event.  An explanation of the event may be
	    provided if one is available.  See the EvmEvent(5) reference page
	    for a description of event contents.

  Next Event
	    Displays details of the next event.

  Previous Event
	    Displays details of the previous event.

  First Event
	    Displays details of the first event.

  Last Event
	    Displays details of the last event.

  BBUUTTTTOONN     DDEESSCCRRIIPPTTIIOONN

  OK	    Closes the dialog box.

  Save...   Opens the Event Details: Save dialog box to save the event
	    details to a file.

  Print...  Opens the Event Details: Print dialog box to print the event
	    details.

  Help	    Displays help for the dialog box.

SSeeee AAllssoo

    oo++  EvmEvent(5) reference page

=============================================================================

22..77  EEvveenntt DDeettaaiillss:: PPrriinntt DDiiaalloogg BBooxx

  Use this dialog box to print the event details.

  FFIIEELLDD	     DDEESSCCRRIIPPTTIIOONN

  Print Command
	    Enter or modify the UNIX command to print the event details.

	    DDaattaa TTyyppee:: Alphanumeric
	    MMaannddaattoorryy//OOppttiioonnaall:: Mandatory
	    VVaalliidd VVaalluueess:: Any command acceptable to the operating system
	    DDeeffaauulltt:: /usr/bin/lpr

  BBUUTTTTOONN     DDEESSCCRRIIPPTTIIOONN

  OK	    Prints event details and closes the dialog box.

  Apply	    Prints event details without closing the dialog box.

  Cancel    Closes the dialog box without printing event details.

  Help	    Displays help for the dialog box.

SSeeee AAllssoo

    oo++  Section 2.13, Print Event Summaries Dialog Box

    oo++  lpr(1) reference page

    oo++  lp(1) reference page

    oo++  pr(1) reference page

=============================================================================

22..88  EEvveenntt DDeettaaiillss:: SSaavvee DDiiaalloogg BBooxx

  Use this dialog box to save the details of the selected event to a file.

  FFIIEELLDD	     DDEESSCCRRIIPPTTIIOONN

  Save to File
	    Enter or modify the name of a file where the details of the
	    selected event are to be stored.  If the file does not exist, it
	    will be created.  If the file exists, the option to replace it or
	    add to it will be presented.

	    DDaattaa TTyyppee:: Alphanumeric
	    MMaannddaattoorryy//OOppttiioonnaall:: Mandatory
	    VVaalliidd VVaalluueess:: Any file name.  The path to the file is relative to
	    the directory from which the Event Viewer was started, unless an
	    aabbssoolluuttee ppaatthhnnaammee is specified.
	    DDeeffaauulltt:: details.txt

  BBUUTTTTOONN     DDEESSCCRRIIPPTTIIOONN

  OK	    Saves event details and closes the dialog box.

  Cancel    Closes the dialog box without saving event details.

  Help	    Displays help for the dialog box.

SSeeee AAllssoo

    oo++  Section 2.14, Save Event Summaries Dialog Box

    oo++  Section 2.9, File Exists Dialog Box

=============================================================================

22..99  FFiillee EExxiissttss DDiiaalloogg BBooxx

  This dialog box is presented when an attempt is made to save event sum-
  maries or the details of an event to a file and the file already exists.

  FFIIEELLDD	     DDEESSCCRRIIPPTTIIOONN

  The specified file exists
	    The file name specified in a previous dialog box exists.

  Overwrite Replaces the file.

  Append    Adds data to the end of the file.

  BBUUTTTTOONN     DDEESSCCRRIIPPTTIIOONN

  OK	    Writes the file, using the overwrite or append option selected,
	    and closes the dialog box.

  Cancel    Closes the dialog box without writing the file.  This allows the
	    selection of a different file name, or canceling the action
	    entirely.

  Help	    Displays help for the dialog box.

SSeeee AAllssoo

    oo++  Section 2.14, Save Event Summaries Dialog Box

    oo++  Section 2.8, Event Details: Save Dialog Box

=============================================================================

22..1100  FFiilltteerr DDiiaalloogg BBooxx

  When this dialog box is opened, the currently selected filter specification
  is indicated.	 This is the active filter specification if the last filter
  was applied with this dialog box.  If the active filter was specified with
  the advanced filter capability, an informational message is presented.

  Use this dialog box to establish an eevveenntt ffiilltteerr for event selection.	 Each
  field checked indicates a filter element.  If more than one filter element
  (field) is checked, events must match all filter elements specified to be
  selected.  See the EvmFilter(5) reference page for more information on
  filtering events.

  FFIIEELLDD	     DDEESSCCRRIIPPTTIIOONN

  Event Name
	    Select this to filter events eeqquuaall ttoo or nnoott eeqquuaall ttoo a specific
	    eevveenntt nnaammee.

	    DDaattaa TTyyppee:: Alphanumeric
	    FFoorrmmaatt:: A dot separated event name.	 The name may include "*" and
	    "?" wwiillddccaarrdd specifiers.  A wildcard may be used for a name
	    component.	A wildcard may not be used with any other character
	    in a single name component.
	    MMaannddaattoorryy//OOppttiioonnaall:: Optional

  Posting Host:
	    Select this to filter events with a ppoossttiinngg hhoosstt name eeqquuaall ttoo or
	    nnoott eeqquuaall ttoo a specific hhoosstt nnaammee.

	    DDaattaa TTyyppee:: Alphanumeric
	    MMaannddaattoorryy//OOppttiioonnaall:: Optional
	    DDeeffaauulltt:: None

  Priority: Select this to filter events based on their eevveenntt pprriioorriittyy.
	    Events may be selected which are eeqquuaall ttoo or nnoott eeqquuaall ttoo a
	    priority value or range of values as shown in the following list.

	    Range     Only events with priority within this range are
		      evaluated for selection or rejection.

	    Absolute  Only events with priority equal to this value are
		      evaluated for selection or rejection.

	    Min	      Only events with priority of this value or higher are
		      evaluated for selection or rejection.

	    Max	      Only events with priority of this value or lower are
		      evaluated for selection or rejection.

	    A priority value is entered in the available fields.
	    DDaattaa TTyyppee:: Numeric
	    MMaannddaattoorryy//OOppttiioonnaall:: Optional
	    VVaalliidd VVaalluueess:: 0 to 700
	    DDeeffaauulltt:: Range 600 - 700
	    DDeeffaauulltt:: Absolute 0
	    DDeeffaauulltt:: Min 0
	    DDeeffaauulltt:: Max 700

  Before    Select this to filter events that have an eevveenntt ttiimmeessttaammpp that is
	    at or before the specified date and time.

	    The date and time specification is as follows.  The use of the
	    date and time specification is optional, but, if used, all fields
	    must be entered.

	    Day	      DDaattaa TTyyppee:: Numeric
		      VVaalliidd VVaalluueess:: 1 to the number of days in the month
		      DDeeffaauulltt:: Current Day

	    Month     The month, selected from the available list.
		      DDeeffaauulltt:: Current Month

	    Year      DDaattaa TTyyppee:: Numeric
		      VVaalliidd VVaalluueess:: 1970 to 2030
		      DDeeffaauulltt:: Current Year

	    hh	      Hour
		      DDaattaa TTyyppee:: Numeric
		      VVaalliidd VVaalluueess:: 0 to 23
		      DDeeffaauulltt:: 0

	    mm	      Minute
		      DDaattaa TTyyppee:: Numeric
		      VVaalliidd VVaalluueess:: 0 to 59
		      DDeeffaauulltt:: 0

	    ss	      Second
		      DDaattaa TTyyppee:: Numeric
		      VVaalliidd VVaalluueess:: 0 to 59
		      DDeeffaauulltt:: 0

  Since	    Select this to filter events that have an eevveenntt ttiimmeessttaammpp that is
	    at or after the specified date and time.

	    The date and time specification is the same as shown for the
	    BBeeffoorree field.  The use of the date and time specification is
	    optional, but, if used, all fields must be entered.

  Age	    Select this to filter events based on their age using a numeric
	    value.  Refer to the EvmFilter(5) reference page for more infor-
	    mation.  Event vvaalluueess that are less than or more than a given
	    range as shown in the following list may be entered.

	    days      The number of days

	    weeks     The number of weeks

	    hours     The number of hours

	    minutes   The number of minutes

	    seconds   The number of seconds

  BBUUTTTTOONN     DDEESSCCRRIIPPTTIIOONN

  OK	    Rereads events using this filter and closes the dialog box.

  Apply	    Rereads events using this filter without closing the dialog box.

  Cancel    Closes the dialog box without rereading events.

  Help	    Displays help for the dialog box.

SSeeee AAllssoo

    oo++  Section 2.2, Advanced Filter Dialog Box

    oo++  evmwatch(1) reference page

    oo++  evmlogger(8) reference page

=============================================================================

22..1111  GGeett EEvveennttss ffrroomm DDiiaalloogg BBooxx

  Use this dialog box to select a source for stored event logs.

  FFIIEELLDD	     DDEESSCCRRIIPPTTIIOONN

  Select event source:
	    Select the source of events, either from a locally stored file or
	    by subscription to a host.

	    FFIIEELLDD      DDEESSCCRRIIPPTTIIOONN

	    file      Obtains events from a file.

	    host      Obtains events from a host.

  Enter name of file:
	    Enter the name of the event file.  This field is only available
	    if ffiillee is selected.

	    DDaattaa TTyyppee:: Alphanumeric
	    MMaannddaattoorryy//OOppttiioonnaall:: Mandatory when allowed
	    VVaalliidd VVaalluueess:: Any file name
	    DDeeffaauulltt:: None

  Get events from host:
	    Select the host where the event logs are stored.  This choice is
	    available only if hhoosstt is selected.

	    FFIIEELLDD      DDEESSCCRRIIPPTTIIOONN

	    local     Obtains events from the log files on the llooccaall hhoosstt.

	    remote    Obtains events from the log files on a rreemmoottee hhoosstt.

		      Enter or modify the name of the host where the event
		      logs are stored.	A list of host names, separated by
		      spaces, may be supplied to obtain events from several
		      hosts.

		      DDaattaa TTyyppee:: Alphanumeric
		      MMaannddaattoorryy//OOppttiioonnaall:: Mandatory when rreemmoottee is selected.
		      VVaalliidd VVaalluueess:: The allowable names and the detail
		      required depend on the local host configuration.
		      DDeeffaauulltt:: None

  BBUUTTTTOONN     DDEESSCCRRIIPPTTIIOONN

  OK	    Reads event summaries from this source and closes the dialog box.

  Apply	    Reads event summaries from this source without closing the dialog
	    box.

  Cancel    Closes the dialog box without reading event summaries.

  Help	    Displays help for the dialog box.

=============================================================================

22..1122  OOppttiioonnss DDiiaalloogg BBooxx

  Use this dialog box to access additional options for the Event Viewer.

  FFIIEELLDD	     DDEESSCCRRIIPPTTIIOONN

  Select an option
	    Select one of the options presented to obtain the result you
	    want.

	    OOppttiioonn     RReessuulltt

	    Advanced filter...
		      Opens the Advanced Filter dialog box to perform
		      advanced filter selection and maintenance actions.

	    Get events from...
		      Opens the Get Events from dialog box to select a source
		      of events.

	    Print event summaries...
		      Opens the Print Event Summaries dialog box to print the
		      event summaries.

	    Save event summaries to a file...
		      Opens the Save Event Summaries dialog box to save the
		      event summaries.

  BBUUTTTTOONN     DDEESSCCRRIIPPTTIIOONN

  OK	    Applies the selected option and closes this dialog box.  If the
	    option invokes another dialog box, that box is opened at this
	    time.

  Apply	    Applies the selected option without closing this dialog box.  If
	    the option invokes another dialog box, that box is opened at this
	    time.

  Cancel    Closes the dialog box without applying any option.

  Help	    Displays help for the dialog box.

=============================================================================

22..1133  PPrriinntt EEvveenntt SSuummmmaarriieess DDiiaalloogg BBooxx

  Use this dialog box to print the event summaries.

  FFIIEELLDD	     DDEESSCCRRIIPPTTIIOONN

  Print Command:
	    Enter or modify a UNIX command to print the event summaries.

	    DDaattaa TTyyppee:: Alphanumeric
	    MMaannddaattoorryy//OOppttiioonnaall:: Mandatory
	    VVaalliidd VVaalluueess:: Any command acceptable to the operating system
	    DDeeffaauulltt:: /usr/bin/lpr

  BBUUTTTTOONN     DDEESSCCRRIIPPTTIIOONN

  OK	    Prints the event summaries and closes the dialog box.

  Apply	    Prints the event summaries without closing the dialog box.

  Cancel    Closes the dialog box without printing.

  Help	    Displays help for the dialog box.

SSeeee AAllssoo

    oo++  Section 2.7, Event Details: Print Dialog Box

    oo++  lpr(1) reference page

    oo++  lp(1) reference page

    oo++  pr(1) reference page

=============================================================================

22..1144  SSaavvee EEvveenntt SSuummmmaarriieess DDiiaalloogg BBooxx

  Use this dialog box to save the event summaries to a file.

  FFIIEELLDD	     DDEESSCCRRIIPPTTIIOONN

  Save to File
	    Enter or modify the name of a file where the event summaries are
	    to be stored.  If the file does not exist, it will be created.
	    If the file exists, the option to replace it or add to it will be
	    presented.

	    DDaattaa TTyyppee:: Alphanumeric
	    MMaannddaattoorryy//OOppttiioonnaall:: Mandatory
	    VVaalliidd VVaalluueess:: Any file name.  The path to the file is relative to
	    the directory from which the Event Viewer was started, unless an
	    aabbssoolluuttee ppaatthhnnaammee is specified.
	    DDeeffaauulltt:: summaries.txt

	    If Event Viewer cannot write the file to your specified location,
	    it will attempt to write the file to your default temporary
	    directory.

  BBUUTTTTOONN     DDEESSCCRRIIPPTTIIOONN

  OK	    Saves the event summaries and closes the dialog box.

  Cancel    Closes the dialog box without saving event summaries.

  Help	    Displays help for the dialog box.

SSeeee AAllssoo

    oo++  Section 2.8, Event Details: Save Dialog Box

    oo++  Section 2.9, File Exists Dialog Box

=============================================================================

22..1155  SSoorrtt EEvveenntt SSuummmmaarriieess DDiiaalloogg BBooxx

  When this dialog box is opened, the currently active sort key and sort
  order are indicated.

  Use this dialog box to select the sort key, that is the event data item
  determining the order of events, and sort sequence, ascending order or des-
  cending order, for event summaries.

  FFIIEELLDD	     DDEESSCCRRIIPPTTIIOONN

  Sort Key  Choose the sort key for sorting the event summaries.  The events
	    in the display will be ordered by the value in this event data
	    item.  The content of each item is indicated in the description
	    of the CCuussttoommiizzee dialog box.  Only one item may be selected.

  Sort Order
	    Use the selectors to choose the ordering for the sorted event
	    summaries.

	    Ascending Sorts event summaries in aasscceennddiinngg oorrddeerr.

	    Descending
		      Sorts event summaries in ddeesscceennddiinngg oorrddeerr.

  BBUUTTTTOONN     DDEESSCCRRIIPPTTIIOONN

  OK	    Sorts the event summaries and closes the dialog box.

  Apply	    Sorts the event summaries without closing the dialog box.

  Cancel    Closes the dialog box without resorting the event summaries.

  Help	    Displays help for the dialog box.

SSeeee AAllssoo

    oo++  Section 2.5, Customize Dialog Box

    oo++  evmsort(1) reference page

=============================================================================

33  TTrroouubblleesshhoooottiinngg

  This section describes some problems you may encounter using Event Viewer
  and suggests corrective action.  Error messages presented by the Event
  Viewer are self-explanatory, and indicate corrective action, so they are
  not described in this section.

  EERRRROORR CCOONNDDIITTIIOONN
	    DDEESSCCRRIIPPTTIIOONN

  The IInniittiiaalliizziinngg...... or WWoorrkkiinngg...... messages remain.
	    DDeessccrriippttiioonn:: These messages seem to indicate that the system is
	    hung.
	    PPoossssiibbllee CCaauussee:: The initialization or refresh process may require
	    several minutes, depending on the number of log files stored on
	    the host, the size of the files, filters or sort specifications
	    applied, and the speed of the network if the events are being
	    supplied by a one or more remote hosts.
	    SSuuggggeesstteedd AAccttiioonn:: Review the current display, filter, and sort
	    specifications applied.

=============================================================================

44  AAbboouutt EEvveenntt VViieewweerr

  Copyright 1999 Compaq Information Technologies Group, L.P.

  Compaq, the Compaq logo and Tru64 are trademarks of Compaq Information
  Technologies Group, L.P.  in the U.S.	 and/or other countries.
  Motif, OSF/1, UNIX, and the `X Device' are trademarks of The Open Group in
  the U.S.  and/or other countries.
  All other product names mentioned herein may be the trademarks of their
  respective companies.

  Confidential computer software.  Valid license from Compaq required for
  possession, use or copying.  Consistent with FAR 12.211 and 12.212, Commer-
  cial Computer Software, Computer Software Documentation,  and Technical
  Data for Commercial Items are licensed to the U.S.  Government under
  vendor's standard commercial license.
  Compaq shall not be liable for technical or editorial errors or omissions
  contained herein.  The information in this document is provided `as is'
  without warranty of any kind and is subject to change without notice.
  The warranties for Compaq products are set forth in the express limited
  warranty statements accompanying such products.  Nothing herein shall be
  construed as constituting an additional warranty.

SSeeee AAllssoo

    oo++  Section 4.1, Additional Trademark and Product Information

=============================================================================

44..11  AAddddiittiioonnaall TTrraaddeemmaarrkk aanndd PPrroodduucctt IInnffoorrmmaattiioonn

  All other product names mentioned herein may be the trademarks of their
  respective companies.

=============================================================================

GGlloossssaarryy

  aabbssoolluuttee ppaatthhnnaammee

       A pathname that begins at the root directory; a pathname that always
       begins with a slash (/).	 For example, /usr/bin is an absolute path-
       name.  Also called a full pathname.  Contrast with  rreellaattiivvee ppaatthhnnaammee.
       See also ppaatthhnnaammee

  aasscceennddiinngg oorrddeerr

       An order of sorting that starts with the lowest value of a key and
       proceeds to the highest value in accordance with the rules for compar-
       ing data items in the current locale.  For time based sorts, this
       implies earliest or oldest first.

  AASSCCIIII

       American Standard Code for Information Interchange.  A set of 8-bit
       binary numbers representing the alphabet, punctuation, numerals, and
       other special symbols used in text representation and communications
       protocol.

  CCDDEE

       Common Desktop Environment.  The graphical user interface running on
       the desktop.  CDE is compatible with the X Window System.

  CCDDEE ffrroonntt ppaanneell

       A centrally located window on the CDE desktop containing controls for
       accessing applications and utilities including workspaces.  The Front
       Panel occupies all workspaces.  See also CCDDEE

  ddeesscceennddiinngg oorrddeerr

       An order of sorting that starts with the highest value of a key and
       proceeds to the lowest value in accordance with the rules for compar-
       ing data items in the current locale.  For time based sorts, this
       implies latest or newest first.

  eevveenntt

       Something that happens that may be of interest either to some part of
       a local or remote system or to a user.

  eevveenntt ddeettaaiill

       A format that presents all event data items, including variables, in a
       fixed manner.  This format is used for in-depth analysis of an event.

  eevveenntt ffiilltteerr

       An event filter is an ASCII character string used to select interest-
       ing events from an event stream.	 See also AASSCCIIII

  eevveenntt mmaannaaggeemmeenntt

       A facility for communicating event information to interested parties
       for immediate or later action.  An event management system may include
       storage and retrieval facilities.

  eevveenntt mmoonniittoorriinngg

       A capability to recognize, in real time, the posting of an event.

  eevveenntt nnaammee

       The EVM event name is an ASCII character string, made up of a dot-
       separated series of components, with the left-most component
       representing the top of a notational hierarchy.	Component substrings
       may include any combination of letters, digits, and underbar charac-
       ters.  There is no restriction on the number of components that can be
       included in an event name.

  eevveenntt pprriioorriittyy

       The EVM event priority is an integer value in the range 0-700, with
       zero being the least significant priority.  The priority is assigned
       by the posting client.  EVM uses an event priority value solely for
       filtering, sorting and presentation purposes.  See also ppoossttiinngg cclliieenntt

  eevveenntt ssuummmmaarryy

       A format that presents event data items in an abbreviated form.	A
       subset of the standard event data items may be selected for presenta-
       tion.  This format is used to scan a quantity of events to identify or
       isolate a specific event.

  eevveenntt ttiimmeessttaammpp

       The UNIX system time when the event was generated.  If the event
       includes a repeat count, the event timestamp represents the time of
       the first occurrence.

  EEVVMM

       The implementation on this operating system of an event management
       system.	See also eevveenntt mmaannaaggeemmeenntt

  EEVVMM cclliieenntt

       Any program that processes events through a connection to the EVM dae-
       mon.  See also eevveenntt and EEVVMM

  EEVVMM wwiillddccaarrdd

       An EVM event name selector may include asterisk (*) and question mark
       (?) wildcard characters in any component position.  An asterisk
       represents 0 or more components with any value.	A question mark
       represents exactly one component.  See also eevveenntt nnaammee

  hhoosstt

       (1) The primary or controlling computer in the communications network.
       (2) A computer attached to a network.

  hhoosstt nnaammee

       The name given to a system to identify it to local and remote users
       and to the network.  Lowercase and uppercase letters (a-z and A-Z),
       numbers (0-9), periods, and dashes are permitted in host names.	Valid
       host names contain from 2 to 63 characters with the first character
       being a letter.	See also  hhoosstt and nneettwwoorrkk

  lliisstteenniinngg cclliieenntt

       A client that uses the connection to the EVM daemon to listen for
       events distributed by the daemon.  Also known as a subscribing client.
       See also EEVVMM cclliieenntt

  llooccaall hhoosstt

       (1) The computer system to which your terminal is directly connected.
       (2) In event management, local host is the host on which the event
       viewer is running.  See also eevveenntt mmaannaaggeemmeenntt and  rreemmoottee hhoosstt

  nneettwwoorrkk

       Two or more computing systems that are linked for the purpose of
       exchanging information and sharing resources.

  ppaatthhnnaammee

       The name of a file, concatenated onto a list of the directories
       through which access to that file is achieved; hence, the complete
       name of the file.  Absolute pathnames begin at the root directory and
       are written with an initial slash (for example,
       /usr/users/test/myfile.txt).  Relative pathnames begin at the current
       working directory and are written without the initial slash (for exam-
       ple, test/myfile.txt).

  ppoossttiinngg cclliieenntt

       A client that uses a connection to the EVM daemon to post events to
       the daemon for distribution.  See also EEVVMM cclliieenntt

  ppoossttiinngg hhoosstt

       The name of the host where an event was generated.  See also  eevveenntt

  rreellaattiivvee ppaatthhnnaammee

       A pathname that begins at the user's current working directory; it is
       written without the initial slash.  For example, docs/myfile.txt is a
       relative pathname.  Contrast with aabbssoolluuttee ppaatthhnnaammee.  See also ppaatthh--
       nnaammee

  rreemmoottee hhoosstt

       (1) Any node in a network other than your local node.  (2) In event
       management, the remote host is any host other than the host on which
       the event viewer is running.  See also eevveenntt mmaannaaggeemmeenntt and llooccaall hhoosstt

  rreettrriieevviinngg cclliieenntt

       A client that uses a connection to the EVM daemon to retrieve events
       from the log files.  See also EEVVMM cclliieenntt

  SSyyssMMaann MMeennuu

       A menu of system management tasks organized in a tree-like hierarchy
       with branches of general functionality, and leaves for actual tasks.
       Selecting a leaf invokes a task, which opens a dialog box for perform-
       ing the task.  Depending on the user's display device, the SysMan Menu
       provides either a graphical or text-based interface.  The SysMan Menu
       is invoked from the command line by entering /usr/sbin/sysman or from
       the CDE Application Manager if your system is running the CDE desktop.
