[Search] [txt|pdf|bibtex] [Tracker] [WG] [Email] [Nits]

Versions: 00 01 02                                                      
INTERNET DRAFT                                                B. Coutts
<draft-ietf-frnetmib-spvc-00.txt>       Cascade Communications Corp.
                                                       February 1, 1997
                                                   Expires July 1, 1997



          Frame Relay Service Extensions MIB for Switched PVCs



1.  Status of this Memo

   This document is an Internet-Draft.  Internet-Drafts are working
   documents of the Internet Engineering Task Force (IETF), its areas,
   and its working groups.  Note that other groups may also distribute
   working documents as Internet-Drafts.

   Internet-Drafts are draft documents valid for a maximum of six
   months.  Internet-Drafts may be updated, replaced, or obsoleted by
   other documents at any time.  It is not appropriate to use Internet-
   Drafts as reference material or to cite them other than as a
   ``working draft'' or ``work in progress.''

   To learn the current status of any Internet-Draft, please check the
   ``1id-abstracts.txt'' listing contained in the Internet-Drafts Shadow
   Directories on ds.internic.net (US East Coast), nic.nordu.net
   (Europe), ftp.isi.edu (US West Coast), or munnari.oz.au (Pacific
   Rim).

   This draft document will be submitted to the RFC editor as an
   extension to the SNMP MIB.  Please send comments to the author,
   copying iplpdn@cnri.reston.va.us.  It expires July 1997.

2.  Abstract

   This memo defines a portion of the Management Information Base (MIB)
   for use with network management protocols in TCP/IP- based internets.
   In particular, it defines objects for managing Frame Relay Switched
   Permanent Virtual Circuits (SPVCs) as extensions to RFC 1604 [1].
   This memo does not specify a standard for the Internet community.

3.  The SNMPv2 Network Management Framework

   The major components of the SNMPv2 Network Management framework are
   described in the documents listed below.

   o    RFC 1902 [2] defines the Structure of Management



Coutts                    Expires July 1, 1997                  [Page 1]


INTERNET DRAFT       FR SPVC Service Extensions MIB     February 1, 1997


        Information (SMI), the mechanisms used for describing and
        naming objects for the purpose of management.

   o    STD 17, RFC 1213 [3] defines MIB-II, the core set of
        managed objects (MO) for the Internet suite of protocols.

   o    RFC 1905 [4] defines the protocol used for network access
        to managed objects.

   o    RFC 1604 [1] defines the protocol used for managing
        Frame Relay services.

   The framework is adaptable/extensible by defining new MIBs to suit
   the requirements of specific applications/protocols/situations.

   Managed objects are accessed via a virtual information store, the
   MIB.  Objects  in  the  MIB  are  defined  using the subset of
   Abstract Syntax Notation One (ASN.1) defined in the SMI. In
   particular, each object type is named by an OBJECT IDENTIFIER, which
   is an administratively assigned name. The object  type  together
   with  an  object  instance  serves  to uniquely  identify  a
   specific  instantiation  of the object.  For human convenience, often
   a textual string, termed the descriptor, is  used  to refer to the
   object type.

4.  Overview

   Section 3 "Overview" of RFC 1604 [1] and its subsections provide
   overview and background of how to use the Frame Relay Service MIB.
   This material is pertinent to the RFC 1604 extensions provided in
   this draft, and should be followed.

4.1.  Frame Relay Service MIB Extensions for SPVCs

   This MIB addresses the instances needed to manage the Frame Relay
   Forum's Implementation Agreement for SPVCs (FRF.10).  These instances
   are based on the ATM Forum Soft PVC MIB [5] objects to provide a
   consistent Switched PVC management model for both ATM and Frame Relay
   SPVCs.

   A Switched PVC (SPVC) is a virtual circuit that appears to the user
   to be a PVC but spans multiple networks as an SVC.  The originating
   network "ingress" endpoint is configured as one PVC endpoint and is
   configured with information (including a destination address)
   required to signal and establish an SVC across the NNI interfaces
   between networks.  The destination network "egress" endpoint is
   configured as the second PVC endpoint and is configured with the
   destination address.  The originating endpoint has the responsibility



Coutts                    Expires July 1, 1997                  [Page 2]


INTERNET DRAFT       FR SPVC Service Extensions MIB     February 1, 1997


   for establishing, releasing, and re-establishing the SPVC.

   Note that the MIB extensions defined herein allow either or both ends
   of the SPVC to be configured as originating endpoints.  Note, also,
   that these SPVC MIB extensions define configuration of only the
   originating endpoint SPVC parameters.

   In order to configure the originating endpoint SPVC parameters, an
   entry in the PVC End-Point table and an entry in the Switched PVC
   table must be defined.  The PVC End-Point table entry (see the PVC
   End-Point Group in RFC 1604 [1]) identifies the bi-directional
   traffic parameters for the originating endpoint of the SPVC.  The
   Switched PVC table entry (defined in these SPVC MIB Extensions)
   identifies the destination address information (e.g., E.164 address)
   of the SPVC.  Together these two entries provide the information
   required (by the network originating the SPVC) to signal an SVC
   across the NNI.

   A row in the PVC End-Point table must be created prior to creating a
   row in the Switched PVC table.  And the corresponding row in the PVC
   End-Point table must be active prior to activating the Switched PVC
   table row.  When the Switched PVC table row is made active, an
   attempt is made to set up a switched connection to an interface at
   the destination switch.

   Presently, the Frame Relay Service MIB does not include an SVC
   cross-connect table.  Once such a table is defined, an SVC cross-
   connect table entry should be created at the time the SPVC table row
   is made active;  and deleted at the time the SPVC table row is made
   inactive.





















Coutts                    Expires July 1, 1997                  [Page 3]


INTERNET DRAFT       FR SPVC Service Extensions MIB     February 1, 1997


5.  Definitions

   FRNETSERV-MIB DEFINITIONS ::= BEGIN

   IMPORTS
           MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE
           Counter32, Integer32,
           TimeTicks                               FROM SNMPv2-SMI
           TEXTUAL-CONVENTION, DisplayString, PhysAddress,
           TimeStamp, RowStatus                    FROM SNMPv2-TC
           MODULE-COMPLIANCE, OBJECT-GROUP         FROM SNMPv2-CONF
           ifIndex, transmission                   FROM RFC-1213

   frnetservMIB MODULE-IDENTITY
           .
           .
           .

   IfIndex ::= TEXTUAL-CONVENTION
           .
           .
           .

   frnetservObjects        OBJECT IDENTIFIER ::= { frnetservMIB 1 }
   frnetservTraps          OBJECT IDENTIFIER ::= { frnetservMIB 2 }

           .
           .
           .

   --
   -- Switched PVC Extensions
   --
   --
   -- A Switched PVC (SPVC) is a virtual circuit that appears to the user to be a
   -- PVC but spans multiple networks as an SVC.
   -- The PVC End-Point table entry (see the PVC End-Point Group) identifies the
   -- bi-directional traffic parameters for the originating endpoint of the SPVC;
   -- and the Switched PVC table entry (of these Switched PVC Extensions)
   -- identifies the destination address information (e.g., E.164 address) of the
   -- SPVC.  Together these two entries provide the information required (by the
   -- network originating the SPVC) to signal an SVC across the NNI.
   --
   -- To create and activate an SPVC, the following procedures shall be followed:
   -- 1).  Create an entry in the frPVCEndptTable.
   -- 2).  Create an entry in the frSwitchedPVCTable.
   -- 3).  Activate the frPVCEndptTable entry.
   -- 4).  When the corresponding row in the frSwitchedPVCTable (i.e., the rows with



Coutts                    Expires July 1, 1997                  [Page 4]


INTERNET DRAFT       FR SPVC Service Extensions MIB     February 1, 1997


   --      matching UNI/NNI logical port and matching DLCI index values) is set to
   --      'active', an attempt is made to set up a switched connection to an
   --      interface at the destination switch.

   -- The Frame Relay Switched PVC Table

   frSwitchedPVCTable OBJECT-TYPE
           SYNTAX  SEQUENCE OF FrSwitchedPVCEntry
           MAX-ACCESS      not-accessible
           STATUS  current
           DESCRIPTION
                   "The (conceptual) table used to manage Switched Permanent
                    Virtual Connections (SPVCs). The SPVC table is applicable
                    only to switches."
           ::= { frnetservObjects 8 }

   frSwitchedPVCEntry OBJECT-TYPE
           SYNTAX  FrSwitchedPVCEntry
           MAX-ACCESS      not-accessible
           STATUS  current
           DESCRIPTION
                   "Each entry in this table represents a Switched Permanent
                    Virtual Connection (SPVC) Originating at a switch interface.
                    An SPVC is a VC that is :
                    - provisioned at the originating (source) interface of the
                      connection.
                    - established by signalling procedures across a network to a
                      destination interface.

                    A row in the frPVCEndptTable must be created, defining a PVC
                    endpoint on the source interface, prior to creating an
                    frSwitchedPVCEntry row.  The row in the frPVCEndptTable must
                    be active prior to activating the frSwitchedPVCEntry row. The
                    contents of this table reflect only the characteristics unique
                    to a Switched PVC. The traffic and signalling parameters are
                    defined in the PVC endpoint row for the source interface.
                    Since the Low Layer Compatibility, Called Party Subaddress,
                    and Calling Party Subaddress information elements are used to
                    carry end-to-end information, they are not used in the
                    configuration of Switched PVC. Note that the User-User
                    Information information element may be used to contain the
                    frSwitchedPVCTargetDlci if 'specificSPVCCorrelator' is
                    selected in the frSwitchedPVCTargetSelectType.  For Switched
                    PVC configuration, all  parameters in the bearer capability
                    parameters shall be set to their default values.

                    When a row is made active, an attempt is made to set up a
                    switched connection to an interface at the destination switch.



Coutts                    Expires July 1, 1997                  [Page 5]


INTERNET DRAFT       FR SPVC Service Extensions MIB     February 1, 1997


                    No objects (other that frSwitchedPVCRowStatus) can be set
                    while the row is active.

                    The combination of frSwitchedPVCIfIndex and
                    frSwitchedPVCDlciIndex specified in index clause of this entry
                    serves to identify the PVC endpoint on the source interface.

                    In accordance with ITU-T X.76 Annex A, if the
                    frSwitchedPVCTargetSelectType is provisioned for either
                    'specificDLCI' or 'specificSPVCCorrelator', SPVC
                    establishment can be attempted from either one or both
                    endpoints. Otherwise, SPVC establishment must be
                    attempted from a single endpoint chosen through bilateral
                    agreement - that is, the SPVC need only be provisioned at a
                    single endpoint"
           INDEX { frSwitchedPVCIfIndex, frSwitchedPVCDlciIndex }
           ::= { frSwitchedPVCTable 1 }

   FrSwitchedPVCEntry ::=
           SEQUENCE {
                   frSwitchedPVCIfIndex
                           ifIndex,
                   frSwitchedPVCDlciIndex
                           Integer32,
                   frSwitchedPVCTargetAddress
                           OCTET STRING,
                   frSwitchedPVCTargetAddressType
                           INTEGER,
                   frSwitchedPVCTargetSelectType
                           INTEGER,
                   frSwitchedPVCTargetDlci
                           Integer32,
                   frSwitchedPVCLastReleaseCause
                           INTEGER,
                   frSwitchedPVCLastReleaseDiagnostic
                           OCTET STRING,
                   frSwitchedPVCOperStatus
                           INTEGER,
                   frSwitchedPVCRestart
                           INTEGER,
                   frSwitchedPVCRetryInterval
                           INTEGER,
                   frSwitchedPVCRetryTimer
                           INTEGER,
                   frSwitchedPVCRetryFailures
                           INTEGER,
                   frSwitchedPVCRetryLimit
                           INTEGER,



Coutts                    Expires July 1, 1997                  [Page 6]


INTERNET DRAFT       FR SPVC Service Extensions MIB     February 1, 1997


                   frSwitchedPVCRowStatus
                           RowStatus
                   }

   frSwitchedPVCIfIndex OBJECT-TYPE
           SYNTAX  IfIndex
           MAX-ACCESS      not-accessible
           STATUS  current
           DESCRIPTION
                   "The value of this object is equal to MIB II's ifIndex value of
                    the UNI/NNI logical port for thisPVC endpoint."
           ::= { frSwitchedPVCEntry 1 }

   frSwitchedPVCDlciIndex OBJECT-TYPE
           SYNTAX  Integer32
           MAX-ACCESS      not-accessible
           STATUS  current
           DESCRIPTION
                   "The value of this object is equal to the DLCI value for this
                    PVC endpoint."
           ::= { frSwitchedPVCEntry 2 }

   frSwitchedPVCTargetAddress OBJECT-TYPE
           SYNTAX  OCTET STRING
           MAX-ACCESS      read-create
           STATUS  current
           DESCRIPTION
                   "The target Address of this SPVC."
           ::= { frSwitchedPVCEntry 3 }

   frSwitchedPVCTargetAddressType OBJECT-TYPE
           SYNTAX  INTEGER {
                   e164 (2)                -- E.164 addressing format
           }
           MAX-ACCESS      read-create
           STATUS  current
           DESCRIPTION
                   "The target Address Type of this SPVC."
           ::= { frSwitchedPVCEntry 4 }

   frSwitchedPVCTargetSelectType OBJECT-TYPE
           SYNTAX  INTEGER {
                   anyDLCI(1),
                   specificDLCI(2),
                   specificSPVCCorrelator(3)
           }
           MAX-ACCESS      read-create
           STATUS  current



Coutts                    Expires July 1, 1997                  [Page 7]


INTERNET DRAFT       FR SPVC Service Extensions MIB     February 1, 1997


           DESCRIPTION
                   "Indicates whether the target DLCI value or SPVC correlator is
                    to be used at the destination.  If the value 'anyDLCI' is
                    specified, the destination switch will choose the DLCI value.
                    In such a case, once the SPVC frSwitchedPvcOperStatus value is
                    'connected', the DLCI value chosen will be available for
                    reading in frSwitchedPVCTargetDlci.  If the value
                    'specificDLCI' or 'specificSPVCCorrelator' is specified, then
                    a value must be supplied for object frSwitchedPVCTargetDlci
                    prior to activation of the row.  This value is then to be used
                    at the destination."
           DEFVAL { specificDLCI }
           ::= { frSwitchedPVCEntry 5 }

   frSwitchedPVCTargetDlci OBJECT-TYPE
           SYNTAX  INTEGER  (0..8388607)
           MAX-ACCESS      read-create
           STATUS  current
           DESCRIPTION
                   "The DLCI value of the SPVC used at the target interface when
                    the frSwitchedPVCTargetSelectType is set to 'specificDLCI'.
                    Or the value of the specific SPVC correlator to be passed in
                    the SETUP message User-User information element and to be used
                    at the target interface when the frSwitchedPVCTargetSelectType
                    is set to 'specificSPVCCorrelator'."
           ::= { frSwitchedPVCEntry 6 }

   frSwitchedPVCLastReleaseCause   OBJECT-TYPE
           SYNTAX  INTEGER(1..127)
           MAX-ACCESS      read-only
           STATUS  current
           DESCRIPTION
                   "Value of the Cause field of the Cause Information Element in
                    the last Release Signalling message received for this SPVC.
                    Indicates the reason for the Disconnect."
           ::= { frSwitchedPVCEntry 7 }

   frSwitchedPVCLastReleaseDiagnostic      OBJECT-TYPE
           SYNTAX  OCTET STRING (SIZE(0..8))
           MAX-ACCESS      read-only
           STATUS  current
           DESCRIPTION
                   "Value of the first 8 bytes of diagnostic information from the
                    Cause field of the Cause Information Element in the last
                    Release Signalling message received for this SPVC."
           ::= { frSwitchedPVCEntry 8 }

   frSwitchedPVCOperStatus     OBJECT-TYPE



Coutts                    Expires July 1, 1997                  [Page 8]


INTERNET DRAFT       FR SPVC Service Extensions MIB     February 1, 1997


           SYNTAX  INTEGER {
                   other(1),
                   setupInProgress(2),
                   connected(3),
                   failed(4)
                   }
           MAX-ACCESS      read-only
           STATUS  current
           DESCRIPTION
                   "Describes the status of the SPVC. If the row is not active,
                    the value of this object is 'other'."
           ::= { frSwitchedPVCEntry 9 }

   frSwitchedPVCRestart    OBJECT-TYPE
           SYNTAX  INTEGER {
                   restart(1),
                   noop(2)
                   }
           MAX-ACCESS      read-create
           STATUS  current
           DESCRIPTION
                   "When the value is set to 'noop' then no action is taken;
                    otherwise, when the value is set to 'restart', the PVC is
                    released if necessary and a new setup procedure is begun. As a
                    result of this action, the frSwitchedPVCOperStatus object
                    transitions to 'setupInProgress' (either from the 'connected'
                    or 'failed' state). When read, the value 'noop' is returned."
           ::= { frSwitchedPVCEntry 10 }

   frSwitchedPVCRetryInterval      OBJECT-TYPE
           SYNTAX  INTEGER (0..3600)
           UNITS           "seconds"
           MAX-ACCESS      read-create
           STATUS  current
           DESCRIPTION
                   "Defines the period to wait (in seconds) before attempting to
                    establish the SPVC connection after the first failed call
                    attempt.  Zero represents an infinite interval indicating no
                    retries."
           DEFVAL { 0 }
           ::= { frSwitchedPVCEntry 11 }

   frSwitchedPVCRetryTimer OBJECT-TYPE
           SYNTAX  INTEGER
           UNITS           "seconds"
           MAX-ACCESS      read-only
           STATUS  current
           DESCRIPTION



Coutts                    Expires July 1, 1997                  [Page 9]


INTERNET DRAFT       FR SPVC Service Extensions MIB     February 1, 1997


                   "Indicates the current value of the retry timer (in seconds)
                    for this connection. When the value reaches zero, an attempt
                    will be made to establish the SPVC connection"
           ::= { frSwitchedPVCEntry 12 }

   frSwitchedPVCRetryFailures      OBJECT-TYPE
           SYNTAX  INTEGER
           MAX-ACCESS      read-only
           STATUS  current
           DESCRIPTION
                   "Indicates how many attempts to establish the connection have
                    failed.  This counter is reset whenever a connection is
                    successfully established or the SPVC is restarted."
           ::= { frSwitchedPVCEntry 13 }

   frSwitchedPVCRetryLimit OBJECT-TYPE
           SYNTAX  INTEGER
           MAX-ACCESS      read-create
           STATUS  current
           DESCRIPTION
                   "Sets a maximum limit on how many consecutive unsuccessful call
                    setup attempts can be made before stopping the attempt to set
                    up the connection. If this limit is reached then management
                    action will be required to initiate a new attempt to establish
                    the connection. A value of zero indicates no limit - the
                    attempt will continue until successful."
           DEFVAL { 0 }
           ::= { frSwitchedPVCEntry 14 }

   frSwitchedPVCRowStatus  OBJECT-TYPE
           SYNTAX  RowStatus
           MAX-ACCESS      read-create
           STATUS  current
           DESCRIPTION
                   "Used to create and delete an SPVC. When this object is set to
                    'active' an attempt is made to set up the SPVC. When this
                    object has the value 'active' and is set to another value, any
                    set-up or connection in-progress is released."
           ::= { frSwitchedPVCEntry 15 }

   --
   -- Currently Failing Switched PVC table.
   --

   frCurrentlyFailingSwitchedPVCTable      OBJECT-TYPE
           SYNTAX  SEQUENCE OF FrCurrentlyFailingSwitchedPVCEntry
           MAX-ACCESS      not-accessible
           STATUS  current



Coutts                    Expires July 1, 1997                 [Page 10]


INTERNET DRAFT       FR SPVC Service Extensions MIB     February 1, 1997


           DESCRIPTION
                   "A table indicating all Switched Permanent Virtual Connections
                    (Switched PVCs) for which the frSwitchedPVCRowStatus is
                    'active' and the frSwitchedPVCOperStatus is other than
                    'connected'."
           ::= { frSwitchedPvcMIBObjects 11 }

   frCurrentlyFailingSwitchedPVCEntry      OBJECT-TYPE
           SYNTAX  FrCurrentlyFailingSwitchedPVCEntry
           MAX-ACCESS      not-accessible
           STATUS  current
           DESCRIPTION
                   "Each entry in this table represents a Switched Permanent
                    Virtual Connection (Switched PVC) for which the
                    frSwitchedPVCRowStatus is 'active' and the
                    frSwitchedPVCOperStatus is other than 'connected'."
           INDEX { ifIndex, frDlci }
           ::= { frCurrentlyFailingSwitchedPVCTable 1 }

   FrCurrentlyFailingSwitchedPVCEntry ::=
           SEQUENCE {
                   frCurrentlyFailingSwitchedPVCTimeStamp
                           TimeStamp
                   }

   frCurrentlyFailingSwitchedPVCTimeStamp  OBJECT-TYPE
           SYNTAX  TimeStamp
           MAX-ACCESS      read-only
           STATUS  current
           DESCRIPTION
                   "The time at which this Switched PVC began to fail."
           ::= { frCurrentlyFailingSwitchedPVCEntry 1 }


   --
   -- Switched PVC MIB Definitions
   --

   frSwitchedPvcBaseGroup  OBJECT IDENTIFIER ::= { frnetservObjects 12 }

   frSwitchedPvcCallFailuresTrapEnable     OBJECT-TYPE
           SYNTAX  TruthValue
           MAX-ACCESS      read-write
           STATUS  current
           DESCRIPTION
                   "Allows the generation of traps in response to call failures."
           ::= { frSwitchedPvcBaseGroup 1 }




Coutts                    Expires July 1, 1997                 [Page 11]


INTERNET DRAFT       FR SPVC Service Extensions MIB     February 1, 1997


   frSwitchedPvcCallFailures       OBJECT-TYPE
           SYNTAX  TruthValue
           MAX-ACCESS      read-only
           STATUS  current
           DESCRIPTION
                   "The number of times a series of call attempts has failed to
                    establish a Switched PVC."
           ::= { frSwitchedPvcBaseGroup 2 }

   frSwitchedPvcCurrentlyFailingSwitchedPVCs       OBJECT-TYPE
           SYNTAX  Gauge32
           MAX-ACCESS      read-only
           STATUS  current
           DESCRIPTION
                   "The current number of Switched-PVC connections for which the
                    frSwitchedPVCOperStatus does not have the value 'connected'."
           ::= { frSwitchedPvcBaseGroup 3 }

   frSwitchedPvcNotificationInterval               OBJECT-TYPE
           SYNTAX  Integer32 (0..3600)
           UNITS   "seconds"
           MAX-ACCESS      read-write
           DESCRIPTION
                   "The minimum interval in seconds between the sending of
                    frSwitchedPvcCallFailuresTrap notifications."
           ::= { frSwitchedPvcBaseGroup 4 }

   END























Coutts                    Expires July 1, 1997                 [Page 12]


INTERNET DRAFT       FR SPVC Service Extensions MIB     February 1, 1997


6.  Acknowledgments

   Special thanks to Andy Malis and Ron Parker of Cascade
   Communications and Dave Sinicrope of IBM for their
   valuable comments.

7.  References

   [1]  Brown, T., "Definitions of Managed Objects for Frame
        Relay Service", RFC 1604, Bell Communications Research,
        March 1994.

   [2]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M.,
        and S. Waldbusser, "Structure of Management Information
        for Version 2 of the Simple Network Management Protocol
        (SNMPv2)", RFC 1902, January 1996.

   [3]  McCloghrie, K., and M. Rose, Editors, "Management
        Information Base for Network Management of TCP/IP-based
        internets: MIB-II", STD 17, RFC 1213, Hughes LAN Systems,
        Performance Systems International, March 1991.

   [4]  SNMPv2 Working Group, Case, J., McCloghrie, K., Rose, M.,
        and S. Waldbusser, "Protocol Operations for Version 2 of
        the Simple Network Management Protocol (SNMPv2)", RFC
        1905, January 1996.

   [5]  ATM Forum Technical Committee, "Private Network-Network
        Specification Version 1.0 Addendum (Soft PVC MIB)",
        af-pnni-0066.000, July 1996.

8.  Author's Address

   Bill Coutts
   Cascade Communications Corp
   5 Carlisle Road
   Westford, MA  01886
   USA

   Phone:  +1 508 692 2600 x1516
   Email:  bcoutts@casc.com










Coutts                    Expires July 1, 1997                 [Page 13]