() — AMT DAP 4.1S



CODE                      PSAM Commands                      CODE



NAME
     code - disassemble APAL or CPAL code

SYNOPSIS
     code [<instruction_offset>] [ , [<instruction_offset>] ]

DESCRIPTION
     The code command  disassembles  user-written  APAL  or  CPAL
     code.   If  no  arguments are supplied code disassembles the
     whole of the currently selected procedure.  Alternatively  a
     portion  of  the  current  procedure  can be disassembled by
     specifying upper and lower instruction offsets separated  by
     a  comma.  The  current procedure is determined initially by
     the procedure in which execution most  recently  halted  and
     thereafter by the procedure, up, down and top commands.

     Instruction offsets can be specified in decimal  or  hexade-
     cimal  form.   Hexadecimal  offsets must be preceded by '#',
     '0x' or '0X'. Offsets  can  be  specified  relative  to  the
     current  instruction by preceding the decimal or hexadecimal
     value by '+' or '-'. In addition the current instruction can
     be  referred to by '.'. Initially the current instruction is
     the  instruction  where  execution  most  recently   halted.
     Thereafter  the current instruction is modified by the code,
     procedure, up, down and top commands. code sets the  current
     instruction to the last instruction displayed and procedure,
     up, down and top set the current instruction to 0.

     The displayed form of  a  disassembled  instruction  can  be
     indicated using the following example:

               14>B1 : 00023 f2000028     J        SECT2 + #00031

     The first field ('14') is the  hexadecimal  offset  of  this
     instruction relative to the start of the procedure. The next
     field ('>') is used to indicate the next instruction  to  be
     executed.   This  field  is  blank everywhere except at that
     instruction. The next field ('B1') indicates the  breakpoint
     status of the instruction. In this case, 'B1' indicates that
     the breakpoint with reference number 1 is at  this  location
     and is currently enabled. Disabled breakpoints are indicated
     with the letter b in lower case and if no breakpoint is  set
     the  field  is blank. The colon is a separator common to all
     instructions and the next field ('00023') is the hexadecimal
     address  of  this  instruction  relative to the start of the
     program. The next two fields ('f2000028' and  'J')  are  the
     instruction  itself and its APAL mnemonic. The fields to the
     right of the APAL mnemonic contain  the  parameters  of  the
     APAL instruction and may be followed by a short comment. The
     instruction shown will cause program execution  to  jump  to
     hexadecimal  offset 00031 relative to the start of procedure
     SECT2.



AMT Release 4.1S  Last change: 8th January 1991                 1






CODE                      PSAM Commands                      CODE



     Note that the code command cannot reproduce pseudo  instruc-
     tions in their source form.

EXAMPLES
     code                     disassemble whole of  current  pro-
                              cedure.

     code #10,#20             disassemble instructions  10  (hex)
                              to  20  (hex)  inclusive of current
                              procedure.

     code -3,+6               disassemble  from  3   instructions
                              before  to 6 instructions after the
                              current instruction.

     code ,.                  disassemble the  current  procedure
                              up to the current instruction.

SEE ALSO
     breakpoints, map, procedure, top



































AMT Release 4.1S  Last change: 8th January 1991                 2
Museum
