|Powered by QM on a Rpi server|
KnowledgeBase 00037: The Private VOC
This article was originally published as a Tip of the Week.
Developers frequently want to add personal items to the VOC file. It is usually necessary to implement some sort of naming convention to avoid clashes and a periodic purge of unwanted items. QM supports a private VOC file as an extension to the standard VOC, eliminating these problems.
Using the Private VOC
The private VOC is a multi-file named PVOC that has subfiles that are the uppercase version of the user's login name. The system will look for an item in the private VOC if it cannot be found in the standard VOC or as a catalogued program. Only command type items (verbs, sentences, paragraphs, menus or procs) are supported in the private VOC. Other record types such as file references, phrases or keywords are not supported.
The optional LOGIN, ON.EXIT, ON.LOGTO and ON.ABORT command scripts must reside in the standard VOC, not the private VOC.
There are extended forms of the .D, .L. .R and .S command stack editor operations named .DP, .LP, .RP and .SP that use the private VOC. Use of .SP will create the private VOC if it does not already exist.
Sharing the Private VOC
Although the intention of the private VOC is to allow an individual user to create personal command items, it is sometimes useful for a group of users to share the same private VOC. Because this file is located using a standard F-type VOC entry, there is no reason why two or more subfile names cannot point to the same physical file.