PreviousAdvanced Operations Guide (v10)

Advanced Operations Guide - Index

- A - B - C - D - E - F - G - H - I - J - K - L - M - N - O - P - Q - R - S - T - U - V - W - X


~PVSW~.LOC file

A

Accelerated

DSN open mode

file open mode used by LOAD command

Accept Remote Request

Access

configuration settings 1 2

Access methods

Active

files, monitoring

Active session

deleting

refreshing the list

viewing

Adding

a new engine

Address space, common

All-segment null keys

Btrieve Maintenance utility and

description files and

Allocate Resources at Startup

configuration parameter 1 2 3 4

Allow Cache Engine Connections

configuration parameter

Allow Client-stored Credentials

configuration parameter

Alternate collating sequence

Btrieve Maintenance utility and 1 2 3

description files and 1 2

ANSI

character translation

Any-segment null keys

Btrieve Maintenance utility and

description files and

Application Characteristics

configuration settings

Applications

configuration scenarios

Archival logging

definition of 1 2

disk I/O and

file backups and

referential integrity and

setting up

transaction logging and

Archival Logging Selected Files

configuration parameter

Array fetch

ArrayBufferSize connection string

ArrayFetchOn connection string

ASCII data file format

Btrieve Maintenance utility and

BUTIL and

Asynchronous I/O

Atomicity, transaction

not guaranteed with multiple engines

Attributes

engine configuration 1 2

Windows client configuration

Authentication

Server engine vs. Workgroup

Auto Reconnect Timeout

configuration parameter

Auto-reconnect

defined

Automatic mode

in Function Executor

Available Linked Keys

Btrieve Maintenance utility and

B

Back to Minimal State if Inactive

configuration parameter 1 2

Backing up

a database with BUTIL

data files

data with continuous operations

Backup

and restore

with continuous operations

Bcfg utility

command syntax

configuration

configuration utility

java.lang.UnsatisfiedLinkError error on Linux

troubleshooting starting on Linux

unable to connect to database engine error on Linux 1 2

Blank truncation

Btrieve Maintenance utility and

description files and

bmon

java.lang.UnsatisfiedLinkError error on Linux

monitoring utility

troubleshooting starting on Linux

Bound databases

Btrieve and

Btrieve

constraints when used with SRDE access

interaction with relational constraints

login configuration

owner name

security

before you begin

quick start

reasons to choose classic model

reasons to choose database model

reasons to choose mixed model

security models for

Btrieve Command-Line Maintenance utility. See BUTIL

Btrieve files

creating with Function Executor

Btrieve Interface Module, displaying version

Btrieve Maintenance utility

about

creating a file

extended files and

menu options

online help

starting

Buffers

editing key and data

Building

external index files, and BUTIL

BUTIL

about

ASCII files

backing up databases

command files

command files rules

commands

CLONE

CLROWNER

COPY

CREATE

DROP

ENDBU 1 2

INDEX

LOAD

overview

RECOVER

ROLLFWD 1 2

SAVE

SETOWNER

SINDEX

STARTBU 1 2

STAT

STOP 1 2

VER

creating and modifying data files

displaying Btrieve interface module version

extended file support

importing and exporting data 1 2

overview

owner names

recovering changes after system failure

redirecting error messages

return codes

starting and stopping continuous operation 1 2

syntax

unloading the Btrieve engine

viewing command syntax

C

Cache

client

memory usage 1 2

database

data pages and

how to calculate ideal size

limited to 2 GB on Windows 1 2

memory use and XIO driver

physical memory and

Cache allocation size

effect on rebuilding files

Cache Allocation Size

configuration parameter

virtual memory and

Cache engine

configuration settings

Cache Engine Debugging

configuration settings

Cache read bytes

XIO statistic

Cache size

XIO statistic

Cache write bytes

XIO statistic

Cacheable I/O %

XIO statistic

Caching files

specifying files to exclude

XIO driver

Cascade rule

Case sensitivity in keys

Btrieve Maintenance utility and

description files and

Changing

configuration parameters

gateway engine across multiple data directories

See also How to

Character translation

OEM to ANSI

Characters

valid in regular identifier

Classic

security model

Clearing owner names

and BUTIL

Btrieve Maintenance utility and

Client

cache

memory usage 1 2

DSN

options

optimizing support for multiple clients

parameters

CLONE command

CLROWNER command

Cluster, see Clustering

Clustering

adding groups for Pervasive PSQL

databases on shared disk

failback

failure behavior

licensing Pervasive PSQL

Microsoft Cluster Service

add Pervasive.SQL relational service

add Pervasive.SQL transactional service

changing startup setting for relational service

configure PCC for

specify DSNs on cluster nodes

test relational connection from Pervasive PSQL client

test transactional connection from Pervasive PSQL client

verify cluster functioning correctly

modes

server

COLLATE.CFG file

Collating sequence

Column name

maximum length

valid characters

Command files

BUTIL and

rules

Command line parameters

for Rebuild utility

Command-line interface

bcfg utility for configuration

Command-line utilities, see BUTIL

Comments

in description files

Common address space

Communication Protocols

configuration settings 1 2

Communications

auto-reconnect feature

monitoring

MicroKernel

Communications Threads

configuration parameter

Compacting data files

and Btrieve Maintenance utility

and BUTIL

Compatibility

configuration settings

Compressing data files

Compressing pages

Btrieve Maintenance utility and

Compressing records in data files

Btrieve Maintenance utility and

description files and

Compression

page

record

Compression ration

XIO statistic

Configuration

making changes

optimizing

parameters for wire encryption

settings

using bcfg utility 1 2

using command-line interface

Configuration file

for Monitor

Configuration parameters

before you modify

client

Allocate Resources at Startup

Back to Minimal State

Cache Allocation Size

Connection Timeout 1 2

Embedded Spaces 1 2

Enable Auto Reconnect

Encryption Level

Gateway Durability

Max MicroKernel Memory Usage

Minimal State of Delay

Number of Bytes from Data Buffer

Number of Bytes from Key Buffer

Number of Load Retries 1 2

Runtime Server Support 1 2

Select Operations

Splash Screen

Supported Protocols 1 2

Trace File Location

Trace Operation

Use Cache Engine

Use IDS

Use Local MicroKernel Engine

Use Remote MicroKernel Engine

Verify Key Length

Wire Encryption

Wire Encryption Level

Linux client

Embedded Spaces

Enable Autoreconnect

Use IDS

Use Local MicroKernel Engine

Use Remote MicroKernel Engine

Verify Key Length

Wire Encryption

Wire Encryption Leve

Monitor and

server

Access

Allocate Resources at Startup

Allow Cache Engine Connections

Allow Client-stored Credentials

Archival Logging Selected Files

Authentication

Auto Reconnect Timeout

Back to Minimal State if Inactive

Cache Allocation Size 1 2

Communications Threads

Create File Version

DBNames Configuration Location

Enable Auto Reconnect

Encoding

Encryption Level

File Growth Factor

Index Balancing

Initiation Time Limit

Limit Segment Size

Listen IP Address

Log Buffer Size

Max MicroKernel Memory Usage

Minimal State of Delay

NetBIOS Port

Number of Bytes from Data Buffer

Number of Bytes from Key Buffer

Number of I/O Threads

Operation Bundle Limit

Prompt for Client Credentials

Select Operations

Sort Buffer Size

Supported Protocols

System Cache

System Data

TCP/IP Multihomed

TCP/IP Port

Trace File Location

Trace Operation

Transaction Durability

Transaction Log Directory

Transaction Log Size

Transaction Logging

Wait Lock Timeout

Wire Encryption 1 2

Working Directory

Configuration settings

Access 1 2

Application Characteristics

Cache engine

Cache Engine Debugging

Communication Protocols 1 2

Compatibility

Data Integrity

Debugging

Directories

Information

Memory Usage

Performance Tuning 1 2

Security

Configuration Utility

Configurations

for database engine

Configuring

application scenarios

PCC for clustering, see Clustering

Connecting

to local or remote machines

to workgroup, eliminating delay

Connection

terminating user

timeout

Connection delay

how to minimize

troubleshooting for Workgroup

Connection strings

OPENMODE

TRANSLATIONDLL

Connection Timeout parameter

Constraints

mixed access

referential integrity

Continuous Operations

backing up data file

definition of 1 2

ending

file locked because of

starting

starting with BUTIL

stopping with ENDBU

transaction logging and

Converting

OEM to ANSI characters

Converting data files

with command-line Rebuild utility

with GUI Rebuild utility

with Rebuild utility

COPY command

BUTIL and

Copying records between files

CPU speed

effect on rebuilding files

CPU, fast

versus fast disk

CREATE command

Create File Version 1 2

Creating

DSNs with ODBC

indexes

additional with BUTIL

primary key 1 2

redirecting Gateway Locator File

Creating a Btrieve file

in Function Executor

with Function Executor

Creating data files

with BUTIL

Creating files

Btrieve Maintenance utility and

BUTIL and

Credentials, definition of

Current database

definition of

D

Damaged files, recovering

BUTIL and

Data

continuous operations

copying data from one MicroKernel file to another

encryption

encryption on disk

exporting ASCII data

files locked when in continuous operations

importing ASCII data

recovering changes to a data file

viewing as any data type

Data archival

Data buffer

editing

Data compression

Data encryption

Data file

segments

structure

Data files

compacting with Btrieve Maintenance utility

compacting with BUTIL

converting

with GUI Rebuild utility

copying with BUTIL

creating

creating with BUTIL

decreasing size of with Btrieve Maintenance utility

decreasing size of with BUTIL

generate statistics report

Data files, converting

with command-line Rebuild utility

Data integrity

configuration settings

not guaranteed with multiple engines

Data pages

cache and

Data restoration

Data types

description files and

NULL

Data-only files

Database

access methods

bound

current, definition of

default, definition of

security 1 2

security model

Database cache

data pages and

how to calculate ideal size

physical memory and

Database engine

and status code 116

configurations

java.lang.UnsatisfiedLinkError error on Linux 1 2

unable to connect to error on Linux 1 2

Database name

maximum length

valid characters

where stored

DBNames Configuration Location 1 2

Dbnames file

Dbnames.cfg file

DBQ

connection string

DDF

file structure

Debugging

configuration settings

Decreasing data file size

with Btrieve Maintenance utility

with BUTIL

Default database

definition of

DefaultDB

Delay,connection

how to minimize

troubleshooting for Workgroup

Delete

rule

Deleting

active session

Delimited identifier

definition of

length for names

Delimited identifiers

Delta files 1 2

Descending sort order in keys 1 2

Description files

adding comments to

Btrieve Maintenance utility and

BUTIL and

elements

examples

format

rules

Dictionary file

structure

Directories

configuration settings

Dirty buffers %

XIO statistic

Discrete ordering

null value

Disk I/O

archival logging and

how to minimize

transaction logging and 1 2

Disk speed

effect on rebuilding files

Disk, fast

versus fast CPU

Driver manager

for XIO

Driver name

for Pervasive Engine

DROP command

Dropping indexes

Btrieve Maintenance utility and

BUTIL and

DSN

client options

open modes

DSNs

creating with ODBC

Duplicate keys

Durability, gateway

eliminating delay upon connection to Workgroup

E

Editor

File Information

Elements

of description files

Embedded Spaces

configuration parameter 1 2

Embedded Spaces setting for Linux client

Enable array fetch

Enable Auto Reconnect

configuration parameter 1 2

Enable Autoreconnect setting for Linux client

Encoding

configuration parameter

Encryption

data

how to choose level

of data files

Encryption Level

configuration parameter

ENDBU command

and continuous operation

BUTIL and

Ending Continuous Operations

Engine

driver name

DSN

open modes

Pervasive PSQL

Error

messages, redirecting with BUTIL

Error Code Clarification, about

Event log messages

for XIO

Event logging

Exclusive

DSN open mode

Export files

naming convention 1 2

size limit 1 2

Exporting data

and BUTIL 1 2 3

ASCII file format

Btrieve Maintenance utility and

Extended files

Btrieve Maintenance utility and

BUTIL and

External index files

Btrieve Maintenance utility and

BUTIL and

F

Fast CPU

versus fast disk

Fast Disk

versus fast CPU

File

ASCII

automation upgrad of version

creating

delta 1 2

description 1 2

dividing into segments

export

naming convention 1 2

size limit 1 2

extended

Btrieve Maintenance utility and

BUTIL and

external index 1 2

formats supported with Rebuild

maximum size

names, long

owner name

segmentation

size comparisons based on page size and records per page

specifications

Btrieve Maintenance utility and

description files and

structure

unformatted, see File, export 1 2

version

creation of

version upgrade

File Information Editor

Data File Info

Owner Name

Total Records

Version

Elements

Create File

Description Comments

File Specification 1 2

Help

Load Information

Set to Default

File Specification

# Pages

% Free Space

Available Linked Keys

Balanced Indexing

Blank Truncation

Include VATs

Key-Only

Page Compression

Preallocation

Record Compression

Record Length

Variable Records

Key

ACS Information

All Segments

Any Segment

duplicates

Modifiable

Null Key

Repeating duplicates

Sparse Key

Unique Values

Key Segment

Case Insensitive

Data Types

Descending

Length

Null Value

Position

Use ACS

Tasks

Add comments to a description file

Compact a Btrieve file

Create a new file

Load information from an existing file

Specify a key's alternate collating sequence

File segments

File size

comparisons based on page size and records per page

File Statistics

Function Executor

File, description

elements

examples

rules

File, idshosts

entry formats

using

Files

backing up

creating a Btrieve file with Function Executor

deleting temporary

monitoring

opening with Function Executor

optimizing support for multiple

restoring

restoring with Continuous Operations

Foreign key

adding to existing table

creating in a table

definition of

Free space threshold

Btrieve Maintenance utility and

description files and

Function Executor

automatic mode

concepts

creating a Btrieve file

creating Btrieve files

features

file statistics

Get

GetExt

GUI reference

opening files

statistics

to login

to logout

transactions

Function Executor utility

overview

performing operations

starting

Function name

maximum length

valid characters

G

Gateway durability

and adding a new engine

configuration parameter

Gateway engine

changing for multiple directories at once

see also Workgroup engine

Gateway Locator File

creating a

redirecting

Get

in Function Executor

GetExt

in Function Executor

GRANT

owner names and

Group

restrictions for

Group name

maximum length

valid characters

Groups, and users

in security

H

Handles

monitoring

High encryption

How

to add or remove network protocol support 1 2

to allow or prohibit embedded spaces in data file names

to calculate ideal size of database cache

to change

amount of memory used for database cache 1 2

amount of memory used for sorting during creation of indexes

amount of time a client and server try to re-connect

amount of time the engine waits for a lock to release

directory where the engine stores temporary files

free file space available to Turbo Write Accelerator

how long the engine waits before returning to minimal state 1 2

location of DBNames configuration file

location of transaction log

NetBIOS port used by the server

number of operations required to start a system transaction

number of threads available for client requests

number of times the client attempts to connect

number of worker threads

size of the log buffer

time limit for starting a system transaction

total memory available to engine 1 2

to choose encryption level

to decrease time required to find a Gateway engine using gateway durability

to determine amount of physical memory needed

to ensure

transaction atomicity 1 2

transaction durability

transaction logging

to find

performance bottlenecks with Monitor

to increase performance on read operations by using index balancing

to limit

size of transaction log segments

to limit data file segment size

to make the client use a remote database engine

to make the client use the local engine

to make the engine release resources if inactive

to make the Linux client use a remote database engine

to make the Linux client use the local engine

to minimize

client/server connection delay

disk I/O

to prevent

a Server or Workgroup engine from accepting remote requests

the Pervasive splash screen from appearing

to set default file format version for file creation

to specify

the TCP/IP port that the ODBC Communications Manager uses

whether a client and server attempt to reconnect after a network interruption

whether the engine should use the system cache

to use

client cache engine

I

I/O

asynchronous

Identifier

definition of

length for identifier names

restrictions

when name enclosed by quotes

Identifiers

regular

unique within scope

Identifiers, regular

case-insensitivity of

IDS

configuration parameter

Idshosts file

entry formats

using

Importing data

and BUTIL 1 2 3

ASCII file format

Index

creating

creating and dropping

creating with BUTIL

dropping

name

maximum length

valid characters

viewing in the Btrieve Maintenance utility

Index balancing

Btrieve Maintenance utility and

configuration parameter 1 2

description files and

INDEX command

BUTIL and

Index page size

effect on rebuilding files

Indexes

primary keys and

Information

configuration settings

on sessions

Initiation Time Limit

configuration parameter

Integrity

not guaranteed with multiple engines

Interactive Btrieve Maintenance utility. See Btrieve Maintenance utility

J

Java.lang.UnsatisfiedLinkError error on Linux 1 2

K

Key

attributes 1 2

buffer

editing

cannot contain a null column

foreign

adding to existing table

creating in a table

definition of

linked duplicate

numbers

primary

adding to existing table

creating in a table

definition of

repeating duplicate

segment specifications 1 2

Key name

maximum length

valid characters

Key-only files

Btrieve Maintenance utility and

description files and

Keys

repeating duplicate

with referential integrity

L

Large files. See Extended files

Length

maximum for identifier names

Licensing

for clustering

Limit Segment Size

configuration parameter

Limitations

users and groups

Linked duplicate keys 1 2

Linked-duplicate keys. See Linked duplicate keys

Linux

bcfg

errors trying to start

java.lang.UnsatisfiedLinkError engine error

troubleshooting starting

unable to connect to database engine error

bmon

errors trying to start

java.lang.UnsatisfiedLinkError engine error

troubleshooting starting

unable to connect to database engine error

Linux client

configuration parameters

setting properties

LOAD command

accelerated file open mode and

BUTIL and

Local configuration setting

see Use Local MicroKernel Engine 1 2

Lock

files locked when in continuous operations

Locking

row level

Locks, see Locking

Log Buffer Size

configuration parameter 1 2

transaction durability and

Log file

Rebuild

Logging

archival

referential integrity and

performance and

Pervasive PSQL events

transaction

transaction logging and archival logging

Login

configuration, Btrieve

using Function Executor

Login credentials, definition of

Logout

using Function Executor

Long file names

Low encryption

M

Maintenance utility

See Btrieve Maintenance Utility and BUTIL

Managing

XIO driver

Master user

in security

Max MicroKernel memory usage

effect on rebuilding files

MaxCache, definition of

MaxCacheSizeMB

XIO setting

Maximizing

runtime throughput

Maximum

file size

length for identifier names

MaxPAEMemMB

XIO setting

Medium encryption

Memory

common address space architecture

database cache and

determining amount needed

effect on rebuilding files

limit to 2 GB on Windows 1 2

use of extended with XIO

use of standard with XIO

Memory cache

and XIO driver

Memory Usage

configuration settings

Messages

event log messages for XIO

Methods, access

MicroKernel Database Engine

common address space with SRDE

monitoring

monitoring resources

overview of

tracing

performance and

MicroKernel Database Engine message log. See Pervasive PSQL event log.

MicroKernel Router

decision algorithm

Microsoft

Cluster Service See Clustering

Minimal State of Delay

configuration parameter 1 2

Minimizing

disk I/O

Mixed

security model

Mixed access constraints

Mixed security policy

Workgroup engines and

Models

security

Modes

DSN open

Modifiable keys 1 2

Modifying

configuration parameters

data files

with BUTIL

Monitor

command syntax

configuration file

configuration parameters and

finding performance bottlenecks with

how to identify performance problems

overview

setting screen refresh options

starting

terminating a user connection

versions of

Monitor utility

See Monitor

Monitoring

active files

files

handles

MicroKernel communications

MicroKernel resources 1 2

output

SQL interface resources

user information

using bmon utility

utilities for

Multiple

clients

optimizing support for

files

optimizing support for

processors

use of

N

Named databases

where metadata stored

Names of delimited identifiers

Names of objects

restrictions for

Names of regular identifiers

case-insensitivity of

valid characters

Naming

extended file

NetBIOS

with Workgroup engine

NetBIOS Port

configuration parameter

Network

auto-reconnect feature

connection timeout

ports used 1 2

Networking

with Workgroup engine

Normal

DSN open mode

Null

keys

not allowed in a key column

NULL

data type

Null key

Null value discrete ordering

Number of Bytes from Data Buffer

configuration parameter 1 2

Number of Bytes from Key Buffer

configuration parameter 1 2

Number of indexes

effect on rebuilding files

Number of Input/Output Threads

configuration parameter 1 2

Number of Load Retries

configuration parameter

O

Object names

restrictions for

ODBC

connection strings

creating DSNs

TCP/IP port number

tracing

performance and

OEM to ANSI

character translation

connection string

Open cached files

XIO statistic

Open File

in Function Executor

Open modes

Opening a file

with Function Executor

opening files

OPENMODE connection string

Operation Bundle Limit

Operations, performing with Function Executor

Optimizing

database configuration

read-heavy databases

Optimizing the rebuild process

Options

client DSN

Owner name

setting for a file

Owner names

BUTIL and 1 2 3

clearing with BUTIL

GRANT syntax and

how to set or clear an owner name

relational security and

REVOKE syntax and

setting and clearing

setting with BUTIL

summary

P

Page

compression

Btrieve Maintenance utility and

description files and

preallocation

Btrieve Maintenance utility and

description files and

sizes

Btrieve Maintenance utility and

description files and

Page compression

in File Information Editor

Page size

effect on file size

PAM

authentication

library

required link to

required link to PAM library

PAR file

Parameters

client

server

Parameters, configuration

before you modify

PARC See Auto-reconnect

Password

name

maximum length

valid characters

Performance

client cache 1 2

logging and

tuning

virtual memory and

Performance Tuning

configuration settings 1 2

Pervasive Control Center

configure for Microsoft Cluster Service

OEM characters and

Pervasive Engine

driver name

Pervasive PSQL

engine

event log

field descriptions

file location

overview

Pervasive_admin

security group

Physical memory

XIO statistic

Planning security scheme

Port number

NetBIOS

TCP/IP 1 2

TCP/IP ODBC

Primary key

adding to existing table

creating in a table

definition of

Procedure

name

maximum length

valid characters

Processors, multiple

see Multiple processors

Prompt for Client Credentials

configuration parameter

Properties

setting for Linux client

setting with bcfg utility

setting with command-line utility

Protocols

supported

PUBLIC group

used with security

PVSW.LOG

file

PWD connection string

Q

Quoted names

R

Read hit %

XIO statistic

Read-only

DSN open mode

Rebuild

log file

Rebuild utility

CLI example for Linux

CLI example for Windows

CLI versions

command line parameters

deleting temporary files

GUI version

optimizing the rebuild process

running on Linux

running on Windows

Rebuilding files

amount of memory

cache allocation size

CPU speed and disk speed

GUI Rebuild utility

index page size

max MicroKernel memory usage

number of indexes

optimizing the rebuild process

sort buffer size

Rebuilt

file formats

Record

compression

Btrieve Maintenance utility and

description files and

length

Btrieve Maintenance utility and

description files and

Record compression

in File Information Editor

Records

copying between data files

effects of number of on file size

exporting

Btrieve Maintenance utility and

BUTIL and

importing

Btrieve Maintenance utility and

BUTIL and

variable-length

Btrieve Maintenance utility and

description files and

RECOVER command

Recovering

changes

and BUTIL

damaged files

Btrieve

data

Redirecting Locator File, See Gateway Locator File

Referential integrity

archival logging and

Btrieve and

cascade

definition of

delete rule

foreign key

primary key

restrict

rule, definition of

update rule

Referential Integrity

concepts

Refreshing

active session list

Registry setting

for embedded spaces 1 2

Regular identifier

definition of

length for names

Regular identifiers

case-insensitive of

valid characters

Relational architecture

client

server 1 2

Relational interface

security for

security model

Relational security

Btrieve and

owner names and

Repeating duplicate keys

Btrieve Maintenance utility and

Repeating duplicates

Repeating-duplicatable keys

description files and

Repeating-duplicate keys. See Repeating duplicate keys

Requester configuration parameter, See Use Remote MicroKernel Engine 1 2

Resources, monitoring

MicroKernel

Restore and backup

Restoring

data files

files

files using Continuous Operations

Restrict rule

Restrictions

for identifiers