[Search for users] [Overall Top Noters] [List of all Conferences] [Download this site]

Conference azur::mcc

Title:DECmcc user notes file. Does not replace IPMT.
Notice:Use IPMT for problems. Newsletter location in note 6187
Moderator:TAEC::BEROUD
Created:Mon Aug 21 1989
Last Modified:Wed Jun 04 1997
Last Successful Update:Fri Jun 06 1997
Number of topics:6497
Total number of notes:27359

1619.0. "what is the GETEVENT in_p argument ?" by KETJE::PACCO (To manage you have to be a (manag..) skilled person!) Tue Oct 08 1991 19:05

    According the SRM the request argument of a GETEVENT is an 
    EventIdList , which is a construction of event NAMES (in
    Latin1String).  This is clearly shown in the example page 156.
    
    The ILV encoding of in_p of a GETEVENT directive shows however a
    construction with as elements a number of bytes, each associated
    with the corresponding named event.
    
    Is this an inconsistency, or do I misinterpret the SRM ?

    
	Regards,
	Dominique.
    
T.RTitleUserPersonal
Name
DateLines
1619.1The argument to a GETEVENT directive is an EventIdListNANOVX::ROBERTSKeith Roberts - DECmcc Toolkit TeamWed Oct 09 1991 13:0523
>    According the SRM the request argument of a GETEVENT is an 
>    EventIdList , which is a construction of event NAMES (in
>    Latin1String).  This is clearly shown in the example page 156.

The MSL code-segment is correct.  The 'Which Events' argument *is* an
"EventIdList".  What seems to be incorrect, however, is the 
"REQUIRED=TRUE" line.  The 'Which Events' is optional, and if not
present in the request indicates *all* events (ie, a wildcard).


You are probably getting confused by the BNF information for EvnetIDList

On page 264 (section 9.3.8 Event ID List), the SRM says:

  <EventIDList> ::= <Event-Name> { "," <Event-Name> }
  <Event-Name>  ::= <Latin1Char> { <Latin1Char> }

An Event Id List, INTERNALLY, is a setof Unsigned32 values - each value is an
Event Id for the target Entity of the GETEVENT directive.  

EXTERNALLY, the Event Id List is a list of Event Names.  I think the
Event-Name should have been <Latin1String> instead of <Latin1Char>, but
I'm not a BNF expert.
1619.2TOOK::STRUTTManagement - the one word oxymoronThu Oct 10 1991 14:369
    I hate to be picky, but:
    
.1>			The 'Which Events' is optional, and if not
.1> present in the request indicates *all* events (ie, a wildcard).
    
    If Which Events argument is missing, it indicates that *any* event
    may be returned.
    
    Colin
1619.3Ok - *any* event, not *all* eventsNANOVX::ROBERTSKeith Roberts - DECmcc Toolkit TeamThu Oct 10 1991 14:5710
Ok - *any* event, not *all* events,
that makes sense - sorry if I confused anyone.

.1> 
But - As far as the "REQURIED=TRUE" statement in the MSL for
the Getevent directive argument 'Which Event' .. which is it?
Should it be True, or False ??

/keith
1619.4Recommend you use REQUIRED=FALSE for GetEvent argTOOK::STRUTTManagement - the one word oxymoronTue Oct 15 1991 11:567
    re: .3
    The standardised directive in chapter 15 shows the request argument
    Events Wanted as optional.
    The example MSL does not adhere to the standardised directive - this is
    clearly an oversight - QAR #1012 has been entered.
    
    Colin
1619.5TOOK::STRUTTManagement - the one word oxymoronTue Oct 15 1991 12:013
    Oh, and isn't it good timing - Keith is the new owner of SRM chapter 7.
    
    :-}
1619.6Great timing -NANOVX::ROBERTSKeith Roberts - DECmcc Toolkit TeamTue Oct 15 1991 15:135
>>  Oh, and isn't it good timing - Keith is the new owner of SRM chapter 7

I couldn't have planned it better myself

8)
1619.7ECO 111 - getevent definition changingTOOK::CALLANDERMCC = My Constant CompanionWed Oct 23 1991 20:5411
Just be warned...ECO 111 which should be out for full MRG review any
moment now (MASG has the updated copy ready for distribution to the
masses), modifies the GETEVENT directive to support the added value
functions of the V1.2 notification FM. So if you are just adding in
support for the GETEVENT directive you will want to get a copy of
the eco when distributed. The ECO does *NOT* change the calling
arguments or response codes, but addes new arguments and exceptions
to allow more information to be returned, including OSI compliant
events.

jill