Documentation on PC300 MCR program
	----------------------------------

The MCR program was written to enable me to explore the P/OS system,
and to provide me with a command line interface to tasks.

This kit contains the following:-

	TECO.TSk
	COPY.TSK
	SRD.TSK
	MCR.TSK

---------------------------------------------------------------

	THE MCR PROGRAM
	---------------

The MCR program accepts command lines from the terminal, and
using its built in knowledge of a P/OS V1.0 system, can display
various features as well as dispatching the commands.

Known commands:

ROL	(default) Use the screen in scroll mode
PAG		  Clear the screen before each prompt.
CLR		  Clear the screen

HEL		  Display the help page (also on HELP key)

ASSign logicalname string
DEAssign logicalname

OPEn   location	  The OPEN function (but no deposit!) with R50 and Ascii o/p

INSTALL file[/RON] Install a task or resident library
REMOVE  name[/REG] Remove task or resident library
RUN     filename   Install, run and remove program
XQT     taskname   Run task on printer port.


DIR		   Perform a directory listing (SRD /MC/TO)

TECO
MAKE
MUNG		   all invoke TECO

DELETE
TYPE		   invoke PIP (SORRY I cant give away RSX11Mv4 PIP)

SET xxxx
SHOW xxxx
		   see various attributes below.

Other commands:

Any other command is treated as a request to spawn the named task,
ie.   >ZAP fred
spawns ZAP with command line "ZAP fred"

-------------------------------------------------------------------

SHOW COMMANDS
-------------

SHOW TERMINAL
		shows terminal attributes
SHOW PARTITIONS (*)
		displays the system PCB list
SHOW MEMORY	(*)
		displays memory layout (and may be wrong if not 128kw)
SHOW COMMONS	(*)
		shows the common block directory
SHOW ACTIVE	(*)
		shows the list of active tasks
SHOW TASKLIST	(*)
		shows the list of tasks installed in the system
SHOW LOGICALS	(*)
		displays the contents of the system logical name table
SHOW TRANSLATION logname
		translates a specified logical name
SHOW DEFAULTS
		displays default directory and device
SHOW DEVICES	(*)
		displays the list of devices known to the system
SHOW FEATURES	
		shows the list of features the P/OS exec claims to support
SHOW SYSTEM	
		displays the system configuration table.
SHOW TIME
		displays system date and time
SHOW DATE	
		ditto 

(*)	This function only works with the correct version of P/OS.

SET commands
------------

SET DEFAULT  [directory]
		establishes a new default directory
SET TERMINAL WIDE
		sets to 132 mode
	     NARROW
		sets to 80 columns
	     VT100
		as a VT100 (also other terminal types)
	     WRAP
		to wrap at eol
	     ESCSEQ
		generates escape sequences
	     FDX
		full (or half) duplex
	     CRT
		scope (or not)
	     ECHO
		echo input (or not)
	     LOWER
		enable lower case input
	     EBC
	     VFILL
	     HHT
	     FORM
	     RPA
Most of the above can also be negated by prefixing with NO
i.e.
	SET TERMINAL NOESCSEQ

and
	SET TERMINAL/WIDE TT2:
or
	SHOW TERMINAL TT2:


The locations used by the MCR program which are O/S release dependant
are stored in the form of a base address, and a list of offsets from 
that at the beginning of the task.

	in block 4, location 260 the base address ($DCBHD)
	4:262	offset to CBDHD
	 :264		  LOGHD
	 :266		  DCBHD =0
	 :270		  TCBHD
	 :272		  PCBHD
         :274		  ACTHD
	 :276		  Logical name list in SECPOL
	4:300 Address of system ID string.

these may be patched to run this on a later version of P/OS.

This version of MCR has been modified to remove the problem due
to the changes in the SWST$ directive between V1.0 and V1.1

---------------------------------------------------------------

TECO

This is a standard TECO 36, based on the RSX teco 36 kit, modified 
as follows:

TECO now understands the keys F11(ESC) F12(BS) and F13(LF). This means
that the use of Control/3 for escape is now somewhat unpredictable.
(it does mean that you can use the same keys whether or not you are 
working locally!)

in [001002] is a copy of VTEDIT, modified only be the removal of the
ESC Z instruction, since VTEDIT does not swallow all of the reply to
that.

This version of TECO understands wildcard directories (as in EN[*]*.*$$)
and alphanumeric directories.

---------------------------------------------------------------------

COPY

This is a simple, image, disk copier.  It always copies from drive 1 to
drive 2.

There is a problem that it dismounts both drives at the end of a pass, so
after you have done a copy, pull out both diskettes, and replace the source
for another copy.

SRD
---

This is a somewhat modified version of SRD, the following switches
should be noted.

/HE	A breif help message

/MC:n	Multicolumn in n columns (default 4)
/SZ	File sizes, dates... like PIP

[*]	is wild directories
[*]/SY	................... includes numeric and ZZ directories(SYSTEM)

/SD	Selective delete, prompts Y,N,Q,G and expects one of these (or
	return only) followed by a return.
/TO	Print allocation and use totals.

/HD	Print header format (default if more than just filespec printed)
	i.e.	** BIGVOLUME:[USERFILES] **
		FRED     .D  ;1
	If no other information is output, default format is
		BIGVOLUME:[USERFILES]FRED.D;1

/-DT	When selecting by dates, dont print the dates.
/DA:dd-mmm-yy	On date
/BE:dd-mmm-yy:hh:mm    Before date and time given.
/AF:...............    After  ....................
			date fields default to today, this month, year
			time defaults to 00:00

		so /AF is all of todays
		   /BE is all before today
		   /DA:9-Jan  on 9th jan this year
		   /AF::12    after noon today

+ all the usual selection criteria, as well as
/EX:wildselect	       An extra field of files not to select, e.g.

			/SE:A*/EX:AA*

--------------------------------------------------------------------