ZVEMRHL ;DJB,VRR**Help Text - Rtn Lbry ; 11/30/00 1:30pm ;;12;VPE;;COPYRIGHT David Bolduc @1993 ; LIBRARY ;;;Routine Library & Versioning ;;; INTRODUCTION ;;; ------------ ;;; ;;; VPE's Library & Versioning modules work in concert with the routine ;;; editor (..E). They are activated with the ..LBRY System QWIK as follows: ;;; ;;; ..LBRY Displays the Library/Versioning menu. ;;; ..LBRY ON Activates both modules. ;;; ..LBRY OFF Inactivates both modules. ;;; ..LBRY ON L Activates Library only. ;;; ..LBRY ON V Activates Versioning only. ;;; ;;; This sets the following nodes: ;;; ^VEE(19200.11,"A-ACTIVE") = "ON/OFF" (Library) ;;; ^VEE(19200.112,"A-ACTIVE")= "ON/OFF" (Version) ;;; ;;; Note: If Library is active and Versioning inactive and you want to ;;; reverse this, first do ..LBRY OFF to inactivate Library and then ;;; do ..LBRY ON V to activate Versioning. ;;; ;;; SETUP ;;; ----- ;;; ;;; Files used: ;;; ;;; VPE PERSON.......^VEE(19200.111) ;;; Name ;;; Identifier ;;; VPE ID ;;; Routine Versioning Prompt ;;; ;;; VPE RTN LBRY..............^VEE(19200.11) ;;; Name ;;; Identifier ;;; Date Signed Out ;;; Signed Out By (Pointer to 19200.111) ;;; ;;; VPE RTN VERSIONING...^VEE(19200.112) ;;; Routine ;;; Version ;;; Description ;;; Date ;;; Text ;;; ;;; Move to your production account and restore file VPE_x.PRD. This will load ;;; FM Init routines ^VEEMI*. Next, DO ^VEEMINIT to install the files listed ;;; above. Edit file VPE PERSON. This file should contain the names of all ;;; your programmers. It IS NOT a pointer to the NEW PERSON file. It also ;;; contains each person's VPE ID number, which you can find by looking at ;;; variable VEE("ID") at the ">>" prompt when you're logged into the VPE ;;; programmer shell. For this to work correctly, these files should be ;;; translated so they are available in multiple UCI's. ;;; ;;; R O U T I N E L I B R A R Y ;;; ----------------------------- ;;; ;;; The Library's purpose is to help prevent routines from being accidentily ;;; overwritten when there are multiple programmers working on the same routines. ;;; ;;; The premise is that programmers can 'sign out' routines they will be working ;;; on. If another programmer attempts to edit a signed out routine using VPE's ;;; routine editor, a message is displayed warning that the routine has been ;;; signed out. The programmer should then check with the person who signed out ;;; the routine, before continuing. ;;; ;;; This IS NOT a database that tracks revisions to routines. It is a database ;;; of the names of all routines currently signed out. Once the routines are ;;; signed back in, they are dropped from the database. ;;; ;;; System QWIC ..LBRY is the main menu for signing routines in & out of the ;;; Library. The VPE routine editor (..E) also interacts with the Library. ;;; ;;; Routine Editor (..E): ;;; ;;; a. When you enter the editor, you will receive a warning message IF ;;; the routine you are editing has been signed out by someone else. ;;; The same will happen if you BRANCH to another routine. ;;; ;;; b. When you leave the editor, IF the routine you were editing hasn't ;;; been signed out and you hit SAVE to save any changes, you will be ;;; asked if you want to sign out the routine. ;;; ;;; NOTE: The menu option "Sign In Routines" uses VPE's 'Selector' software. ;;; You select the routines you want to sign in, by positioning the cursor ;;; and hitting . "=>" Will appear next to selected items. Hit ;;; again to de-select an item. ;;; ;;; R O U T I N E V E R S I O N I N G ;;; ----------------------------------- ;;; ;;; As a routine is edited and the changes saved, the versioning module stores ;;; the routine's code, by version number. A programmer can, at any time, ;;; restore any version of the routine, making it the active version. ;;; ;;; System QWIK ..LBRY is the main menu for viewing and restoring different ;;; versions of a routine. The VPE routine editor (..E) contains the prompts ;;; that allow a programmer to create the different versions. ;;; ;;; Routine Editor (..E): ;;; ;;; a. When you leave the editor, if you choose SAVE to save any changes, ;;; you will be asked if you want to store a version of the routine. ;;; You may create a new version or update an existing version. ;;; ;;; b. Filling in the DESCRIPTION field will aid you in selecting the ;;; correct routine to restore. ;;;***