IsOffByName

Purpose

This function checks the status of a device, using the device's name.

Parameters

Parameter: device name
Type: string
Description: This is the name of the device.  The device name must include the device's location and its name like "den table lamp".  The name is not case-sensitive.

Returns

Return value: status
Type: boolean
Description: This returns TRUE if a device is off and FALSE if it's on or dimmed.