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