.TITLE	DATBAS.HLP	78J10C		07-AUG-78/16-OCT-78


.SBTTL	INTRODUCTION

;	THIS HELP FILE IS DESIGNED TO ASSIST A USER OF THE BASIC
;	INTERPRETER  EXTENDED  WITH  THE  ROUTINES  CONTAINED IN
;	BATBAS.MAC.   THIS  EXTENSION  PROVIDES  THE  MEANS  FOR
;	READING  AND  WRITING  WORDS,  BYTES,  OR  BITS  AT  ANY
;	IMPLEMENTED UNIBUS  ADDRESS,  IDENTIFYING  THE  EXTENDED
;	BASIC INTERPRETER, AND NULLING ARRAYS.

;	THE  ARGUMENTS  FOR "PUT", "GET", "PUTB", "GETB", "SBIT"
;	AND "TBIT"  MAY  BE  CONSTANTS,  EXPRESSIONS,  VARIABLES
;	AND/OR  ARRAY  ELEMENTS.   THE  ARGUMENTS  MAY  ALSO  BE
;	EITHER DECIMAL OR OCTAL.   A  DECIMAL  ARGUMENT  MAY  BE
;	EITHER  NUMERIC  (REAL)  OR  INTEGER.  AN OCTAL ARGUMENT
;	MUST BE A STRING.  A NUMERIC  IS  ONE  OR  MORE  DECIMAL
;	DIGITS,  EITHER  POSITIVE  OR  NEGATIVE,  IN  WHICH  THE
;	DECIMAL POINT IS OPTIONAL.   AN INTEGER IS ONE  OR  MORE
;	DECIMAL  DIGITS,  EITHER  POSITIVE  OR NEGATIVE, WITH NO
;	DECIMAL POINT.   AN OCTAL STRING IS ONE OR MORE  OF  THE
;	NUMERIC CHARACTERS EXCLUDING THE "8" AND "9".

;       THESE  ROUTINES  ARE  DESIGNED  FOR  USE  ON  ANY PDP-11
;       FAMILY COMPUTER RUNNING  BASIC-11  UNDER  RT-11  V03  OR
;	LATER.

;	FOR INSTRUCTIONS TO INSTALL  THESE  EXTENSIONS  ON  YOUR
;	SYSTEM SEE A LISTING OF DATBAS.MAC.
.SBTTL	THE WORD ROUTINES


.SBTTL	PUT  -  OUTPUT A WORD TO A UNIBUS ADDRESS

;	THIS ROUTINE DEPOSITS THE VALUE OF ARGUMENT ONE  AT  THE
;	UNIBUS WORD ADDRESS OF ARGUMENT TWO.

;	CALLING SEQUENCE:

;		CALL PUT(ARG1,ARG2)

;			OCTAL			DECIMAL

;	ARG1 RANGE:	100000 TO 177777	-32768 TO -1
;			0 TO 77777		0 TO 32767

;	ARG2 RANGE:	0 TO 77776		0 TO 32766
;			100000 TO 177776	-32768 TO -2


.SBTTL	GET  -  INPUT A WORD FROM A UNIBUS ADDRESS

;	THIS ROUTINE DEPOSITS THE WORD CONTENTS  OF  THE  UNIBUS
;	ADDRESS  OF  ARGUMENT  ONE  INTO THE BASIC TEXT VARIABLE
;	NAMED IN ARGUMENT TWO.

;	CALLING SEQUENCE:

;		CALL GET(ARG1,ARG2)

;			OCTAL			DECIMAL

;	ARG1 RANGE:	0 TO 77776		0 TO 32766
;			100000 TO 177776	-32768 TO -2

;	ARG2 RANGE:	100000 TO 177777	-32768 TO -1
;			0 TO 77777		0 TO 32767
.SBTTL	THE BYTE ROUTINES


.SBTTL	PUTB -  OUTPUT A BYTE TO A UNIBUS ADDRESS

;	THIS ROUTINE DEPOSITS THE VALUE OF ARGUMENT ONE  AT  THE
;	UNIBUS BYTE ADDRESS OF ARGUMENT TWO.

;	CALLING SEQUENCE:

;		CALL PUTB(ARG1,ARG2)

;			OCTAL			DECIMAL

;	ARG1 RANGE:	200 TO 377		-128 TO -1
;			0 TO 177		0 TO 127

;	ARG2 RANGE:	0 TO 77777		0 TO 32767
;			100000 TO 177777	-32768 TO -1


.SBTTL	GETB -  INPUT A BYTE FROM A UNIBUS ADDRESS

;	THIS ROUTINE DEPOSITS THE CONTENTS OF  THE  UNIBUS  BYTE
;	ADDRESS  OF  ARGUMENT  ONE  INTO THE BASIC TEXT VARIABLE
;	NAMED IN ARGUMENT TWO.

;	CALLING SEQUENCE:

;		CALL GETB(ARG1,ARG2)

;			OCTAL			DECIMAL

;	ARG1 RANGE:	0 TO 77777		0 TO 32767
;			100000 TO 177777	-32768 TO -1

;	ARG2 RANGE:	200 TO 377		-128 TO -1
;			0 TO 177		0 TO 127
.SBTTL	THE BIT ROUTINES


.SBTTL	TBIT -  TEST A BIT AT A UNIBUS ADDRESS

;	THIS ROUTINE TESTS THE BIT NAMED IN ARGUMENT ONE AT  THE
;	UNIBUS ADDRESS OF ARGUMENT TWO.   THE RESULT IS RETURNED
;	IN THE VARIABLE NAMED IN ARGUMENT  THREE.   IF  THE  BIT 
;	TESTED  IS CLEAR, THEN ARG3=0, AND IF SET, ARG3=1.

;	CALLING SEQUENCE:

;		CALL TBIT(ARG1,ARG2,ARG3)

;			OCTAL			DECIMAL

;	ARG1 RANGE:	0 TO 17			0 TO 15

;	ARG2 RANGE:	0 TO 77776		0 TO 32766
;			100000 TO 177776	-32768 TO -2

;	ARG3 RANGE:	0 OR 1			0 OR 1


.SBTTL	SBIT -  SET A BIT AT A UNIBUS ADDRESS

;	THIS ROUTINE SETS THE BIT NAMED IN ARGUMENT ONE  AT  THE
;	UNIBUS  ADDRESS  OF  ARGUMENT  TWO TO THE VALUE GIVEN IN
;	ARGUMENT THREE.

;	CALLING SEQUENCE:

;		CALL SBIT(ARG1,ARG2,ARG3)

;			OCTAL			DECIMAL

;	ARG1 RANGE:	0 TO 17			0 TO 15

;	ARG2 RANGE:	0 TO 77776		0 TO 32766
;			100000 TO 177776	-32768 TO -2

;	ARG3 RANGE:	0 OR 1			0 OR 1
.SBTTL	THE MISCELLANEOUS ROUTINES


.SBTTL	NULL -  NULL ONE OR MORE ARRAYS

;	THIS ROUTINE NULLS OR ZEROES THE ARRAY(S) NAMED  IN  THE
;	ARGUMENT(S).   THE  ARGUMENT(S)  MAY  BE  THE NAME(S) OF
;	NUMERIC ARRAY(S), INTEGER ARRAY(S) OR  STRING  ARRAY(S).
;	ANY  NUMBER OF ARGUMENTS MAY BE GIVEN, SUBJECT TO NORMAL
;	LINE LENGTH LIMITATIONS.

;	CALLING SEQUENCE:

;		CALL NULL(ARG1(),ARG2(),...)


.SBTTL	IDEN -  OUTPUT SOFTWARE IDENTIFICATION

;	THIS ROUTINE OUTPUTS THE IDENTIFICATION OF THE  EXTENDED
;	BASIC INTERPRETER.  NO ARGUMENT IS REQUIRED.

;	CALLING SEQUENCE:

;		CALL IDEN


        .END                            ;END OF HELP FILE
