Welcome

Other Workbench-Related Tools and Programs

The following group of commands invoke other Workbench tools, utilities, and programs.

Calculator

Provides an on-screen calculator.

Format	CALCULATOR [PUBSCREEN <public screen name>] [TAPE <window>]
Template	PUBSCREEN,TAPE/K
Location	SYS:Tools

The output of the Calculator can be copied and pasted into any console window, such as the Shell or ED.

TAPE creates a Calculator window of a specific size in which your input and output is displayed. The specification is in the form of:

TAPE=RAW:x/y/width/height/title/options

For a description of the options and arguments used for the TAPE window, see the description of window specification for the NEWSHELL command in Chapter 6.

Clock

Provides an on-screen clock.

Format	CLOCK [DIGITAL] [<LEFT>] [<TOP>] [<WIDTH>] [<HEIGHT>] [24HOUR] [SECONDS] [DATE] [<FORMAT><n>] [PUBSCREEN <public screen name>]
Template	DIGITAL/S,LEFT/N,TOP/N,WIDTH/N,HEIGHT/N,24HOUR/S,SECONDS/S,DATE/S,FORMAT/N,PUBSCREEN/K
Location	SYS:Utilities

The DIGITAL option opens a digital clock. A resizable analog clock is the default.

The LEFT, TOP, WIDTH, and HEIGHT options allow you to specify the size and position of the clock. The keywords are optional; if not given, the numerical arguments are interpreted by their position as follows:

1st number	The clock opens <n> pixels from the left edge of the screen.
2nd number	The clock opens <n> pixels from the top of the screen.
3rd number	The analog clock is <n> pixels wide.
4th number	The analog clock is <n> pixels high.

For example, to specify only the width and height of the Clock, use the WIDTH and HEIGHT keywords. When entering only two numbers, the clock interprets them as the LEFT and TOP positions. WIDTH and HEIGHT are not available if you use the DIGITAL option.

The 24HOUR option displays the time in 24 hour mode, which is not available for the analog clock.

The SECONDS option displays a second hand on the analog clock and has no effect if DIGITAL is specified.

The DATE option displays the date.

The FORMAT option applies only to the digital clock. It takes a value from 0 to 5, which determines which of the six digital formats is used. Formats 4 and 5 vary, depending on your Locale Preferences Editor settings. To specify a digital format, either include the FORMAT keyword or use LEFT, TOP, WIDTH, and HEIGHT values; the WIDTH and HEIGHT values function as placeholders only and are ignored.

Example 1:

To open a clock that is 75 pixels from the left edge of the screen, 75 pixels from the top edge of the screen, 300 pixels wide and 100 pixels high, enter:

1> CLOCK 75 75 300 100

Example 2:

To use the SECONDS and DATE options, enter:

1> CLOCK SECONDS DATE

Example 3:

To open a 24-hour digital clock with seconds that is 320 pixels from the left edge of the screen and in the screen's title bar (0 pixels from the top), enter:

1> CLOCK DIGITAL 320 0 FORMAT 2

For more examples using Clock, see Chapter 8.

CMD

Redirects serial or parallel output to a file.

Format	CMD <devicename> <filename> [OPT S \| M \| N]
Template	DEVICENAME/A,FILENAME/A,OPT/K
Location	SYS:Tools

The <devicename> can be serial or parallel. To redirect printer output, it should be the same device as specified in the Printer editor. <Filename> is the name of the file to which the redirected output should be sent.

The CMD options are as follows:

S	Skip any short initial write (usually a reset if redirecting a screen dump).
M	Redirect multiple files until a BREAK command or Ctrl+C is entered.
N	Notify user of progress (messages are displayed on the screen).

Example:

1> CMD parallel RAM:cmd_file

Any output sent to the parallel port is rerouted to a file in RAM: called cmd_file.

DiskCopy

Copies the contents of one disk to another.

Format	DISKCOPY [FROM] <device> [TO] <device> [NAME <name>] [NOVERIFY] [MULTI]
Template	FROM/A,TO/A,NAME/K,NOVERIFY/S,MULTI/S,
Location	SYS:System

The <device> parameters specify the name of the disk devices to copy from and to copy to; for example, DF0: and DF1:.

By default, the destination disk has the same name as the source disk. If you specify the NAME option, you can give the destination disk a different name from the source disk.

Normally during a DiskCopy, the Amiga copies and verifies each cylinder of data. The NOVERIFY option allows you to skip the verification process, making the copy faster.

The MULTI option loads the data on the source disk into memory, allowing you to make multiple copies without having to read the data from the source disk each time.

Example 1:

1> DISKCOPY> DF0: TO DF2:

copies the contents of the disk in drive DF0: to the disk in drive DF2: overwriting the contents of the disk in drive DF2:.

Example 2:

1> DISKCOPY DF0: TO DF2: NAME NewDisk NOVERIFY

copies the contents of the disk in drive DF0: to the disk in drive DF2: and gives the disk in drive DF2: the name NewDisk. The disk is not verified as it is copied.

FixFonts

Updates the .font files of the FONTS: directory.

Format	FIXFONTS
Template	(none)
Location	SYS.System

FixFonts does not open a window or produce any output. While the FONTS: directory is updated, the drive activity light is on. When the update is finished, the light goes off and the Shell prompt reappears. If the disk needed to update the FONTS: directory is not available or if there is a problem with it, FixFonts produces a standard requester concerning the problem.

Use FixFonts whenever you make changes in the FONTS: directory; for example, copying new font files or deleting single font sizes.