1-- --------------------------------------------------------------------
2-- ATM FORUM SOFT PVC MIB
3--
4-- December 1998, Satya Narayana
5--
6-- Copyright (c) 1996-1998, 1999 by cisco Systems, Inc.
7-- All rights reserved.
8-- *****************************************************************
9ATM-SOFT-PVC-MIB DEFINITIONS ::= BEGIN
10
11IMPORTS
12	enterprises				FROM RFC1155-SMI
13	MODULE-IDENTITY, OBJECT-TYPE,
14	NOTIFICATION-TYPE,
15	Counter32, Gauge32			FROM SNMPv2-SMI
16	TEXTUAL-CONVENTION, RowStatus,
17	TruthValue, TimeStamp			FROM SNMPv2-TC
18	MODULE-COMPLIANCE, OBJECT-GROUP		FROM SNMPv2-CONF
19	ifIndex					FROM IF-MIB
20	atmVplVpi, atmVclVpi,
21	atmVclVci				FROM ATM-MIB;
22
23atmSoftPvcMIB MODULE-IDENTITY
24	LAST-UPDATED	"9703010000Z"
25	ORGANIZATION	"The ATM Forum."
26	CONTACT-INFO
27		"The ATM Forum
28		2570 West El Camino Real, Suite 304
29		Mountain View, CA 94040-1313 USA
30		Phone:	+1 415-949-6700
31		Fax:		+1 415-949-6705
32		info@atmforum.com"
33	DESCRIPTION
34		"ATM Soft PVC MIB"
35        REVISION        "9703010000Z"
36        DESCRIPTION
37                "Updated version of the Soft PVC MIB released with the
38                PNNI V1.0 Errata and PICS (af-pnni-81.00)."
39	REVISION	"9606210000Z"
40	DESCRIPTION
41		"Initial version of this MIB module."
42	::= { atmfSoftPvc 1 }
43
44atmForum 		OBJECT IDENTIFIER ::= { enterprises 353 }
45atmForumNetworkManagement	OBJECT IDENTIFIER ::= { atmForum 5 }
46atmfSoftPvc		OBJECT IDENTIFIER ::= { atmForumNetworkManagement 5 }
47
48atmSoftPvcMIBObjects  OBJECT IDENTIFIER ::= { atmSoftPvcMIB 1 }
49atmSoftPvcMIBTraps    OBJECT IDENTIFIER ::= { atmSoftPvcMIB 2 }
50
51AtmAddr ::= TEXTUAL-CONVENTION
52	STATUS  current
53	DESCRIPTION
54		"The ATM address used by the network entity.
55		The address types are: no address (0 octets),
56		E.164 (8 octets)and NSAP (20 octets).
57		Note: The E.164 address is encoded in BCD format."
58	SYNTAX    OCTET STRING (SIZE(0|8|20))
59--
60-- This MIB contains five tables and a number of scalars. The scalars
61-- contain overall status information and counters. The tables are:
62--     Soft PVC VCCs - manage Soft PVCC at originating switch
63--     Soft PVC VPCs - manage Soft PVPC at originating switch
64--     Interface Soft PVC Address
65--	 Currently failing Soft PVCC table
66--	 Currently failing Soft PVPC table
67--
68-- Traffic statistics for Soft PVCCs and Soft PVPCs are accessible
69-- via the atmVclStatTable and atmVplStatTable, as defined in the
70-- Supplemental AtomMIB
71
72
73atmSoftPvcBaseGroup	OBJECT IDENTIFIER ::= { atmSoftPvcMIBObjects 1}
74
75atmSoftPvcCallFailuresTrapEnable	OBJECT-TYPE
76	SYNTAX	TruthValue
77	MAX-ACCESS	read-write
78	STATUS	current
79	DESCRIPTION
80		"Allows the generation of traps in response to call
81		failures. By default, this object is set to 'false'."
82	::= { atmSoftPvcBaseGroup 1 }
83
84
85atmSoftPvcCallFailures	OBJECT-TYPE
86	SYNTAX	Counter32
87	MAX-ACCESS	read-only
88	STATUS	current
89	DESCRIPTION
90		"The number of times a series of call attempts has failed to
91		establish a Soft PVCC or Soft PVPC. The number of call
92		attempts in a series is determined by
93		atmSoftPVccRetryThreshold or atmSoftPVpcRetryThreshold,
94		respectively."
95	::= {atmSoftPvcBaseGroup 2 }
96
97
98atmSoftPvcCurrentlyFailingSoftPVccs	OBJECT-TYPE
99	SYNTAX	Gauge32
100	MAX-ACCESS	read-only
101	STATUS	current
102	DESCRIPTION
103		"The current number of Soft PVCCs for which there is
104		an active row in the atmSoftPVccTable having an
105		atmSoftPVccOperStatus with a value other than 'connected'."
106	::= { atmSoftPvcBaseGroup 3 }
107
108
109atmSoftPvcCurrentlyFailingSoftPVpcs	OBJECT-TYPE
110	SYNTAX	Gauge32
111	MAX-ACCESS	read-only
112	STATUS	current
113	DESCRIPTION
114		"The current number of Soft PVPCs for which there is an
115		active row in the atmSoftPVpcTable having an
116		atmSoftPVpcOperStatus with a value other than 'connected'."
117	::= { atmSoftPvcBaseGroup 4 }
118
119
120atmSoftPvcNotificationInterval	OBJECT-TYPE
121	SYNTAX	INTEGER (0..3600)
122	UNITS		"seconds"
123	MAX-ACCESS	read-write
124	STATUS	current
125	DESCRIPTION
126		"The minimum interval between the sending
127		of atmSoftPvcCallFailuresTrap notifications."
128	DEFVAL { 30 }
129	::= { atmSoftPvcBaseGroup 5 }
130
131
132--
133-- Table to manage Soft PVCCs.
134--
135
136atmSoftPVccTable	OBJECT-TYPE
137	SYNTAX	SEQUENCE OF AtmSoftPVccEntry
138	MAX-ACCESS	not-accessible
139	STATUS	current
140	DESCRIPTION
141		"The (conceptual) table used to manage Soft
142		Permanent Virtual Channel Connections (Soft PVCCs).
143		The Soft PVCC table is applicable only to switches."
144	::= { atmSoftPvcMIBObjects 2 }
145
146
147atmSoftPVccEntry	OBJECT-TYPE
148	SYNTAX	AtmSoftPVccEntry
149	MAX-ACCESS	not-accessible
150	STATUS	current
151	DESCRIPTION
152		"Each entry in this table represents a  Soft
153		Permanent Virtual Channel Connection (Soft PVCC)
154		originating at a switch interface.
155
156		A Soft PVCC is a VCC that is:
157		  - provisioned at the originating (source)
158			interface of the connection
159		  - established by signalling procedures
160			across a network to a destination interface.
161
162		A row in the atmVclTable must be created,
163		defining a VCL on the source interface, prior to
164		creating an atmSoftPVccEntry row. The row in the
165		atmVclTable must be active prior to activating the
166		atmSoftPVccEntry row.
167
168		The contents of this table reflect only the
169		characteristics unique to a Soft PVCC. The traffic
170		parameters are defined in the VCL row for the source
171		interface, as specified in the ATOMMIB (RFC1695) and
172		the forthcoming addition, the Supplemental ATOMMIB.
173
174		Note that the atmSigDescrParamTable contains some objects
175		such as the AAL parameters, Broadband high layer
176		information and Broadband low layer information
177		elements which are used to carry end-to-end information.
178		For this reason, these objects are not relevant to Soft
179		PVCCs.
180
181		When a row is made active, an attempt is made
182		to set up a switched connection to an interface at
183		the destination switch. No objects (other than
184		atmSoftPVccRowStatus) can be set while the row is
185		active.
186
187		At the destination, the VCL may be defined (but
188		not cross-connected) prior to arrival of the Setup
189		request.
190
191		The combination of ifIndex, atmVclVpi, and atmVclVci
192		specified in the index clause of this entry serves to
193		identify the VCL on the source interface. The
194		atmSoftPVccLeafReference object aids in distinguishing
195		between leaves of a point-to-multipoint Soft PVCC."
196	INDEX	{ ifIndex,
197		atmVclVpi,
198		atmVclVci,
199		atmSoftPVccLeafReference }
200	::= { atmSoftPVccTable 1 }
201
202
203AtmSoftPVccEntry ::=
204	SEQUENCE	{
205			atmSoftPVccLeafReference		INTEGER,
206			atmSoftPVccTargetAddress		AtmAddr,
207			atmSoftPVccTargetSelectType		INTEGER,
208			atmSoftPVccTargetVpi			INTEGER,
209			atmSoftPVccTargetVci			INTEGER,
210			atmSoftPVccLastReleaseCause		INTEGER,
211			atmSoftPVccLastReleaseDiagnostic	OCTET STRING,
212			atmSoftPVccOperStatus			INTEGER,
213			atmSoftPVccRestart			INTEGER,
214			atmSoftPVccRetryInterval		INTEGER,
215			atmSoftPVccRetryTimer			INTEGER,
216			atmSoftPVccRetryThreshold		INTEGER,
217			atmSoftPVccRetryFailures		Gauge32,
218			atmSoftPVccRetryLimit			INTEGER,
219			atmSoftPVccRowStatus			RowStatus
220			}
221
222
223atmSoftPVccLeafReference OBJECT-TYPE
224	SYNTAX	INTEGER  (1..65535)
225	MAX-ACCESS	not-accessible
226	STATUS	current
227	DESCRIPTION
228		"An arbitrary integer which, in the case of the
229		source VCL having an atmVclCastType of
230		'p2mpRoot', serves to distinguish between the
231		multiple leaves attached to a root of a
232		point-to-multipoint Soft PVCC. If the atmVclCastType
233		is not 'p2mpRoot' the value 1 shall be used."
234	::= { atmSoftPVccEntry 1 }
235
236
237atmSoftPVccTargetAddress	OBJECT-TYPE
238	SYNTAX	AtmAddr
239	MAX-ACCESS	read-create
240	STATUS	current
241	DESCRIPTION
242		"The target ATM Address of this Soft PVCC.  If no
243                address is supplied, no attempts to establish the
244                Soft PVCC are initiated."
245	::= { atmSoftPVccEntry 2 }
246
247
248atmSoftPVccTargetSelectType	OBJECT-TYPE
249	SYNTAX	INTEGER {
250				required(1),
251				any(2)
252			}
253	MAX-ACCESS	read-create
254	STATUS	current
255	DESCRIPTION
256		"Indicates whether the target VPI/VCI values
257		are to be used at the destination.
258
259		If the value 'any' is specified, the destination
260		switch will choose the VPI/VCI values. In such a
261		case, once the Soft PVCC atmSoftPVccOperStatus
262		value is 'connected', the value of this object
263		changes to 'required', such that the same VPI/VCI
264		values will continue to be used even if the connection
265		is subsequently torn down and re-established. The
266		VPI/VCI values chosen will be available for reading in
267		atmSoftPVccTargetVpi and atmSoftPVccTargetVci.
268
269		If the value 'required' is specified, then values
270		must be supplied for objects atmSoftPVccTargetVpi
271		and atmSoftPVccTargetVci prior to activation of the
272		row. These values are then to be used at the destination."
273	DEFVAL { required }
274	::= { atmSoftPVccEntry 3 }
275
276
277atmSoftPVccTargetVpi	OBJECT-TYPE
278	SYNTAX	INTEGER (0..4095)
279	MAX-ACCESS	read-create
280	STATUS	current
281	DESCRIPTION
282		"The VPI value of the VCL used at the target interface.
283		This value is not relevant when the value of
284		atmSoftPVccTargetSelectType is 'any'."
285	DEFVAL { 0 }
286	::= { atmSoftPVccEntry 4 }
287
288
289atmSoftPVccTargetVci	OBJECT-TYPE
290	SYNTAX	INTEGER  (0..65535)
291	MAX-ACCESS	read-create
292	STATUS	current
293	DESCRIPTION
294		"The VCI value of the VCL used at the target interface.
295		This value must be filled in when the
296		atmSoftPVccTargetSelectType is set to 'required'.This
297		value is not relevant when the value of
298		atmSoftPVccTargetSelectType is 'any'."
299	::= { atmSoftPVccEntry 5 }
300
301
302atmSoftPVccLastReleaseCause	OBJECT-TYPE
303	SYNTAX	INTEGER(1..127)
304	MAX-ACCESS	read-only
305	STATUS	current
306	DESCRIPTION
307		"Value of the Cause field of the Cause
308		Information Element in the last RELEASE
309		signalling message received for this Soft PVCC.
310		Indicates the reason for the Release."
311	::= { atmSoftPVccEntry 6 }
312
313
314atmSoftPVccLastReleaseDiagnostic	OBJECT-TYPE
315	SYNTAX	OCTET STRING (SIZE(0..8))
316	MAX-ACCESS	read-only
317	STATUS	current
318	DESCRIPTION
319		"Value of the first 8 bytes of diagnostic information
320		from the Cause field of the Cause Information Element
321		in the last RELEASE signalling message received for
322		this Soft PVCC."
323	::= { atmSoftPVccEntry 7 }
324
325
326atmSoftPVccOperStatus     OBJECT-TYPE
327	SYNTAX	INTEGER {
328				other(1),
329				establishmentInProgress(2),
330				connected(3),
331				retriesExhausted(4),
332                                noAddressSupplied(5),
333                                lowerLayerDown(6)
334				}
335	MAX-ACCESS	read-only
336	STATUS	current
337	DESCRIPTION
338		"Describes the status of the Soft PVCC.  Valid values
339                are:
340                   other              - none of the types specified below
341                   establishmentInProgress - connection or party is not
342                                             operational, but setup or add
343                                             party attempts are ongoing
344                   connected          - connection or party is currently
345                                        operational
346                   retriesExhausted   - retry limit has been reached and
347                                        setup or add party attempts have
348                                        ceased
349                   noAddressSupplied  - no remote address has been
350                                        configured, so no setup or add
351                                        party attempts are initiated
352                   lowerLayerDown     - underlying ATM interface is not
353                                        operational
354                When the row is not 'active', the value of this
355		object is 'other'."
356	::= { atmSoftPVccEntry 8 }
357
358
359atmSoftPVccRestart	OBJECT-TYPE
360	SYNTAX	INTEGER {
361			restart(1),
362			noop(2)
363			}
364	MAX-ACCESS	read-create
365	STATUS	current
366	DESCRIPTION
367		"When the value is set to 'restart' the Soft PVCC
368		is released if necessary and a new setup procedure
369		is begun. As a result of this action, the
370		atmSoftPVccOperStatus object transitions to
371		'establishmentInProgress' (if not already in this state)
372		and the atmSoftPVccRetryFailures object is cleared
373
374		When the value is set to 'noop' no operation is
375		performed. When read, the value 'noop' is returned."
376	::= { atmSoftPVccEntry 9 }
377
378
379atmSoftPVccRetryInterval	OBJECT-TYPE
380	SYNTAX	INTEGER (0..3600)
381	UNITS		"seconds"
382	MAX-ACCESS	read-create
383	STATUS	current
384	DESCRIPTION
385		"Defines the period to wait before attempting
386		to establish the Soft PVCC after the first failed call
387		attempt.  The time to wait between subsequent call
388                attempts may differ to implement a backoff scheme.
389                Zero represents an infinite interval indicating no
390		retries."
391	DEFVAL { 10 }
392	::= { atmSoftPVccEntry 10 }
393
394
395atmSoftPVccRetryTimer	OBJECT-TYPE
396	SYNTAX	INTEGER (0..86400)
397	UNITS		"seconds"
398	MAX-ACCESS	read-only
399	STATUS	current
400	DESCRIPTION
401		"Indicates the current value of the retry timer for
402		this connection. When the value reaches zero an attempt
403		will be made to establish the Soft PVCC. When the timer
404		is not running, the value zero shall be returned."
405	::= { atmSoftPVccEntry 11 }
406
407
408atmSoftPVccRetryThreshold	OBJECT-TYPE
409	SYNTAX	INTEGER (0..65535)
410	MAX-ACCESS	read-create
411	STATUS	current
412	DESCRIPTION
413		"Indicates the number of consecutive call setup attempts for
414		the same Soft PVCC which need to fail before the
415		atmSoftPvcCallFailures object is incremented. A value of
416		zero indicates that an infinite number of call attempts
417		are required to increment the atmSoftPvcCallFailures object
418		and thus disables alarms for the Soft PVCC."
419	DEFVAL { 1 }
420	::= { atmSoftPVccEntry 12 }
421
422
423atmSoftPVccRetryFailures	OBJECT-TYPE
424	SYNTAX	Gauge32
425	MAX-ACCESS	read-only
426	STATUS	current
427	DESCRIPTION
428		"Indicates how many attempts to establish the connection
429		have failed.  This count is reset whenever a connection
430		is successfully established or the Soft PVCC is restarted."
431	::= { atmSoftPVccEntry 13 }
432
433
434atmSoftPVccRetryLimit	OBJECT-TYPE
435	SYNTAX	INTEGER (0..65535)
436	MAX-ACCESS	read-create
437	STATUS	current
438	DESCRIPTION
439		"Sets a maximum limit on how many consecutive unsuccessful
440		call setup attempts can be made before stopping the attempt
441		to set up the connection. If this limit is reached then
442		management action will be required (e.g. setting
443		atmSoftPVccRestart to 'restart') to initiate a new attempt
444		to establish the connection. A value of zero indicates
445		no limit - the attempts will continue until successful."
446	DEFVAL { 0 }
447	::= { atmSoftPVccEntry 14 }
448
449
450atmSoftPVccRowStatus	OBJECT-TYPE
451	SYNTAX	RowStatus
452	MAX-ACCESS	read-create
453	STATUS	current
454	DESCRIPTION
455		"Used to create and delete a Soft PVCC. When this
456		object is set to 'active' an attempt is made to
457		set up the Soft PVCC. When this object has the value
458		'active' and is set to another value, any
459		set-up or connection in-progress is released."
460	::= { atmSoftPVccEntry 15 }
461
462
463-- Table to manage Soft PVPCs
464
465--
466-- The following MIB definition includes support for point to
467-- multipoint Soft PVPCs. Version 1.0 of the PNNI specification does
468-- not allow the use of point to multipoint Soft PVPCs. The value
469-- of atmSoftPVpcLeafReference should always be set to 1 indicating
470-- a point to point Soft PVPC.
471--
472
473
474atmSoftPVpcTable	OBJECT-TYPE
475	SYNTAX	SEQUENCE OF AtmSoftPVpcEntry
476	MAX-ACCESS	not-accessible
477	STATUS	current
478	DESCRIPTION
479		"The (conceptual) table used to manage Soft
480		Permanent Virtual Path Connections (Soft PVPCs)
481		The Soft PVPC table is applicable only to switches."
482	::= { atmSoftPvcMIBObjects 3 }
483
484
485atmSoftPVpcEntry	OBJECT-TYPE
486	SYNTAX	AtmSoftPVpcEntry
487	MAX-ACCESS	not-accessible
488	STATUS	current
489	DESCRIPTION
490		"Each entry in this table represents a  Soft
491		Permanent Virtual Path Connection (Soft PVPC)
492		originating at a switch interface.
493
494		A Soft PVPC is a VPC that is:
495		  - provisioned at the originating (source)
496			interface of the connection
497		  - established by signalling procedures
498			across a network to a destination interface.
499
500		A row in the atmVplTable must be created,
501		defining a VPL on the source interface, prior to
502		creating an atmSoftPVpcEntry row. The row in the
503		atmVplTable must be active prior to activating the
504		atmSoftPVpcEntry row.
505
506		The contents of this table reflect only the
507		characteristics unique to a Soft PVPC. The traffic
508		parameters are defined in the VPL row for the source
509		interface, as specified in the ATOMMIB (RFC1695) and
510		the forthcoming addition, the Supplemental ATOMMIB.
511
512		Note that the atmSigDescrParamTable contains some
513		objects such as the AAL parameters, Broadband high
514		layer information, and Broadband low layer information
515		elements which are used to carry end-to-end information.
516		For this reason, these objects are not relevant to Soft
517		PVPCs.
518
519		When a row is made active, an attempt is made
520		to set up a switched connection to an interface at
521		the destination switch. No objects (other than
522		atmSoftPVpcRowStatus) can be set while the row is
523		active.
524
525		At the destination, the VPL may be defined (but
526		not cross-connected) prior to arrival of the Setup
527		request.
528
529		The combination of ifIndex, atmVplVpi specified
530		in the index clause of this entry serves to
531		identify the VPL on the source interface. The
532		atmSoftPVpcLeafReference object aids in distinguishing
533		between leaves of a point-to-multipoint Soft PVPC."
534	INDEX	{ ifIndex,
535		atmVplVpi,
536		atmSoftPVpcLeafReference }
537	::= { atmSoftPVpcTable 1 }
538
539
540AtmSoftPVpcEntry ::=
541	SEQUENCE {
542		atmSoftPVpcLeafReference		INTEGER,
543		atmSoftPVpcTargetAddress		AtmAddr,
544		atmSoftPVpcTargetSelectType		INTEGER,
545		atmSoftPVpcTargetVpi			INTEGER,
546		atmSoftPVpcLastReleaseCause		INTEGER,
547		atmSoftPVpcLastReleaseDiagnostic	OCTET STRING,
548		atmSoftPVpcOperStatus			INTEGER,
549		atmSoftPVpcRestart			INTEGER,
550		atmSoftPVpcRetryInterval		INTEGER,
551		atmSoftPVpcRetryTimer			INTEGER,
552		atmSoftPVpcRetryThreshold		INTEGER,
553		atmSoftPVpcRetryFailures		Gauge32,
554		atmSoftPVpcRetryLimit			INTEGER,
555		atmSoftPVpcRowStatus			RowStatus
556		}
557
558
559atmSoftPVpcLeafReference	OBJECT-TYPE
560	SYNTAX	INTEGER  (1..63535)
561	MAX-ACCESS	not-accessible
562	STATUS	current
563	DESCRIPTION
564		"An arbitrary integer which, in the case of the
565		source VPL having a atmVplCastType of
566		'p2mpRoot', serves to distinguish between the
567		multiple leaves attached to a root of a
568		point-to-multipoint Soft PVPC.
569
570		If the atmVplCastType is not 'p2mpRoot', the
571		value 1 shall be used."
572	::= { atmSoftPVpcEntry 1 }
573
574
575atmSoftPVpcTargetAddress	OBJECT-TYPE
576	SYNTAX	AtmAddr
577	MAX-ACCESS	read-create
578	STATUS	current
579	DESCRIPTION
580		"The target ATM Address of this Soft PVPC.  If no
581                address is supplied, no attempts to establish the
582                Soft PVPC are initiated."
583	::= { atmSoftPVpcEntry 2 }
584
585
586atmSoftPVpcTargetSelectType	OBJECT-TYPE
587	SYNTAX	INTEGER {
588			required(1),
589			any(2)
590			}
591	MAX-ACCESS	read-create
592	STATUS	current
593	DESCRIPTION
594		"Indicates whether the target VPI value
595		is to be used at the destination.
596		If the value 'any' is specified, the
597		destination switch will choose the VPI
598		value. In such a case, once the Soft PVPC
599		atmSoftPVpcOperStatus value is 'connected',
600		the value of this object changes to 'required',
601		such that the same VPI value will continue to
602		be used even if the connection is subsequently
603		torn down and re-established. The VPI value
604		chosen will be available for reading in
605		atmSoftPVpcTargetVpi.
606
607		If the value 'required' is specified, then
608		a value must be supplied for object
609		atmSoftPVpcTargetVpi prior to activation
610		of the row. This value is then to be used
611		at the destination."
612	DEFVAL { required }
613	::= { atmSoftPVpcEntry 3 }
614
615
616atmSoftPVpcTargetVpi	OBJECT-TYPE
617	SYNTAX	INTEGER (0..4095)
618	MAX-ACCESS	read-create
619	STATUS	current
620	DESCRIPTION
621		"The VPI value of the VPL used at the
622		target interface.
623
624		This value must be filled in when the
625		atmSoftPVpcTargetSelectType is set to 'required'.
626		This value is not relevant when the value of
627		atmSoftPVpcTargetSelectType is 'any'."
628	::= { atmSoftPVpcEntry 4 }
629
630
631atmSoftPVpcLastReleaseCause	OBJECT-TYPE
632	SYNTAX	INTEGER(1..127)
633	MAX-ACCESS	read-only
634	STATUS	current
635	DESCRIPTION
636		"Value of the Cause field of the Cause
637		Information Element in the last RELEASE
638		signalling message received for this Soft PVPC.
639		Indicates the reason for the Release."
640	::= { atmSoftPVpcEntry 5 }
641
642
643atmSoftPVpcLastReleaseDiagnostic	OBJECT-TYPE
644	SYNTAX	OCTET STRING (SIZE(0..8))
645	MAX-ACCESS	read-only
646	STATUS	current
647	DESCRIPTION
648		"Value of the first 8 bytes of diagnostic information
649		from the Cause field of the Cause Information Element
650		in the last RELEASE signalling message received for
651		this Soft PVPC."
652	::= { atmSoftPVpcEntry 6 }
653
654
655atmSoftPVpcOperStatus	OBJECT-TYPE
656	SYNTAX	INTEGER {
657				other(1),
658				establishmentInProgress(2),
659				connected(3),
660				retriesExhausted(4),
661                                noAddressSupplied(5),
662                                lowerLayerDown(6)
663				}
664	MAX-ACCESS	read-only
665	STATUS	current
666	DESCRIPTION
667	      "Describes the status of the Soft PVPC.
668                   other              - none of the types specified below
669                   establishmentInProgress - connection or party is not
670                                             operational, but setup or add
671                                             party attempts are ongoing
672                   connected          - connection or party is currently
673                                        operational
674                   retriesExhausted   - retry limit has been reached and
675                                        setup or add party attempts have
676                                        ceased
677                   noAddressSupplied  - no remote address has been
678                                        configured, so no setup or add
679                                        party attempts are initiated
680                   lowerLayerDown     - underlying ATM interface is not
681                                        operational
682                When the row is not 'active', the value of this
683		object is 'other'."
684	::= { atmSoftPVpcEntry 7 }
685
686
687atmSoftPVpcRestart	OBJECT-TYPE
688	SYNTAX	INTEGER {
689				restart(1),
690				noop(2)
691				}
692	MAX-ACCESS	read-create
693	STATUS	current
694	DESCRIPTION
695		"When the value is set to 'restart', the Soft PVPC is
696		released if necessary and a new setup procedure is begun.
697		As a result of this action, the atmSoftPVpcOperStatus
698		object transitions to 'establishmentInProgress' (if not
699		already in this state) and the atmSoftPVpcRetryFailures
700		object is cleared.
701
702		When the value is set to 'noop', no operation is performed.
703		When read, the value 'noop' is returned."
704	::= { atmSoftPVpcEntry 8 }
705
706
707atmSoftPVpcRetryInterval	OBJECT-TYPE
708	SYNTAX	INTEGER (0..3600)
709	UNITS		"seconds"
710	MAX-ACCESS	read-create
711	STATUS	current
712	DESCRIPTION
713		"Defines the period to wait before attempting
714		to establish the Soft PVPC after the first failed
715                call attempt.  The time to wait between subsequent
716                call attempts may differ to implement a backoff scheme.
717                Zero represents an infinite interval indicating no
718                retries."
719	DEFVAL { 10 }
720	::= { atmSoftPVpcEntry 9 }
721
722
723atmSoftPVpcRetryTimer	OBJECT-TYPE
724	SYNTAX	INTEGER (0..86400)
725	UNITS		"seconds"
726	MAX-ACCESS	read-only
727	STATUS	current
728	DESCRIPTION
729		"Indicates the current value of the retry timer for
730		this connection. When the value reaches zero an attempt
731		will be made to establish the Soft PVPC. When the
732		timer is not running, the value zero shall be returned."
733	::= { atmSoftPVpcEntry 10 }
734
735
736atmSoftPVpcRetryThreshold  OBJECT-TYPE
737	SYNTAX	INTEGER (0..65535)
738	MAX-ACCESS	read-create
739	STATUS	current
740	DESCRIPTION
741		"Indicates the number of consecutive call setup attempts for
742		the same Soft PVPC which need to fail before the
743		atmSoftPvcCallFailures object is incremented. A value of
744		zero indicates that an infinite number of call attempts
745		are required to increment the atmSoftPvcCallFailures object
746		and thus disables alarms for the Soft PVPC."
747	DEFVAL { 1 }
748	::= { atmSoftPVpcEntry 11 }
749
750
751atmSoftPVpcRetryFailures	OBJECT-TYPE
752	SYNTAX	Gauge32
753	MAX-ACCESS	read-only
754	STATUS	current
755	DESCRIPTION
756		"Indicates how many attempts to establish the connection
757		have failed.  This count is reset whenever a connection
758		is successfully established or the Soft PVPC is restarted."
759	::= { atmSoftPVpcEntry 12 }
760
761
762atmSoftPVpcRetryLimit	OBJECT-TYPE
763	SYNTAX	INTEGER (0..65535)
764	MAX-ACCESS	read-create
765	STATUS	current
766	DESCRIPTION
767		"Sets a maximum limit on how many consecutive unsuccessful
768		call setup attempts can be made before stopping the attempt
769		to set up the connection. If this limit is reached then
770		management action will be required (e.g. setting
771		atmSoftPVpcRestart to 'restart') to initiate a new attempt
772		to establish the connection. A value of zero indicates no
773		limit - the attempts will continue until successful."
774	DEFVAL { 0 }
775	::= { atmSoftPVpcEntry 13 }
776
777
778atmSoftPVpcRowStatus	OBJECT-TYPE
779	SYNTAX	RowStatus
780	MAX-ACCESS	read-create
781	STATUS	current
782	DESCRIPTION
783		"Used to create and delete a Soft PVPC. When this
784		object is set to 'active' an attempt is made to
785		set up the Soft PVPC. When this object has the value
786		'active' and is set to another value, any
787		set-up or connection in-progress is released."
788	::= { atmSoftPVpcEntry 14 }
789
790
791--
792-- This table is used to configure one or more ATM addresses
793-- prior to setting up Soft PVCCs or Soft PVPCs at an ATM
794-- interface in a node.
795-- In addition, prior to setting up a Soft PVC at the source
796-- interface, this table can be consulted at the destination
797-- interface.
798--
799
800atmInterfaceSoftPvcAddressTable	OBJECT-TYPE
801	SYNTAX	SEQUENCE OF AtmInterfaceSoftPvcAddressEntry
802	MAX-ACCESS	not-accessible
803	STATUS	current
804	DESCRIPTION
805		"This table is used to configure ATM addresses at
806		an ATM interface on this node prior to setting up
807		Soft PVPCs or Soft PVPCs at that interface."
808	::= { atmSoftPvcMIBObjects 4 }
809
810
811atmInterfaceSoftPvcAddressEntry	OBJECT-TYPE
812	SYNTAX	AtmInterfaceSoftPvcAddressEntry
813	MAX-ACCESS	not-accessible
814	STATUS	current
815	DESCRIPTION
816		"ATM address entry for configuring Soft PVCCs or
817		Soft PVPCs at an ATM interface."
818	INDEX { ifIndex, atmInterfaceSoftPvcAddress }
819	::= { atmInterfaceSoftPvcAddressTable 1 }
820
821
822AtmInterfaceSoftPvcAddressEntry ::=
823	SEQUENCE {
824		atmInterfaceSoftPvcAddress		AtmAddr,
825		atmInterfaceSoftPvcAddressRowStatus	RowStatus
826		}
827
828
829atmInterfaceSoftPvcAddress	OBJECT-TYPE
830	SYNTAX	AtmAddr
831	MAX-ACCESS	not-accessible
832	STATUS	current
833	DESCRIPTION
834		"Specifies the address that can be used to establish a Soft
835		PVCC or Soft PVPC to this interface."
836	::= { atmInterfaceSoftPvcAddressEntry 1 }
837
838
839atmInterfaceSoftPvcAddressRowStatus	OBJECT-TYPE
840	SYNTAX	RowStatus
841	MAX-ACCESS	read-create
842	STATUS	current
843	DESCRIPTION
844		"Used to create and delete an ATM address at this interface
845		for setting up Soft PVCCs or Soft PVPCs."
846	::= { atmInterfaceSoftPvcAddressEntry 2 }
847
848
849-- Currently Failing Soft PVCC table
850
851
852atmCurrentlyFailingSoftPVccTable	OBJECT-TYPE
853	SYNTAX	SEQUENCE OF AtmCurrentlyFailingSoftPVccEntry
854	MAX-ACCESS	not-accessible
855	STATUS	current
856	DESCRIPTION
857		"A table indicating all Soft Permanent Virtual Channel
858		Connections (Soft PVCCs) for which the atmSoftPVccRowStatus
859		is 'active' and the atmSoftPVccOperStatus is other than
860		'connected'."
861	::= { atmSoftPvcMIBObjects 5 }
862
863
864atmCurrentlyFailingSoftPVccEntry	OBJECT-TYPE
865	SYNTAX	AtmCurrentlyFailingSoftPVccEntry
866	MAX-ACCESS	not-accessible
867	STATUS	current
868	DESCRIPTION
869		"Each entry in this table represents a Soft Permanent
870		Virtual Channel Connection (Soft PVCC) for which the
871		atmSoftPVccRowStatus is 'active' and the
872		atmSoftPVccOperStatus is other than 'connected'."
873	INDEX { ifIndex,
874		atmVclVpi,
875		atmVclVci,
876		atmSoftPVccLeafReference }
877	::= { atmCurrentlyFailingSoftPVccTable 1 }
878
879
880AtmCurrentlyFailingSoftPVccEntry ::=
881	SEQUENCE {
882		atmCurrentlyFailingSoftPVccTimeStamp	TimeStamp
883		}
884
885
886atmCurrentlyFailingSoftPVccTimeStamp	OBJECT-TYPE
887	SYNTAX	TimeStamp
888	MAX-ACCESS	read-only
889	STATUS	current
890	DESCRIPTION
891		"The time at which this Soft PVCC began to fail."
892	::= { atmCurrentlyFailingSoftPVccEntry 1 }
893
894
895
896
897-- Currently Failing Soft PVPC table
898
899atmCurrentlyFailingSoftPVpcTable	OBJECT-TYPE
900	SYNTAX	SEQUENCE OF AtmCurrentlyFailingSoftPVpcEntry
901	MAX-ACCESS	not-accessible
902	STATUS	current
903	DESCRIPTION
904		"A table indicating all Soft Permanent Virtual Path
905		Connections (Soft PVPCs) for which the atmSoftPVpcRowStatus
906		is 'active' and the atmSoftPVpcOperStatus is other than
907		'connected'."
908	::= { atmSoftPvcMIBObjects 6 }
909
910
911atmCurrentlyFailingSoftPVpcEntry	OBJECT-TYPE
912	SYNTAX	AtmCurrentlyFailingSoftPVpcEntry
913	MAX-ACCESS	not-accessible
914	STATUS	current
915	DESCRIPTION
916		"Each entry in this table represents a Soft Permanent
917		Virtual Path Connection (Soft PVPC) for which the
918		atmSoftPVpcRowStatus is 'active' and the
919		atmSoftPVpcOperStatus is other than 'connected'."
920	INDEX { ifIndex,
921		atmVclVpi,
922		atmSoftPVpcLeafReference }
923	::= { atmCurrentlyFailingSoftPVpcTable 1 }
924
925
926AtmCurrentlyFailingSoftPVpcEntry ::=
927	SEQUENCE {
928		atmCurrentlyFailingSoftPVpcTimeStamp	TimeStamp
929		}
930
931
932atmCurrentlyFailingSoftPVpcTimeStamp	OBJECT-TYPE
933	SYNTAX	TimeStamp
934	MAX-ACCESS	read-only
935	STATUS	current
936	DESCRIPTION
937		"The time at which this Soft PVPC began to fail."
938	::= { atmCurrentlyFailingSoftPVpcEntry 1 }
939
940
941-- Soft PVC Traps
942
943atmSoftPvcTraps		OBJECT IDENTIFIER ::= { atmSoftPvcMIBTraps 1 }
944
945atmSoftPvcTrapsPrefix	OBJECT IDENTIFIER ::= { atmSoftPvcTraps 0 }
946
947atmSoftPvcCallFailuresTrap	NOTIFICATION-TYPE
948	OBJECTS	{ atmSoftPvcCallFailures,
949			atmSoftPvcCurrentlyFailingSoftPVccs,
950			atmSoftPvcCurrentlyFailingSoftPVpcs }
951	STATUS	current
952	DESCRIPTION
953		"A notification indicating that one or more series of
954		call attempts in trying to establish a Soft PVPC or
955		Soft PVCC have failed since the last
956		atmSoftPvcCallFailureTrap was sent. If this trap has
957		not been sent for the last atmSoftPvcNotificationInterval,
958		then it will be sent on the next increment of
959		atmSoftPvcCallFailures."
960::= { atmSoftPvcTrapsPrefix 1 }
961
962
963-- conformance information
964
965atmSoftPvcMIBConformance
966		OBJECT IDENTIFIER ::= { atmSoftPvcMIB 3 }
967atmSoftPvcMIBCompliances
968		OBJECT IDENTIFIER ::= { atmSoftPvcMIBConformance 1 }
969atmSoftPvcMIBGroups
970		OBJECT IDENTIFIER ::= { atmSoftPvcMIBConformance 2 }
971
972
973-- compliance statements
974
975atmSoftPvcMIBCompliance	MODULE-COMPLIANCE
976	STATUS	current
977	DESCRIPTION
978		"The compliance statement for the ATM Soft PVC group."
979	MODULE	-- this module
980	MANDATORY-GROUPS
981		{ atmSoftPvcBaseMIBGroup, atmSoftPvcVccMIBGroup,
982		  atmSoftPvcAddressMIBGroup
983		}
984	OBJECT atmSoftPVccRetryLimit
985	MIN-ACCESS read-only
986	DESCRIPTION
987		"Write access not required."
988
989	GROUP atmSoftPvcVpcMIBGroup
990	DESCRIPTION
991		"Required if Soft PVPCs are supported."
992
993	OBJECT atmSoftPVpcRetryLimit
994	MIN-ACCESS read-only
995	DESCRIPTION
996		"Write access not required."
997
998	::= { atmSoftPvcMIBCompliances 1 }
999
1000
1001-- units of conformance
1002
1003atmSoftPvcBaseMIBGroup	OBJECT-GROUP
1004	OBJECTS {
1005		atmSoftPvcCallFailuresTrapEnable,
1006		atmSoftPvcCallFailures,
1007		atmSoftPvcCurrentlyFailingSoftPVccs,
1008		atmSoftPvcCurrentlyFailingSoftPVpcs,
1009		atmSoftPvcNotificationInterval
1010		}
1011	STATUS	current
1012	DESCRIPTION
1013		"A collection of objects to related to failing
1014		Soft PVCCs and Soft PVPCs."
1015	::= { atmSoftPvcMIBGroups 1 }
1016
1017
1018
1019
1020atmSoftPvcVccMIBGroup	OBJECT-GROUP
1021	OBJECTS {
1022		atmSoftPVccTargetAddress,
1023		atmSoftPVccTargetSelectType, atmSoftPVccTargetVpi,
1024		atmSoftPVccTargetVci, atmSoftPVccLastReleaseCause,
1025		atmSoftPVccLastReleaseDiagnostic,
1026		atmSoftPVccOperStatus, atmSoftPVccRestart,
1027		atmSoftPVccRetryInterval,
1028		atmSoftPVccRetryTimer, atmSoftPVccRetryThreshold,
1029		atmSoftPVccRetryFailures, atmSoftPVccRetryLimit,
1030		atmSoftPVccRowStatus
1031		}
1032	STATUS	current
1033	DESCRIPTION
1034		"A collection of objects managing Soft PVCCs."
1035	::= { atmSoftPvcMIBGroups 2 }
1036
1037
1038atmSoftPvcVpcMIBGroup	OBJECT-GROUP
1039	OBJECTS	{
1040		atmSoftPVpcTargetAddress,
1041		atmSoftPVpcTargetSelectType, atmSoftPVpcTargetVpi,
1042		atmSoftPVpcLastReleaseCause,
1043		atmSoftPVpcLastReleaseDiagnostic,
1044		atmSoftPVpcOperStatus, atmSoftPVpcRestart,
1045		atmSoftPVpcRetryInterval,
1046		atmSoftPVpcRetryTimer, atmSoftPVpcRetryThreshold,
1047		atmSoftPVpcRetryFailures,
1048		atmSoftPVpcRetryLimit,atmSoftPVpcRowStatus
1049		}
1050	STATUS	current
1051	DESCRIPTION
1052		"A collection of objects managing Soft PVPCs."
1053	::= { atmSoftPvcMIBGroups 3 }
1054
1055
1056atmSoftPvcAddressMIBGroup	OBJECT-GROUP
1057	OBJECTS	{
1058		atmInterfaceSoftPvcAddressRowStatus
1059		}
1060	STATUS	current
1061	DESCRIPTION
1062		"A collection of objects managing interfaces addresses for
1063		Soft PVCCs and Soft PVPCs."
1064	::= { atmSoftPvcMIBGroups 4 }
1065
1066
1067atmCurrentlyFailingSoftPVccMIBGroup	OBJECT-GROUP
1068	OBJECTS	{
1069		atmCurrentlyFailingSoftPVccTimeStamp
1070		}
1071	STATUS	current
1072	DESCRIPTION
1073		"A collection of objects for management of currently
1074		failing Soft PVCCs."
1075	::= { atmSoftPvcMIBGroups 5 }
1076
1077
1078atmCurrentlyFailingSoftPVpcMIBGroup	OBJECT-GROUP
1079	OBJECTS	{
1080		atmCurrentlyFailingSoftPVpcTimeStamp
1081		}
1082	STATUS	current
1083	DESCRIPTION
1084		"A collection of objects for management of currently
1085		failing Soft PVPCs."
1086	::= { atmSoftPvcMIBGroups 6 }
1087
1088
1089END
1090
1091