Library Browser

About the Library Browser

The Library Browser is a simple utility that allows you to view the contents of a VAST library (manager.dat or mgr*.dat) from several different perspectives. It was designed to allow you to see what changes had occurred to your VAST library since the library was installed. This information is useful when moving from one library to another, to understand on what levels of VAST you’re running, or to simply get a view of all of your code. Included with the Library Browser is knowledge about the Smalltalk code editions shipped as part of

Based on this knowledge, the Library Browser provides five views, which are explained in more detail below.

Using the Library Browser

When you load the Library Browser configuration map, an entry is added to the Tools pull-down on the transcript menu bar, Open Library Browser. Select this to start the Library Browser. As it comes up, you'll see a slight hesitation and a busy cursor as the browser collects information about the known VAST product versions. The browser opens to the new code view. The status line at the bottom indicates which view is being displayed. It also indicates whether or not the view needs to be calculated.

Calculate a view by selecting Calculate and then a view from the menu bar. A progress dialog is displayed and when the calculation is complete, the view is switched to the one just calculated. You can also switch between views by selecting View and then a view from the menu bar. Note, depending on the size of your library file and a few other factors, these calculations can be quite lengthy. Typically, calculating the code owned or managed by a specified user takes the longest time.

The calculations are based on information in LibraryBrowserTableOfContentsApp that specifies the contents of each of the 'known' VA product releases listed above.

Each view is an icon tree of Smalltalk code artifacts. The icons represent configuration maps, applications, subapplications, and defined, extended, and undefined classes. From the Actions pull-down on the menu bar, or from the pop-up menu, you can expand and collapse items in the icon tree, search for items, browse items, export items, and (from the changed code view) browse changes between the edition of product code in your manager and the 'official' released edition.

When you select an item, a more detailed description of the selected item is provided in the bottom text pane. This includes the top level categories.

New Code View

This view shows all the Smalltalk configuration maps, applications, and subapplications in your Smalltalk library that are not recognized, by name, as being part of one of the known product versions. Generally, this is code that you have authored or code you loaded into your library from another source.

Configuration Maps shows all new configuration maps and all of their applications and subapplications. Note that if you created a configuration map and included a VA product application, that application would show up in this view as 'new'. You might expect 'LibraryBrowser' to show up because it has not been shipped as part of a VAST release, but it doesn't because it is explicitly excluded from the New Code View.

Applications and SubApplications shows all new applications and subapplications. This is an alternate view to Configuration Maps. Under each application are all of its possible subapplications (regardless of configuration expression), under each subapplication are all of its possible subapplications, etc. Some of the application or subapplication icons may be colored grey. A grey application or subapplication icon indicates that the edition is also included in one or more of the new configuration maps. A 'normal' icon indicates that the application or subapplication either is not included in a new configuration map or that the application or subapplication is included in a new configuration map, but a later edition than the one released in the configuration map was found. You might expect the two applications comprising the Library Browser, 'LibraryBrowserApp' and 'LibraryBrowserTableOfContentsApp', to show up here as new since they have not been shipped as part of a VAST release, but they don't because they are explicitly excluded from the New Code View.

SubApplications shows all new subapplications in a simple flat list. A grey subapplication icon indicates that the edition is also included in a new application or subapplication appearing under Applications and SubApplications or Configuration Maps. A 'normal' icon indicates that subapplication either is not included in a new configuration map, application, or subapplication, or that the subapplication is included in a new configuration map, application, or subapplication but a later edition than the one released in the configuration map, application, or subapplication was found.

Changed Code View

This view shows all configuration maps, applications, and subapplications in your Smalltalk library that are recognized by name as being part of one of the known products but whose edition time stamps do not match one of the known time stamps. Since the edition time stamps of the fix packs are known, changed code is generally product code that has been changed by the customer, most commonly through filing in of a code fix.

You can view the changes by selecting and item and then Actions>Browse Changes…. Doing may cause a selection prompter to be displayed asking you with which known product edition you wish to browse changes. This can happen if you have more than one version of VAST included in your library. There are also a few cases where multiple subapplications with the same name are used in different places and have different contents.

Configuration Maps shows all product configuration maps and all of their applications and subapplications that have changed.

Applications and SubApplications shows all product applications and subapplications that are changed. This is an alternate view to Configuration Maps. Under each application are all of its possible subapplications (regardless of configuration expression) that are changed, under each subapplication are all of its possible subapplications that are changed, etc. Some of the application or subapplication icons may be colored grey. A grey application or subapplication icon indicates that the edition is also included in one or more changed configuration maps. A 'normal' icon indicates that the application or subapplication either is not included in a changed configuration map or that a later edition exists than the one released in the configuration map.

SubApplications shows all of the product subapplications that are changed in a simple flat list. A grey subapplication icon indicates that the edition is also included in a changed application or subapplication appearing under Applications and SubApplications or Configuration Maps. A 'normal' icon indicates that subapplication either is not included in a changed configuration map, application, or subapplication, or that the subapplication is included in a changed configuration map, application, or subapplication but a later edition than the one released in the configuration map, application, or subapplication was found.

Open Class Editions View

This view shows all of the classes that are currently open editions, along with their controlling applications. This list can include product as well as new code.

By User View

This view shows all of the configuration maps, applications and subapplications managed by the specified user; and classes owned by the specified user. The user is specified at calculation time. The Configuration Maps, Applications and SubApplications, and SubApplications lists are similar to those in the new and changed views. The Other Classes list shows all those class definitions or extensions owned by the specified user, but controlled by an application managed by someone other than the specified user. A word of warning, this last part of the calculation takes some time.

Product Version View

This view shows which versions of VAST are installed. A green icon indicates the installed version. Note, this view currently supports finding at most one version of VAST. If your library contains multiple versions, only the latest will be 'found'.

Contents of .zip file

Supported Platforms

The Library Browser works with VisualAge Smalltalk (VAST) v4.0 and later. Supported operating systems are the same as for the version of VisualAge Smalltalk that you are running it on.

Installation Instructions

  1. Unzip the .zip file (okay, so you’ve probably already done that)
  2. Copy libbro.cat to your messages subdirectory (this is usually the ‘nls’ subdirectory under the main VisualAge Smalltalk directory.
  3. Import the 'LibraryBrowser' configuration map from libbro.dat.
  4. Load the 'LibraryBrowser' configuration map. This map contains applications ‘LibraryBrowserApp’ and 'LibraryBrowserTableOfCotentsApp’.

Version History

Reporting Errors

Your thoughts, comments, suggestions, and criticisms are much appreciated. Please use the VisualAge Smalltalk newsgroup to provide this feedback.

Disclaimer(s)

license