PreviousUser's Guide (v10) Next

psc

Chapter contents

Availability

Windows
Linux
Clients
Engines
Yes
No
Yes
Yes

Description

Psc stands for Pervasive service controller. The utility retrieves and sets control information about Pervasive PSQL services.

You must have administrator authority to run psc.

Synopsis

psc < start | stop | restart | query | create | delete | 
getpolicy > servicename 

or

psc setpolicy servicename < automatic | manual | disabled 
> 

Options

A service specifies the name of a program, routine, or process that performs a specific system function to support other programs, particularly at a low level (close to the hardware). Servicename specifies the name given to the service key in the registry. Note that service key name may differ-and in most cases does differ-from the service display name.

The options described below are case-insensitive.

start
Starts a Pervasive PSQL service running
stop
Terminates the running of a Pervasive PSQL service
restart
Terminates the running of a Pervasive PSQL service then starts the service running again
query
Specifies whether servicename is running or not
create
Creates a new servicename given the following syntax:
create "servicename" "servicedisplayname" servicetype startmode "path" [ numdependencies dependencieslist ]
where:
servicedisplayname = the name of the service that you want to display in Service Manager and utilities like PCC
servicetype = < own | shared >
own specifies that the service runs in its own process
shared specifies that the service runs inside a process shared with other services
startmode = < auto | demand >
path = the fully qualified path of the binary executable associated with the service and any parameters that must be passed to the executable
numdependencies = the number of other programs, routines, or processes upon which the service depends
dependencieslist = the list of other programs, routines, or processes upon which the service depends
delete
Removes servicename as a service
getpolicy
Retrives the type of startmode associated servicename (automatic, manual, or disabled)
setpolicy
Sets the type of startmode associated servicename (automatic, manual, or disabled)
automatic
The service starts automatically when the operating system starts
manual
The service must be started manually after the operating system starts
disabled
The service is disabled and does not start after the operating system starts

Examples

To create a service for the Workgroup Engine that starts automatically when the operating system starts:

psc create "psqlWGE" "Pervasive PSQL Workgroup Engine" 
own auto "file_path\PSQL\bin\w3dbsmgr.exe service 
srde" 

To start the Workgroup Engine service manually:

psc start psqlWGE 

To create a service for the Cache Engine that starts automatically when the operating system starts:

psc create "psqlCE" "Pervasive PSQL Cache Engine" own 
auto "file_path\PSQL\bin\w3dbsmgr.exe service btrv" 

To start the Cache Engine service manually:

psc start psqlCE 

Chapter contents
Book contents

Prev topic: isql
Next topic: psregedit