1-- ***************************************************************** 2-- ciscoVismXgcpExtensionMIB 3-- "VISM(Voice Interworking Service Module) specific extensions 4-- to XGCP MIB. This MIB is an extension to the XGCP-MIB as 5--- defined by: External Media Gateway Control Protocol 6-- MIB-XGCP-MIB <ietf-nguyen-xgcp-mib-01.txt> April 13, 1999" 7-- 8-- July 2003, George Ogagan 9-- 10-- Copyright (c) 2003 by cisco Systems, Inc. 11-- All rights reserved. 12-- **************************************************************** 13 14CISCO-VISM-XGCP-EXT DEFINITIONS ::= BEGIN 15IMPORTS 16 MODULE-IDENTITY, 17 OBJECT-TYPE, 18 Integer32, 19 Counter32, 20 IpAddress 21 FROM SNMPv2-SMI 22 MODULE-COMPLIANCE, 23 OBJECT-GROUP FROM SNMPv2-CONF 24 voice FROM BASIS-MIB 25 ciscoWan FROM CISCOWAN-SMI; 26 27ciscoVismXgcpExtMIB MODULE-IDENTITY 28 LAST-UPDATED "200307110000Z" 29 ORGANIZATION "Cisco Systems, Inc." 30 CONTACT-INFO 31 " Cisco Systems 32 Customer Service 33 34 Postal: 170 W Tasman Drive 35 San Jose, CA 95134 36 USA 37 38 Tel: +1 800 553-NETS 39 40 E-mail: cs-wanatm@cisco.com" 41 DESCRIPTION 42 "The MIB module contain the XGCP MIB feature in VISM" 43 44 REVISION "200307110000Z" 45 DESCRIPTION 46 "Initial version of the MIB. 47 48 The content of this MIB was originally available 49 in SMIv1 version. The MIB has been converted to 50 SMIv2 version and descriptions of some of the objects 51 have been modified." 52 ::= { ciscoWan 94 } 53 54 55vismXgcpExtensionGrp OBJECT IDENTIFIER ::= { voice 5 } 56vismXgcpCoreObjects OBJECT IDENTIFIER ::= { vismXgcpExtensionGrp 1 } 57vismXgcpEnhancementsObjects OBJECT IDENTIFIER ::= { vismXgcpExtensionGrp 2 } 58 59 60-- ********************************************************************* 61-- The XGCP Core Group Extension 62-- ********************************************************************* 63 64vismXgcpRequestMaxTimeout OBJECT-TYPE 65 SYNTAX Integer32 (1..100000) 66 MAX-ACCESS read-write 67 STATUS current 68 DESCRIPTION 69 " 70 This object specifies the maximum timeout value. 71 72 This timer value is used along with xgcpRequestTimeout and 73 xgcpRequestRetries (in xgcpGrp.my) to determine the exponential 74 retry interval for retransmitting unacknowledged xgcp messages. 75 76 The value of this timer has to be greater than or equal to 77 xgcpRequestTimeout. 78 79 The default value of this object is 500 milliseconds. 80 81 When the value of this object changes vismXgcpCoreObjects changed 82 trap will be sent. 83 84 " 85 DEFVAL{500} 86 ::= {vismXgcpCoreObjects 1} 87 88vismXgcpPort OBJECT-TYPE 89 SYNTAX Integer32(1025..65535) 90 MAX-ACCESS read-write 91 STATUS current 92 DESCRIPTION 93 "This object is used to configure the local UDP port on 94 VISM used by the SGCP and MGCP protocols to communicate 95 with the call agent. 96 97 The UDP port is used together with vismIpAddress to 98 identify the local end of a SGCP/MGCP connection. 99 100 The default value of this object is 2427. 101 102 In VISM 1.5 this object always defaults to 2427 and is 103 read-only. 104 " 105 DEFVAL { 2427 } 106 ::= { vismXgcpCoreObjects 2 } 107 108-- ********************************************************************* 109-- The XGCP Peer Configuration Table 110-- ********************************************************************* 111 112vismXgcpPeerTable OBJECT-TYPE 113 SYNTAX SEQUENCE OF VismXgcpPeerEntry 114 MAX-ACCESS not-accessible 115 STATUS current 116 DESCRIPTION 117 "This table is used to provision peer-specific XGCP 118 configuration information. Each table entry corresponds 119 to an XGCP peer name / peer XGCP variant combination. 120 " 121 ::= { vismXgcpCoreObjects 3 } 122 123vismXgcpPeerEntry OBJECT-TYPE 124 SYNTAX VismXgcpPeerEntry 125 MAX-ACCESS not-accessible 126 STATUS current 127 DESCRIPTION 128 "Each row is identified by XGCP peer name and peer XGCP 129 protocol number combination. This means, if an MGC uses 130 more than one variant of XGCP (i.e MGCP, SGCP 1.0, 131 SGCP 1.1 etc), an entry will be maintained for each 132 of the protocols. mgcNumber and mgcProtocolNumber from 133 MGMIB are used as foreign index to this table. 134 135 Entries in this table are implicitly created by the 136 agent. An entry shall be created when an entry is created 137 in the mgcProtocolTable and when mgcProtocolNumber refers 138 to an XGCP variant (i.e MGCP, SGCP 1.0, SGCP 1.1 etc) as 139 supported protocol. An entry shall be deleted if the 140 corresponding entry in the mgcProtocolTable is deleted. 141 142 As both mgcProtocolTable and vismXgcpPeerTable have 143 mgcNumber and mgcProtocolNumber as index, referential 144 integrity between the two tables is automatically ensured. 145 " 146 INDEX { vismXgcpPeerNumber, vismXgcpPeerProtocolNumber } 147 ::= { vismXgcpPeerTable 1 } 148 149VismXgcpPeerEntry ::= SEQUENCE { 150 vismXgcpPeerNumber Integer32, 151 vismXgcpPeerProtocolNumber Integer32, 152 vismXgcpPeerPort Integer32 153 } 154 155vismXgcpPeerNumber OBJECT-TYPE 156 SYNTAX Integer32 (1..8) 157 MAX-ACCESS read-only 158 STATUS current 159 DESCRIPTION 160 "The value of this object is the same as mgcNumber from 161 MGMIB. 162 " 163 ::= { vismXgcpPeerEntry 1 } 164 165vismXgcpPeerProtocolNumber OBJECT-TYPE 166 SYNTAX Integer32 (1..8) 167 MAX-ACCESS read-only 168 STATUS current 169 DESCRIPTION 170 "The value of this object is the same as mgcProtocolNumber 171 from MGMIB. 172 " 173 ::= { vismXgcpPeerEntry 2 } 174 175vismXgcpPeerPort OBJECT-TYPE 176 SYNTAX Integer32 (1025..65535) 177 MAX-ACCESS read-write 178 STATUS current 179 DESCRIPTION 180 "This object is used to configure the local UDP port on 181 VISM used by the SGCP and MGCP protocols to communicate 182 with the call agent. 183 184 The UDP port is used together with vismIpAddress to 185 identify the local end of a SGCP/MGCP connection. 186 187 If the protocol configured for the call agent is MGCP 1.0, 188 the default port is 2727. In all other cases, the default 189 value of this object is 2427. 190 191 In VISM 1.5 this object always defaults to 2427 and is 192 read-only. 193 " 194 DEFVAL { 2427 } 195 ::= { vismXgcpPeerEntry 3 } 196 197-- ***************************************************************** 198-- The XGCP Statistics table extension 199-- ***************************************************************** 200 201vismXgcpMsgStatTable OBJECT-TYPE 202 SYNTAX SEQUENCE OF VismXgcpMsgStatEntry 203 MAX-ACCESS not-accessible 204 STATUS current 205 DESCRIPTION 206 "This table is an extension to the xgcpMsgStatTable contained 207 in the XGCP MIB. This table provides per-message type based 208 detailed statistics information. 209 " 210 ::= { vismXgcpCoreObjects 4 } 211 212vismXgcpMsgStatEntry OBJECT-TYPE 213 SYNTAX VismXgcpMsgStatEntry 214 MAX-ACCESS not-accessible 215 STATUS current 216 DESCRIPTION 217 "The row of the vismXgcpMsgStatTable contains 218 additional information about XGCP message statistics 219 beyond that provided by the XGCP MIB. 220 " 221 INDEX { vismXgcpIpAddress } 222 ::= { vismXgcpMsgStatTable 1 } 223 224VismXgcpMsgStatEntry ::= SEQUENCE { 225 vismXgcpIpAddress IpAddress, 226 vismXgcpCrcxCnts Counter32, 227 vismXgcpCrcxFailCnts Counter32, 228 vismXgcpMdcxCnts Counter32, 229 vismXgcpMdcxFailCnts Counter32, 230 vismXgcpDlcxRcvCnts Counter32, 231 vismXgcpDlcxRcvFailCnts Counter32, 232 vismXgcpDlcxSentCnts Counter32, 233 vismXgcpDlcxSentFailCnts Counter32, 234 vismXgcpRqntCnts Counter32, 235 vismXgcpRqntFailCnts Counter32, 236 vismXgcpNtfyCnts Counter32, 237 vismXgcpNtfyFailCnts Counter32, 238 vismXgcpAuepCnts Counter32, 239 vismXgcpAuepFailCnts Counter32, 240 vismXgcpAucxCnts Counter32, 241 vismXgcpAucxFailCnts Counter32, 242 vismXgcpRsipCnts Counter32, 243 vismXgcpRsipFailCnts Counter32 244 } 245 246vismXgcpIpAddress OBJECT-TYPE 247 SYNTAX IpAddress 248 MAX-ACCESS read-only 249 STATUS current 250 DESCRIPTION 251 " This object specifies the IP address of the 252 Media Gateway Controller. The value of this object is 253 the same as xgcpIpAddress of XGCP-MIB. 254 " 255 ::= { vismXgcpMsgStatEntry 1 } 256 257vismXgcpCrcxCnts OBJECT-TYPE 258 SYNTAX Counter32 259 MAX-ACCESS read-only 260 STATUS current 261 DESCRIPTION 262 " This refers to the count of CRCX (Create Connection) 263 messages received from the call agent since reset. 264 " 265 ::= { vismXgcpMsgStatEntry 2 } 266 267vismXgcpCrcxFailCnts OBJECT-TYPE 268 SYNTAX Counter32 269 MAX-ACCESS read-only 270 STATUS current 271 DESCRIPTION 272 " This refers to the count of CRCX (Create Connection) 273 messages received from the call agent that were responded 274 to with a failure return code. 275 " 276 ::= { vismXgcpMsgStatEntry 3 } 277 278vismXgcpMdcxCnts OBJECT-TYPE 279 SYNTAX Counter32 280 MAX-ACCESS read-only 281 STATUS current 282 DESCRIPTION 283 " This refers to the count of MDCX (Modify Connection) 284 messages received from the call agent since reset. 285 " 286 ::= { vismXgcpMsgStatEntry 4 } 287 288vismXgcpMdcxFailCnts OBJECT-TYPE 289 SYNTAX Counter32 290 MAX-ACCESS read-only 291 STATUS current 292 DESCRIPTION 293 " This refers to the count of MDCX (Modify Connection) 294 messages received from the call agent that were responded 295 to with a failure return code. 296 " 297 ::= { vismXgcpMsgStatEntry 5 } 298 299vismXgcpDlcxRcvCnts OBJECT-TYPE 300 SYNTAX Counter32 301 MAX-ACCESS read-only 302 STATUS current 303 DESCRIPTION 304 " This refers to the count of DLCX (Delete Connection) 305 messages received from the call agent since reset. 306 " 307 ::= { vismXgcpMsgStatEntry 6 } 308 309vismXgcpDlcxRcvFailCnts OBJECT-TYPE 310 SYNTAX Counter32 311 MAX-ACCESS read-only 312 STATUS current 313 DESCRIPTION 314 " This refers to the count of DLCX (Delete Connection) 315 messages received from the call agent that were responded 316 to with a failure return code. 317 " 318 ::= { vismXgcpMsgStatEntry 7 } 319 320vismXgcpDlcxSentCnts OBJECT-TYPE 321 SYNTAX Counter32 322 MAX-ACCESS read-only 323 STATUS current 324 DESCRIPTION 325 " This refers to the count of DLCX (Delete Connection) 326 messages sent to the call agent since reset. 327 " 328 ::= { vismXgcpMsgStatEntry 8 } 329 330vismXgcpDlcxSentFailCnts OBJECT-TYPE 331 SYNTAX Counter32 332 MAX-ACCESS read-only 333 STATUS current 334 DESCRIPTION 335 " This refers to the count of DLCX (Delete Connection) 336 messages sent to the call agent for which a response 337 with failure return code was received or which timed 338 out waiting for an acknowledgement. 339 " 340 ::= { vismXgcpMsgStatEntry 9 } 341 342vismXgcpRqntCnts OBJECT-TYPE 343 SYNTAX Counter32 344 MAX-ACCESS read-only 345 STATUS current 346 DESCRIPTION 347 " This refers to the count of RQNT (Request Notify) 348 messages received from the call agent since reset. 349 " 350 ::= { vismXgcpMsgStatEntry 10 } 351 352vismXgcpRqntFailCnts OBJECT-TYPE 353 SYNTAX Counter32 354 MAX-ACCESS read-only 355 STATUS current 356 DESCRIPTION 357 " This refers to the count of RQNT (Request Notify) 358 messages received from the call agent that were 359 responded to with a failure return code. 360 " 361 ::= { vismXgcpMsgStatEntry 11 } 362 363vismXgcpNtfyCnts OBJECT-TYPE 364 SYNTAX Counter32 365 MAX-ACCESS read-only 366 STATUS current 367 DESCRIPTION 368 " This refers to the count of NTFY (Notify) messages 369 sent to the call agent since reset. 370 " 371 ::= { vismXgcpMsgStatEntry 12 } 372 373vismXgcpNtfyFailCnts OBJECT-TYPE 374 SYNTAX Counter32 375 MAX-ACCESS read-only 376 STATUS current 377 DESCRIPTION 378 " This refers to the count of NTFY (Notify) messages 379 sent to the call agent for which a response with 380 failure return code was received or which timed out 381 waiting for a response. 382 " 383 ::= { vismXgcpMsgStatEntry 13 } 384 385vismXgcpAuepCnts OBJECT-TYPE 386 SYNTAX Counter32 387 MAX-ACCESS read-only 388 STATUS current 389 DESCRIPTION 390 " This refers to the count of AUEP (Audit Endpoint) 391 messages received from the call agent since reset. 392 " 393 ::= { vismXgcpMsgStatEntry 14 } 394 395vismXgcpAuepFailCnts OBJECT-TYPE 396 SYNTAX Counter32 397 MAX-ACCESS read-only 398 STATUS current 399 DESCRIPTION 400 " This refers to the count of AUEP (Audit Endpoint) 401 messages received from the call agent that were 402 responded to with a failure return code. 403 " 404 ::= { vismXgcpMsgStatEntry 15 } 405 406vismXgcpAucxCnts OBJECT-TYPE 407 SYNTAX Counter32 408 MAX-ACCESS read-only 409 STATUS current 410 DESCRIPTION 411 " This refers to the count of AUCX (Audit Connection) 412 messages received from the call agent since reset. 413 " 414 ::= { vismXgcpMsgStatEntry 16 } 415 416vismXgcpAucxFailCnts OBJECT-TYPE 417 SYNTAX Counter32 418 MAX-ACCESS read-only 419 STATUS current 420 DESCRIPTION 421 " This refers to the count of AUCX (Audit Connection) 422 messages received from the call agent that were 423 responded to with a failure return code. 424 " 425 ::= { vismXgcpMsgStatEntry 17 } 426 427vismXgcpRsipCnts OBJECT-TYPE 428 SYNTAX Counter32 429 MAX-ACCESS read-only 430 STATUS current 431 DESCRIPTION 432 " This refers to the count of RSIP (Restart In Progress) 433 messages sent to the call agent since reset. 434 " 435 ::= { vismXgcpMsgStatEntry 18 } 436 437vismXgcpRsipFailCnts OBJECT-TYPE 438 SYNTAX Counter32 439 MAX-ACCESS read-only 440 STATUS current 441 DESCRIPTION 442 " This refers to the count of RSIP (Restart In Progress) 443 messages sent to the call agent for which a response 444 with failure return code was received or which timed out 445 waiting for a response. 446 " 447 ::= { vismXgcpMsgStatEntry 19 } 448 449-- ********************************************************************* 450-- The XGCP Enhancement Group 451-- ********************************************************************* 452 453vismXgcpRestartInProgressTdinit OBJECT-TYPE 454 SYNTAX Integer32 (1..100) 455 MAX-ACCESS read-write 456 STATUS current 457 DESCRIPTION 458 "The endpoint becomes disconnected when it tries to communicate 459 with the call agent and the retransmission procedure times out 460 after retrying. 461 462 The endpoint in disconnected state starts the disconnected timer 463 initialised to the random value and uniformly distributed between 464 1 and initial waiting delay (Tdinit) in seconds. 465 466 The gateway waits for either the end of this timer, or the reception 467 of call agent command or the detection of local user activity for 468 the endpoint. 469 470 When the disconnected timer elapses, or when a command is received 471 from the call agent or when there is a local user activity, the 472 Media Gateway sends the Restart In Progress command with the restart 473 method as RM:disconnected to the Media Gateway Controller. 474 475 The initial waiting delay (Tdinit) timeout value is defined by 476 this MIB object. 477 478 The recommended value of this object is 15 seconds. 479 " 480 REFERENCE 481 " Media Gateway Control Protocol (MGCP), 482 version 1.0 bis, May 10, 2001 : Section 4.4.7 483 " 484 DEFVAL{ 15 } 485 ::= { vismXgcpEnhancementsObjects 1 } 486 487vismXgcpRestartInProgressTdmin OBJECT-TYPE 488 SYNTAX Integer32 (0..100) 489 MAX-ACCESS read-write 490 STATUS current 491 DESCRIPTION 492 "The endpoint becomes disconnected when it tries to communicate 493 with the call agent and the retransmission procedure times out 494 after retrying. 495 496 The endpoint in disconnected state starts the disconnected timer 497 initialised to the random value and uniformly distributed between 498 1 and initial waiting delay (Tdinit) in seconds. 499 500 The gateway waits for either the end of this timer, or the reception 501 of call agent command or the detection of local user activity for 502 the endpoint. 503 504 When the disconnected timer elapses, or when a command is received 505 from the call agent or when there is a local user activity, the 506 Media Gateway sends the Restart In Progress command with the restart 507 method as RM:disconnected to the Media Gateway Controller. 508 509 In case of local user activity, a provisionable disconnected 510 minimum waiting delay (Tdmin) must have been elapsed since the 511 gateway became disconnected. 512 513 The minimum waiting delay (Tdmin) timeout value used by the 514 Media Gateway to send the Restart In Progress with the restart 515 method as RM:disconnected to the Media Gateway Controller if 516 there is any local user activity is defined by this object. 517 518 Media Gateway initiated delete connection (DLCX) or restart in 519 progress (RSIP) commands are not considered as local user 520 activity. 521 522 The events observed on the TDM interface or on the network 523 constitute the local user activity. 524 525 The recommended value of this object is 15 seconds. 526 " 527 REFERENCE 528 " Media Gateway Control Protocol (MGCP), 529 version 1.0 bis, May 10, 2001 : Section 4.4.7 530 " 531 DEFVAL{ 15 } 532 ::= { vismXgcpEnhancementsObjects 2 } 533 534vismXgcpRestartInProgressTdmax OBJECT-TYPE 535 SYNTAX Integer32 (1..5000) 536 MAX-ACCESS read-write 537 STATUS current 538 DESCRIPTION 539 "The maximum waiting delay (Tdmax) timeout value used by the 540 Media Gateway to send the Restart In Progress with the restart 541 method as RM:disconnected to the Media Gateway Controller when 542 the endpoint has become disconnected is defined by this object. 543 544 The endpoint becomes disconnected when it tries to communicate 545 with the call agent and the retransmission procedure times out 546 after retrying. 547 548 The endpoint in disconnected state starts the disconnected timer 549 initialised to the random value and uniformly distributed between 550 1 and initial waiting delay (Tdinit) in seconds. 551 552 The gateway waits for either the end of this timer, or the reception 553 of call agent command or the detection of local user activity for 554 the endpoint. 555 556 When the disconnected timer elapses, or when a command is received 557 from the call agent or when there is a local user activity, the 558 Media Gateway sends the Restart In Progress command with the restart 559 method as RM:disconnected to the Media Gateway Controller. 560 561 If the disconnected procedure still left the endpoint disconnected, 562 the disconnected timer is doubled subject to a provisionable 563 disconnected maximum waiting delay (Tdmax) in seconds and the 564 gateway starts the new disconnected procedure again. 565 566 Once the maximum value is reached, the subsequent disconnected 567 Restart In Progress commands use the maximum waiting delay (Tdmax). 568 569 The recommended value of this object is 600 seconds. 570 " 571 REFERENCE 572 " Media Gateway Control Protocol (MGCP), 573 version 1.0 bis, May 10, 2001 : Section 4.4.7 574 " 575 DEFVAL{ 600 } 576 ::= { vismXgcpEnhancementsObjects 3 } 577 578-- conformance information 579 580ciscoVismXgcpExtMIBConformance OBJECT IDENTIFIER ::= { ciscoVismXgcpExtMIB 2 } 581 582ciscoVismXgcpExtMIBGroups OBJECT IDENTIFIER ::= 583 { ciscoVismXgcpExtMIBConformance 1 } 584 585ciscoVismXgcpExtMIBCompliances OBJECT IDENTIFIER ::= 586 { ciscoVismXgcpExtMIBConformance 2 } 587 588-- compliance statements 589 590ciscoVismXgcpExtCompliance MODULE-COMPLIANCE 591 STATUS current 592 DESCRIPTION 593 "The compliance statement for objects related 594 to VISM-XGCP-MIB." 595 MODULE -- this module 596 MANDATORY-GROUPS { 597 ciscoVismXgcpExtensionGroup, 598 ciscoVismXgcpCoreGroup, 599 ciscoVismXgcpStatsGroup, 600 ciscoVismXgcpEnhancementGroup 601 } 602 ::= { ciscoVismXgcpExtMIBCompliances 1 } 603 604ciscoVismXgcpExtensionGroup OBJECT-GROUP 605 OBJECTS { 606 vismXgcpRequestMaxTimeout, 607 vismXgcpPort 608 } 609 STATUS current 610 DESCRIPTION 611 "The collection of objects which are used to represent 612 VISM XGCP MIB." 613 ::= { ciscoVismXgcpExtMIBGroups 1 } 614 615ciscoVismXgcpCoreGroup OBJECT-GROUP 616 OBJECTS { 617 vismXgcpPeerNumber, 618 vismXgcpPeerProtocolNumber, 619 vismXgcpPeerPort 620 } 621 STATUS current 622 DESCRIPTION 623 "The collection of objects which are used to represent 624 VISM peer XGCP MIB configuration." 625 ::= { ciscoVismXgcpExtMIBGroups 2 } 626 627ciscoVismXgcpStatsGroup OBJECT-GROUP 628 OBJECTS { 629 vismXgcpIpAddress, 630 vismXgcpCrcxCnts, 631 vismXgcpCrcxFailCnts, 632 vismXgcpMdcxCnts, 633 vismXgcpMdcxFailCnts, 634 vismXgcpDlcxRcvCnts, 635 vismXgcpDlcxRcvFailCnts, 636 vismXgcpDlcxSentCnts, 637 vismXgcpDlcxSentFailCnts, 638 vismXgcpRqntCnts, 639 vismXgcpRqntFailCnts, 640 vismXgcpNtfyCnts, 641 vismXgcpNtfyFailCnts, 642 vismXgcpAuepCnts, 643 vismXgcpAuepFailCnts, 644 vismXgcpAucxCnts, 645 vismXgcpAucxFailCnts, 646 vismXgcpRsipCnts, 647 vismXgcpRsipFailCnts 648 } 649 STATUS current 650 DESCRIPTION 651 "The collection of objects which are used to represent 652 VISM peer XGCP MIB Statistics information." 653 ::= { ciscoVismXgcpExtMIBGroups 3 } 654 655ciscoVismXgcpEnhancementGroup OBJECT-GROUP 656 OBJECTS { 657 vismXgcpRestartInProgressTdinit, 658 vismXgcpRestartInProgressTdmin, 659 vismXgcpRestartInProgressTdmax 660 } 661 STATUS current 662 DESCRIPTION 663 "The collection of objects which are used to represent 664 VISM XGCP Enhancement." 665 ::= { ciscoVismXgcpExtMIBGroups 4 } 666 667END 668