Managing ObjectStore

ossetasp: Patching Executable with Application Schema Pathname

The ossetasp utility patches an executable so that it looks for its application schema in a database that you specify.

Syntax

ossetasp -p executable
ossetasp executable database
-p 
Instructs ossetasp to display the pathname of the specified executable's application schema database. Do not specify database in the command line when you include -p.

executable 
Specifies the pathname of an executable. On Windows systems, this can also be the pathname of a DLL.

database 
Specifies the pathname of an application schema database. ObjectStore patches the specified executable so it uses this application schema.

Description

When the schema generator generates an application schema, ObjectStore stores the actual string given as the -asdb argument to ossg (or the -final_asdb argument, if specified). When the application starts, it uses that string to find the application schema database.

When you move or copy an ObjectStore application to a machine that is not running a Server, leave the application schema database on the Server host. Normally, the application schema database must be local to the Server.

After you copy or move an application to another machine, you must patch the executable so it can find the application schema database. Run the ossetasp utility with the absolute pathname of the application schema database. Be sure to specify the name of the Server host.

A locator file allows a database and its application schema to be on a machine other than the Server host. See Chapter 5, Using Locator Files to Set Up Server-Remote Databases.

Windows

On Windows systems, you can perform the ossetasp utility on any EXE or DLL that contains schema (that is, that has a schema object file produced by ossg linked into it).

API

Class: objectstore
Methods: get_application_schema_pathname
and set_application_schema_pathname



[previous] [next]

Copyright © 1999 Object Design, Inc. All rights reserved.

Updated: 03/11/99 11:19:07