Cisco Systems 4.1 XML DTD for DLMS, Guidelines for Creating the XML File

3-48

User Guide for Resource Manager Essentials 4.1

OL-11714-01

Chapter 3 Adding and Troubleshooting Devices Using Device Management

Device List Manipulation Service

XML DTD for DLMS

The required XML DTD for the DLMS tool is:

<!ELEMENT request

(authentication,source,addDevices?,listDevices?,getDeviceCredentials?,setCredentials?,g

etDeviceIPAddresses?)>

<!ELEMENT authentication EMPTY>

<!ELEMENT source (host,product,version,description)>

<!ELEMENT host (#PCDATA)>

<!ELEMENT product (#PCDATA)>

<!ELEMENT version (#PCDATA)>

<!ELEMENT description (#PCDATA)>

<!ELEMENT addDevices (deviceInfo)>

<!ELEMENT listDevices (deviceInfo?)>

<!ELEMENT getDeviceCredentials (deviceInfo?)>

<!ELEMENT setCredentials (deviceInfo)>

<!ELEMENT getDeviceIPAddresses (deviceInfo?)>

<!ELEMENT deviceInfo (#PCDATA)>

<!ATTLIST request responseFormat (csv | xml) #IMPLIED>

<!ATTLIST authentication name CDATA #REQUIRED pwd CDATA #REQUIRED>

<!ATTLIST listDevices deviceType (all | managed) #IMPLIED>

<!ATTLIST getDeviceCredentials wantdbid (yes) #IMPLIED wantsysoid (yes) #IMPLIED>

The following are the guidelines while creating the DLMS request XML file:

• One request can contain up to five operations.

• You can specify the output as CSV or XML.

• The attribute pwd of the tag authentication must be 64-based encoded.

• If you include deviceInfo in any operation, you will receive information only on the devices

specified in deviceInfo. If you do not specify deviceInfo, you will receive information on all

managed devices. Create deviceInfo using CSV format data.

deviceInfo is the Device Display Name as entered in Device and Credential Repository.

• When using listDevices, you can list all devices or only the managed devices by specifying either

the all or managed attribute.

–

You can list all devices by specifying the attr as yes and devType as all. If you do not specify

this, then only RME managed devices will be displayed.

• When using getDeviceCredentials,

–

You can display the device ID by specifying the wantdbid attribute as yes.

–

You can display the sysobject ID by specifying the wantsysoid attribute as yes.