1 | ZVEMRHL ;DJB,VRR**Help Text - Rtn Lbry ; 11/30/00 1:30pm
|
---|
2 | ;;12;VPE;;COPYRIGHT David Bolduc @1993
|
---|
3 | ;
|
---|
4 | LIBRARY ;;;Routine Library & Versioning
|
---|
5 | ;;; INTRODUCTION
|
---|
6 | ;;; ------------
|
---|
7 | ;;;
|
---|
8 | ;;; VPE's Library & Versioning modules work in concert with the routine
|
---|
9 | ;;; editor (..E). They are activated with the ..LBRY System QWIK as follows:
|
---|
10 | ;;;
|
---|
11 | ;;; ..LBRY Displays the Library/Versioning menu.
|
---|
12 | ;;; ..LBRY ON Activates both modules.
|
---|
13 | ;;; ..LBRY OFF Inactivates both modules.
|
---|
14 | ;;; ..LBRY ON L Activates Library only.
|
---|
15 | ;;; ..LBRY ON V Activates Versioning only.
|
---|
16 | ;;;
|
---|
17 | ;;; This sets the following nodes:
|
---|
18 | ;;; ^VEE(19200.11,"A-ACTIVE") = "ON/OFF" (Library)
|
---|
19 | ;;; ^VEE(19200.112,"A-ACTIVE")= "ON/OFF" (Version)
|
---|
20 | ;;;
|
---|
21 | ;;; Note: If Library is active and Versioning inactive and you want to
|
---|
22 | ;;; reverse this, first do ..LBRY OFF to inactivate Library and then
|
---|
23 | ;;; do ..LBRY ON V to activate Versioning.
|
---|
24 | ;;;
|
---|
25 | ;;; SETUP
|
---|
26 | ;;; -----
|
---|
27 | ;;;
|
---|
28 | ;;; Files used:
|
---|
29 | ;;;
|
---|
30 | ;;; VPE PERSON.......^VEE(19200.111)
|
---|
31 | ;;; Name
|
---|
32 | ;;; Identifier
|
---|
33 | ;;; VPE ID
|
---|
34 | ;;; Routine Versioning Prompt
|
---|
35 | ;;;
|
---|
36 | ;;; VPE RTN LBRY..............^VEE(19200.11)
|
---|
37 | ;;; Name
|
---|
38 | ;;; Identifier
|
---|
39 | ;;; Date Signed Out
|
---|
40 | ;;; Signed Out By (Pointer to 19200.111)
|
---|
41 | ;;;
|
---|
42 | ;;; VPE RTN VERSIONING...^VEE(19200.112)
|
---|
43 | ;;; Routine
|
---|
44 | ;;; Version
|
---|
45 | ;;; Description
|
---|
46 | ;;; Date
|
---|
47 | ;;; Text
|
---|
48 | ;;;
|
---|
49 | ;;; Move to your production account and restore file VPE_x.PRD. This will load
|
---|
50 | ;;; FM Init routines ^VEEMI*. Next, DO ^VEEMINIT to install the files listed
|
---|
51 | ;;; above. Edit file VPE PERSON. This file should contain the names of all
|
---|
52 | ;;; your programmers. It IS NOT a pointer to the NEW PERSON file. It also
|
---|
53 | ;;; contains each person's VPE ID number, which you can find by looking at
|
---|
54 | ;;; variable VEE("ID") at the ">>" prompt when you're logged into the VPE
|
---|
55 | ;;; programmer shell. For this to work correctly, these files should be
|
---|
56 | ;;; translated so they are available in multiple UCI's.
|
---|
57 | ;;;
|
---|
58 | ;;; R O U T I N E L I B R A R Y
|
---|
59 | ;;; -----------------------------
|
---|
60 | ;;;
|
---|
61 | ;;; The Library's purpose is to help prevent routines from being accidentily
|
---|
62 | ;;; overwritten when there are multiple programmers working on the same routines.
|
---|
63 | ;;;
|
---|
64 | ;;; The premise is that programmers can 'sign out' routines they will be working
|
---|
65 | ;;; on. If another programmer attempts to edit a signed out routine using VPE's
|
---|
66 | ;;; routine editor, a message is displayed warning that the routine has been
|
---|
67 | ;;; signed out. The programmer should then check with the person who signed out
|
---|
68 | ;;; the routine, before continuing.
|
---|
69 | ;;;
|
---|
70 | ;;; This IS NOT a database that tracks revisions to routines. It is a database
|
---|
71 | ;;; of the names of all routines currently signed out. Once the routines are
|
---|
72 | ;;; signed back in, they are dropped from the database.
|
---|
73 | ;;;
|
---|
74 | ;;; System QWIC ..LBRY is the main menu for signing routines in & out of the
|
---|
75 | ;;; Library. The VPE routine editor (..E) also interacts with the Library.
|
---|
76 | ;;;
|
---|
77 | ;;; Routine Editor (..E):
|
---|
78 | ;;;
|
---|
79 | ;;; a. When you enter the editor, you will receive a warning message IF
|
---|
80 | ;;; the routine you are editing has been signed out by someone else.
|
---|
81 | ;;; The same will happen if you BRANCH to another routine.
|
---|
82 | ;;;
|
---|
83 | ;;; b. When you leave the editor, IF the routine you were editing hasn't
|
---|
84 | ;;; been signed out and you hit SAVE to save any changes, you will be
|
---|
85 | ;;; asked if you want to sign out the routine.
|
---|
86 | ;;;
|
---|
87 | ;;; NOTE: The menu option "Sign In Routines" uses VPE's 'Selector' software.
|
---|
88 | ;;; You select the routines you want to sign in, by positioning the cursor
|
---|
89 | ;;; and hitting <SPACE BAR>. "=>" Will appear next to selected items. Hit
|
---|
90 | ;;; <SPACE BAR> again to de-select an item.
|
---|
91 | ;;;
|
---|
92 | ;;; R O U T I N E V E R S I O N I N G
|
---|
93 | ;;; -----------------------------------
|
---|
94 | ;;;
|
---|
95 | ;;; As a routine is edited and the changes saved, the versioning module stores
|
---|
96 | ;;; the routine's code, by version number. A programmer can, at any time,
|
---|
97 | ;;; restore any version of the routine, making it the active version.
|
---|
98 | ;;;
|
---|
99 | ;;; System QWIK ..LBRY is the main menu for viewing and restoring different
|
---|
100 | ;;; versions of a routine. The VPE routine editor (..E) contains the prompts
|
---|
101 | ;;; that allow a programmer to create the different versions.
|
---|
102 | ;;;
|
---|
103 | ;;; Routine Editor (..E):
|
---|
104 | ;;;
|
---|
105 | ;;; a. When you leave the editor, if you choose SAVE to save any changes,
|
---|
106 | ;;; you will be asked if you want to store a version of the routine.
|
---|
107 | ;;; You may create a new version or update an existing version.
|
---|
108 | ;;;
|
---|
109 | ;;; b. Filling in the DESCRIPTION field will aid you in selecting the
|
---|
110 | ;;; correct routine to restore.
|
---|
111 | ;;;***
|
---|