NCCP84 Console Command Processor Replacement
============================================

NCCP84 replaces the standard CCP of a KAYPRO 4-84.  It has a much
improved set of internal commands, while retaining full compatibility
with the CCP command set  [ ERA, DIR, etc... ].  It has the same
memory requirement as the CCP - so it's pretty close to a free lunch!

NCCP84 may not be distributed for commercial purposes.


1. Installing NCCP84

NCCP84 is delivered in a version which depends on a particular CP/M
release that came with the KAYPRO 4-84.  While I can easily adapt it
to other environments, I only have a particular version of CP/M 2.2G
at hand which I used here.  The install procedure will make sure
that you don't attempt to install NCCP84 on a KAYPRO that is 
incompatible.

The installation is fully automatic and extremely simple:

a.  Prepare a system disk with CP/M and copy DDT.COM and
    SYSGEN.COM to that disk.

b.  Copy all files in this library to that disk.

c.  Boot the newly prepared disk and at the A0> prompt type:

                  EX INSTALL

d.  The install procedure will ask a few simple questions, and that's
    it !!

2.  NCCP84 Commands

NCCP84 supports the full set of CCP commands and a few new unique
commands.  Some of the familiar CCP commands have improved
functionality.  The following command description uses

        d	to specify either drive A: or B:

	fn	to specify a filename which may 
		contain wildcards [ *,? ]

	ufn	to specify a fully qualified filename,
		i.e., wildcards are not allowed

	nn	a number - the range is specified with the
		command

	[]	square brackets to indicate that the command
		token is optional

	|	indicates an either/or condition, e.g., P|S
		means that you can specify either P or S in
		this position.

2.1.	CLS

	This command clears the screen and makes sure that the
	cursor is visible again.

2.2.	DEL [d:] fn

	This command is identical with ERA, and I included it
	for folks like myself who also use MS-DOS and constantly
	find themselves typing DEL to delete files.

	DEL and ERA delete the specified file(s) and display
	their names as they are deleted.

2.3.	DIR [d:][fn]

	This is the standard directory display command.

2.4.	ERA [d:] fn

	See DEL

2.5.	GO

	This restarts a program which is still in memory without
	reloading it from disk.  You could, e.g., leave your
	editor, DELete a few files, and GO back to the editor
	without having to reload it from disk.

2.6.	LDEV [P|S]

	This directs the output of the logical LST: device to
	either the Parallel or the Serial printer port of your
	KAYPRO.  I use this to switch between a letter quality
	printer and a matrix printer.  You could do the same
	thing with STAT LST:=LPT: and STAT LST:=TTY:, but that
	would require the STAT program and destroy your
	environment so that you could not GO back to where you
	left.  Handy in combination with LIST!

2.7.	LIST [d:] ufn [N]
	
	The specified file is printed on the LST: device with
	high-bit suppression, i.e., WORDSTAR files will print
	fine.  Normally LIST will start the output with a 
	formfeed, and issue formfeeds every 60 lines.  If the
	N option is specified you will have a continuous
	printout, i.e., No paging.  ^C cancels the LIST operation.


2.8.	PATH [dn][dn][dn]......[dn]     (max. 8 [dn])

	This defines the search path which NCCP84 uses to locate
	a COM file which it cannot find in the current user area
	on the default drive.  If the path specification is
	omitted, the current path will be displayed.

	The d may be A or B or $, with $ specifying the current
	drive.  The n may be a user number from 0 to 9 or $,
	with $ specifying the current user number.

	An few examples to clarify this command:

		PATH A$A0

	This means, 'if you don't find a COM file in the current
	user area on the default disk, try first to locate it in
	the same user area on drive A:, and if that fails in
	user area 0 on drive A:'

		PATH $0A0

	This means, 'look first in user area 0 of the current disk,
	and then in user area 0 on drive A:'

	Up to 8 path specifications, without intervening blanks,
	can be specified.  If the system has to search a file,
	it will display the current drive and user in front of
	the command line that you typed in.

	Let's assume, you specified:

		PATH A$A5$0$5A0

	Then, in user area 2 on drive B: you type MYCOM, the name
	of a program that is in user area 0 on drive A:
	You would see:

		B2>MYCOM

	and the B2> in the command line replaced by A2:, A5:,
	B0:, B5:, and finally A0:.  You have a visual display
	of where the program was actually found!

	(If you want to have some fun with this, specify a
	long path which alternates between A: and B: and
	type in a non-existent program name.  You will see
	the system toggling between the A: and B: drives 
	for a while before it gives up.)

2.9.	REN d:|[d:]ufn=ufn

	An improved version of the REN command.  If the target 
	file already exists, you have the option to replace it
	or cancel the REN operation.

2.10.	SAVE nn[H] ufn

	An improved version of the SAVE command.  You may
	optionally specify the number of memory pages
	in hexadecimal by using the H option.	If the file
	already exists, you have the option to replace it
	or cancel the SAVE operation.

2.11.	TYPE [d:] ufn [N]
	
	An improved version of the TYPE command.  The specified
	file is displayed on the CON: device with high-bit 
	suppression, i.e., WORDSTAR files will look fine.  Unless
	the N option is specified, TYPE will stop after each
	full screen, 23 lines, and wait for any key to continue.
	^C cancels the TYPE operation.
  
2.12.	USER [nn][H]

	A (slightly) improved version of the USER command.
	The user area can range from 0 to 15, or by using
	the H suffix, you could specify it in hexadecimal.
	If nn is omitted, 0 is the default.

2.13.	[d]:|;

	This is a convenient extension of the standard command
	to change drives.  Instead of typing B: at the prompt,
	you could use B; - with a semicolon instead of the colon.

The system comes with a default PATH specification of A0.  If you
want anything else, look into the INSTALL.BAT file.  You will
find the DDT command S22E0 followed by 41 and 30 in the next two
lines.  41 and 30 are the hex codes for A0, and you can specify
something else or a longer path as long as you don't exceed the
maximum of 8 path specifications, and don't forget to terminate
the DDT function with a line that contains a '.'

If you have questions, or if you have a CP/M version other than mine
and would like an adapted version of NCCP84, please let me know.


		Enjoy!       


		Ulrich H. Steinberg
		(212) 536-1697