Just as you begin a session in the PowerBuilder development environment by running PowerBuilder and end the session by exiting PowerBuilder, you need to open a session when using ORCA and close the session when finished.
Library list and current application
In the PowerBuilder development environment, you must first have a current application. You also set the library list search path if you plan to view or modify objects or create executables. ORCA has the same requirements, but in reverse order. In ORCA, you set the library list and then set the current application.
ORCA functions that do not involve compiling objects or building applications do not require a library list and current application. These are the library management functions. For source control functions, PBORCA_SccSetTarget implicitly sets the library list and current application.
Session management
Listed here are the session management functions (which all have the prefix PBORCA_), the purpose of each, and their equivalents in the PowerBuilder development environment:
|
Function (prefix PBORCA_) |
Purpose |
Equivalent in PowerBuilder |
|---|---|---|
|
ConfigureSession |
Sets session properties that affect the behavior of subsequent ORCA commands |
Options |
|
SessionOpen |
Opens an ORCA session and returns the session handle |
Starting PowerBuilder |
|
SessionClose |
Closes an ORCA session |
Exiting PowerBuilder |
|
SessionSetLibraryList |
Specifies the libraries for the session |
File>Library List |
|
SessionSetCurrentAppl |
Specifies the Application object for the session |
File>Select Application |
|
SessionGetError |
Provides information about an error |
No correspondence |
