SQL*Net Listeners (PD_PDLS)
- Organization of this page
Function
The SQL*Net Listeners (PD_PDLS) record stores performance data indicating the status and overview of each defined listener at a specific point in time. PFM - Agent for Oracle creates one record for each name specified in listener_name. Only one listener can be monitored.
If you omit the listener name when setting an instance, PFM - Agent for Oracle monitors the default listener. If the listener is not active, the Alias field is blank.
If SQL*Net has not been installed, an attempt to display a report that uses this record will display the No records returned message.
- Notes
-
When setting an alarm monitoring SQL * Net Listeners (PD_PDLS) records, if you set the name of a listener that does not exist in the listener_name of the instance information, the Listener Status alarm status will always be normal. Upon the occurrence of this phenomenon, the following message is output to the common message log:
KAVF12412-W The listener does not exist. (ListenerName=listener-name)
If this message is output, correct the LISTENER_NAME property value.
Default and changeable values
Item |
Default value |
Changeable |
---|---|---|
Collection Interval |
60 |
Y |
Collection Offset |
0 |
Y |
Log |
No |
Y |
LOGIF |
(Blank) |
Y |
Over 10 Sec Collection Time |
No |
N |
ODBC key fields
PD_PDLS_ALIAS
Lifetime
From the creation to the deletion of a listener instance
Record size
-
Fixed part: 678 bytes
-
Variable part: 688 bytes
Fields
PFM - View name (PFM - Manager name) |
Description |
Summary |
Format |
Delta |
Supported version |
Data source |
---|---|---|---|---|---|---|
Alias (ALIAS) |
Name of the listener |
-- |
string(20) |
No |
All |
lsnrctl stat |
Availability (AVAILABILITY) |
Listener task's availability status; this value can be either 0 (inactive) or 1 (active) |
-- |
short |
No |
All |
Agent Collector |
Change Time (CHANGE_TIME) |
Time the availability task was changed |
-- |
time_t |
No |
All |
Agent Collector |
Handlers (HANDLERS) |
Number of services processed by the listener task |
-- |
short |
No |
All |
lsnrctl stat |
Log File (LOG_FILE) |
Location of log file |
-- |
string(256) |
No |
All |
lsnrctl stat |
Parameter File (PARAMETER_FILE) |
Location of parameter file. This is Blank when the listener.or a file does not exist in the Oracle environment. For details about the listener.ora file, see the Oracle documentation. |
-- |
string(256) |
No |
All |
lsnrctl stat |
Record Time (RECORD_TIME) |
Collection termination time for the performance data stored in the record |
-- |
time_t |
No |
All |
Agent Collector |
Record Type (INPUT_RECORD_TYPE) |
Record name (always PDLS) |
-- |
string(4) |
No |
All |
Agent Collector |
Security (SECURITY) |
Security status |
-- |
string(5) |
No |
All |
lsnrctl stat |
Start Date (START_DATE) |
Listener start date and time |
-- |
string(20) |
No |
All |
lsnrctl stat |
Start Time (START_TIME) |
Collection start time for the performance data stored in the record |
-- |
time_t |
No |
All |
Agent Collector |
Trace Level (TRACE_LEVEL) |
Listener's trace level |
-- |
string(5) |
No |
All |
lsnrctl stat |
Up Time (UP_TIME) |
Total run time |
-- |
string(30) |
No |
All |
lsnrctl stat |
Version (VERSION) |
Listener's version |
-- |
string(80) |
No |
All |
lsnrctl stat |