Dispatcher Interval (PI_PIDS)
- Organization of this page
Function
The Dispatcher Interval (PI_PIDS) record stores performance data indicating the status of dispatcher processes at a specific point in time. To collect this record, you must have a multi-thread server (MTS) configuration.
PFM - Agent for Oracle creates one record for each dispatcher in an instance. This is a multi-instance record.
Default and changeable values
Item |
Default value |
Changeable |
---|---|---|
Collection Interval |
300 |
Y |
Collection Offset |
35 |
Y |
Log |
No |
Y |
LOGIF |
(Blank) |
Y |
Over 10 Sec Collection Time |
No |
N |
ODBC key fields
PI_PIDS_NAME
Lifetime
From the creation to the deletion of an Oracle instance
Record size
-
Fixed part: 678 bytes
-
Variable part: 334 bytes
Fields
PFM - View name (PFM - Manager name) |
Description |
Summary |
Format |
Delta |
Supported version |
Data source |
---|---|---|---|---|---|---|
Accept (ACCEPT) |
If the dispatcher accepts a new connection, the value of this field is YES, otherwise the value is NO.#1 |
COPY |
string(3) |
No |
All |
V$DISPATCHER.ACCEPT |
Breaks (BREAKS) |
Number of breaks (pauses) in this connection#2 |
AVG |
double |
Yes |
All |
V$DISPATCHER.BREAKS |
Busy (BUSY) |
Dispatcher's total busy time in hundredths of a second#2 |
AVG |
double |
Yes |
All |
V$DISPATCHER.BUSY |
Busy % (PERCENT_BUSY) |
Percentage of time the dispatcher was busy#2 |
AVG |
double |
No |
All |
(V$DISPATCHER.BUSY / (V$DISPATCHER.BUSY + V$DISPATCHER.IDLE)) * 100 |
Bytes (BYTES) |
Size of message processed by the dispatcher in bytes#2 |
AVG |
double |
Yes |
All |
V$DISPATCHER.BYTES |
Created (CREATED) |
Number of circuits created by the dispatcher#2 |
AVG |
ulong |
Yes |
All |
V$DISPATCHER.CREATED |
Idle (IDLE) |
Dispatcher's idle time in hundredths of a second#2 |
AVG |
double |
Yes |
All |
V$DISPATCHER.IDLE |
Idle % (PERCENT_IDLE) |
Percentage of time the dispatcher was in idle status#2 |
AVG |
double |
No |
All |
(V$DISPATCHER.IDLE / (V$DISPATCHER.BUSY + V$DISPATCHER.IDLE)) * 100 |
Listener (LISTENER) |
Most recent Oracle error number the dispatcher received from listener#1 |
COPY |
short |
No |
All |
V$DISPATCHER.LISTENER |
Messages (MESSAGES) |
Number of messages processed by the dispatcher#2 |
AVG |
double |
Yes |
All |
V$DISPATCHER.MESSAGES |
Network (NETWORK) |
Network protocols supported by the dispatcher (such as TCP or DECNET) #1 |
COPY |
string(128) |
No |
All |
V$DISPATCHER.NETWORK |
Oracle PID (PID) |
Dispatcher process's Oracle process ID#1 |
COPY |
ulong |
No |
All |
V$PROCESS.PID WHERE V$PROCESS.ADDR = V$DISPATCHER.PADDR |
Owned (OWNED) |
Number of circuits owned by the dispatcher#2 |
AVG |
ulong |
No |
All |
V$DISPATCHER.OWNED |
Process Name (NAME) |
Name of dispatcher process#1 |
COPY |
string(5) |
No |
All |
V$DISPATCHER.NAME |
Record Time (RECORD_TIME) |
Collection termination time for the performance data stored in the record#1 |
COPY |
time_t |
No |
All |
Agent Collector |
Record Type (INPUT_RECORD_TYPE) |
Record name (always PIDS)#1 |
COPY |
string(4) |
No |
All |
Agent Collector |
Start Time (START_TIME) |
Collection start time for the performance data stored in the record#1 |
COPY |
time_t |
No |
All |
Agent Collector |
Status (STATUS) |
Dispatcher status:#1 WAIT: Idle SEND: Sending a message connection RECEIVE: Receiving a message CONNECT: Establishing connection DISCONNECT: Processing a disconnection request BREAK: Engaged in break processing OUTBOUND: Establishing outbound connection TERMINATE: Under termination processing ACCEPT: Accepting connection (no available information) REFUSE: Refusing connection (no available information) |
COPY |
string(16) |
No |
All |
V$DISPATCHER.STATUS |