Parameter

Arthur Foster

Hillman House, 4, Madeira Road,

Parkstone, Poole, Dorset BH14 9ET

Description of GDMO
Parameter

e-mail:	arthur@arthurfoster.com
tel:	+44 (01202) 469468
fax:	+44 (01202) 469861

Parameter Example

The Parameter template enables the syntax of an attribute, notification, or action to be extended to include additional syntax. This can include additional errors, additional replies, additional information in requests.

Parameters references can be added to any CMIS operation. Specifically PACKAGE, ATTRIBUTE, ACTION, NOTIFICATION, and NAME BINDING templates can include parameter references. In packages references to actions, notifications and attributes can include a reference to a parameters that extend that syntax in that context.

       name PARAMETER
                CONTEXT  context ;
                WITH SYNTAX  reference;
                BEHAVIOUR  behaviour ... ;
        REGISTERED AS  object identifier;

The behaviour identifier in BEHAVIOUR clause identifies a behaviour template that specifies the associated behaviour. The behaviour definition is optional.

The context defines the circumstances in which the parameter is expected to be used. These include:

ACTION-INFO which indicates that the parameter is carried in an ACTION request;

ACTION-REPLY which indicates that the parameter is carried in an ACTION reply;

EVENT-INFO which indicates that the parameter is carried in EVENT request;

EVENT-REPLY which indicates that the parameter is carried in EVENT reply;

SPECIFIC-ERROR which indicates that the parameter is carried in processing failure error.

In addition to these defined types it is also possible to use a parameter in a specific context defined by a type defined in ASN.1. The ASN.1 definition must included an OBJECT IDENTIFIER that indicates a registered value. This type of construction is called an information object class in ASN.1 and has special definitions.

The WITH SYNTAX reference defines the information carried in the notification request. The reference identifies a ASN.1 production that defines the syntax of information. The reference consists of an ASN.1 module containing the production and is followed by the name of the ASN.1 production.

The REGISTERED AS object identifier is a unique identity that is used in the protocol to identify this particular parameter.


Author: Arthur Foster 28 May 2002	Arthur Foster is a founder member of
Author: Arthur Foster 28 May 2002		Hosted by