1 What is a .CLI File?
- 1.1 Types of .cli files
2 Writing a .cli File
3 Planning
- 3.1 Prerequisites
- 3.2 Collecting the files
- 3.3 Writing Loadgame.cli
  - 3.3.1 Check List
- 3.4 Using the Keyboard
- 3.5 Editing the file
- 3.6 Testing
- 3.7 .CLI Comments
4 .CLI Examples
- - 4.1.1 Comments
- 4.2 OZ 4.7
  - 4.2.1 Loading and installing a Game
- 4.3 OZ 3.0
  - 4.3.1 Change the Default RAM in the Panel
  - 4.3.2 Create Directories in the Filer
  - 4.3.3 Printer Drivers
  - 4.3.4 Set the Clock
  - 4.3.5 After a BOOT.CLI file is used

What is a .CLI File?

A CLI file is a 'plain text' or ASCII file that is read by Command Line Interpreter. The Z88 can then use this file to interpret a list of keystrokes to fulfil a particular function. There are other commands apart from keystrokes, but these are the ones being used here,

Types of .cli files

There are two types of .cli files

A BOOT.CLI file (with the unique name of BOOT.CLI) runs after the Z88 has a Soft or Hard Reset. The previously written CLI program, stored on an EPROM or Flash card, is run automatically. This is a useful facility as after a HARD RESET, all settings are lost. The starting point for these files is in the INDEX.
Any other file with the extension of .cli is run by selecting it in the Filer
F with
EX, Execute. The starting point for these files is in the Filer

When using OZ 3.0 cli's can

set up the Default RAM Device in the Panel
change the Device in the Filer
create some Directories in the Filer
load the Printer Driver file
select the Clock - to enter the time manually.

Moving on to OZ 4.7 advanced functions cli's can

fetch, unzip, install RAM Applications then delete the any working files used left in RAM
fetch, unzip and view a file in Pipedream

Writing a .cli File

Planning

Prerequisites

OZ 4.7 with Unzip ^*
At least 128K RAM
Flash card
Connection to the desktop to get files off the internet

The typical configuration would either be a

512K/512K Flash/RAM card in slot 1 or
1M Flash card in slot 1 and at least 128K RAM in slot 2

Unzip*

Having Unzip as an application allows smaller files to be stored in the File Area which can be unzipped when required. The image of OZ 4.7 leaves a 32K hole before the File area begins. This hole may be used to add other applications.

Ziputils, which consists of Unzip and ZipUp together with ZetiZ is supplied to fill the hole with new flash cards. These files are not included with the upgrade version. If Unzip is not available,

It may be added as a separate exercise - see RomCombiner
It may be run as a RAM application - added to the .cli file
the file may be unzipped on the desktop and stored on the Z88 as a RAM file. The Unzip component of this example is then omitted.

Collecting the files

These files are RAM applications

Application	Download Area
All RAM Applications	https://sourceforge.net/projects/z88/files/Z88%20RAM%20Applications/
Ziputils.zip	https://sourceforge.net/projects/z88/files/Z88%20RAM%20Applications/ziputils/
bounder.zip	https://sourceforge.net/projects/z88/files/Z88%20RAM%20Applications/bounder/

Fetch the RAM applications needed. If Ziputils is required, the files need to be unzipped on the desktop before downloading them to the file area of the Z88.

Writing Loadgame.cli

Here are the steps to write a cli file to do the following:-

Install Ziputils (not needed if already installed)
Start Unzip
Unzip bounder.zip from the file area
Install bounder.app
erase the files used

Check List

	Check	Notes
	Make the first action of the cli file to go into the INDEX I	If at any time the cli file (which starts in the Filer) needs to be a BOOT.CLI file (which starts in the INDEX), putting this command here ensures that both start at the same place.
	Use the keys to select Applications and menu commands.
	Do not use cursor keys to select files or functions	unless there is no other way of using that function

.CLI Files