Section Seven - Filer reference

The Filing System Hierarchical System looks like an upside down tree with the Device at the top.
Underneath that can be either a Directory or a filename,
Underneath that can be either a Directory or a filename,
and so on ... 

The full form of a file name is
:DEVICE I DIRECTORY I DIRECTORY I .... /filename
where
DEVICE is one of the specification listed below
DIRECTORY and filename are each of the form
name.extension
consisting of a name of up to 12 letters or digits, followed by an optional extension of up to three letters or digits, DIRECTORY is a directory name subject to the same constraints as filename.

All ISO characters (such as é and å) are allowed in filenames^OZ4.7.

.sgn

For

Open

symb_square.png

+K and

Open

symb_square.png

+S CLI files

.CLI

For BOOT.CLI; see CLI files section below

.L

For PipeDream multi-file List file

../name

Parent directory of name

.

Current directory

:RAM.0 

RAM in slot 0 (internal memory)

:RAM.1 

RAM in slot 1 (external memory)

:RAM.2 

RAM in slot 2 (external memory)

:RAM.3 

RAM in slot 3 (external memory)

:RAM.- 

Any RAM memory; ie 0, 1, 2, or 3. Used by CLI for temporary files, and lost on reset.

:EPR.0 

FLASH or EPROM in slot 0 (internal memory)^OZ4.7

:EPR.1 

FLASH or EPROM in slot 1 (external file area)^OZ4.7

:EPR.2 

FLASH or EPROM in slot 2 (external file area)^OZ4.7

:EPR.3 

FLASH or EPROM in slot 3 (external file area)^OZ4.7

:ROM.0 

ROM

:SCR.0 

Screen

:PRT.0 

Printer; via printer driver so that highlight codes are interpreted

:COM.0 

Communications; via serial port

:INP.0 

Standard input

:OUT.0 

Standard output

:NUL.0

Null: absorbs output, and acts like an empty file on input

*

Matches any number of characters (or none)

?

Matches a single character

//

Matches any number of directories (or none)

:*//letter

Finds the file called letter anywhere

doc*

Finds: doc. tx, document, doc27, doc, etc

*.*

Finds only files with extensions.

../fred

Finds all files beginning with fred in the parent directory

catalogues all files (in the current directory) 

fred*

catalogues all files beginning with fred

*.bas

catalogues all files with a bas extension

letter.txt

17:42:54

novel.txt

01-Jun-1987

17:41:17

game.bas

02-Jun-1987

12:27:43

02-Jun-1987

CE

 Catalogue File Card

Gives a list of information on all files in a Flash or EPROM card. The directories and file names will be given to show where the files originally came from.

Flashing Display whilst using Flash or EPROM card is normal

When you catalogue or save to a blank EPROM, the display will go blank for a few seconds while the EPROM is checked. This also happens with Flash cards when OZ is running on the same card. This happens only once; afterwards cataloging is without flickering.

 

ES

 Save to File Card

Copies files from the filing system to a Flash or EPROM card. The file or files to be saved can either be selected as already described, or specified after the prompt

Name :   

When a file is being saved to EPROM or to a Flash card in Slot 1, the screen will blank intermittently (if OZ is running on the same card) until saving is completed, when the Cambridge Z88 will bleep.

Warning: the display may be blank for a long time when saving large files

When saving very large file, the Z88 may appear to be doing nothing. It isn't, it is just working as fast as it can so leave it alone. For example a 368K file can take up to 3 minutes to complete, so just wait.

Several files may be saved at the same time. See Select Extra File

UV EPROM fully erased?

From OZ 4.5 a check is made that the file area is fully erased when using this command for the first time. Users using previous versions should check that the EPROM is fully erased using ROMcombiner.

 

EF

Fetch from File Card

Copies files from Flash or EPROM card back to the filing system. Gives the prompts

     Source : 
Destination :

Source: specifies the name of the file in the EPROM.

Destination: gives the name it is to be saved as in the destination filing system. It is initially set to the same as the source name, but you can edit it if you want to save the file under a different name.

CO

 Copy

Makes a second copy of a file in RAM. Gives the prompt

    Name :

allowing you to specify the file name to be copied, followed by the prompt

New name :

for the name of the copy.

Multiple files (selected in the catalogue window) can be merged into a single file with the Copy command; they will be appended in the order in which they were selected. See Select Extra File

RE

 Rename

Allows the name of a file in RAM to be altered. Gives the prompts

    Name : 
New name :

For example, to change the name of a file from game.bas to 0ldversion you would specify

    Name : game.bas 
New name : oldversion

Note that you cannot use the Rename command to move a file from one directory or device to another. The new name must be a simple file name; devices and path names are not permitted.

ER

Allows one or more files from RAM to be removed from the filing system. Gives the prompt

Name :

followed by the prompt

Confirm each file ? Yes

Pressing 

You will not be permitted to erase a file which is in use; for example, a directory containing other files, or an open BASIC file.

Several files may be erased at the same time. See Select Extra File

SE

Select File Card

Selects the slot for the default File Card. This is selected using the number keys, 0-3 or

EC

Create File Card

If the Flash card is blank, this command formats the File Area for the first time. If this has already been done and there are some files already saved, this command will format the file area again after giving a warning.

Sets the current directory to the specified directory. Gives the prompt

Name :

displaying the current directory string (if any).

For example; to set the current directory to directory TEXT in the current directory, specify

Name : TEXT

If the directory has not been created, a File not found error will be displayed.

Sets the current RAM device. Gives a prompt such as

Name : :RAM.1

showing the current device, which can be edited to the required new device.

The Select Device command resets the current directory to the root directory.

The Select Device and Select Directory commands affect the device and directory for the activity from which the Filer was entered, if there is one. This allows different activities to use different devices and directories without the need for specifying them explicitly each time.

Down Directory

These commands are used for traversing a hierarchical directory structure. To select a directory move the highlight bar to the directory name in the Filer DIRECTORY window and press 

EX

Executes a CLI file of commands specified after the prompt

Name : I

See CLI files below.

Creates a directory within the current directory; the name is specified after the prompt

Name : I

Copies a file tree from one directory to another. Arguments to the S o u r c e and D e s t i n a t i o n fields must be devices or directories. For example,

will make a duplicate copy of all files from RAM card 1 to RAM card 2.

The source area cannot be part of the destination area.

Sets up a match string restricting access to files in the current directory to those that match the string. For example, setting

Name : *.bas

Will catalogue only files with a bas extension. The default match string is *, matching all file names. When a name match other than * is active, the symbol NM will be displayed at the left-hand end of the Filer DIRECTORY window

VF

When this command is issued, the user is prompted for the file name.

Open

enter filename