The services.inTray Table
The services.inTray
database table is an active
table for managed processes.
Data is inserted into this table by ncp_ctrl when it reads its configuration
file. Processes with an entry in this database are started by ncp_ctrl as
managed processes. If an entry is removed from this table, it is stopped by
ncp_ctrl.. The ncp_ctrl process also monitors the status of processes named in
the inTray
table and restarts them if they are stopped.
The table below describes the services.inTray database table.
Column name |
Constraints |
Data type |
Description |
---|---|---|---|
argList |
List of type text |
Specifies a list of arguments sent to the service. |
|
binaryName |
NOT NULL |
Text |
Base name for the binary that implements the service. This is used in preference to the serviceName field to launch the service. |
dependsOn |
List of type text |
Specifies a list of processes, prerequisites, required to run the current services. |
|
domainName |
Text |
Specifies the domain under which the service is running. |
|
hostName |
Text |
Specifies the name of the system upon which the service is running. |
|
interval |
Integer |
Specifies the average interval between heartbeat signals from the service. |
|
logFile |
Text |
Specifies the name of file in which output is logged. |
|
logLevel |
Text |
The logging level for the process. By default, this field has
the value warn . The value in this table updates dynamically if
the logging level is changed for the process on the command line. Changing this
value in the table dynamically changes the logging level for the process even if
it is already running. |
|
processId |
Long integer |
Specifies the process ID of the service. |
|
memUsage |
Long integer |
The native memory of the process. | |
retryCount |
Integer |
Specifies the number of times to attempt to restart a service. Note: Providing the value 0 (zero) means no attempt is made to restart a service
when it stops, while -1 sets the service to always start again when it
stops.
|
|
serviceId |
PRIMARY KEY NOT NULL UNIQUE |
Integer |
Specifies the unique ID of the service and is assigned internally. |
serviceKey |
NOT NULL UNIQUE |
Text |
Auto-generated unique key for a process. |
serviceName |
NOT NULL |
Text |
Specifies the name of the service to be managed. |
servicePath |
Text |
Specifies the full path to the service, which might be |
|
serviceState |
Externally defined serviceState data type |
Integer |
Specifies an integer which reflects the current operational state of the service. 0 - The service is alive but currently idle. 1 - The service is waiting for its prerequisites, that is, waiting for its dependencies to be satisfied. 2 - The service is waiting to begin sending heartbeats. 3 - The application is currently starting, which is Fork service. 4 - The service is alive and running. 5 - The service is not functioning correctly. 6 - The service is stopped. 7 - The service has failed. 8 - The service is shutdown. |
traceLevel |
Integer |
The trace level for the process. By default, this field has
the value 0 (zero). The value in this table updates dynamically
if the trace level is changed for the process on the command line. Changing this
value in the table dynamically changes the trace level for the process even if
it is already running. |