| The following is the example MS that has been proposed to go along with the
srm definition of the getevent directive. If you want to work with the
V1.2 notification services please use this .MS file. I will post updates
when this has completed the MRG (MCC review group) reivew process for
approving ECO's to the SRM.
jill
(******************************************************************************)
(* *)
(* Management Specification for GETEVENT directive *)
(* *)
(******************************************************************************)
(* **************************************************************
* ********************************************************** *
* * * *
* * Copyright (c) Digital Equipment Corporation, 1990 * *
* * All Rights Reserved. Unpublished rights reserved * *
* * under the copyright laws of the United States. * *
* * * *
* * The software contained on this media is proprietary * *
* * to and embodies the confidential technology of * *
* * Digital Equipment Corporation. Possession, use, * *
* * duplication or dissemination of the software and * *
* * media is authorized only pursuant to a valid written * *
* * license from Digital Equipment Corporation. * *
* * * *
* * RESTRICTED RIGHTS LEGEND Use, duplication, or * *
* * disclosure by the U.S. Government is subject to * *
* * restrictions as set forth in Subparagraph (c)(1)(ii) * *
* * of DFARS 252.227-7013, or in FAR 52.227-19, as * *
* * applicable. * *
* * * *
* ********************************************************** *
************************************************************** *)
TYPE
OSI_Severity = 1
(
indeterminate = 0,
critical = 1,
major = 2,
minor = 3,
warning = 4,
clear = 5
);
TYPE
OSI_Mode = 2
(
confirmed = 0,
non-confirmed = 1
);
(*
*
* DESCRIPTION This service is used to request any events designated by the
* P-component of the <V,E,P>-tuple and the Events Wanted argument. The
* partition specifies which set of events are requested, with the Events
* Wanted argument being used to qualify specific events in the partition.
* All events are returned using the GETEVENT SUCCESS response.
*
* When returning an OSI compliant event, the Mode argument must be
* returned. The Managed Object field is optionally returned. The data in
* the Event Data argument makes up the remainder of the event information.
* The event identifier returned in the event report should be used to look
* up the CMIP object identifier in the dictionary, for the event type. The data
* in the event report should include the event data fields specific to the
* event type, as specified in the ISO OSI specifications.
*
* The target arguments, target entity and target severity, allow the event
* source to provide added value. These fields supply the means in which an
* event source can specify a target entity different from the managed
* object, or to modify the event or severity information (See ISO/IEC DP
* 10164-4 chapter 7 for information on the different views of severity at
* different layers in the management hierarchy). If the target severity is
* specified on an OSI compliant event, then the value in the target
* severity argument should be used instead of the severity returned in the
* event report.
*
* When returning OSI clear events, the clear can only be determined if an
* existing event report has already been received with the same data values
* for the Managed Object, alarm type, problem type and problem ID (event
* type, specific problem, and probable cause -- OSI terms).
*
* If the duration of interest for the GETEVENT expires, then the
* Getevent_Nomore response is returned to signal the completion of the
* request.
*
* The specialized exception of Getevent_Lost is used to inform the user
* when events have been lost by the Event Manager. This is not a fatal or
* failure condition. This exception should be used in conjunction with a
* handle state of MCC_K_HANDLE_MORE, as long as the duration has not
* expired, allowing the service requester to continue with the next
* available event.
*
*)
(*
* Directive == GETEVENT
*)
DIRECTIVE GetEvent = 65 :
DIRECTIVE-TYPE = EVENT,
DISPLAY = TRUE,
SYMBOL = VERB_GETEVENT,
CATEGORIES = (ALL),
(*
* Request Arguments
*)
REQUEST
ARGUMENT Events Wanted = 01 : EventIdList
ECHO = TRUE,
DISPLAY = TRUE,
REQUIRED = TRUE,
DEFAULT = NO DEFAULT,
SYMBOL = EVT_IDS
END ARGUMENT Events Wanted;
END REQUEST;
(*
* Response == GETEVENT_SUCCESS
*)
RESPONSE GetEvent Success = 01 :
SYMBOL = GETEVENT_SUCCESS,
ARGUMENT Event Data = 01 : Event_report
DISPLAY = TRUE,
SYMBOL = ARG_EVENT_DATA
END ARGUMENT;
ARGUMENT Mode = 02 : OSI_Mode
DISPLAY = FALSE,
SYMBOL = ARG_MODE
END ARGUMENT;
ARGUMENT Managed Object = 03 : FullEntityName
DISPLAY = TRUE,
SYMBOL = ARG_MANAGED_OBJECT
END ARGUMENT;
ARGUMENT Target Entity = 04 : FullEntityName
DISPLAY = TRUE,
SYMBOL = ARG_TARGET_ENTITY
END ARGUMENT;
ARGUMENT Target Severity = 05 : OSI_Severity
DISPLAY = TRUE,
SYMBOL = ARG_TARGET_SEVERITY
END ARGUMENT;
END RESPONSE GetEvent Success;
(*
* Response == GETEVENT_NOMORE
*)
RESPONSE GetEvent NoMore = 02 :
SYMBOL = GETEVENT_NOMORE,
TEXT = "Time Scope of Interest Expired, No More Events",
(* No Arguments *)
END RESPONSE GetEvent NoMore;
(*
* Exception == GETEVENT_LOST
*)
EXCEPTION GetEvent Lost = 01 :
SYMBOL = GETEVENT_LOST,
TEXT = "An Event was reported lost !<Arg Event Lost Count> times by the Event Manager",
ARGUMENT Arg Event Lost Count = 1: Unsigned32
SYMBOL = ARG_EVENT_LOST_COUNT,
DISPLAY = FALSE
END ARGUMENT Arg Event Lost Count;
END EXCEPTION GetEvent Lost;
END DIRECTIVE GetEvent;
|