HDOS COOKBOOK

This appendix provides you with a number of examples of possible HDOS
functions and commands. The possible applications of the command will be
given along with the exact command syntax, including prompts.

These examples are not intended as explanations of how HDOS accomplishes
various functions. Rather, they are intended as a survey of some of the
more useful commands and options. For a more detailed explanation of any
of the commands listed below, refer to the "General Operation" section.


LISTING FILES

The following variations of the TYPE command allow you to type the
contents of various files on your system console terminal. It is
necessary to specify a device in the file name if you wish to type files
from a disk mounted in a drive other than SY0:. You may type files from a
disk on SY0: without an actual specification of SY0:. Wildcards and
multiple file designations are valid and cause files to be listed one
after the other. Note that you may use CTRL-C to stop the listing
entirely, CTRL-S to halt it temporarily, and CTRL-Q to restart the
listing after a CTRL-S. We recommend that you do not type files with
the.ABS, .DVD, or .SYS extensions because such files do not normally
contain meaningful information written in ASCII. If you wish to type the
contents of system files using a wild card, you must use the /S
modifier.

	>TYPE FNAME.EXT
	>TYPE FNAME.EXT/S
	>TYPE DVn:FNAME.EXT
	>TYPE DVn:FNAME.EXT/S
	>TYPE *.EXT
	>TYPE *.EXT/S
	>TYPE *.*
	>TYPE *.*/S
	>TYPE FNAME.EXT,...,FNAMEn.EXT
	>TYPE DVn:FNAME.EXT,...,DVn:FNAMEn.EXT
	>TYPE DVn:*.EXT,...,DVn:FNAMEn.*


CATALOGING FILES

The following commands produce a catalogue listing of a specific file or
files. If you want a catalogue listing of files on a disk mounted in a
drive other than SY0:, you must specify the device name. If you specify
no device name, HDOS catalogues SY0:. You must use the /S modifier if a
system file is to be catalogued. If the * wildcard is used in place of
either FNAME or.EXT, multiple files may be catalogued if two or more
files have the * part in common. Note that there are a great many
possible commands that are not shown.

	>CAT
	>CAT/S
	>CAT FNAME.EXT
	>CAT FNAME.EXT/S
	>CAT FNAME.EXT,...,FNAMEn.EXT
	>CAT DVn:
	>CAT DVn:/S
	>CAT DVn:FNAME.EXT
	>CAT DVn:FNAME.EXT/S
	>CAT DVn:*.EXT
	>CAT DVn:*.EXT/S
	>CAT DVn:FNAME.*
	>CAT DVn:*.*
	>CAT DVn:*.*/S


MOUNTING AND DISMOUNTING DISKS

If you want to use disks with devices other than SY0:, it is necessary
that you mount them on the H17 and/or H47 drive units. The system volume
(the disk in SY0:) is automatically mounted during bootstrap. When you
have finished using a volume, it is necessary to dismount it before you
power the system down or mount a new volume. If you do not dismount
volumes, data which is held in memory may be lost because HDOS is not
given a chance to update the volume(s). The correct procedures for
mounting and dismounting disks are as follows:

	>MOUNT SY1:<cr>
	Volume 002, Mounted on SY1:
	Label: SPARE SYSTEM VOLUME

	>MOUNT DK1:<cr>
	Volume 180, Mounted on DK1:
	Label: ASSEMBLY PROGRAMS

	>DISMOUNT DK1:<cr>
	Volume 180, Dismounted from DK1:
	Label: ASSEMBLY PROGRAMS

	>DISMOUNT SY1:<cr>
	Volume 002, Dismounted from SY1:
	Label: SPARE SYSTEM VOLUME

	>DISMOUNT DK0:<cr>
	Volume 005, Dismounted from DK0:
	Label: GENERAL LEDGER AUGUST 1980

	>DISMOUNT SY0:<cr>
	Volume 001, Dismounted from SY0:
	Label: SYSTEM VOLUME

	Install a Bootable Disk in SY0: Hit RETURN to Reboot:


RUNNING PROGRAMS

Executable binary programs have the .ABS extension under the HDOS
convention. This extension enables you to type the FNAME portion of a
file name from the command mode as an abbreviated command to run the
program contained in the file SY0:FNAME.ABS. In order to run a program
contained on a file in a device other than SY0:, you must specify a
device in the file name. For example:

	>FNAME
	>DVn:FNAME
	>RUN FNAME
	>RUN FNAME.ABS
	>RUN DVn:FNAME
	>RUN DVn:FNAME.ABS


DUPLICATING FILES

It is possible to copy the contents of one or more files with a single
command. The general command syntax is:

	>COPY DVn:DESTINAT.EXT=DVn:SOURCE.EXT<cr>

Some examples of this command are:

	>COPY DVn:FNAME.EXT=FNAME.EXT
	>COPY FNAME.EXT=DVn:FNAME.EXT
	>COPY DVn:FNAME.EXT=AT:
	>COPY DVn:*.*=DVn:*.EXT
	>COPY AT:=*.*


DELETING FILES

It is possible to delete one or more files using only one DELETE
command. You must be careful with this command because valuable
information could be lost if you were to delete the wrong file(s).
System files are protected by flags and cannot be deleted until the
flags are changed. Those files which are both writeprotected and locked
can never be deleted unless the diskette is reinitialized. Here are a
few examples of the DELETE command:

	>DELETE FNAME.EXT
	>DELETE DVn:FNAME.EXT
	>DELETE DVn:FNAME.EXT,...,FNAMEn.EXT
	>DELETE *.EXT
	>DELETE FNAME.*
	>DELETE *.*


PERIPHERAL INTERCHANGE PROGRAM (PIP)

In general, you can use PIP to accomplish the same things that you can
accomplish in the command mode. This does not include running programs,
or such general-purpose functions as SET or DATE. However, PIP is the
basis for most command mode file manipulations. The following is a list
of some useful PIP commands:

	:P:HELP
	:P:FNAME.EXT
	:P:DVn:FNAME.EXT
	:P:DVn:DESTINAT.EXT=DVn:SOURCE.EXT
	:P:DVn:DESTINAT.EXT=DVn:SOURCE.EXT/S
	:P:/L
	:P:/L/S
	:P:LP:=/L
	:P:DVn:FNAME.EXT/L
	:P:FNAME.*/L
	:P:FNAME.EXT,...,FNAMEn.EXT/L/S
	:P:/B
	:P:/B/S
	:P:*.*/B/S
	:P: DVn:*.*=*.*
	:P:NEWNAME.EXT=OLDNAME.EXT/R
	:P:DVn:FNAME.EXT,...,DVn:FNAMEn.EXT/DEL
	:P:DVn:/RES
	:P:DVn:/DIS
	:P:/VER


SYSTEM OPTIMIZATION

There are several variations of the SET command which enable you to
optimize the performance of your disk drive system. For instance, you
can adjust the seek time of your disk drives to operate at highest
reliable speed. You can also configure the operating system to utilize
the console terminal in such a way that the terminal can backspace and
support lower-case input and output. Use the following format to obtain
help with the SET command:

	>SET HELP<cr>

	General Command Format:

	SET xx: opt
	  xx: -- Device Name
	  opt -- Desired Option

	For HELP with a specific device, type:

	  SET xx: HELP

	To determine the version of SET, type:

	  SET Ver


ONECOPY

This program is a stand-alone utility which enables owners of
single-drive systems to copy files from one diskette to another. The
destination file(s) automatically have the same name as the source
file(s). The number of times that you need to swap diskettes will depend
upon how much memory your computer has. The following list demonstrates
some of the possible ONECOPY commands:

	:OC:FNAME.EXT
	:OC:FNAME.*
	:OC:*.EXT
	:OC:*.*
	:OC:*.*/L/S
	:OC:/B
	:OC:/B/S
	:OC:/MOU
