Table Of Contents

Cisco Unified CME Commands: X

xml user

xmlschema

xmltest

xmlthread

Cisco Unified CME Commands: X

---

Revised: December 17, 2007

This chapter contains commands to configure and maintain Cisco Unified Communications Manager Express (formally known as Cisco Unified CallManager Express). The commands are presented in alphabetical order. Some commands required for configuring Cisco Unified Communications Manager Express (Cisco Unified CME) may be found in other Cisco IOS references. Use the reference master index or search online to find these commands.

xml user

To define a user who is authorized to use XML applications to execute commands, use the xml user command in telephony-service configuration mode. To delete the user, use the no form of this command.

xml user user-name password password privilege-level

no xml user user-name password password privilege-level

Syntax Description

user-name	Unique string used by authorized user to access Cisco Unified CME. Maximum length of string: 19 alphanumeric characters.
password password	Alphanumeric string to be used with this user name to provide access to Cisco Unified CME. Maximum length of string: 19 alphanumeric characters.
privilege-level	Level of access to Cisco IOS commands to be granted to this user. Only the commands with the same or a lower level can be executed via XML. Range is 0 to 15.

Command Default

User name is not defined.

Command Modes

Telephony-service configuration (config-telephony)

Command History

Cisco IOS Release	Cisco Product	Modification
12.4(4)XC	Cisco Unified CME 4.0	This command was introduced.
12.4(9)T	Cisco Unified CME 4.0	This command was integrated into Cisco IOS Release 12.4(9)T.

Usage Guidelines

This command creates a credential be used by an authorized user to access Cisco Unified CME via XML and enable the user to execute all the Cisco IOS commands associated with a particular privilege level.

To change the default privilege level for one or more Cisco IOS commands, use the privilege command in global configuration mode.

Examples

The following example defines user23 as an authorized user at level 15:

Router(config)# telephony-service

Router(config-telephony)# xml user user23 password 3Rs92uzQ 15

 

Related Commands

Command	Description
privilege	Configures a new privilege level for users and associates commands with that privilege level.

xmlschema

Effective with Cisco Unified CME 4.0, the xmlschema command was made obsolete.

For earlier releases, to specify the URL for a Cisco CME eXtensible Markup Language (XML) application program interface (API) schema, use the xmlschema command in telephony-service configuration mode. To set the URL for the XML API schema to the default, use the no form of this command.

xmlschema schema-url

no xmlschema

Syntax Description

schema-url

Local or remote URL as defined in RFC 2396.

Command Default

Url for Cisco XML API schema is srst-its.xsd.

Command Modes

Telephony-service configuration (config-telephony)

Command History

Cisco IOS Release	Cisco Product	Modification
12.2(15)ZJ	Cisco CME 3.0	This command was introduced.
12.3(4)T	Cisco CME 3.0	This command was integrated into Cisco IOS Release 12.3(4)T.
12.4(4)XC	Cisco Unified CME 4.0	This command was made obsolete.
12.4(9)T	Cisco Unified CME 4.0	This command was made obsolete in Cisco IOS Release 12.4(9)T.

Examples

The following example specifies a URL for an XML API schema:

Router(config)# telephony-service

Router(config-telephony)# xmlschema http://server2.example.com/schema/schema1.xsd

 

Related Commands

	Description
telephony-service	Enters telephony-service configuration mode.

xmltest

Effective with Cisco Unified CME 4.0, the xmltest command was made obsolete.

For earlier releases, to specify that the HTTP payload in eXtensible Markup Language (XML) application program interface (API) queries be interpreted as having form format, use the xmltest command in telephony-service configuration mode. To specify that the HTTP payload should be interpreted as plain text (no form) format, use the no form of this command.

xmltest

no xmltest

Syntax Description

This command has no arguments or keywords.

Command Default

Default format is plain text (no form) format.

Command Modes

Telephony-service configuration (config-telephony)

Command History

Cisco IOS Release	Cisco Product	Modification
12.2(15)ZJ	Cisco CME 3.0	This command was introduced.
12.3(4)Ts	Cisco CME 3.0	This command was integrated into Cisco IOS Release 12.3(4)T.
12.4(4)XC	Cisco Unified CME 4.0	This command was made obsolete.
12.4(9)T	Cisco Unified CME 4.0	This command was made obsolete in Cisco IOS Release 12.4(9)T.

Examples

The following example specifies that the HTTP payload in XML API queries be interpreted as having form format:

Router(config)# telephony-service

Router(config-telephony)# xmltest

 

Related Commands

	Description
telephony-service	Enters telephony-service configuration mode.

xmlthread

Effective with Cisco Unified CME 4.0, the xmlthread command was made obsolete.

For earlier releases, to set the maximum number of concurrent Cisco CME eXtensible Markup Language (XML) application program interface (API) queries, use the xmlthread command in telephony-service configuration mode. To set the maximum number of queries to the default, use the no form of this command.

xmlthread number

no xmlthread

Syntax Description

number

Maximum number of XML API queries. Range is from 1 to 5. Default is 2.

Command Default

The maximum number of queries is 2.

Command Modes

Telephony-service configuration (config-telephony)

Command History

Cisco IOS Release	Cisco Product	Modification
12.2(15)ZJ	Cisco CME 3.0	This command was introduced.
12.3(4)T	Cisco CME 3.0	This command was integrated into Cisco IOS Release 12.3(4)T.
12.4(4)XC	Cisco Unified CME 4.0	This command was made obsolete.
12.4(9)T	Cisco Unified CME 4.0	This command was made obsolete in Cisco IOS Release 12.4(9)T.

Examples

The following example sets the maximum number of XML API queries to 5:

Router(config)# telephony-service

Router(config-telephony)# xmlthread 5

 

Related Commands

	Description
telephony-service	Enters telephony-service configuration mode.