Get or set a DCXP property. 

Arguments: [-c] [-delete] [<resource>,] <property>, [value]

Arguments are delimited by comma ( , ).  Specifying a property with a comma but not a value (e.g. dcxProperty ppp username,) clears the property.

The character ( * ) denotes all instances (e.g., dcxProperty resource.Event.* ). If resource is not specified, then it defaults to the DCX node property. 

• –c is used to create a resource
• –delete is used to delete a resource

Get all configuration and status properties of the DCX; display the property names. 

Get the DCX’s modem type.

Clear a property such as agent.

Get the device 2048’s state.

Get the state property of all devices.

Disable device 2048.

Clear device 2048’s agent.

Set all functions to disabled.

Get all configuration and status properties for device 2048.

View the property names.

Delete all devices.

Delete everything.

dcxProperty resource.*

dcxProperty resource.<resource name>*

Count a collection.

1. Obtain a list of Resource.
2. Count resources of a given type.

Examples:

• dcxProperty resource.DeviceConfig.*
  • Returns the number of devices
    
    
• dcxProperty resource.Event.*
  • Returns the number of events
    
    
• dcxProperty resource.Operation.*
  • Returns the number of operations pending
    
    
• dcxProperty resource.Result.*
  • Returns the number of operation results
    
    
• dcxProperty resource.Data.*
  • Returns the number of billing data

dcxProperty resource.*

dcxProperty <resource name>.*

List resources in a collection.

1. Obtain a list of Resource.
2. List all resource instances by key.

Examples:

• dcxProperty device.*
  • Lists all device keys
    
    
• dcxProperty event.* 
  • Lists all events
    
    
• dcxProperty eventConfig.*
  • Lists all event types

dcxProperty resource.*

dcxProperty <resource name>.*

dcxProperty <key>

List properties of a resource.

1. Obtain a list of Resource.
2. List all resource instances by key.
3. Specify the key.

Examples:

• dcxProperty eventConfig.*
  • Lists all event types
    
    
• dcxProperty <key>
  • where <key> is listed in the above command

Arguments: [+/-commPending] [+/-up] [+/-disabled] [+/-s<states>] [+/-h#\n");

• + requests that only qualifying devices be displayed
• - requests that qualifying devices be excluded
• <states> is a list of characters denoting the states to be listed (+) or suppressed (-)
• [up], [no] agent, [co]nfirmed down, [na]scent, [wr]ong key, [in]valid neuron state, [un]known
• +h# where # is a decimal number; selects devices with # or more hops
• -h# where # is a decimal number; selects devices with # or less hops
  
  

Example:

dcxShowDevices

This command displays general state information for all devices device on the DC.

The default is to display all devices except DC NI.

• dcxShowDevices +scono –h3 +h3
  • Lists Confirmed Down and No Agent devices that use exactly 3 hops

Not used

First 6 bytes of the last status reported by the device (see also Status2).

The number of times a message was delivered after trying an alternate agent. During commissioning, this value is incremented each time the SmartServer attempts to commission a device with a different agent.  The value for a device is cleared when the device is successfully commissioned.

The number of communication attempts that were skipped due to the destination device not being in the up state. During commissioning, this value is incremented each time the SmartServer finds an agent which can communicate with the target but rejects the agent due to invalid phase or insufficient margin.  The value for a device is cleared when the device is successfully commissioned.

A bit array, one bit per function identifiers (LSB == function 0). For non-continuous functions, a 1 indicates the function is outstanding for this device (either has not run successfully or at all). For continuous functions, a 1 indicates that the device is enabled for the function.

1 specifies the agent uses the primary frequency.

The device state. The values are as follows:

• Up
• Down (not responding)
• Confirmed Down (not responding for duration exceeding down limit)
• Nascent (responds to messages using unique ID addressing but not to messages using subnet/node ID addressing)
• Wrong Key (could not commission using authentication key
• Invalid Neuron
• Unknown (commissioning is scheduled but has not begun on this device).  

A typical state transition for commissioning is as follows: the device is created by the SmartServer in the Up state (because it is a zero value), and then almost immediately changes to the Unknown state since it is scheduled for commissioning. When the commissioning function runs and the device does not have an assigned agent, the device is initialized into the ConfirmedDown state (if an agent is assigned then it is left in the Unknown state). When commissioning completes successfully, then the state changes to Up and the commissioning pending flag is cleared. If commissioning fails, the device is placed in ConfirmedDown (indicating no agents found or device is not reachable), Wrong Key, or Invalid Neuron state. A Down event is generated for the Wrong Key and Invalid Neuron states.

The LON program ID.

The time an agent last reached this device.

A signed value with the last measured amount of clock error.

 The last non-zero cause code.

Bit field indicating which phases on the device are configured to be inactive. Bit 0 indicates phase A is inactive, if set; bit 1 indicates phase B is inactive, if set; bit 2 indicates phase C is inactive, if set; bit 7 indicates data is valid, if set.

A log with 10 entries. Each entry consists of a 16-bit agent handle, 4-bit primary signal margin, 4-bit primary signal strength, 4-bit secondary signal margin, 4-bit secondary signal strength, and a 16-bit failure history. The 10 entries are followed by a 16-bit value for the next clear time represented as seconds since 00:00:00 1-Jan-2002. 

The margin values are encoded as follows:

• 0: -6dB (worst or failed)
• 1: -3dB
• 2: 0dB
• 3: 3dB
• 4: 6dB
• 5: 9dB (marginal)
• 6: 12dB
• 7: 15dB
• 8: 18dB
• 9: 21dB
• 10: 24dB
• 11: 27dB
• 12: 30dB
• 13: 33dB
• 14: 36dB
• 15: 39dB (best)

The signal strength values are encoded as follows:

• 0: -84dB (worst or failed)
• 1: -78dB
• 2: -72dB
• 3: -66dB
• 4: -60dB (marginal)
• 5: -54dB (marginal)
• 6: -48dB
• 7: -42dB
• 8: -36dB
• 9: -30dB
• 10: -24dB
• 11: -18dB
• 12: -12dB
• 13: -6dB
• 14: 0dB
• 15: 6dB (best)

The number of hops required to reach the device. A hop represents a leg of transmission.  A device that is directly reachable from the SmartServer has a hop count of 1.  The SmartServer has a hop count of 0; other devices have a zero hop count only if the Agent property is zero.   The maximum value is 8 (6 repeaters and 1 agent).

Not used.

Reports the time of the most recent non-response from the device in a function other than the Find Agent or Priority Find Agent functions. Failures from Find Agent and Priority Find Agent are not tracked because they can normally occur while trying bad agents and do not reflect target failures. The time is logged whenever the device’s Comm Failure count is incremented (but may continue to be logged even if the count has stopped due to reaching the limit).

Not used.

Last 4 bytes of the last status reported by the device (see also Status).

The value can be Not a Test Point, Automatic Test Point, Confirmed Test Point, or Removing.

Not used.

Indicates reliability of the phase measurement. A value of 0 indicates the best accuracy. The larger the value, the worse the accuracy.

The current IDI of the device.

An array with 10 entries reporting the agent margin history for this device covering 12 two hour periods (0:00-2:00, 2:00-4:00, etc). The first byte has the 0:00-2:00 value, the second the 2:00-4:00 value, and so on. Within each byte, the LSN is the primary value and the MSN is the secondary value. The margin values are encoded as described for the Agent Log. Each entry corresponds to one of the 10 entries in the Agent Log property. An Agent Log entry may not correspond to the entry in the Agent Margin Detail if you read them at different times.

A bit array, one bit per function identifiers. A 1 indicates that a failure occurred with this on the most recent function execution.

Not used.

Not used.

Not used.

Not used.

Not used.

Not used.

A bit array reporting the status of the device relative to the currently computer topology.

A bit array with one bit per function identifiers (LSB == function 0). This property only applies to continuous functions and functions with an ID > 31. A 1 indicates the function is outstanding for this device (either has not run successfully or at all).

 A value of 0 indicates commissioning is pending; a value of 1 indicates commissioning failed; and a value of 2 indicates successful commissioning. The value is set to 0 if the device configuration is modified or the commission function is rescheduled.

Reports the date and time the commission status was updated to success or failure. The value is set to 0 if the device configuration is modified or the commission function is rescheduled.