Copyright: ® Corsoft Corporation


Help Contents
Contents

Overview

 Introduction

 CorUtils Installation

 CorUtils Quick Start

 Product Support

Using CorUtils

 CorEdit

 CorLib

 CorDoc

Other Help Topics

 CorSwitch

 CorLib Illustrator


 Introduction

CorUtils for ObjectView™ comprises of three utilities:

CorEdit is a Multiple Document Interface based color-coded scripting environment for ObjectView™.  It utilizes the ObjectView™ technology, typically, its Compiler (OBVComp.EXE) and its Resource Manager (MakeRun.EXE) and provides a much more integrated and user-friendly environment that helps improve the productivity of a novice as well as an experienced ObjectView™ programmer.

Note: CorEdit does not provide trace level debugging capabilities but it does provide support for compiling ViewScript code in both: Release mode as well as Debug mode.  To facilitate switching back and forth between CorEdit and the ObjectView™ compiler interface, CorUtils installation maintains both interfaces within a subdirectory and provides a utility called CorSwitch to help switch between CorEdit and ObjectView™ compiler interface.

CorLib is a rich set of ObjectView™ Function Library with functions that enable new and enhanced functionality within various areas of Windows programming.  These functions exploit the totally available ObjectView™ functionality.  Most routines have been developed in C-language and have been compiled into a Windows Dynamic Link Library.  This DLL is referenced using ObjectView™ OBXDLL to provide the most embedded and most simplistic approach that avoids confusion for the users and provides superior performance.

CorDoc is an application documentation and maintenance tool for applications and screens developed with ObjectView™.  It provides for maintenance of applications with its impact analysis and cross-reference capability.  It provides a graphical view and hierarchy for the application flow and is designed as a read-only environment.


 CorUtils Installation

 Overview

 Installation


 Overview

Follow these steps to help us ensure our continued committment to serve you better:

•	Fill out and return your registration card.

•	If you would like to be eligible for our full time technical support and product upgrades at reduced costs, you must fill out the registration card and mail it to us.

•	Backup the original disks.

•	Use the Windows File Manager' Copy Disk menu selection to make a backup copy of each of the product disks.  Keep these copies in safe place in case your original disks ever fail.


 Installation

The following steps will help you install CorUtils for ObjectView™ :

1.	Make sure that Windows is running.

2.	Make sure that ObjectView has already been installed.

3.	Insert Setup Disk 1 into floppy drive A or B.

4.	From the Program Manager's File menu, choose the Run... command.

5.	In the Command Line Box, type A:Setup or B:Setup (depending on the drive in which you placed the disk), then click on OK button to start the installation process.

6.	Setup will analyze your system to search for ObjectView directory on your Windows drive and set that directory as the installation directory.  If it does not find the same at that drive, it will prompt a message and set the installation directory to be C:\View (provided Windows is installed on your C-drive)

Note: CorUtils for ObjectView™ must be installed in the same directory where your ObjectView™ development program has been installed.

7.	Follow the instructions on your screen to specify your selection and click on install to continue with the installation.

8.	When prompted, remove Disk 1 and insert Disk 2.

Note: Installation of CorEdit will rename the existing ObjectView™ compiler interface (ObvComp.EXE) to ObComp.EXE.  This is required as the ObjectView™ compiler is needed for code compilation.  CorEdit will be copied over as ObvComp.EXE to allow for switching between the ObjectView™ screen editor and CorEdit with the F5 toggle key.   Besides CorEdit, it copies CorDoc and its associated files within ObjectView™ directory.  It also creates a subdirectory within called ..\CORSOFT and copies ObjectView™ compiler and CorEdit Interface in that subdirectory to provide for switching back and forth between ObjectView™ compiler and CorEdit.  It also copies the CorSwitch (CorSw.EXE) utility and CorLib samples (if selected) within this subdirectory

9.	Upon succesful installation, the setup will create a program group within the Program Manager, called CorUtils and provide a message stating succesful installation.


 CorUtils Quick Start

CorUtils for ObjectView™ interfaces with various ObjectView modules and it has to be installed within ObjectView™ directory.  It has been verified to work with ObjectView™ release 1.1X, 2.X and 3.X.  The following is a brief description of each icon installed:

 CorEdit: Scripting environment

 CorSwitch: Utility to switch between CorEdit and ObjectView™ compiler interface

 CorDoc: Application documenting and maintenance tool

 CorLib Illustrator: Functional interface to demonstrate CorLib.

 CorUtils Help: Windows Help file.

The following CorLib samples are optional and can be installed by selecting samples check box during setup.  Two samples, with its associated source code are installed:

 Sample for Table functions

 Sample for Graphics functions


 Product Support

In United States and Canada, the technical support for all modules of CorUtils for ObjectView™ can be obtained by calling Corsoft Corporation.  CorUtils for ObjectView™ comprises of three utilities:

•	CorEdit: Improved Scripting Environment.

•	CorLib: Enhanced set of function library.

•	CorDoc: Application and Screen documenting tool.

CorUtils for ObjectView™ was developed by Corsoft Corporation.

Corsoft Corporation, 411 Borel Avenue, Suite 507, San Mateo, California 94402

Ph: (415) 286-2870

Fax: (415) 286-2879


 CorEdit

CorEdit is an ObjectView™ Compiler Interface.  It utilizes the ObjectView™ technology, typically, its Compiler (OBVComp.EXE) and its Resource Manager (MakeRun.EXE) and provides a much more user-friendly environment that helps improve the productivity of a novice as well as an experienced ObjectView™ programmer.  The following is a list of additional features supported by CorEdit beyond the ones supported by the ObjectView Compiler:

•	Configurable and Customizable as per user's personal preferences

•	Multi Document Interface support

•	No more 32KB limits for code

•	Unlimited Undo operation - helps trace back code changes

•	Color-Coding sensitivity exclusively for ObjectView™ scripting

•	New options supported: choice of Font, Color and Project

•	Customizable preferences: Support for customizing Color, Font, etc.

•	Tightly integrated with ObjectView™ screen editor

•	Ability to display and copy corresponding objects from its OBV file

•	Mark / UnMark Comments (multiple lines or single line)

•	Ability to invoke ObjectView™ help with cursor over an ObjectView™ command

•	Ability to configure and remember up to last opened ten files

•	Ability to set and configure TAB settings

•	Ability to open a file as READ-ONLY

•	Ability to validate an open file if it is out-of-date

•	Non-restrictive ability for coding at any position within a line eliminates the need for tab/space

•	Support for auto-indentation with reference to indentation in the current line

•	Ability to indent/undent lines (multiple lines or single line)

•	Support for checking all errors via 'Output' window on compilation

•	Double click on error line in 'Output' window enforces a jump to error

•	Support for line and column numbers for caret position

•	Ability to direct the screen focus to go to specified line number or caret position

•	Tool Bar support: Move cursor over toolbar and statusbar for status-help

•	Status Bar support: Double click on visible options in status bar to toggle or change

•	Drag files from file manager and drop into editor to load the file

•	Use right mouse button on an open script file to display available objects on the corresponding screen OBV file

•	Use right mouse button on the MDI Client area (outside an open file) to display syntax help on commands

•	Use right mouse button in syntax commands (after double-clicking on object parameter) for object names

•	Syntax file support with improved .SYN file generation:

•	Ability to update existing .SYN file by keeping previous comments, not overwriting it

•	Ability to edit .SYN file by adding comments graphically

•	Ability to associate Windows help with custom Syntax in syntax help

•	New project support with an ability to define a project as a collection of files that make an application

•	Ability to migrate an existing .LST file (created with MakeRun.EXE) to a new .PRJ file

•	Ability to compile active file, i.e.: CorEdit interfaces with ObjectView™ compiler

•	Ability to compile files that have been changed within a project

•	Ability to force compile all files in a project

•	Ability to detect dependencies and compile files appropriately within a project

•	Ability to generate an .OBR file from a project, i.e.: CorEdit interfaces with Resource Manager

•	Command line execution supports the same parameters as the ObjectView™ compiler.

Note: Debugger NOT supported

•	Provision for switching back to ObjectView™ compiler.


 CorLib

CorLib is a rich set of ObjectView™ function library with functions that enable new and enhanced functionality within various areas of Windows programming.  Until today, some functionality was only achieved by querying the database server with SQL construct.  Some CorLib functions help reduce load on the database server and network traffic by processing data on the client.

CorLib functions exploit the totally available ObjectView™ functionality.  Some routines have been developed in C-language and have been compiled into a Windows Dynamic Link Library (DLL).  This DLL is referenced using ObjectView™ OBXDLL to provide the most embedded and most simplistic approach that avoids confusion for the users and provides superior performance.  The library is well integrated into CorEdit and offer the following functionality:

Table/Object Functions:

•	CorCrossTab: Cross Tab Data Representation

•	CorSQLFilter: Filter for Column and Row data within an Object.  This function provides 'SQL' Equivalence on Table/SpreadSheet object.

•	CorSearchString: Search for specified occurences of data within an object

•	CorMatrixTranspose: Switching data from rows to columns

•	CorTemplate: Mask data within object with specified template

Aggregate Functions:

•	CorGetSum#: Sum of data within an object

•	CorGetMax#: Acquire Max value from data within an object

•	CorGetAverage#: Average value of data within an object

•	CorGetMin#: Min value from data within an object

Graphics Functions:

•	Cor2DPieChart: 2D Pie Chart with Style and Color Support

•	Cor3DPieChart: 3D Pie Chart with Style and Color Support

•	Cor2DBarChart: 2D Bar Chart with Style and Color Support

•	Cor3DBarChart: 3D Bar Chart with Style and Color Support

•	CorLogChart: Log Chart with Style and Color Support

•	CorLineChart: Line Chart with Style and Color Support

•	CorAreaChart: Area Chart with Style and Color Support

•	CorScatterChart: Scatter Chart with Style and Color Support

•	CorPolarChart: Polar Chart with Style and Color Support

Windows Functions:

•	CorColorDlg: Windows Color Dialog

•	CorPrintSetupDlg: Windows printer setup dialog

•	CorWriProfileString: Write specified data to Win.INI

•	CorGetProfileString: Read specified data from Win.INI

•	CorWriPriProfile: Write specified data to user defined .INI file

•	CorGetPriProfile: Read specified data from user defined .INI file

•	CorMaxWindow: Maximize the specified Window

•	CorMinWindow: Minimize the specified Window

•	CorNormalWindow: Restore the specified Window to normal State

•	CorIsIconWindow: Check if the specified Window is in iconic state

•	CorFindWindow: Check if the specified Window exists

•	CorWinAlwaysTop: Set a specified Window to always be on top

•	CorBringWindowTop: Bring a specified Window on top

•	CorFreeSysResource: Check for available free resources (User, GDI)

•	CorFreeSpace: Check for available space

Scroll Bar Functions:

•	CorGetScrollPos: Get scroll position on a specified scroll bar

•	CorSetScrollPos: Set scroll position on a specified scroll bar

•	CorGetScrollRange: Get scroll range on a specified scroll bar

•	CorHideScroll: Hide specified scroll bar

•	CorShowScroll: Show specified scroll bar

•	CorEnableScroll: Enable specified scroll bar

•	CorDisableScroll: Disable specified scroll bar

Windows Help Functions:

•	CorWinHelpContent: Activate specified help file to display contents

•	CorWinHelpOnHelp: Activate help file for using help file

•	CorWinHelpOnSearch: Activate help file with a search dialog

•	CorWinHelpClose: Close the specified help file

Object Functions:

•	Cor3StateChkBox: Make 3-State Check Box

•	CorEditProtect: Make specified Edit Box as READ-ONLY

Date Functions:

•	CorChkDate$: Check if specified date is correct

•	CorDaysDiff: Provide difference between two specified dates

•	CorBizDays: Provide Date offset by specified Business days

•	CorDay4Date: Provide Day for a specified Date


 CorDoc

CorDoc is a read-only environment and its primary purpose is to help ObjectView™ application developer with documentation and maintenance.  CorDoc provides complete objects and resources documentation for documenting ObjectView™ applications and screens.  CorDoc also  facilitates in ObjectView™ application maintenance with its impact analysis and cross-reference capability.

Application Documentation:

CorDoc creates an hierarchy of all screens and displays the structural layout of the application graphically.  Where and with which screen the application starts, how the application navigates, how the screens are interlinked, etc.  It generates the hierarchical tree structure by analyzing the source code.  All screens within the application are listed as nodes and are illustrated with different icons to graphically demonstrate the behavior (Modal, Chain, etc.).

Screen Documentation:

CorDoc displays all the Objects, Menus, Attributes, Events, Properties and Scripts with their INClude files in a coherent manner.  It provides an easy way to view all the objects in a screen to be sorted by their name, type or its embedded command.  It displays the screen header information along with its attributes, events and properties.  For each object within the screen, it again displays all the attributes, events and properties.  It provides an ability to view the screen objects information, associated menu for that screen (if any) and its associated script files, which includes the INClude files and references to external script files which are used as OBXDLL calls (".OBS" files) within the script.

Cross-Referencing:

It provides cross-reference capability for variable names, subroutine names, function names and more within the active file and project.

Impact Analysis:

CorDoc provides for impact analysis for objects within a given directory as well as for a defined project.

Reports:

CorDoc is primarily a documenting tool and provides an ability to generate user defined header information for the active script file or all files within a project.  It also provides capability to print the application heirarchy, source files: screens and scripts, cross-reference reports, etc.  The script files are printed with different font styles to improve legibility.


 CorSwitch

CorEdit provides support for compiling ViewScript code in both: Release mode as well as Debug mode.  However, it does not support trace level debugging.  In order to allow for trace level debugging provision, users can revert back to ObjectView™ compiler interface.

To facilitate switching back and forth between CorEdit and the ObjectView™ compiler interface, Corsoft provides a utility called CorSwitch.  CorUtils installation maintains both the interfaces within a sub directory and CorSwitch manages to copy appropriate files to switch between CorEdit and ObjectView™ compiler interface.

CorSwitch provides options to switch back and forth and an option to upgrade in a situation where ObjectView™ environment is upgraded.

Note: Since it copies the appropriate files in either case, CorSwitch should only be executed when either interface is not being used.  CorSwitch does check to ensure neither interface is running when executed.


 CorLib Illustrator

CorLib Illustrator is an application developed with ObjectView™ to demonstrate the implementation of CorLib functions.  Each CorLib function is demonstrated with an example and is provided with a capability to view the source code of its implementation.

CorLib Illustrator offers the following features, some of them only available while using it with ObjectView 3.X environment:

•	CorLib Illustrator provides an ability to activate the details on the selected function (or Run the function sample) via F7 key.

•	CorLib Illustrator provides an ability to toggle between its example screen and its corresponding code screen via F5 key.

•	CorLib Illustrator provides a capability to return back to its main sceen by pressing the 'ESC' key.

•	CorLib Illustrator provides a capability to invoke the Windows context sensitive help file by clicking on the F1 key.

•	CorLib Illustrator provides an ability to view the code in color - thus making it more explicit and understandable.

•	CorLib Illustrator provides an ability to copy the entire code for the selected example via its 'Copy' button.  Alternatively, you can highlight a portion of the selected code and click on 'Copy' button to copy the highlighted code.

Note: CorLib library provides two include files: CorLib.INC and CorLibP.INC.  The former provides the definition and values for all applicable constants.  The latter provides the declaration of function prototypes to the external OBXDLL (specified by CorLib.OBX).