Sometimes it is necessary to remove an object version from a specific location. For example, if you want to replace an object with an earlier version of itself, you must first remove the later version. (VC/m does not permit an earlier version to overwrite a later version.)
You can delete an object version from a location by creating a transfer route which moves the object version to a backup or null location.
The Null location should look something like this:
| Location | Null |
|---|---|
| Description | Null virtual location |
| Single /multi version | Multi-Version |
| Component masks | (None) |
To configure the transfer route set the following values:
| Function code | It is counter-intuitive to use the Transfer function to delete something. It is therefore preferable to use a different function code, eg DELETE. If a value other than "XFER" is used, VC/m menus must be customized with new menu options which initiate transfers using this function code, eg ^%vc220("DELETE") instead of ^%vc220("XFER"). |
|---|---|
| From location | The location which the object is to be deleted from. |
| To location | The backup or null location discussed above. |
| Access codes | A list of access codes, separated by commas, for the groups of users who will be able to perform transfers using this transfer route. This kind of route often needs very restricted access. |
| Dependencies | Normally there is no need to specify any dependent locations for a deletion route. |
| New active locations | None. |
| New master location | None. |
| Copy /move (Transfer type) | This should be Move (or M in the character-based interface) not Copy (C). |
| Create new version? | Leave this box unchecked (or enter N in the character-based interface). |
| Audit trail level | A deletion is an unusual event. Enter a low number (eg 10) to indicate that this is a significant event. A high number (eg 90) indicates a less important event. |
| Audit trail message | Enter the text of the message that you would like to see in the audit trail for this event, eg "Deleted from %FROM". |
| Comments | When a system has a large number of complex transfer routes, it can be helpful to add a comment here to help understand the purpose of the transfer route at a later date. |
| Copy only if changed? | Leave this unchecked (or enter N in the character-based interface). |
| Status date behavior | Enter Hide to hide the status date prompt (or H in the character-based interface). |
| Status date caption | Leave this blank. |
| Function caption | Enter the caption to be used for the menu options in the browser interface. Prefix the hot key with '&', eg "&Delete". |
Last reviewed: Feb 10, 2005
Copyright 1997, 2005 George James Software.