Assembler Source-Text Commands: SAVE, LOAD and VERIFY

ZX Land #06

Assembler User Manual

(continued)

IN/OUT OPERATIONS

SAVE:xxx((SS+S)+:xxx) - save the source text and symbol table to tape under the name "xxx"
SAVE - save the source text and symbol table to tape under the previously defined name
SAVE b:xxx((SS+S)+b+:nazwa) - save the selected block of source text and symbol table to tape under the name "xxx"
SAVE b - save the selected block of source text and symbol table to tape under the previously defined name
LOAD:xxx - load source text named "xxx" from tape into the computer's memory
LOAD - load the first source-text block encountered on tape into the computer's memory
VERIFY(SS+V) - check that the recorded source text is correct

Additional functions in version 128:

SAVE a((SS+S)+a) - switch the disk drive in use from "A" to "B" and vice versa
SAVE d((SS+S)+b) - IN/OUT operations will apply to the disk drive
SAVE t((SS+S)+t) - IN/OUT operations will apply to the tape recorder

NOTE! When working with a disk drive, IN/OUT operations recognize only files with the following extensions:

"+.PTX" - for source text
"+.PCD" - for files saved from the monitor
"+.ASM" - for files in GENS format

SYMBOL TABLE

TABLE(SS+T) - display the contents of the symbol table in alphabetical order. Two types of symbols may appear:

- a defined symbol, e.g.
  SCREEN  16384
- an undefined symbol, e.g.
  LENGHT  .....

TABLE p((SS+T)+p) - display the contents of the symbol table and print it
                    on the printer
TABLE c((SS+T)+c) - delete undefined symbols from the symbol table
TABLE l((SS+T)+l) - protect the symbol table from being cleared by the CLEAR y
                    command. After this function is executed, a "*" will be
                    displayed before protected symbols
TABLE u((SS+T)+u) - unlock the symbol table. All defined symbols become
                    undefined, i.e. they lose their values

Additional function in version 128:

TABLE:xxx((SS+T)+:xxx) - display the contents of the symbol table starting
                         from the symbol named "xxx"

ADDITIONAL OPERATIONS

GENS(SS+G) - load source text in GENS format from tape or disk and convert
             it to Prometheus format

NOTE! When using a disk drive, source text in GENS format must have the
      "+.ASM" extension

ASSEMBLY(SS+A) - compile the source text
ASSEMBLY b((SS+A)+b) - compile the selected block of source text
RUN(SS+R) - compile the source text and simultaneously run the resulting
            code from the address specified in the ENT pseudo-instruction
RUN b((SS+R)+b) - compile the selected block of source text and simultaneously
                  run the resulting code from the address specified in the
                  ENT pseudo-instruction
PRINT(SS+P) - print the source text
MONITOR(SS+M) - call the monitor
MONITOR a((SS+M)+a) - call the monitor and compile the source text
BASIC(SS+B) - return to BASIC
NEW(SS+N) - return to BASIC and simultaneously clear its contents
QUIT y((SS+Q)+y) - reset the computer

Additional function in version 128:

CALC expression((SS+Y)+expression) - calculate the value of an expression
                                      and display the result in the information
                                      line. For example, CALC 10+20 displays
                                      the result as: 00030 #001E

PSEUDO-INSTRUCTIONS

ORG number — address at which the source text will be assembled
PUT number — address at which the resulting code will be placed.
              The source text is assembled as if it were to run
              from the address specified by the ORG pseudo-instruction.
EQU number — constant, e.g.
   STO  EQU 100
   ZERO EQU STO-STO
ENT number — address from which the resulting code will be run
              after the RUN command
DEFB byte,byte... — array of 8-bit numbers
DEFW word,word... — array of 16-bit numbers
DEFM "xxx" — character array
DEFM 'xxx' — character array in which the code of the last character
              is stored inverted, i.e. 128 is added to that character's code
DEFS number — reserves “number” bytes in memory

The assembler recognizes the following types of constants:

  • Decimal, e.g. 30, -25
  • Hexadecimal, e.g. #2A, -#FF
  • Binary, e.g. %10111, -%11101
  • Character, e.g. "aB", "ccc"

Special constant:

  • Reference to the current address, e.g. END EQU $

Arithmetic operations:

  • Addition (+)
  • Subtraction (-)
  • Multiplication (*)
  • Division (/)
  • Remainder (?)

NOTE! In the 128 version, the PUT pseudo-instruction allows the following bank numbers to be specified as the address at which the source text is assembled: 0, 1, 3, 4, 6, 7. For example:

   ORG 60000
   PUT 1

This means that the source text will be assembled at address 60000 in bank one.

To be continued.

Share your thoughts about the article