Study guide

5.4 Administrative XML (AXL) API & Dial-Plan Troubleshooting Tools

Cisco 350-801 CLCOR CCNP/CCIE Collaboration Core v2.0

Track your progress as you read

Finished sections get a check mark.

1 Chapter 1: Collaboration Architecture, Deployment Models, Sizing & Upgrades

1.1 Collaboration Architecture & Deployment Models 1.2 Capacity Planning, Sizing & Bandwidth Considerations 1.3 High Availability, Redundancy & Disaster Recovery 1.4 Cisco Unified CM Cluster Upgrade Process

2 Chapter 2: Edge Architecture, Security & Network Services

2.1 Collaboration Edge Architecture: CUBE & Expressway 2.2 Security Protocols & PKI: SSO, OAuth, TLS & SRTP 2.3 Network Infrastructure Services: DNS, NTP, DHCP & LDAP

3 Chapter 3: Protocols, Codecs & Endpoint Provisioning

3.1 SIP Signaling Architecture & Call Flows 3.2 Session Description Protocol (SDP) & Early Offer vs. Delayed Offer 3.3 Audio/Video Codecs & DTMF Relay 3.4 Endpoint Deployment, Onboarding & Troubleshooting

4 Chapter 4: CUCM Dial Plan Fundamentals & Digit Analysis

4.1 Partitions and Calling Search Spaces (CSS) 4.2 Route Patterns, Route Groups & Route Lists 4.3 Translation Patterns, Transformation Patterns & Digit Manipulation 4.4 Globalized Call Routing & Local Route Group (LRG)

5 Chapter 5: Advanced Call Control, Call Routing & User Management

5.1 Call Admission Control (CAC), Locations & AAR 5.2 Toll Fraud Prevention & Call Privileges 5.3 CUCM User Management, LDAP Integration & RBAC 5.4 Administrative XML (AXL) API & Dial-Plan Troubleshooting Tools

6 Chapter 6: Cisco Unity Connection & Voicemail Integration

6.1 Cisco Unity Connection Architecture & SIP Integration 6.2 Mailbox Provisioning, User Templates & Class of Service 6.3 Message Waiting Indication (MWI) & Troubleshooting 6.4 Call Handlers & Directory Handlers

7 Chapter 7: IOS XE Voice Gateways, CUBE & Media Resources

7.1 Cisco IOS XE Voice Gateways & Dial Peers 7.2 Voice Translation Rules and Translation Profiles 7.3 Cisco Unified Border Element (CUBE) Configuration & Redundancy 7.4 IOS XE Media Resources & DSP Management

8 Chapter 8: Webex Architecture, Control Hub, Meetings & Messaging

8.1 Webex Suite Overview & Control Hub Architecture 8.2 Cloud Identity Management, SCIM & Directory Connector 8.3 Webex Developer Platform & APIs 8.4 Configuring Webex Cloud Meetings 8.5 Configuring Webex Cloud Messaging

9 Chapter 9: Webex Calling Routing, Permissions & PSTN Connectivity

9.1 Webex Calling Architecture, Locations & Number Management 9.2 Webex Calling Routing, Trunks & Dial Plans 9.3 Webex Calling Call Routing Process & Translation Patterns 9.4 Webex Calling Toll Fraud Prevention, Call Permissions & Operating Modes 9.5 PSTN Connectivity: Cloud-Connected PSTN (CC-PSTN) & Cisco Calling Plans 9.6 Webex Calling Local Gateway (LGW) Architecture & Configuration

10 Chapter 10: Webex Hybrid Services & Cloud Connected UC

10.1 Cloud-Connected UC (CCUC) Architecture & Telemetry 10.2 Webex Hybrid Calendar & Hybrid Directory Services 10.3 Webex Video Mesh & Hybrid Data Security

11 Chapter 11: Media Quality, QoS Engineering & Troubleshooting

11.1 Real-Time Media Characteristics & Impairments 11.2 QoS Classification, Marking & Trust Boundaries 11.3 Low Latency Queuing (LLQ) Configuration on Cisco IOS XE 11.4 Troubleshooting Media Quality & Call Failures

5.4 Administrative XML (AXL) API & Dial-Plan Troubleshooting Tools

Key Takeaways Explain This Topic AI

The Administrative XML (AXL) API provides programmatic SOAP-over-HTTPS web services on TCP port 8443, enabling Create, Read, Update, and Delete (CRUD) provisioning and direct SQL execution against the CUCM Informix engine.

The Cisco Real-Time Monitoring Tool (RTMT) tracks real-time performance counters (CallsActive, CallsAttempted, CallsInProgress), monitors system alerts, and centralizes trace log collection across all cluster nodes.

The Dialed Number Analyzer (DNA) executes offline digit analysis simulations using the live database to evaluate Calling Search Spaces, partitions, translation patterns, and egress route lists without placing physical calls or seizing trunk channels.

CallManager SDI traces show digit analysis decisions and full SIP messages, while SDL (Signal Distribution Layer) traces record the internal messages between CUCM processes; collect both with RTMT Trace & Log Central.

ISDN Q.931 Disconnect Cause Codes provide authoritative diagnostic identification of call failures, distinguishing between unassigned numbers (Cause 1), normal clearing (Cause 16), user busy (Cause 17), and circuit congestion (Cause 34).

Last updated: October 2026

5.4 Administrative XML (AXL) API & Dial-Plan Troubleshooting Tools

Operating enterprise collaboration networks requires automated provisioning tools alongside diagnostic instruments capable of troubleshooting complex dial plans. Cisco Unified Communications Manager provides the Administrative XML (AXL) API for programmatic database manipulation, complemented by the Real-Time Monitoring Tool (RTMT) , Dialed Number Analyzer (DNA) , and Signaling Distribution Layer (SDL) trace analysis to isolate call routing anomalies.

1. Administrative XML (AXL) API Architecture & Operations

The Administrative XML (AXL) API is an enterprise management interface allowing external scripts, orchestration platforms, and third-party provisioning engines to configure and query the CUCM Informix database.

Architectural Specifications

Protocol : Simple Object Access Protocol (SOAP 1.1) wrapped in XML payloads.

Transport : Encrypted HTTPS over TCP port 8443 (or port 443 with reverse-proxy redirection).

Authentication : HTTP Basic Authentication over TLS, requiring an Application User or End User assigned the Standard AXL API Access role.

Database Target : Interacts directly with the Informix Dynamic Server (IDS) database engine running on the Publisher node. +--------------------------------------------------------------------------------+

  • | AXL API ARCHITECTURE |
  • | |
  • | +--------------------+ |
  • | | Provisioning App | |
  • | | (Python / Ansible) | |
  • | +---------+----------+ |
  • | | |
  • | |=== 1. HTTPS POST SOAP/XML (Port 8443) ==================> |
  • | | Auth: Basic (AXL Application User) |
  • | | Payload: <updateLine> or <addPhone> |
  • | | |
  • | | +---------------------------+ |
  • | | | CUCM Publisher Node | |
  • | | | - Tomcat Web Server | |
  • | | | - AXL Web Service | |
  • | | +-------------+-------------+ |
  • | | | |
  • | | v |
  • | | +---------------------------+ |
  • | | | Informix IDS Database | |
  • | | | (Read / Write Access) | |
  • | | +-------------+-------------+ |
  • | | | |
  • | |<== 2. SOAP XML Response (200 OK) <===============+ |
  • | | <return>{UUID}</return> |
  • +--------------------------------------------------------------------------------+
  • Core AXL CRUD Operations

AXL models configuration entities through standard Create, Read, Update, and Delete methods:

addPhone : Provisions a new physical IP phone or softphone, specifying MAC address, product model, device pool, phone button template, and line associations.

getPhone : Queries configuration attributes and line associations for a specific device.

updateLine : Modifies line parameters, including directory number, route partition, alert name, and Call Forward All (CFA) destinations.

removeUser : Deletes an End User account or disassociates assigned extensions.

executeSQLQuery / executeSQLUpdate : Executes direct Informix SQL statements against the CUCM database for high-performance bulk reporting or complex data manipulation.

Example AXL SOAP Request

The following XML payload illustrates an AXL updateLine operation configuring Call Forward All to voicemail for extension 5001: <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"

  • xmlns:ns="http://www.cisco.com/AXL/API/14.0">
  • <soapenv:Header/>
  • <soapenv:Body>
  • <ns:updateLine>
  • <pattern>5001</pattern>
  • <routePartitionName>Internal_PT</routePartitionName>
  • <callForwardAll>
  • <forwardToVoiceMail>true</forwardToVoiceMail>
  • <callingSearchSpaceName>Internal_CSS</callingSearchSpaceName>
  • </callForwardAll>
  • </ns:updateLine>
  • </soapenv:Body>
  • </soapenv:Envelope>
  • Other Unified CM APIs (Blueprint 3.5)

Objective 3.5 asks you to describe each API's type , authentication , and capabilities . For Unified CM the main interfaces are:

API Type Authentication Capabilities

AXL SOAP/XML over HTTPS (TCP 8443) HTTP Basic; the account needs the Standard AXL API Access role Add, get, update, and remove configuration objects; SQL queries

User Data Services (UDS) REST (XML responses) over HTTPS Directory queries can be anonymous; user-specific calls use the end user's credentials or an OAuth token Directory search, user and device lookups, home-cluster discovery for Jabber and Webex App

Serviceability XML (SXML) SOAP over HTTPS HTTP Basic with a serviceability-enabled account RisPort70 real-time registration status, PerfMon counters, Control Center service start and stop, log collection

CTI (JTAPI/TAPI) Java or Windows libraries talking to CTIManager (TCP 2748) An application or end user with Standard CTI Enabled (or Allow Control of All Devices) Call control, monitoring, and recording of associated devices

A provisioning script therefore uses AXL to build a phone, RisPort70 to confirm the phone registered, and UDS or CTI only when a client or application needs runtime user data or call control.

2. Real-Time Monitoring Tool (RTMT) & Performance Telemetry

The Cisco Unified Real-Time Monitoring Tool (RTMT) is an administrator client application that monitors system health, tracks performance counters, and manages diagnostic logs across all cluster nodes.

Core Telemetry Counters

Administrators monitor live telephony performance through the Cisco CallManager object counters:

CallsActive : Instantaneous number of active voice and video sessions currently established across the cluster node.

CallsAttempted : Cumulative count of call setup attempts initiated since the CallManager service last started.

CallsInProgress : Number of calls currently in setup, digit analysis, or teardown phases.

CallsCompleted : Number of successfully completed and normally cleared calls.

PartiallyRegisteredPhone : SIP phones that are registered but have one or more lines that failed to register.

Alert Central & Trace Collection

Alert Central : Tracks real-time threshold conditions (for example, CallProcessingNodeCpuPegging , MediaListExhausted , RouteListExhausted , DBReplicationFailure , and LowActivePartitionAvailableDiskSpace ). When thresholds are exceeded, RTMT generates visual alerts and dispatches SNMP traps or email notifications.

Trace & Log Central : Provides a centralized utility to collect diagnostic logs across all cluster nodes simultaneously. Administrators can query, download, and zip traces for Cisco CallManager , Cisco IP Voice Media Streaming App , and Cisco Extension Mobility services without requiring command-line SSH access.

3. Dialed Number Analyzer (DNA)

Dialed Number Analyzer (DNA) is a specialized diagnostic simulation tool embedded within CUCM Serviceability. It allows engineers to test and validate complex dial plans offline. +--------------------------------------------------------------------------------+

  • | DNA SIMULATION PIPELINE |
  • | |
  • | INPUT PARAMETERS: |
  • | Calling Device: SEP001122334455 |
  • | Line DN: 2001 (Line CSS: Internal_CSS) |
  • | Dialed Digits: 912145551212 |
  • | Time of Day: Monday 14:00 |
  • | |
  • | DIGIT ANALYSIS ENGINE (Offline Simulation): |
  • | Step 1: Check Translation Patterns in Line/Device CSS |
  • | -> Match 9.1[2-9]XX[2-9]XXXXXX (Discard: PreDot) |
  • | Step 2: Check Egress Route Patterns |
  • | -> Match 1[2-9]XX[2-9]XXXXXX in [PSTN_PT] |
  • | Step 3: Route List Resolution |
  • | -> Traverses RL_PSTN -> RG_LocalGateway |
  • | Step 4: Egress Device Selection |
  • | -> Target: CUBE_SIP_Trunk (192.168.10.50) |
  • | |
  • | OUTPUT: Full resolution tree; ZERO physical calls or trunk circuits seized! |
  • +--------------------------------------------------------------------------------+
  • Advantages of DNA Simulation

Zero Impact on Production Trunks : DNA runs against the live Informix configuration database but does not initiate signaling or seize B-channels/SIP sessions.

Granular Transformation Tracing : Exposes every transformation step: pattern matching, discard digit instructions (e.g., PreDot ), prefixing, route list filter application, and gateway selection.

Line vs. Device CSS Disambiguation : Visualizes exactly whether a pattern was matched via the Line CSS or Device CSS partition list.

4. SDL Trace Analysis & ISDN Q.931 Disconnect Codes

When diagnosing intermittent call failures, one-way audio, or unexpected disconnects, engineers analyze the Cisco CallManager SDI traces ( ccm*.txt.gz ), which show digit analysis results such as the matched pattern and the CSS used, together with SDL (Signal Distribution Layer) traces, which record the internal messages between CUCM processes.

Structure of SDL Traces

SDL traces live in /var/log/active/cm/trace/ccm/sdl/ (files named like SDL001_100_000123.txt.gz ) and SDI traces in /var/log/active/cm/trace/ccm/sdi/ ; collect both with RTMT Trace & Log Central rather than browsing the file system.

SDL records internal message exchanges between CUCM state-machine processes (for example, StationD for SCCP phones, digit analysis, the SIP handlers, and route list control).

Engineers search for the GlobalCallId or CallID to trace a call leg from ingress signaling (a SIP INVITE or an SCCP off-hook message) through digit translation, route selection, and egress alerting ( 180 Ringing ).

Authoritative Q.931 Disconnect Cause Codes

When a call terminates, CUCM logs the authoritative ISDN Q.931 Disconnect Cause Code (which directly maps to corresponding SIP response status codes):

Q.931 Cause Code Diagnostic Name SIP Response Mapping Technical Meaning & Diagnostic Action

Cause 1 Unallocated (unassigned) number 404 Not Found The dialed number does not exist in the dial plan or route table. Check for missing directory numbers or route patterns.

Cause 16 Normal call clearing 200 OK (to BYE) The call was terminated normally by either the calling or called party hanging up. Indicates successful session completion.

Cause 17 User busy 486 Busy Here The called party is engaged on an active call and has reached their maximum call appearance limit, or sent a busy status.

Cause 28 Invalid number format (address incomplete) 484 Address Incomplete Insufficient digits were dialed before interdigit timeout expired. Check overlap dialing or variable-length route pattern syntax.

Cause 34 Circuit / channel congestion 503 Service Unavailable All PSTN B-channels, trunk channels, or WAN Call Admission Control bandwidth pools are completely exhausted.

Cause 41 Temporary failure 503 Service Unavailable An internal network outage, SIP signaling timeout, or transient gateway malfunction occurred.

Loading diagram... CUCM Dial Plan Troubleshooting and Trace Diagnostic Workflow