Document-ID:        28005.1
Subject:            WIN: USING PVCS WITH ORACLE FORMS 4.5
Author:             PSOMAL
Last Revision Date: 18 December  1996


                   USING PVCS WITH ORACLE FORMS 4.5
                   ================================
This document explains how to use PVCS with Oracle Forms 4.5 and is intended
to supplement the information provided in the CDE2 for WINDOWS Installation
Guide.  Issues involved in installing PVCS are not addressed, for help
on such issues please refer to the documentation provided by Intersolv.

Please note that this bulletin is applicable for Developer/2000 release 1.0
and release 1.1 ONLY.

OVERVIEW OF PVCS:
=================

PVCS (Polytron Version Control System) can be used with Oracle Forms 4.5 for
source control.  PVCS is a third party package manufactured by Intersolv.

The Source Control dialogs will be invoked from the Oracle Forms 4.5 menu
(FILE--> Administration --> check-in, check-out, source control options)
in the Designer.  These commands are available only if PVCS is installed.

The interface module is provided as a DLL (TVC.DLL), and it invokes the PVCS
API's dynamically to perform the Source Control functions.  The Interface
uses the Generator to convert the Modules to their ASCII equivalent
(FMB-->FMT, MMB-->MMT, PLL->PLD).

These are three basic dialog windows the user would invoke to
check-in, check-out and maintain the form, menu or library Modules.

CHECK-IN:
=========

The check-in menu item allows the user to archive a form, menu or library.
When a module is checked-in, it is first converted to its text version
(FMT, MMT or PLD), then the text file is checked in.

CHECK-OUT:
==========

The check-out menu item allows the user to retrieve a form, menu or library
file that has previously been checked into source control.  When an archived
file is checked-out, Oracle Forms 4.5 invokes the generate component to
convert the text file to a .FMB, .MMB, or a .PLL binary file and the user
opens the checked out module in the designer.

The archiving is done on the text version of the files to facilitate the
user to generate Difference Reports between different revisions of the same
archive.

SOURCE CONTROL OPTIONS:
=======================

This dialog allows the user to specify options for using the source control
features.  The interface provides almost all of the standard PVCS Features
like check-in, check-out, locking, unlocking, log reports, difference
reports, add archives, remove archives.

SETUP:
======

Since the interface module is provided as TVC.dll, this dll must be in
the C:\ORAWIN\BIN subdirectory (assuming that the oracle home is C:\ORAWIN).

The file TVC.RES must be in the C:\ORAWIN\FORMS45 subdirectory (During the
installation of Oracle Forms 4.5.6, this file is copied to the
C:\ORAWIN\CDE2
subdirectory.  If the version of Oracle Forms being used is 4.5.6, copy
this file to the C:\ORAWIN\FORMS45 subdirectory).
The user needs to set up the TVCCFG variable in the ORACLE.INI. (The
ORACLE.INI is normally created in the MS-Windows subdirectory and is pointed
to by the ORA_CONFIG parameter in the WIN.INI.)  This parameter must specify
the location and name of the PVCS configuration file that is to be used by
the source control.

For example:
If the configuration file is C:\PVCS\PROJ.CFG, then set the TVCCFG
variable in the ORACLE.INI to the entire path and filename of the
configuration file as
TVCCFG=C:\PVCS\PROJ.CFG.

This is very important for the interface to get archive information from the
PVCS system.

For more information refer to the online help for source control and the
Intersolv Documentation on installing and using PVCS.