home *** CD-ROM | disk | FTP | other *** search
- --Annex C
- --Syntax Imported from ISO 10165-5 (SC6 GMI)
- --(This annex is normative)
-
-
- -- Generic Managed Object Class Definitions
-
- MODULE "Rec. X.723 | ISO/IEC 10165-5"
-
- -- Communication information record
-
- -- The communicationsInformationRecord object class is used to define
- -- the information stored in a log as a result of receiving event reports
- -- with a communication information event type. The semantics of the
- -- object class, namely its attributes and behaviour, are derived from
- -- the communicationsInformation notification.
-
- communicationsInformationRecord MANAGED OBJECT CLASS
- DERIVED FROM "Rec. X.721 | ISO/IEC 10165-2 : 1992":eventLogRecord;
- CHARACTERIZED BY communicationsInformationRecordP1 PACKAGE
- BEHAVIOUR communicationsInformationRecordB1 BEHAVIOUR
- DEFINED AS
- !Log record class for communicationsInformation events.!;
- ;
- ATTRIBUTES
- informationType GET;
- ;;
- CONDITIONAL PACKAGES
- informationDataPackage PACKAGE
- ATTRIBUTES
- informationData GET;
- REGISTERED AS {CommonMgt.poi informationDataPackage(1001)};
- PRESENT IF !The informationData parameter is present in the
- communicationsInformation event report corresponding to
- the instance of communicationsInformationRecord.!;
- REGISTERED AS {CommonMgt.moi communicationsInformationRecord(1101)};
-
- -- Communications entity
-
- -- Summary of changes to 10165-5:
-
- -- 1. Added CCITT part to document references.
-
- -- 2. Gave plural labels to set-valued attributes.
- -- 3. Fixed typo in label communicationsEentityId.
- -- 4. Did not register mandatory package.
-
- communicationsEntity MANAGED OBJECT CLASS
- DERIVED FROM "Rec. X.721 | ISO/IEC 10165-2 : 1992":top;
- CHARACTERIZED BY communicationsEntityP1 PACKAGE
- BEHAVIOUR
- communicationsEntityB1 BEHAVIOUR
- DEFINED AS
- !A communications entity supports the disabled and enabled
- values of the operationalState attribute as described in
- CCITT Rec. X.731 | ISO/IEC 10164-2 as follows:
- - an entity is disabled if it is inoperable or a resource
- upon which it depends is inoperable.
- - an entity is enabled if it is operable.!;
- ;
- ATTRIBUTES communicationsEntityId GET,
- localSapNames GET,
- "Rec. X.721 | ISO/IEC 10165-2 : 1992":operationalState GET;
- ;;
- REGISTERED AS {CommonMgt.moi communicationsEntity(1002)};
-
-
- -- Connection
-
- -- Summary of changes to 10165-5:
-
- -- 1. Added CCITT part to document references.
- -- 2. Gave plural label to set-valued attribute.
- -- 3. Did not register mandatory package.
- -- 4. Removed attributes not generally applicable in all layers.
-
- connection MANAGED OBJECT CLASS
- DERIVED FROM "Rec. X.721 | ISO/IEC 10165-2 : 1992":top;
- CHARACTERIZED BY connectionP1 PACKAGE
- BEHAVIOUR
- connectionB1 BEHAVIOUR
- DEFINED AS
- !This managed object class represents the view of a
- single-peer connection between a pair of entities as seen
- by the local entity.!;
- ;
- ATTRIBUTES connectionId GET,
- underlyingConnectionNames GET;
- ;;
- REGISTERED AS {CommonMgt.moi connection(1003)};
-
-
-
- -- Connectionless-mode Protocol Machine
-
- -- Summary of changes to 10165-5:
-
- -- 1. Added CCITT part to document references.
- -- 2. Did not register mandatory package.
- -- 3. Changed name of naming attribute to clProtocolMachineId.
- -- 4. Removed DEFAULT VALUE and REQUIRED VALUES on naming attribute.
- -- 5. Generalised description.
-
- clProtocolMachine MANAGED OBJECT CLASS
- DERIVED FROM "Rec. X.721 | ISO/IEC 10165-2 : 1992":top;
- CHARACTERIZED BY clProtocolMachineP1 PACKAGE
- BEHAVIOUR
- clProtocolMachineB1 BEHAVIOUR
- DEFINED AS
- !A protocol machine which performs connectionless-mode
- communications functions.!;
- ;
- ATTRIBUTES clProtocolMachineId GET,
- "Rec. X.721 | ISO/IEC 10165-2 : 1992":operationalState GET;
- ;;
- REGISTERED AS {CommonMgt.moi clProtocolMachine(1004)};
-
-
- -- Connection-mode Protocol Machine
-
- -- Summary of changes to 10165-5:
-
- -- 1. Added CCITT part to document references.
- -- 2. Did not register mandatory package.
- -- 3. Changed name of naming attribute to coProtocolMachineId.
- -- 4. Removed DEFAULT VALUE and REQUIRED VALUES on naming attribute.
- -- 5. Generalised description.
-
- coProtocolMachine MANAGED OBJECT CLASS
- DERIVED FROM "Rec. X.721 | ISO/IEC 10165-2 : 1992":top;
- CHARACTERIZED BY coProtocolMachineP1 PACKAGE
- BEHAVIOUR
- coProtocolMachineB1 BEHAVIOUR
- DEFINED AS
- !A protocol machine which performs connection-mode
- communications functions.!;
- ;
- ATTRIBUTES coProtocolMachineId GET,
- "Rec. X.721 | ISO/IEC 10165-2 : 1992":operationalState GET;
- ;;
- REGISTERED AS {CommonMgt.moi coProtocolMachine(1005)};
-
-
-
- -- Sap 1
-
- -- Summary of changes to 10165-5:
-
- -- 1. Added CCITT part to document references.
- -- 2. Gave plural label to set-valued attribute.
- -- 3. Did not register mandatory package.
-
- sap1 MANAGED OBJECT CLASS
- DERIVED FROM "Rec. X.721 | ISO/IEC 10165-2 : 1992":top;
- CHARACTERIZED BY sap1P1 PACKAGE
- BEHAVIOUR
- sap1B1 BEHAVIOUR
- DEFINED AS
- !This managed object represents the point at which an
- entity provides services to the user entity. Refer to the
- Basic Reference Model for the definition of (N)-sap.!;
- ;
- ATTRIBUTES sapId GET,
- sap1Address GET,
- userEntityNames GET;
- ;;
- REGISTERED AS {CommonMgt.moi sap1(1008)};
-
- -- Sap 2
-
- -- Summary of changes to 10165-5:
-
- -- 1. Added CCITT part to document references.
- -- 2. Gave plural labels to set-valued attributes.
- -- 3. Did not register mandatory package.
-
- sap2 MANAGED OBJECT CLASS
- DERIVED FROM "Rec. X.721 | ISO/IEC 10165-2 : 1992":top;
- CHARACTERIZED BY sap2P1 PACKAGE
- BEHAVIOUR
- sap2B1 BEHAVIOUR
- DEFINED AS
- !A service access point, the address of which is
- independent of the SAP of the underlying layer.!;
- ;
- ATTRIBUTES sapId GET,
- sap2Addresses GET,
- userEntityNames GET,
- providerEntityNames GET;
- ;;
- REGISTERED AS {CommonMgt.moi sap2(1009)};
-
-
- -- Subsystem
-
- -- Summary of changes to 10165-5:
-
- -- 1. Added CCITT part to document references.
- -- 2. Fixed typo in naming attribute.
- -- 3. Did not register mandatory package.
-
- subsystem MANAGED OBJECT CLASS
- DERIVED FROM "Rec. X.721 | ISO/IEC 10165-2 : 1992":top;
- CHARACTERIZED BY subsystemP1 PACKAGE
- BEHAVIOUR
- subsystemB1 BEHAVIOUR
- DEFINED AS
- !This managed object class represents a portion of a
- system where components are named independently of the
- components of other subsystems.!;
- ;
- ATTRIBUTES subsystemId GET;
- ;;
- REGISTERED AS {CommonMgt.moi subsystem(1010)};
- --
- -- Attributes
-
- clProtocolMachineId ATTRIBUTE
- WITH ATTRIBUTE SYNTAX CommonMgt.ProtocolMachineId;
- MATCHES FOR EQUALITY;
- REGISTERED AS {CommonMgt.aoi clProtocolMachineId(1051)};
- communicationsEntityId ATTRIBUTE
- WITH ATTRIBUTE SYNTAX CommonMgt.CommunicationsEntityId;
- MATCHES FOR EQUALITY;
- REGISTERED AS {CommonMgt.aoi communicationsEntityId(1003)};
- informationData ATTRIBUTE
- WITH ATTRIBUTE SYNTAX CommonMgt.InformationData;
- REGISTERED AS {CommonMgt.aoi informationData(1052)};
- informationType ATTRIBUTE
- WITH ATTRIBUTE SYNTAX CommonMgt.InformationType;
- MATCHES FOR EQUALITY;
- REGISTERED AS {CommonMgt.aoi informationType(1053)};
- connectionId ATTRIBUTE
- WITH ATTRIBUTE SYNTAX CommonMgt.ConnectionId;
- MATCHES FOR EQUALITY;
- REGISTERED AS {CommonMgt.aoi connectionId(1004)};
-
- coProtocolMachineId ATTRIBUTE
- WITH ATTRIBUTE SYNTAX CommonMgt.ProtocolMachineId;
- MATCHES FOR EQUALITY;
- REGISTERED AS {CommonMgt.aoi coProtocolMachineId(1050)};
- localSapNames ATTRIBUTE
- WITH ATTRIBUTE SYNTAX CommonMgt.ProviderObjects;
- -- Note: Not derived from DMI.providerobject as in 10165-5.
- MATCHES FOR EQUALITY, SET-COMPARISON, SET-INTERSECTION;
- REGISTERED AS {CommonMgt.aoi localSapNames(1007)};
- nonWrappingCounter ATTRIBUTE
- WITH ATTRIBUTE SYNTAX CommonMgt.NonWrappingCounter;
- MATCHES FOR EQUALITY, ORDERING;
- BEHAVIOUR
- nonWrappingCounterB BEHAVIOUR
- DEFINED AS
- !Generic non-wrapping counter. Never instantiated - used
- to derive specific non-wrapping counter attributes. All counters
- derived from nonWrappingCounter shall have a mandatory initial value
- of zero. The value of a counter attribute derived from this shall be
- incremented by an amount as specified in the behaviour of the refined
- attribute, and shall increase monotonically. It shall be implemented
- in such a way that under all foreseable circumstances the upper bound
- on its value shall not be limited to a value less than 2^64-1. This does not
- require the system to maintain a 64-bit counter if the characteristics of the
- implementation are such that all achievable count values can be contained
- in a smaller number of bits.!;;
- ;-- Note, since this attribute is never instantiated, no object identifier
- -- is registered.
- providerEntityNames ATTRIBUTE
- WITH ATTRIBUTE SYNTAX CommonMgt.ProviderObjects;
- -- Note: Not derived from DMI.providerobject as in 10165-5.
- MATCHES FOR EQUALITY, SET-COMPARISON, SET-INTERSECTION;
- -- Note: The set-valued operations not specified in 10165-5.
- REGISTERED AS {CommonMgt.aoi providerEntityNames(1011)};
- sap1Address ATTRIBUTE
- WITH ATTRIBUTE SYNTAX CommonMgt.Sap1Address;
- MATCHES FOR EQUALITY;
- REGISTERED AS {CommonMgt.aoi sap1Address(1013)};
- sap2Addresses ATTRIBUTE
- WITH ATTRIBUTE SYNTAX CommonMgt.Sap2Addresses;
- MATCHES FOR EQUALITY, SET-COMPARISON, SET-INTERSECTION;
- BEHAVIOUR sap2AddressesB BEHAVIOUR
- DEFINED AS
- !The set of addresses of a SAP.!;;
- REGISTERED AS {CommonMgt.aoi sap2Addresses(1014)};
-
- sapId ATTRIBUTE
- WITH ATTRIBUTE SYNTAX CommonMgt.SapId;
- MATCHES FOR EQUALITY;
- REGISTERED AS {CommonMgt.aoi sapId(1015)};
- timer ATTRIBUTE
- WITH ATTRIBUTE SYNTAX CommonMgt.Timer;
- MATCHES FOR EQUALITY, ORDERING;
- BEHAVIOUR
- timerB BEHAVIOUR
- DEFINED AS
- !A timer whose value may be set and read to the precision
- implied by the syntax definition, but whose effect on the
- precision with which the protocol events controlled by this
- timer are generated is determined by the implementation. The
- details of this precision shall be stated in the MOCS. The
- exponent of the timer value shall be encoded as a decimal
- exponent in the exponent field of the syntax, i.e. the value
- of the timer shall be mantissa*10^exponent.!;;
- ;-- Note, since this attribute is never instaniated, no object identifier
- -- is registered.
- subsystemId ATTRIBUTE
- WITH ATTRIBUTE SYNTAX CommonMgt.SubsystemId;
- MATCHES FOR EQUALITY;
- REGISTERED AS {CommonMgt.aoi subsystemId(1016)};
- underlyingConnectionNames ATTRIBUTE
- WITH ATTRIBUTE SYNTAX CommonMgt.ProviderObjects;
- -- Note: Not derived from DMI.providerobject as in 10165-5.
- MATCHES FOR EQUALITY, SET-COMPARISON, SET-INTERSECTION;
- REGISTERED AS {CommonMgt.aoi underlyingConnectionNames(1019)};
- userEntityNames ATTRIBUTE
- WITH ATTRIBUTE SYNTAX CommonMgt.UserObjects;
- -- Note: Not derived from DMI.userobject as in 10165-5.
- MATCHES FOR EQUALITY, SET-COMPARISON, SET-INTERSECTION;
- REGISTERED AS {CommonMgt.aoi userEntityNames(1020)};
-
- -- Attribute groups
-
- counters ATTRIBUTE GROUP
- -- Empty group definition. Counters are added to the group in
- -- package definitions.
- DESCRIPTION
- !The group of all counter attributes.!;
- REGISTERED AS {CommonMgt.agoi counters(1001)};
-
-
- -- Actions
-
- activate ACTION
- BEHAVIOUR activateB BEHAVIOUR
- DEFINED AS
- !Initializes the operation of the resource. As a result of the action,
- the sequence of operations necessary to cause the resource to enter
- its operational mode shall be initiated. These may include, for example,
- checks against attribute constraint violation and checks on the validity of
- relationship attributes (cross-layer and other). If these operations are
- successfully initiated, the administrative state (if present) shall be
- changed to 'unlocked' and the value 'successResponse' shall be
- returned in the responseCode parameter of the action reply. If these
- operations cannot be successfully initiated, the value
- 'failureResponse' shall be returned,together with a failure reason
- parameter describing the reason for the failure.
- On successful completion of these operations, the operational state
- shall have the value 'enabled'.
- Depending on the current state of the resource, some or all of the
- above operations may be unneccessary.!;;
- MODE CONFIRMED;
- WITH REPLY SYNTAX CommonMgt.ActionReply;
- REGISTERED AS {CommonMgt.acoi activate(1001)};
- deactivate ACTION
- BEHAVIOUR deactivateB BEHAVIOUR
- DEFINED AS
- !Terminates the operation of the resource. As a result of the
- action the sequence of operations necessary to cause the resource
- to cease operation shall be initiated. If these operations are
- successfully initiated, the administrative state (if present) shall
- be changed to 'locked' and the value 'successResponse' shall be
- returned in the responseCode parameter of the action reply. If
- these operations cannot be successfully initiated, the value
- 'failureResponse' shall be returned,together with a failure reason
- parameter describing the reason for the failure.
- On completion of these operations, the operational state shall have
- the value 'disabled'.
- Depending on the current state of the resource, some or all of the
- above operations may be unneccessary.!;;
- MODE CONFIRMED;
- WITH REPLY SYNTAX CommonMgt.ActionReply;
- REGISTERED AS {CommonMgt.acoi deactivate(1002)};
-
- shutdown ACTION
- BEHAVIOUR shutdownB BEHAVIOUR
- DEFINED AS
- !Shuts down the operation of the resource. If at the time, the
- resource has existing users, the administrative state shall become
- 'shutting down', and no new users of the resource shall be
- permitted. The value 'successResponse' shall be returned in the
- responseCode parameter of the action reply. If the resource cannot
- be shut down the value 'failureResponse' shall be returned,together
- with a failure reason parameter describing the reason for the
- failure.
- When, subsequently, the number of existing users drops to zero,
- the sequence of operations necessary to cause the resource to cease
- operation shall be initiated. The administrative state shall be
- changed to 'locked'. When these operations are completed the
- operational state shall become 'disabled'.
- If at the time the resource has no existing users, the sequence of
- operations necessary to cause the resource to cease operation shall
- be initiated. he administrative state shall be changed to 'locked'.
- The value 'successResponse' shall be returned in the responseCode
- parameter of the action reply. If the resource cannot be shut down
- the value 'failureResponse' shall be returned,together with a
- failure reason parameter describing the reason for the failure.
- When the operations initiated above are completed the operational
- state shall become 'disabled'.
- Depending on the current state of the resource, some or all of the
- above operations may be unneccessary.!;;
- MODE CONFIRMED;
- WITH REPLY SYNTAX CommonMgt.ActionReply;
- REGISTERED AS {CommonMgt.acoi shutdown(1003)};
-
-
- -- Notifications
-
- communicationsInformation NOTIFICATION
- BEHAVIOUR communicationsInformationB BEHAVIOUR
- DEFINED AS
- !This notification may be used to report the occurence of
- events pertaining to the normal operation of a managed object.
- These are informational events; important enough to report, but
- not requiring any further action by a manager. Faults and
- abnornal conditions (which may require manager action) shall be
- reported using the event types defined in
- Rec.X.733 | ISO/IEC 10164-4.!;;
- WITH INFORMATION SYNTAX CommonMgt.CommunicationsInformation
- AND ATTRIBUTE IDS
-
- informationType informationType,
- informationData informationData;
- REGISTERED AS {CommonMgt.noi communicationsInformation(1001)};
-
-
- -- Functional unit packages
-
-
- -- The following object identifier
-
- -- {CommonMgt.fupoi informationEventReports(1000)}
-
- -- is assigned as a value of the ASN.1 type FunctionalUnitPackageId
- -- defined in CCITT Rec.X.701 | ISO/IEC 10040 to use for negotiating
- -- use of the following functional unit
-
- -- 0 communication information functional unit
- --
- -- where the number identifies the bit position assigned to the
- -- functional unit.
- END
-
- -- ASN.1 definitions
-
- CommonMgt {joint-iso-ccitt network-layer(13) management(0) sc6-gmi(0)
- asn1Module(2) 0}
- DEFINITIONS IMPLICIT TAGS ::= BEGIN
- -- EXPORTS everything
- -- "infrastructure" object identifier definitions
- cmoi OBJECT IDENTIFIER ::= {joint-iso-ccitt network-layer(13) management(0) sc6-gmi(0)}
- sseoi OBJECT IDENTIFIER ::= {cmoi standardSpecificExtensions(0)}
- fupoi OBJECT IDENTIFIER ::= {cmoi functionalUnitPackage(1)}
- moi OBJECT IDENTIFIER ::= {cmoi managedObjectClass(3)}
- poi OBJECT IDENTIFIER ::= {cmoi package(4)}
- proi OBJECT IDENTIFIER ::= {cmoi parameter(5)}
- aoi OBJECT IDENTIFIER ::= {cmoi attribute(7)}
- agoi OBJECT IDENTIFIER ::= {cmoi attributeGroup(8)}
- acoi OBJECT IDENTIFIER ::= {cmoi action(9)}
- noi OBJECT IDENTIFIER ::= {cmoi notification(10)}
-
- -- other definitions
- ActionInfo ::= SET OF Parameter
- ActionReply ::= SEQUENCE{
- responseCode OBJECT IDENTIFIER,
- responseArgs SET OF Parameter OPTIONAL}
- counterInitialValue NonWrappingCounter ::= 0
- InformationData ::= SET OF Parameter
- CommunicationsInformation ::= SEQUENCE{
- informationType InformationType,
- informationData InformationData OPTIONAL}
- InformationType ::= OBJECT IDENTIFIER
- CommunicationsEntityId ::= GraphicString
- ConnectionId ::= GraphicString
- failureResponse OBJECT IDENTIFIER ::= {responseCode failureResponse(1001)}
- informationEventReports OBJECT IDENTIFIER ::= {fupoi
- informationEventReports(1000)}
- NonWrappingCounter ::= Integer(0..18446744073709551616) -- (0..2^64-1)
- NotificationInfo ::= SET OF Parameter
- Parameter ::= SEQUENCE{
- paramId OBJECT IDENTIFIER,
- paramInfo ANY DEFINED BY paramId}
- ProtocolMachineId ::= GraphicString
- ProviderObjects ::= SET OF CMIP-1.BaseManagedObjectId
- -- only the localDistinguishedName form of ObjectInstance is used
- responseCode OBJECT IDENTIFIER ::= {proi responseCode(1001)}
- -- value assignments for specific action response codes are registered
- -- under this OID.
- ResponseCode ::= OBJECT IDENTIFIER
- Sap1Address ::= Integer
- Sap2Addresses ::= SET OF OctetString
- SapId ::= GraphicString
- SubsystemId ::= GraphicString
- successResponse OBJECT IDENTIFIER ::= {responseCode successResponse(1002)}
- Timer ::= Sequence{
- exponent [1] INTEGER(-62..63),
- mantissa [2] INTEGER(0..65535)}
- UserObjects ::= SET OF CMIP-1.BaseManagedObjectId
- -- only the localDistinguishedName form of ObjectInstance is used
- END
-
-