Device Service Operations

The Device Service operations enable you to manage devices in your TIBCO LogLogic® appliance.

Overview

Using Device Service operations you can create, read, update, and delete devices as well as view all devices in the TIBCO LogLogic® appliance.

Devices are any source of log data that you want captured by a TIBCO LogLogic® appliance. In the TIBCO LogLogic® appliance, to view the user interface implementation navigate to Management > Devices.

Implementation Guidelines

Some general implementation guidelines for Device Service operations:

  • A set of common request parameters are required for each operation. You must specify a value for all required parameters.
  • You must specify the value of the common request parameters only.
  • All parameters must be implemented in the order in which they appear in the Request Parameters section for each of the operations.
  • All values for common request parameters must be enclosed by double quotation marks (“value”). If the name of a device or a parameter value includes a forward slash (/), such as HP/UX, or IBM i5/OS, you must replace the forward slash with %2F. (The F is case-sensitive.)

    Examples: HP%2FUX or IBM i5%2FOS

  • When using the Device Operation, Device Remote Operation, if the dnsRefreshEnabled, parameter is enabled, the value for the deviceName parameter can be overwritten by the value on your DNS server. If this occurs, use the DNS name of the device as the value for the deviceName parameter. You can retrieve the DNS name by looking up the IP address of the device.

Status Codes

2000 Server success
4000 Unauthorized request
5000 Invalid parameter, getStatusMessage() contains detail information about the error

Description of Device Service Operations

There are two kinds of operations:
  • local - operation is performed on the local appliance itself
  • remote - operations (names ending with Remote) performed on a specified remote appliance through the Management Station

The Device Service operations are as follows: