XEROX ARCHIVEBROWSER 2 4 1 ARCHIVEBROWSER 1 4 By: Nick Briggs (Briggs.pa@Xerox.com) requires: TABLEBROWSER This document last edited on March 3, 1987. INTRODUCTION The ArchiveBrowser package provides a file browser like tool for examining the Archive.Directory file created by the Cedar Archive tool. BASICS There are only two functions which you need be aware of (ARCHIVEBROWSER archivefilespec filter) [Function] (AB archivefilespec filter) [NLambda Function] The archivefilespec argument is defaulted to the file server and top-level directory from your LOGINHOST/DIR, with a default file name of Archive.Directory. You may override this by specifying either a directory or a complete file name. The filter argument is defaulted to the pattern "*.*". You may specify any other pattern at invocation or you may use the Filter command (see below) The ARCHIVEBROWSER and AB functions correspond to the FILEBROWSER and FB functions, and may be used in a similar way. OPERATION The commands to the archive browser are given via the command menu attached to the righthand side of the browser. It is quite similar to the FileBrowser in style. The commands dealing with particular files operate on the selected items in the browser. The file names displayed in the browser are printed as they appear in the archive directory file, which is written by the Archivist, and consequently use the [host] notation rather than {host}. Selections Selections are made with the mouse buttons: Left indicates a single selection (and cancels any previous selections), Middle indicates an additional selection, and Right will extend a selection if there is only a single entry already selected. Items may be deselected with the Middle button when the CTRL key (Dorado) or PROP'S key (Dandelion and Daybreak) is depressed. (Note that due to the coding in the TableBrowser package the deselection is hardwired to the given key, not that to which the user has assigned the Control function.) Commands There are a number of blank items in the menu. These items do nothing and are present only to separate seldom used or dangerous commands from commonly used ones. Retrieve [Menu Item] The Retrieve command will generate a retrieve request for any files selected in the browser. Files are retrieved with the same name as they were archived with, however the version number may change when the file is restored. The Retrieve command has alternate forms available as rollout menu subitems: Retrieve selected files [Menu Subitem] Same as the top-level Retrieve command. Retrieve to directory [Menu Subitem] Retrieve to directory prompts for a directory name and will retrieve the selected files into the specified directory. Retrieve renamed [Menu Subitem] Retrieve renamed prompts for a new name for each of the selected files and requests retrieval with this name. Filter [Menu Item] The Filter command allows specification of a pattern that can be used to restrict the files shown in the browser. The default pattern is "*.*" which matches all files. Sort [Menu Item] The Sort command reorders the files presented in the browser. The default sort is in alphabetical order by filename. Other orders are available as rollout menu subitems: Sort by file name [Menu Subitem] Same as top level Sort command. Sort by creation date [Menu Subitem] Sort by creation date sorts the files in order of decreasing creation date. Sort by archive date [Menu Subitem] Sort by archive date returns the files to the order in which they were first displayed when the browser was opened. The archive date is not actually recorded, but is implicit in the order of entries in the archive directory file. Reverse [Menu Subitem] Reverse will reverse the order of the items in the browser. Recompute [Menu Item] The Recompute command causes the archive directory file to be read anew and the items to be redisplayed. Same directory [Menu Subitem] Same as top level Recompute command. New directory [Menu Subitem] The New Directory subcommand prompts for a directory from where it will read an archive directory file. If only a directory is given (no filename) then the name "Archive.Directory" will automatically be supplied. Delete [Menu Item] The Delete command marks the selected items in the browser for later deletion. Note that deleting items from the archive directory file does not actually free up archive tape space, but does mean that you won't be able to retrieve the file. You probably shouldn't use this unless you have a lot of items which you are absolutely sure you will never need again. Undelete [Menu Item] Undelete unmarks the selected items which had previously been marked by the Delete command. Undelete all items [Menu Subitem] Undelete all items removes the deletion marks from all items in the browser. Expunge [Menu Item] The Expunge command removes the items in the browser previously marked for deletion, and writes a new version of the archive directory file. Should you happen to delete and expunge by mistake you can delete the new archive directory file (highest version) reverting to the previous version. (LIST ((PAGE NIL (FOLIOINFO (ARABIC) STARTINGPAGE# 1) (0 0 612 792) ((FOLIO NIL (PARALOOKS (QUAD CENTERED) CHARLOOKS (SUPERSCRIPT 0 SIZE 10 FAMILY MODERN OVERLINE OFF STRIKEOUT OFF UNDERLINE OFF SLOPE REGULAR WEIGHT MEDIUM) FORMATINFO (ARABIC)) (174 36 288 36) NIL) (HEADING NIL (HEADINGTYPE RUNNINGHEAD) (84 744 444 36) NIL) (TEXT NIL NIL (84 96 456 600) NIL))) (PAGE NIL NIL (0 0 612 792) ((FOLIO NIL (PARALOOKS (QUAD CENTERED) CHARLOOKS (SUPERSCRIPT 0 SIZE 10 FAMILY MODERN OVERLINE OFF STRIKEOUT OFF UNDERLINE OFF SLOPE REGULAR WEIGHT MEDIUM)) (282 42 72 36) NIL) (HEADING NIL (HEADINGTYPE RUNNINGHEAD) (84 744 444 36) NIL) (TEXT NIL NIL (84 96 456 600) NIL))) (PAGE NIL NIL (0 0 612 792) ((FOLIO NIL (PARALOOKS (QUAD CENTERED) CHARLOOKS (SUPERSCRIPT 0 SIZE 10 FAMILY MODERN OVERLINE OFF STRIKEOUT OFF UNDERLINE OFF SLOPE REGULAR WEIGHT MEDIUM)) (282 42 72 36) NIL) (HEADING NIL (HEADINGTYPE RUNNINGHEAD) (84 744 444 36) NIL) (TEXT NIL NIL (84 96 456 600) NIL))))))È T2È ÈT(È1È È(ŠŠ8(È (ŠŠ8DÈÈ PAGEHEADING RUNNINGHEAD HELVETICA MODERN MODERN MODERN MODERNMODERN LOGO HRULE.GETFNMODERN  HRULE.GETFNMODERN  HRULE.GETFNMODERN  HRULE.GETFNMODERN  HRULE.GETFNMODERN ', Œ8 ÛŒv þ  £0'(%w n©¬! %L$ç>i&Ö@   \"M%”zº