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.

Table 1. services.inTray Database Table Schema

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 NCHOME/precision/platform/$PLATFORM/bin if NULL.

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.