-*-TAGS-*-  File: Macsix, node: Directives, Up: (Macro)Top Directives of MACRO-11 Directive Functional Significance .ASCII Translates character string to ASCII equivalents. .ASCIZ Same as ASCII, but terminates string with a zero. .ASECT Begins absolute program section .BLKB The assembler reserves a block of storage of n bytes. .BLKW The assembler reserves a block of storage of n words. .BYTE Generates successive byte data in accordance with specified argument. .CSECT Begins relocatable program section. .DSABL Disables specified function. .ENABL Enables specified function. .END Defines logical end of of source program. .ENDC Defines end of conditional assembly block. .ENDM Defines end of macro definition or repeat block. .ENDR Defines end of current repeat block. .EOT Define End of Tape condition. .ERROR Outputs diagnostic message to listing file. .EVEN Word-aligns the current location counter. .GLOBL Declares global attribute for specified symbol(s). .IDENT Labels object module with specified program version number. .IF Begins conditional assembly block. .IFF Begins subconditional assembly block. .IFT Begins subconditional assembly block. .IFTF Begins subconditional assembly block. .IIF Assembles immediate conditional assembly statement. .IRP Begins indefinite repeat block. .IRPC Begins indefinite repeat block. .LIMIT Reserves two words of storage for high and low addresses of task image. .LIST Controls listing level count and format of assembly listing. .MACRO Denotes start of macro definition. .MCALL Identifies required macro definition(s) for assembly. .MEXIT Exit from current macro definition or indefinite repeat block. .NARG Equates specified symbol to the number of argument in the macro expression. .NCHR Equates specified symbol to the number of characters. .NLIST Controls listing level count. .NTYPE Equates specified symbol to the addressing mode. .ODD Byte-aligns the current location counter. .PAGE Advances form to top of next page. .PRINT Prints specified message on command output device. .PSECT Begins specified program section. .RADIX Changes current program radix to specified radix. .RAD50 Generates data block having Radix-50 .REPT Begin repeat block and replicates it. .SBTTL Prints specified subtitle text as the second line of the assembly listing page header. .TITLE Prints specified title text as object module name in the first line of the assembly listing page header. .WORD Generates successive word data in accordance with specified arguments. Notation for Numbers and characters .RADIX r Henceforth all numbers are base r (2,4,8,or 10). ^Dn or n Take n as a decimal number. ^On Take n as an octal number. ^Bn Take n as a binary number. ^Fn Take n as a floating point number. ^Cn Take the 1's complement of n. 'p Take the ASCII value of the character p. "p1p2 Take the ASCII value of the 2 character string p1p2. Location Counter Control .=exp Set counter to value of exp (relocatable). Operator Assignment sym=exp The assembler assigns the symbol "sym" to the value of the expression "exp".  File: Macsix, Node: Input/Output Macros These special Macros must be use special Macros to assemble the program and the task file. These special Macros are: MAC SAMPLE,SAMPLE=IO:IOMAC,[]SAMPLE TKB SAMPLE=SAMPLE,IO:IO RUN SAMPLE (See How to Run a MACRO Program) * Menu: * Integer Input:: * Integer Output:: * String Input:: * String Output:: NOTE:: When INFO states that an argument to a macro should be the name o a memory location, and does NOT mention using a CPU register, it really MEANS it!. You will bomb if you use a CPU register.  File: Macsix, Node: Integer Input, up: INput/Output macros, Next: integer output INPINT RESULT,[ERROR] This Macro operator (INPINT) enters an integer value into the operand RESULT or whatever operand is used in its place. Integers are in the range of -32767 to +32767. An option in this macro is that the program can store the error in an operand called ERROR. If an error occurs, the value 0 will be placed into the operand called RESULT. ERROR CODES: 0 no error occured 1 integer overflow 2 non-numeric input entered 4 an improper terminating character was used.  File: macsix, node: Integer Output, up: INPUT/OUTPUT MACROS, prev: integer input, Next: String Input OUTINT NUMBER This Macro operator (OUTINT) is used to print an integer value to the user's terminal. The operand NUMBER is printed to the terminal and can be stored either in a memory location or in a CPU register (R0-R7). Example: ADD R2,R3 MOV R3,ANSWER OUTINT ANSWER OUTINT R2 OUTINT R3  File: Macsix, Node: String Input, Up: Input/Output Macros, Prev: Integer Output, Next: String Output INPUT BUFFER,LENGTH,[] This Macro operator (INPUT) enters a character string into the program. The operand BUFFER contains the first location of the user's buffer and should be 64 words long. LENGTH contains the number of characters that are entered at the terminal. is a string of character, enclosed in angle brackets, that is printed to the terminal as a prompt to the user. Example: INPUT BUFLOC,LENBUF,  File: Macsix, Node: String Output, Up: Input/Output Macros, Prev: String Input OUTCHR BUFFER, LENGTH This Macro operator (OUTCHR) outputs a string of characters starting at the location stored in BUFFER and printing the number of characters in LENGTH. The operand LENGTH must be in the range of 0 to 128 and determined before using this command. Character Output with Linefeed/Return PRINT [] This Macro operator (PRINT) is used to print a character string STRING followed by a return/linefeed combination. If STRING is not specified, then just a return/linefeed combination will be printed. The operand STRING must be contained in angle brackets and angle bracket can not be used within the text of the string. Example: PRINT Character Output without Linefeed/Return PROMPT [] This Macro operator (PROMPT) is used to print a character string STRING, but this string is not followed by a return/linefeed combination. This operator should be used for prompting numeric input to the terminal or when several strings are to be printed on one line. If no string is specified, a space followed by '?' will appear. The operand STRING must be contained in angle brackets and angle brackets can not be used within the text of string. Example: PROMPT PROMPT < TOO BIG FOR ONE LINE.>  TAGS: :SGAT Directives:17 Input/Output Macros:3362 Integer Input:3977 Integer Output:4617 String Input:5116 String Output:5737-*-TAGS-*- This is the file DIR.INF, which contains the topmost node of the info heirarchy. The first time you invoke INFO you start out looking at that node ("(DIR.INF)Top"). Any user may have a private node of his own in his or her own Directory. This Node must be contained in the file MYDIR.INF and must not be read protected against anyone he wishes to be able to access it.  File: Dir, Node: Top This is the top of the INFO tree This (the Directory node) gives a menu of major topics. Typing a "D" returns here, "Q" exits, "?" lists all INFO commands, "H" gives a primer for first-timers, "MLibrary", visits the LIBRARY topic, etc. ---------------------------------------------------------------------------- ***** IF THIS IS YOUR FIRST TIME USING INFO, TYPE an "H" for HELP ******* * Menu: -*- The list of major topics begins on the next line. * User Info: (user)Top Logging in, system commands, control characters * Languages, * Programming-Systems:: * Editors:: * Library:: * Utilities:: * INFO: (INFO)Top * Other:: * Bugs:: * Private or Personal Information: (Mydir)Top You can use this entry to develop a private information tree. See INFO topic to learn how. * Help: (Help)help The H command also visits this node. SUBSETS of above menu items: Languages and Programming systems: * Basic: (BASIC)Top Basic is the most widely used language on RSTS/E * Assembly, * Macro: (MACRO)Top The PDP-11 assembler. This is not the manual, just an INSTANT. * Pascal: (PASCAL)top Editors: * Teco: (teco1)Top * Edmacs: (edmacs)top * Vtedit: (Vtedit#)* CSUN Applications Library: * Index: (LIB)top RSTS/E library programs may be invoked with the LIB command. Look here for for brief descriptions of Library programs, sample executions, and instructions. Utilities: * Batch, * Que: (Que)Top * Set: (Ttyset)Top * Directory: (Direct)Top * Pip: (Pip)Top * Runoff: (Runoff)Top * Rno: (Rno)Top  File: DIR, Node: Programming-Systems, Up: TOP, Next: Editors This node describes the various programming systems available on RSTS. * Menu: * Basic: (Basic) The most heavily used language on the 11/70 NO DOCUMENTATION YET * Macro-11, * Assembler: (MACRO)Top The MACRO-11 Assembler beginner's guide. * OMSI Pascal: (Pascal)TOP * Pascal: (Pascal)TOP Everything you need to know about OMSI Pascal  File: DIR, Node: Editors, Up: TOP, Prev: Programming-Systems, Next: Library An editor lets you enter text into a file, and modify it. There are several editors available on RSTS/E. * Menu: * Teco: (TECO1)Top TECO is the customarily used editor on RSTS/E. ** Edit: Edit is the DEC standard editor. It is the poorest of the available editors, and there is no info on it here. Screen Editors: * Edmacs: (Edmacs)Top A screen editor based on the EMACS editor written at MIT by Richard M. Stallman. While this is a very powerful EMACS flavored editor, it by no means represents complete EMACS. * Vtedit: (VTEDIT#) A DEC supplied TECO macro for screen editing. Command sets are terminal dependant. There are two of them; one for DEC terminals, and one for Teleray Model 10's. Vtedit Keypad layouts: * Dec terminals: (VTKPVT#) * Teleray terminals: (VTKP10#)  File: Dir, Node: Library, Up: Top, Prev: Editors, Next: Utilities * Menu: * What the library is: (LIBWHT) * How to use it: (LIBHOW) * Index: (LIB)Top This is the Complete index to the programs in the CSUN Applications Library.  File: Dir, Node: Utilities, Up: Top, Prev: Library * Menu: * QUE, * Batch: (Que)Top Que controls the system Batch processor * Terminal Support, * Set: (TTYSET)Top The TTYSET program lets you configure the system to match your terminal, Load Function Keys, etc. File Utilities: * Directory: (DIRECT)Top The directory Listing program * Pip: (Pip)Top DEC's Peripheral Interchange Program Useful for copying, printing, manipulating files and directories Text Formatters: * Runoff: (Runoff)* The standard DEC text formatter. * RNO: (RNo)Top Another formatter.  File: Dir, node: Bugs, Up: top To report INFO and EDMACS bugs, use the command: MU [44,12]BUG name where "name" is the subject of your report. Once you see the bug report header at the top of the screen, type in your report, terminating your input with a Control-C. To read existing bug reports, select one of the following menu items: * Menu: * INFO bug reports: (INFO!)* * EDMACS bug reports: (Edmacs!)* * Other bug reports: (Other!)* BUG may be used from any Teleray 10, VT52, or Vt100 type terminal.  File: DIR, Node: Other, Up: Top You can access general RSTS/e help topics for now with menu item SYSHELP * Menu: * syshelp: (hlpdir)  TAGS: :SGAT Directives:17 Input/Output Macros:3362 Integer Input:3977 Integer Output:4617 String Input:5118 String Output:5739 Top:7785 Programming-Systems:9423 Editors:9859 Library:10797 Utilities:11048 Bugs:11657 Other:12201