A Btrieve application running on a workstation can access local, remote, or both local and remote data as follows:

Workstation Application Accessing Local Data

When an application accesses data stored locally on the workstation, client-based Btrieve must be loaded on the workstation.

The following steps describe accessing data on the workstation:

1. The application makes a Btrieve request using a function call.
2. The interface code that you link with your application makes the call to client-based Btrieve. (Novell^® provides the interface code.)

   NOTE:  In a MS Windows or OS/2 environment, you must import the function definition.

3. Client-based Btrieve processes the request using the Btrieve library of function calls.
4. Client-based Btrieve returns the appropriate data and status code directly to the calling application.

Workstation Application Accessing Remote Data

When an application accesses data stored on a remote server from a workstation, the Btrieve Requester must be loaded on the workstation, and BSPXCOM and the Btrieve NLM must be loaded on the server.

The following steps describe accessing data stored on a server from an application running on a workstation:

1. The application makes a Btrieve request using a function call.
2. The interface code linked with the application makes the call to the requester. (Novell provides the interface code.)

   NOTE:  In a MS Windows or OS/2 environment, you must import the function definition.

3. The requester packages the request into a network message and routes the message to BSPXCOM on the remote server.
4. BSPXCOM receives the network message, validates the parameters, and then executes the request by making function calls to the Btrieve NLM.
5. The Btrieve NLM processes the request and returns the results to BSPXCOM.
6. BSPXCOM forwards the results to the requester at the workstation.
7. The requester returns the appropriate data and status code to the parameter variables in your application's memory and returns control to your application.

Workstation Application Accessing Local and Remote Data

When an application accesses local and remote data from a workstation, the Btrieve Requester and client-based Btrieve must be loaded on the workstation, and BSPXCOM and NetWare Btrieve must be loaded on the server.

The following steps describe accessing local and remote data from an application running on the workstation:

1. The application makes a Btrieve request using a function call.
2. The interface code linked with the application makes the call to the requester. (Novell provides the interface code.)

   NOTE:  In a MS Windows or OS/2 environment, you must import the function definition.

3. The requester determines whether the server or the workstation should receive the request.
4. This step varies, depending on whether the requested data is on the workstation or on a remote server:
   • If the requested data is on the workstation, the requester sends the request directly to client-based Btrieve. Btrieve processes the request using the Btrieve library of function calls. Client-based Btrieve returns the appropriate data and status code directly to the calling application.

   • If the requested data is on a remote server, the requester packages the request into a network message and routes the message to BSPXCOM on that server. BSPXCOM receives the network message, validates the parameters, and then executes the request by making function calls to the Btrieve NLM.

     The Btrieve NLM processes the request and returns the results to BSPXCOM. BSPXCOM forwards the results to the requester at the workstation. The requester returns the data and status code to the calling application.