V  C /  m 3.1.1
The Force of Change

Release Notes

1.       User Interface

The following functional changes have been made to the user interface:

2.       Audit Trail & Audit Trail Categories

In VC/m 3.1, the audit trail records more information and provides additional ways of giving feedback to the user.  The audit trail message levels have been replaced with audit trail categories.  The category determines the behavior.  The following features are available:

Additional methods have been provided for viewing audit trail information.  There are a number of new folders providing:

By double clicking, any persistent audit message can be opened to view more details about the event that occurred.  Additional information which is now recorded includes:

Where a message in the audit trail panel specifies an object or change request, double-clicking on that name opens the corresponding properties dialog.

All messages which are generated by a single action (such as a transfer by change request) are given a transaction number.  This can be used for sorting and identifying all the messages relating to one action.

3.       Caché 5.1

VC/m 3.1.1 is the first version compatible with Caché 5.1.  Before upgrading a VC/m server to Caché 5.1 you should first upgrade VC/m to 3.1.1.  After the Caché upgrade, perform the following steps:

4.       Upgrade Steps

Please note that the minimum supported version of Caché is now 4.0.

Follow the normal installation procedure.  Be sure to run ^%vcins as this performs two file conversion operations:

When upgrading from previous versions of VC/m, audit trail message levels are converted to audit trail categories of the same name.

Since numeric categories are not particularly meaningful, it is recommended that these are renamed to something more descriptive using the Audit Trail Category form in the Setup folder. The following scheme is a suggestion:

We also recommend that if audit level 99 is used, it be renamed to transient.

Any existing audit messages which have a numeric category which gets renamed will maintain the association with the new category. Any category attributes, such as color and icon, will therefore apply to all historical audit messages.

If an audit category is deleted and messages exist which referenced that category, they will be rendered using the color and icon attributes of the default category.

If the old audit levels were not previously assigned with any consistency or functional grouping, it may be preferable to create new functional categories and update the transfer routes to use the new categories. All future audit messages will be generated using the new category scheme, while the old categories (corresponding to numeric audit levels) can be deleted and all old messages will then be rendered using the default category settings.

5.       Bug Fixes and Other Enhancements

Summary of bug fixes and other enhancements which are included in this release:

Between 3.1 and 3.1.1

Change request Title
CLWB154 Resizable columns
L4277 Fix Javascript error when editing message category
L4348 Pass message category etc back from compile over task-server
L4372 Errors during multiple component registration
L4373 User maintenance dialog loses "Cancel all checkouts" setting on opening
L4381 Avoid pre-delete of Caché classes
L4385 Improve validation in File Locations maintenance screen
L4391 Reinstate CR Type disabled flag
L4427 Set default attribute on CSP in FX format to avoid import problems
L4455 bin and text enumeration was not working at remote:// addresses
VCM-D-0099 Add IsMaster^%vc1xvf dependency function to verify master is at from-loc
VCMB56 Rework primary change request and change request fields on object maint form
VCMB74 Web maint of CR types with status was broken
VCMB86 Clarify role of New Active Locations field on Transfer Route definition
VCMB102 Concurrent Branches report misuses term "variant"
VCMB111 Master Location list on Transfer Route definition should offer %TO and %FROM
VCMB115 Implement mechanism for adding local CSS file
VCMB117 Add extra option to Audit Trail setting: 'Integrity checker completion messages'
VCMB125 Include a CR regardless of color only if it was explicitly specified without wildcard
VCMB128 Adding reporting ability to Integrity Checker on CHUI interface
VCMB135 Revise User Guide information about remote address format
VCMB137 Allow entry of filename for transfers involving F-type locations
VCMB139 Port to Caché 5.1
VCMB140 Browser component lists didn't exclude items that mask to an earlier tree

Between 3.0.3 and 3.1

Change request Title
L3479 Improve task-server throughput when ECP networking is used
L3661 Deactivate non-R components when obv resubmitted to RE/m
L3665 Handle trailing slash in EWD app path setting
L3666 Make task server handle local task errors in the same way as remote ones
L3667 Fix some causes of ancestor pointing to missing version
L3675 Allow interrupt of initial toolbar filter
L3676 Make object selector handle object names containing - and :
L3726 Sort objects by version if necessary
L3787 Set/clear file r/o flag correctly when task server address
L3796 Fix bug in Checked-out objects report
L3816 $$order^%vc9fi missing for Caché on VMS
L3840 Use task server to set ^vcvp("rw"
L3854 Include AUTOF as a default transfer function on new installation
L3862 Disallow slashes in values returned from object-naming callout
L3871 Make post-xfer compile of CLS, CSP and CSR components optional - SET ^%vcvc(ctype,"settings","skipCompile")=1
L3920 Extend access code fields to 1000 characters
L3933 Show red objects correctly within red change requests
L3942 Prevent location rename within location maintenance
L3958 ^vcvp("rw" flag not being set for CLS and PRJ; rebuild^%vclM omitted BAS, CLS, CSP, CSR, PRJ
L4008 Pre-kill global tree before putting Lastic components
L4110 Try to avoid preparing details of more change requests than will be listed
L4172 Suppress the browser-back effect of the Backspace key
L4191 Open change request in un-named window, permitting several to be open concurrently
L4231 Some class mappings of VC/m data structures specify field lengths too short
VCM-B-0832 Protect against errors arising from damaged object ancestry chains
VCM-B-0834 CHUI transfer route delete input fields had not been extended in line with rest
VCM-B-0835 OpenM Desktop i/f accessing wrong structure
VCM-B-0836 Prevent ENTER on a gjs:form text field from submitting badly
VCM-B-0837 Disable Connect dialog buttons until scripts loaded
VCM-B-0838 Improve appearance of default.htm
VCM-B-0839 Remove redundant $zu(168) path extensions for temp files
VCM-B-0842 Normalize slashes in return from $$froot^%vcos on Windows
VCM-B-0843 Enable writing of % routines to remote CACHESYS
VCM-B-0844 Tidy up work-list gif
VCM-B-0845 Fix over-simplistic quoting of task server arguments
VCM-B-0852 Prevent amendment of existing addresses on Location maintenance dialog. Physical Address maintenance should be used instead
VCM-B-0859 Disallow colon (:) in location codes.  It is used as the filename separator for F-type locations
VCM-B-0865 Remove CHUI setup options from mnuSetup.  To access them, customize a menu to include mnuSetupCHUI
VCM-B-0906 Report unreachable remote:// addresses
VCM-D-0048 EWD component driver for eXtc Web Developer components
VCM-D-0055 Add bulk transfer API to %vcapi
VCM-D-0058 Frame tabbed panels
VCM-D-0060 Improve keyboard navigation of trees
VCM-D-0062 Displacement of object on CR at checkout is now configurable by setting ^%vcvc("retainOnChangeRequest").  Options are
  • 0 or undefined - always detach 'from object' from CR when checking out on same CR.  This is the default behavior for existing VC/m installations.
  • 1 - only detach 'from object' from CR if that object was not itself created by a check-out on this CR.  For example, the 'from object' might have been manually added to the CR prior to by-CR checkout.   Starting with 3.1, this is the default behavior for new VC/m installations.
  • 2 - never detach 'from object' from CR during checkout.
VCM-D-0064 Disable gjs:form elements until completely loaded
VCM-D-0065 Respect Windows preference to hide underlines on accelerators until Alt pressed
VCM-D-0066 Add afterGet and beforePut callouts to T-type component driver
VCM-D-0067 Provide afterPut callouts on bin and text location drivers
VCM-D-0068 Add new Concurrent Branching report
VCM-D-0070 Add tip about resequencing component masks
VCM-D-0075 Make MRU list length configurable.  Per-user value can be set in ^%vcmf("user",%usr,"mruLength"), site-wide value in ^%vcvc("mruLength"), default remains 10.
VCM-D-0076 Verify ancestor existence during Integrity Check
VCM-D-0080 Show description of change request types on the change request definition dialog
VCM-D-0082 Make forms resize automatically on opening so they show all elements
VCM-D-0093 Make top-level object list include objects that are not active anywhere
VCMB6 No longer require write permissions on license directory for all users
VCMB36 Component list for unreachable location now reports this situation rather than stating "No items found"
VCMB40 Change request lookup dialog now respects item limit
VCMB62 When defining a new change request, if the chosen type has a default status this is now set
VCMB65 Cancel of a merge-point now reinstates the originally checked-out version rather than the merged-in version
VCMB87 Prevent stack errors by making ancestor^%vc1xvd non-recursive
VCMB93 Comment text entered during checkin from Caché Studio 5 is now filed as the object version comment.  This can subsequently be viewed and amended using the Object Properties dialog
VCMB95 Object deletion now attempts to repair ancestry pointers.  Deletion from CHUI (Manager, Delete) reports progress and failures onscreen

Copyright 1999,2005 George James Software
http://www.georgejames.com