Filter
Top Products
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>
Guidelines for Creating the XML File
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.