R: Morrow Designs Co-Pilot Menu system - Rev 2.5
R: Module - TUTORIAL.PIL
R: Copyright 1982, 1983, 1984 Morrow Designs, Inc.
R: All Rights Reserved
R: Written by Harrison Schreppel for Morrow Designs
R: Updated by John VanderWood 3/20/84
R:
ESC:*RETURN
*BEGIN
CLRS:
LF: 1
T:                 {A N    O V E R V I E W    O F    C P / M}
LF: 2
T:     This is the Co-Pilot Menu's on-line CP/M tutorial. It is not meant
T:     to be a thorough presentation on using CP/M, but is intended to be
T:     a "quick reference"  guide for people who are just learning to use
T:     CP/M.  For additional  information  or  variations  on any  of the
T:     commands shown, just type the number shown next to the command.
T:{
T:		1   Use of control keys in CP/M
T:		2   DIR - Display a list of files on a diskette
T:		3   ERA - Erase a file or group of files from a diskette
T:		4   REN - Rename a file
T:		5   STAT - Report system status
T:		6   TYPE - Display a file on the screen or print it
T:		7   PIP - Move or copy files
T:		8   SYSGEN - Put CP/M on a diskette
T:	      ESC   Return to the Main Menu
T:
T:		    Pick a subject:}
INMAX:1
*ACTION
CUR:36,20
TNR:         
CUR:36,20
A:
M:1,2,3,4,5,6,7,8,
BELLN:
Jn:*ACTION
M:1
JY:*CONTROL
M:2
JY:*DIR
M:3
JY:*ERA
M:4
JY:*REN
M:5
JY:*STAT
M:6
JY:*TYPE
M:7
JY:*PIP
J:*SYSGEN

*CONTROL
CLRS:
T:			{  Control Keys in CP/M}
T:
T:  There are four "control codes" which  have special meaning to  CP/M.  To
T:  enter a control code, hold the [CTRL] key down and press the appropriate
T:  letter key.  These are the control codes that are used by CP/M 2.2:
T: 
T:  {CONTROL-C} -  This is used with CP/M to re-initialize the system. Anytime
T:	you change diskettes while working directly with CP/M (as opposed to 
T:	through the menus), you should type control-C so that CP/M will know 
T:	that a diskette was changed.  
T:
T:  {CONTROL-P} -  This code is used to tell CP/M that  characters sent to the
T:	screen should also be sent to the printer.  This will stay in effect
T:	until you press  CONTROL-P a second time to turn off the routing  to 
T:	the printer, or until you press the RESET button on the computer.
T:
T:  {CONTROL-S} -  This is used to pause or "freeze" text that is scrolling by
T:	by on the screen, normally after a TYPE command.  Pressing any other 
T:	character will resume the scrolling on the screen.
T:
T:  {CONTROL-X} -  This will erase a mistyped command line that you have typed 
T:	at the CP/M prompt "A>" or "B>".
T:
TNR:  See your CP/M manual for more control codes. Press RETURN to continue:
A:
J:*BEGIN

*DIR
CLRS:
LF: 2
T:				{  The DIR Command}
LF: 2
T:   This command displays a list of all files on a diskette. Its format is:
T:
T:				{      DIR x:}
T:
T:   where "x:" is an optional disk drive letter (A:, B:, etc.).  If no disk 
T:   drive letter is typed, CP/M gives you a list  of the files on the drive
T:   that is currently logged.
T:
T:  {EXAMPLE -} To get a list of all the files on drive B, you would type:
T:
T:				{      DIR B:}
T:
U:*PAUSE
J:*BEGIN

*ERA
CLRS:
LF: 2
T:				{The ERA Command}
LF: 2
T:  This command is used to erase files from a diskette. The format is:
T:
T:				{ ERA FILENAME}
T:
T:  where FILENAME is any valid CP/M filename.  The filename may be preceded
T:  by a disk drive letter (e.g. ERA B:FILENAME).  If you don't type a drive
T:  letter, then CP/M assumes you mean the current drive.
T:
T: {EXAMPLE -} To erase a file called "LETTER.TXT" from drive B, type:
T:
T:			{       ERA B:LETTER.TXT}
T:
U:*PAUSE
J:*BEGIN

*REN
CLRS:
LF: 2
T:				{The REN Command}
LF: 2
T:  You may change the name that you have given to a file with the REN command.
T:  To use the REN command, you would type:
T:
T:			{      REN NEWNAME=OLDNAME}
T:
T:  Notice how the new name comes first.  This seems  illogical to some people,
T:  so you may have to get used to it.
T:
T: {EXAMPLE -}To change the name of the file "LETTER.TXT" on drive B to the new
T:  name "MEMO.TXT," you would type:
T:
T:			{  REN B:MEMO.TXT=B:LETTER.TXT}
T:
U:*PAUSE
J:*BEGIN

*STAT
CLRS:
LF: 2
T:				{The STAT Command}
LF: 2
T:This command may be used to report the size of a file, or the amount of space
T:left on a diskette.  Here are some examples of its use:
T:
T:	{STAT A:}	  - Reports space remaining on the disk in drive A.
T:	{STAT FILENAME}	  - Reports the size of the file FILENAME.
T:	{STAT B:FILENAME} - Reports the size of the file FILENAME on drive B.
T:	{STAT C:*.*}	  - Reports the size of all files on drive C.
T:
T:The characters  *.* are called "wildcards,"  meaning that they will match any
T:character name.  There are  many forms of  wildcards,  all of which are fully 
T:covered in the CP/M reference manual.
T:
T:There are other  more advanced  uses of STAT,  like making a file so it won't 
T:show up in a directory list, or so it can be looked at but not changed (read-
T:only).  These are also covered in the CP/M reference manual.
T:
U:*PAUSE
J:*BEGIN

*TYPE
CLRS:
T:
T:				{The TYPE Command}
LF: 2
T:The TYPE command is used in CP/M to display a file on the screen.  To use the
T:TYPE command, enter:
T:
T:				{ TYPE FILENAME}
T:
T:This will cause the file called "filename" to be sent to your terminal screen.
T:While  the file is rolling quickly up your screen, you can press CONTROL-S to 
T:stop this "scrolling."  To continue scrolling, press any other key.
T:
T:By preceding the TYPE command with a CONTROL-P, the file will also be sent to 
T:the printer.  Be sure the printer is turned on and on-line first.
T:{
T:EXAMPLE -}To view a file called "LETTER.TXT" on drive B, enter:
T:
T:			{      TYPE B:LETTER.TXT}
T:
T:This command will only work to display text files.  Displaying non-text files
T:such as files ending in "COM," may cause your terminal to do strange things.
T:
U:*PAUSE
J:*BEGIN
 
*PIP
CLRS:
LF: 2
T:				{The PIP Command}
LF: 2
T:This command is used to move files around.   It can be used to move files from
T:one diskette to another, from a diskette to the screen,  or from a diskette to
T:the printer.  There are many different ways to use PIP; the following examples
T:illustrate the most common forms:
T:
T:	{PIP B:=A:FILENAME} - Makes a duplicate copy on drive B, of the file
T:			      "FILENAME" on drive A.
T:{
T:  PIP C:NEWNAME=B:FILENAME} - Makes a duplicate copy on drive C, of the file
T:		              "FILENAME" on drive B, calling it "NEWNAME" on
T:		              drive C.
T:
T:	     {PIP B:=A:*.*} - Copies all files from drive A to drive B.
T:
T:Your CP/M reference manual has more  information on the PIP command, including
T:the use of "wildcards" when copying files.
T:
U:*PAUSE
J:*BEGIN

*SYSGEN
CLRS:
LF: 2
T:				{The SYSGEN Command}
LF: 2
T:This  command is used  to place a  copy of  CP/M in  its reserved  place on a
T:diskette.  The use of  this command is fully explained in the  Micro Decision
T:User's Guide.  
T:
T:Anytime you want to create a diskette that can be used to boot the Micro Dec-
T:ision from its Drive A,  you must use  SYSGEN  to place a copy of CP/M on the
T:diskette first.  This is because the  CP/M operating system always expects to
T:find a copy of itself on the diskette in drive A.
T:
T:Using a non-sysgened diskette in drive A usually results in the error message
T:"NOT A SYSTEM DISKETTE.  PRESS RESET TO TRY AGAIN."
U:*PAUSE
J:*BEGIN

*PAUSE
CUR:0,23
TNR:  Press{RETURN}to continue: {
INMAX:1
A:
E:

*RETURN
CLRS:
LF:10
T:{
TNR:Returning to the Main Menu.  Please stand by. . . 
CH:MICRO.PIL