***** 101.DOC *****


THE HONEYWELL 101 SOFTWARE CONSISTS OF:

	- FORTRAN COMMAND PROTOCOL ROUTINES (APPENDIX A OF OPERATORS MANUAL)

	- FORTRAN INTERROGATE PROTOCOL ROUTINES ( "          "         "   )

	- MACRO ROUTINE FOR I/O ("IO101.MAC")

	- FORTRAN ENABLE COMMAND PROTOCOL ROUTINE ("ENC101.FTN")

	- FORTRAN ENABLE INTERROGATE PROTOCOL ROUTINE ("ENI101.FTN")

	- TEST PROGRAMS FOR ALL ROUTINES

	- LIBRARIAN FOR ALL ROUTINES ("LIB101.OLB")

	- SEVERAL COMMAND FILES FOR COMPILING AND LIBRARIAN


NAMING CONVENTIONS:

	- ALL PROGRAMS AND ROUTINES WILL END WITH "101".

	- COMMAND/INTERROGATE ROUTINES:

	  ALL COMMAND PROTOCOL ROUTINES START WITH A 'C', ALL INTERROGATE
	  PROTOCOL ROUTINES WITH A 'I'.

	  THE SECOND CHARACTER IS THE SAME AS SEND TO THE 101 FOR A SPECIFIC
	  FUNCTION (M,S,B,T,I,K,L FOR COMMAND, M,O,S,C,B,N,F,L,A FOR INTERR.).

	  THE THIRD CHARACTER IS A NUMBER, INDICATING THE MODE OF A FUNCTION
	  IN HEXADECIMAL (1-F). FOR ALL INTERROGATE MODULES THIS IS A 0.

	  EXAMPLES: "CALL CI3101(LUN,IER)" WILL INITIATE PREAMBLE.

		    "CALL IS0101(LUN,IER)" WILL RETURN THE TAPE SPEED.



	- TEST PROGRAMS:

	  ALL TEST PROGRAM NAMES START WITH A 'T'.

	  THE SECOND CHARACTER WILL BE A 'C' FOR COMMAND TEST PROGRAMS AND
	  A 'I' FOR THE INTERROGATE TEST PROGRAM.

	  FOR THE COMMAND TEST PROGRAMS THE MODE IS ALSO CONTAINED IN THE FILE
	  NAME AS THE THIRD CHARACTER.

	  EXAMPLES: "RUN TCS101" WILL TEST ALL SPEED SELECTION ROUTINES.

		    "RUN TI101"  WILL TEST ALL INTERROGATE ROUTINES.


NOTES:

	- THE MACRO I/O ROUTINE PERFORMS THE FOLLOWING FUNCTIONS:

		- FLUSHES THE TYPEAHEAD BUFFER BY MEANS OF A DETACH.

		- ATTACHES THE HONEYWELL 101.

		- WRITES THE COMMAND STRING TO THE 101 (TIME OUT = 5 SECONDS)

		- READS A STRING WITH AS SPECIAL TERMINATOR THE SPACE, SO THE
		  I/O IS FINISHED WHEN EITHER THE BYTECOUNT IS REACHED OR A
		  SPACE IS RECEIVED (WHICH IS NOT IN THE BUFFER).

		- WAITES FOR INPUT. IF ERROR, RETURN TO CALLER WITH ERROR CODE

		- ECHO WILL BE CHECKED. IF ERROR, RETRY AFTER 1 SECOND (MAX 5)

		- IF MORE CHARACTERS WERE EXPECTED, GIVE THEM TO CALLER.


	- THE ENABLE COMMAND AND -INTERROGATE ROUTINES WILL PERFORM MAX 3
	  RETRIES WHEN THE REPLY WAS <CR>,<LF>,'?'.


	- NO ARGUMENT CHECKING IS DONE FOR THE ROUTINES "CKU101" AND "CKS101".

	  THE CHANNEL NUMBER ARGUMENT IN "CKU101" COULD BE 1-32, BUT THE 101
	  RECOGNIZES ONLY 1-16.

	  THE RANGE OF THE MODE ARGUMENT IN "CKS101" IS 1-4.