Arthur Foster

Hillman House,  4, Madeira Road,

Parkstone,  Poole,  Dorset   BH14 9ET

UK

Description of GDMO
 Action Example

e-mail:

arthur@arthurfoster.com

tel: 

+44 (01202) 469468

fax:

+44 (01202) 469861

  

Home Site Map Search

Home Up Action Example Attribute Example Attribute Group Example Behaviour Example Managed Object Example Name Binding Example Notification Example Package Example Parameter Example

 
Action Template
Action Operation

 
This example of an ACTION template is taken from the Network Management Forum specification of the Test Object used in testing an interface.

This example ACTION is very simple. It is part of a simple test system to receive the trigger, this ACTION, to perform the test and then reply with a NOTIFICATION. In other words it is simply a test of the ACTION and the NOTIFICATION capabilities of the interface.

Normally an ACTION would be much more complex. This example is simply illustrative, although it has often been used to test an interface.

 

Action Example

 
 
    toTrigger  ACTION
        BEHAVIOUR toTriggerBehaviour;
        WITH INFORMATION SYNTAX FORUMASN11.ToTrig;
        REGISTERED AS {forumaction 0};
 
    toTriggerBehaviour BEHAVIOUR
        DEFINED AS !
        For each supported alarm notification, the
        FORUM Test Object Shall emit the alarm
        notification in response to the toTrigger
        M-ACTION request. The notification emitted
        shall be determined by the contents of
        the ToTrig field.
        !;

 

The WITH INFORMATION SYNTAX field specifies an ASN.1 data structure that is carried in the arguments of the ACTION operation. In a more complex example the syntax would include information needed to perform the action. In this example the source of the ASN.1 data structure specification is identified as:

FORUMASN11.ToTrig

This is known as a type reference. The type reference has two parts: 

  1. an ASN.1 module name, which identifies the ASN.1 containing the data structure to be employed; and,

  2. an ASN.1 type identifier which must be defined in that module (although it could be imported).

The ASN.1 module is named "FORUMASN11" and the type identifier is "ToTrig" in this case.

The ASN.1 is a simple type in this example, but in a more complex example the ASN.1 syntax would be more complex. Often it is important to be able to qualify the ASN.1 syntax with a PARAMETER. Using a parameter enables the specification to be extended and is especially important for error conditions and other exceptions.

There is no WITH REPLY SYNTAX clause in the example as no reply is required. The reply syntax is also expressed as type reference.

 
 
Author: Arthur Foster
28 May 2002

Arthur Foster is a

founder member of

 
 

Hosted by