Filer6

Simplifies and expands the HP49G+ standard filer

Filer6 requires at least ROM 1.23 for the 49G+. For a 49G+ or 49G with an older ROM version use one of the filers of the Filers package. Main advantages over the standard filer are:

These shiftings are RS N (CHARS) for name sorting (because unshifted N has become EVAL on the 49+) and LS 2 (DEF) for defining or creating a new directory or file. This option is much more powerful than NEW in the standard filer. Clearly, it errors in a standard port because it saves only backups or libraries. But it allows the creation of directories or files also on the SD-card from inside port3 or any of its subdirectories as shown in the screen-shot.  This dialog box was launched after passing to the card to create the subdirectory SOURCE for downloading HP source files (as a rule ordinary text files). Hence, the Directory option is checked. When crreating a directory the black Object: field should be skipped. If pressing OK you'll see the subdirectory SOURCE, either in the card root or in the currently scanned card directly. The new directory is not empty but contains a dummy named # (sharp), with the system binary # FFFFFh in it. This fixes a bug in operating system which doesn't allow the creation of files inside an empty card directory. After storing a useful file in SOURCE you may purge '#'. To purge a card directory is presently only possible with a card reader.

Note that some other hardcoded shiftings, e.g. leftshift N, are basically redundant since key I toggles Inversion for any kind of sorting.


What is New?

Version 5.2004: Simplified Find option on the ALPHA key known from Filer2 returned. NEW on RS DEF improved.

Version 4.2004: Key DEF (RS 2) makes option NEW more powerful. Creates directories or files also directly on the card.

Version 3.2004: Simplified. Document reading removed. This is realized by Headman. Clock toggling unshifted on key 9.

First Version released February 2004   -   Abbreviations: LS = LeftShift, RS = RightShift .


BASIC OPERATION

 The main application menu in Filer6 has only two pages as follows:

EDITB    VIEW      COPY     KEYS    PURGE     RCL
   IOP         ~OVW     SEND     RECV    XSEND    SD

All other options are on hard keys. crib sheet to hardkey of Filer6The menu option KEYS informs on active keys during a filers run as shown by the screen-shot. Active hard keys are listed in more detail below and referred to by the letter on it - provided there is any. After a while, you'll remember the relevant keys. The other options from page 1 are self-explaining. PURGE is executed with or without confirmation, depending on flag -76. Like COPY, PURGE and RCL, it may be used with multi-selection. Selection is done with the +/- key. EDITB ("Edit Best") edits like , while LS EDITB edits an object always in a command line like LS . For instance, pressing EDITB on PERIOD in the CAS menu, you see 2pi in the equation writer, but pressing LS EDITB you see '2*pi' in the edit line. In addition, there is a SysRPL editor on RS EDITB, displaying PERIOD as "SYMBOL ZINT 2 xPI x*". This function should only be used by those familiar with the basics of SysRPL. Note that COPY and MOVE overwrite an equally named backup when copying from a directory to a port.

IOP is a very comfortable I/O parameter setter. It sets a screen and menu for toggling wire/infrared and ascii/binary and cycling through all admissible IOPAR values relevant for the 49+. CANCEL and OK leave the IOP box and set the currently displayed values which the user might have changed. You may reset all values to their default with Reset on the 2nd menu page. Remember that the reserved variable IOPAR does not include any setting of wire/infrared or ascii/binary! ~OVW toggles the Overwrite flag. The transfer options SEND, RECV and XSEND can be used with multiple choice. For more details read  Ioman.htm

SD copies the selected files to the SD-card provided you are in a standard port. If a library was selected or belongs to the selections, a directory LIBS is created on the card in which the library is stored, to  keep the card's file structure easy to survey. If on the card, SD copies the selected files to the port choosen in a special port choose dialog. If being in HOME or another directory, SD may still do something different because from a directory can be copied to the card with COPY. Hence, in this case SD saves all standard ports on the card in one keystroke. This amazing function allows returning a defective unit to the dealer and keeping all data on a card, including all libraries! HOME backups with long names are not transfered to the card since dated HOME backups can directly be created on the card very easily with the SPC key. Note that (empty) directories and files can also directly be created with  the DEF key (LS 2). You cannot create something in an empty card directory, neither with the standard filer nor with Filer6 (a bug in the operating system). You've first to copy something to make the directory non-empty. Attention: In contrast to COPY or MOVE, SD never overwrites. If two objects have the same backup name in different standard ports, only the one with smaller port number is saved on the card. This concerns in particular distinct versions of the same library.

Arrow keys work as in the built-in filer. For instance, goes UPDIR,  to a  selected directory. Use key U to see in the header were you are. Most hardkey options are active only if the main appl menu is present, TREE has its own menu. More options can be added to the APPS box. But these must not affect the filers application menu. For instance, from APPS you may directly run the Constants lib and I/O-functions  inside a filer. Trivially valid hardkeys in the filers are not listed below (e.g. CANCEL, TurnOff). Keys working both with a single item and multiple items are marked with an asterisk.

Hard Keys in Filer6
APPS choose box (for calling additonal options inside the filers).
Toggle two distinct Header views of the filer. 
Toggle inverse sorting provided a sorting (Name, Size, Type) is active.
(VAR) Toggle complete view of variables or long library titles if in a port. 
(STO) store the level 1 object in the selected name by overwriting it. If  in a port, the level 1 object is stored in the current directory under a corresponding name. The backup object itself is not overwritten.
M * Move file to another directory or to a port. Backups in ports will be overwritten.
N Does EVAL. Name sorting is on  RS N.
O * Order a set of selected files in a directory.
P Pause (HALT). Return to the filer with CONT. The HLT indicator remains (bug) but disappears with U.
  Enters the TREE from anywhere. In ports or in HOME the TREE is also set with .
Q Quote the selected name. Quoting in ports includes port-tag. Quoting in a subdirectory on the card includes the path as a string. Only this is a valid argument for EVAL and RCL and usable in programs.
R Rename. Beeps in a port since libraries and backups cannot be renamed.
S Size sorting of files. 
T Type sorting of files.
U Unsort, original order after any sorting. Removes also selection marks and updates the header (clock etc). 
V

Version information as displayed in this screen.Version display Here V was pressed while visiting the card. The screen-shot shows by the way how a HOME backup looks like if made on the card with the SPC key, see below. Right after the backup symbol you see the date of creation.

W (+/-)  Multi-selection. Select and go to the next or the previous item.
ALPHA Find a file name after waiting for its first letter in ALPHA mode after pressing ALPHA (no double-click as in the standard filer). Case-insensitive search. For names starting with $ or other special symbols LS has to be used to obtain the character. When searching for all names starting with N or n, say, simply toggle the left-hand thumb on ALPHA with the right-hand thumb on N.
  (dot) Immediate return to HOME from anywhere, also from subdirectories of  HOME (doesn't work in standard filer).
0,1,2,3 Immediate entry into ports 0, 1, 2 or 3 (SD-card) from anywhere.
     9 Toggles clock display. Can be actualized with key U
 SPC SPC hit in a directoryWorks differently depending on whether in a directory or a port. In a directory (including HOME), a choose box is launched as shown in the screen shot. HIDE hides the selected files(s) in the current directory. It creates a nullnamed file displayed in the filer as
                       ''...''´´      CHAR      3
which separates visibles from hiddens by putting the latter behind the nullname ´´. Hidden files work normally and are invisible only in the VAR menu, hence are well protected against overwriting. UNHIDE unhides the selected files by putting them on top of the directory. Clearly, if nothing is selected, just the scanned name will be hidden or unhidden. ´´ contains a small dummy (character H by default) but anything can be stored in it with the filer's STO function. Also the so-called Hidden directory has a nullname but this one is unvisible in all filers.

SPC hit  in a port sets this choose boxWhen pressing SPC in port (including the SD-card), a choose box as seen in the example screen is set. ARCHIVE archives the entire HOME directory including key assignments in the scanned port, with date and time appended (on the card only date). Date format depends on flag -42. Key VAR uncovers the time of creation. Home backups or libraries should only temporarily stored in port0. Since the card does not accept long names, a HOME backup on the card displays only the date while a HOME backup in a standard port looks as in the screen, containing date&time of creation. For restoring, we suggest first pressing key T. This puts all candidates for RESTORE closely together. Then select the desired HOME backup and press RESTORE. In port2 or on the card there is enough room for several HOME backups.

ENTER Enter the selected directory and leave the filer. Equivalent to running CHDIR at the end of the built-in filer menu and then leaving with CANCEL.

HINT for newbees. We recommend storing Filer6 in port2 and attaching it to a key. For instance, to LS APPS, so that switching USR mode toggles the selected Filer with the built-in filer. If you don't have libs in the ports or a few, COPY may save them on the card. But if many libs are used, they are better saved with SD to keep the card easy to survey.

HINT for advanced users: The access to APPS makes the filers more powerful. E.g., if the APPS box contains BZDIR from OT49+, the scanned directory can be compressed as a whole inside the filer. Keep a copy of Filer6 in port2, for having access to it via the standard filer after a crash  - a filer invokes another one smoothly. RS EDITB applies ASM2 for recompilation. Hence, extable should exist and the libraries 256 and 257 attached (which is granted provided OT49+ is present). 

Credits. Thanks to Luis Morales Boisset for support in realizing the FIND option on ALPHA for the hp49g+.


Wolfgang Rautenberg - raut@math.fu-berlin.de - www.math.fu-berlin.de/~raut