Use the DPLOG attributes to provide a detailed audit trail and performance statistics for the data provider. The attributes include the data provider name, type, version, category, and description.
The DPLOG attributes are available for all data providers.
DP Log Category The category of the data provider log. A valid entry is an alphanumeric text string, with a maximum length of eight characters. The following list provides descriptions of the log categories:
Category |
Description |
SYSTEM |
Entries pertinent to general data provider operations such as startup, shutdown, thread activities, operational status with the IBM Tivoli Universal Agent, and periodic system statistics. |
ERROR |
Entries relating to significant error conditions such as unrecoverable file I/O, execution environment errors, configuration definition errors, and internal processing errors. |
WARNING |
Messages for noncritical situations such as application data definitions not defined or an application already registered with the IBM Tivoli Universal Agent, or circumstances where default actions were taken or default values were supplied during normal processing. |
INFO |
Detailed audit trails of processing activities. They represent general data provider status and work requests, such as console commands received and processing results, application definition activities, and reasons for delay in monitoring a file. |
APINFO |
Informational log entries related to API Data Provider activities. Examples: dp_Define, dp_Redefine, dp_BeginInput, dp_EndInput API calls. |
METAINFO |
Informational messages related to interactions with the centralized data provider metafile server. Examples: processing of a metafile request by the server, outcome of a metafile retrieval. |
APICOMM |
Communication activities between the API Data Provider and the client programs such as dp_OpenSession and dp_CloseSession API calls. |
METACOMM |
Communication activities between data provider metafile client and the data provider metafile server. Examples: data provider metafile client successfully connected to the server, connection failure and status of automatic retry, or disconnection detected by either party. |
SOCKCOMM |
Communication activities related to Socket Data Providers. Examples: new TCP connection accepted, new UDP partner recognized, connection abandoned because of configuration mismatch, or UDP partner timing out because of inactivity. |
DP Log Text The detailed message text for the data provider log. A valid entry is an alphanumeric or Unicode text string, with a maximum length of 256 characters.
DP Name The managed system name for the data provider that issues the log message. A valid entry is an alphanumeric text string, with a maximum length of 32 characters.
DP Time The local time for the data provider log event message. The format is, CYYMMDDHHMMSSmmm.
where:
C = Century (1 for 21st)
Y = Year
M = Month
D = Day
H = Hour
M = Minute
S = Second
m = millisecond
DP Type The data provider types. Types include: ASFS, API Server, Socket, File, Post, Script, SNMP, HTTP, and ODBC. A valid entry is an alphanumeric text string, with a maximum length of 4 characters.
DP Version The current version number of the data provider. A valid entry is an alphanumeric text string, with a maximum length of eight characters.
DP Log MsgID The message ID for the DPLOG message.