
                  ппппппппппппппппппппппппппппппппппппппппп
                      SOURCER DEFINITION FILE - SAMPLE1
                  ммммммммммммммммммммммммммммммммммммммммм




 ББББББББББББББББББ Section 1: CONTROL INFORMATION   ББББББББББББББББББ

 comments are indented one or more spaces
 кФФФ Section 1 instructionsФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФП
 Г                                                                            Г
 Г Enter any of the following options, starting in the 1st column             Г
 Г  (for no options enter "none" )  Only the first letter of the              Г
 Г  command is necessary.                                                     Г
 Г                                                                            Г
 Г  Analysis option    = xxxxx Any option letters A-Z can be used.  Upper     Г
 Г                              case indicates turning option on, lower case  Г
 Г                              turns the option off.   See manual for a      Г
 Г                              complete list of options.                     Г
 Г  Code style         = xxx   Code style types include:                      Г
 Г                              com, exe, fragment, zero start,               Г
 Г                              device driver, overlay, special, new EXE,     Г
 Г                              or Windows VxD.                               Г
 Г  Drive              = x     Disk drive for output (letter a-z)             Г
 Г  Format             = xxx   Output format ASM or LST for source code or    Г
 Г                              listing output (LST is the default)           Г
 Г  Go                         When the .def file has loaded, go              Г
 Г  Header             = xxx   Enter the ascii header string (32 char max)    Г
 Г  Input filename     = xxx   Filename for input (may include disk & path)   Г
 Г  Keep segments      = xxx   When loading a file, use the file defined      Г
 Г                              segments (FILE), use the def file segments    Г
 Г                              in section 2 (DEF) or use both (BOTH)         Г
 Г                              NOTE: Specify this option prior to file input Г
 Г                              BOTH is the default, used in most cases       Г
 Г  Label              = xxx   Select label type, Decimal, Zero fill,         Г
 Г                              Segment & offset, Letter segment & offset     Г
 Г  Math               = xx    Select math co-processor options ON/OFF/AUTO   Г
 Г  Narrow ON                  For listings, do not include hex instructions  Г
 Г  None                       Use default commands only                      Г
 Г  Output filename    = xxx   Filename for output (may include drive & path) Г
 Г  Passes             = x     Select the number of passes from 2 to 9        Г
 Г  Remark             = xxx   Select remarks to be included: All, None,      Г
 Г                              Data remarks only, Interrupts & I/O only,     Г
 Г                              Others only, Except Data, Except Interrupts,  Г
 Г                              Except Others                                 Г
 Г  Segment display    = xxx   Set the segment type, OFF/HEX/NAME             Г
 Г  Target assembler   = xxx   Select the assembler the code may be re-       Г
 Г                              assembled on.  Options include MASM-4.0,      Г
 Г                              MASM-5.0, MASM-5.1, MASM-6.0, MASM-6.1,       Г
 Г                              TASM-1.0, TASM-2.X, TASM-3.0, TASM-3.1,       Г
 Г                              TASM-3.2, OPTASM, OTHER, or NONE (optional    Г
 Г                              functional, size or byte match may follow)    Г
 Г  uP                 = xxx   Select the uP from:                            Г
 Г                              8088, V20/V30, 80186, 80286, P286, 80386,     Г
 Г                              P386, 80486, P486 or AUTO for automatic       Г
 Г  Vertical lines     = xxx   For listings, select the number of lines per   Г
 Г                              page from 10 to 255 (default is 59)           Г
 Г  Words to upper case        Set upper case style (lower case is default)   Г
 Г  Xref               = xx    ON or OFF (selecting ON sets passes to 5)      Г
 Г  Zap load start     = x:x   Specifies double word start point within file  Г
 Г                                                                            Г
 РФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФй
  
 ББББББББББББББББББ Section 1: CONTROL INFORMATION   ББББББББББББББББББ
  
        <<<<<  Insert commands here (start in column 1) or "none"



 ББББББББББББББББББ Section 2: RANGE DEFINITION      ББББББББББББББББББ

 кФФФ Section 2 instructionsФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФП
 Г                                                                            Г
 Г  segment:offset = start processing location (hex)                          Г
 Г                     see note 3 at end on referencing loaded file segments  Г
 Г                                                                            Г
 Г  end offset     = ending location for segment                              Г
 Г                                                                            Г
 Г  default ds, es = default used when not overwritten by in-line code        Г
 Г                                                                            Г
 Г  segment type   = auto  - code/data, full data resolving                   Г
 Г                   code  - code, limited data resolving                     Г
 Г                   data  - data, no code processed                          Г
 Г                   stack - stack, no code processed                         Г
 Г                   rauto - ROM code/data (same as "auto") in ROM            Г
 Г                   rcode - ROM code (same as "code") in ROM                 Г
 Г                                                                            Г
 Г  segment size   = use16 for 16 bit segments (this is the default)          Г
 Г                   use32 for 32 bit segments. The text use32 may not be     Г
 Г                   abbreviated.                                             Г
 Г                                                                            Г
 РФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФй


 ББББ Segments ББББББББББББББББББББББББББ
  
  begin      end      default      seg   seg  
 seg:off     off     ds     es     type  size  
 -------     ----    ----   ----   ----- -----
        <<<<<  Insert ranges here (start in column 1) or "none"



   ББББББББББББББББББ Section 3  REFERENCE DEFINITIONS ББББББББББББББББББ

 кФФФ Section 3 instructionsФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФП
 Г                                                                            Г
 Г  segment:offset = absolute location of item (hex)                          Г
 Г                    see note 3 at end on referencing loaded file segments   Г
 Г                    optional short-cut:                                     Г
 Г                       use "+" to indicate next data offset                 Г
 Г                                                                            Г
 Г  typ            = type field                                               Г
 Г                    DB = data byte                                          Г
 Г                    DW = data word                                          Г
 Г                    DD = double word                                        Г
 Г                    DA = ascii text byte(s)                                 Г
 Г                    DS = data structure                                     Г
 Г                    SUB = subroutine reference (S can also be used)         Г
 Г                    LOC = location reference   (L can also be used)         Г
 Г                    FORCE = forced function    (F can also be used)         Г
 Г                                                                            Г
 Г  options (indicate one or more options with a comma separator, except      Г
 Г           forced functions only can have one option per line)              Г
 Г                                                                            Г
 Г     data options:  , C xxx    comment number xxx (from 1 to 3FF)           Г
 Г                    , EQU      treat label as an equate                     Г
 Г                    , DUP      duplicate same bytes/words R times           Г
 Г                    , INDEX    replace a index of the same value            Г
 Г                    , OSN      offset sub_xxx               (Sub Near)      Г
 Г                    , OSF      offset sub_xxx, seg sub_xxx  (Sub Far)       Г
 Г                    , OLN      offset loc_xxx               (Loc Near)      Г
 Г                    , OLF      offset loc_xxx, seg loc_xxx  (Loc Far)       Г
 Г                    , ODN      offset data_xxx              (Data Near)     Г
 Г                    , ODF      offset data_xx, seg data_xx  (Data Far)      Г
 Г                    , R xxxx   repeat 0 to FFFF, (FFFF bytes max)           Г
 Г                                 (i.e. dw, R 4    indicates 8 bytes)        Г
 Г                                 (see manual for additional options)        Г
 Г                    , SEG      item is a segment name (dw only)             Г
 Г                    , UNUSED   if item is never referenced, then do not use Г
 Г                                                                            Г
 Г      Location      , C xx     comment number xx (from 1 to FF)             Г
 Г         options:   , EXT      external entry point to program              Г
 Г                    , FAR      far procedure                                Г
 Г                    , NEAR     near procedure                               Г
 Г                              Note: EXT, FAR & NEAR all reset the simulator Г
 Г                    , UNUSED   if item is never referenced, then do not use Г
 Г                                                                            Г
 Г      Subroutine    , C xx     comment number xx (from 1 to FF)             Г
 Г         options:   , FAR      subroutine is defined as FAR                 Г
 Г                    , TERM     subroutine terminates (does not return to    Г
 Г                                 caller)                                    Г
 Г                    , UNUSED   if item is never referenced, then do not use Г
 Г                                                                            Г
 Г       Forced       , ANALYSIS xxxxx    Select different analysis options   Г
 Г          options:             at any time, with lower case to turn option  Г
 Г                               off, and upper case to turn option(s) on.    Г
 Г                    , CODE     switch to code mode                          Г
 Г                    , COMMENT xxxxxxxxx  A comment may be placed at any     Г
 Г                               offset within a file, replacing any auto-    Г
 Г                               matically generated comment                  Г
 Г                    , DATA     switch to data mode                          Г
 Г                    , CODE16   switch to 16 bit code mode                   Г
 Г                    , CODE32   switch to 32 bit code mode                   Г
 Г                    , ENDP     force a endp to appear after instruction     Г
 Г                    , AX=xxxx  change the value of any simulation           Г
 Г                               register ax/bx/cx/dx/bp/si/di/sp             Г
 Г                                        ds/es/ss/fs/gs                      Г
 Г                    , EAX=xxxx  change the value of any 32 bit simulation   Г
 Г                                register eax/ebx/ecx/edx/ebp/esi/edi        Г
 Г                    , EAx      LEA instruction's reference item type        Г
 Г                                 EAS for sub, EAL for location, EAD for dataГ
 Г                                 optional segment follows                   Г
 Г                    , IMMEDIATE  force an instrucion with an offset to      Г
 Г                               an immediate.                                Г
 Г                    , Ox       convert immediate value to offset            Г
 Г                               OS for sub, OL for location, OD for data     Г
 Г                               optional segment follows (cs segment default)Г
 Г                    , REG      display the internal simulation registers    Г
 Г                                                                            Г
 Г                            Forced index table analysis for calls & jumps   Г
 Г                    , SN       table type "offset sub_xx"                   Г
 Г                    , SF       table type "offset sub_xxx, seg sub_xxx"     Г
 Г                    , LN       table type "offset loc_xx"                   Г
 Г                    , LF       table type "offset loc_xxx, seg loc_xxx"     Г
 Г                           format: "seg_a:xxxx  f, sn 1234:22 34"           Г
 Г                               where 1234:22 is the location of the table   Г
 Г                               with 34h entries                             Г
 Г                                                                            Г
 Г  label field    = enter label up to 15 characters long (32 chars with EMS; Г
 Г                     label ignored for forced functions; do not place a     Г
 Г                     comma before or inside label)                          Г
 Г                                                                            Г
 Г  comment field  = a short comment can be included here (64 characters max) Г
 Г                   if a semi-colon appears, the rest of the line is ignored Г
 РФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФй
                                                                               
   ББББББББББББББББББ Section 3  REFERENCE DEFINITIONS ББББББББББББББББББ


 ЭЭЭЭ Subroutines ЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭ
  seg:off   type & options     label           comments
  -------   --------------     --------------  --------------
        <<<<<  Insert new reference definitions here (start in column 1)


 ЭЭЭЭ Locations        ЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭ
  seg:off   type & options     label           comments
  -------   --------------     --------------  --------------
        <<<<<  Insert new reference definitions here (start in column 1)


 ЭЭЭЭ Data Items ЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭЭ
  seg:off   type & options     label           comments
  -------   --------------     --------------  --------------
        <<<<<  Insert new reference definitions here (start in column 1)




 кФФФ General Notes ФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФП
 Г  Notes:                                                                   Г
 Г     1) Must have at least one entry in each section to operate properly.  Г
 Г          Use "none" if no entries are needed for a section.               Г
 Г          Separate each section with at least one line with a space in     Г
 Г          column 1.                                                        Г
 Г                                                                           Г
 Г     2) Order of entries within sections 2 & 3 is unimportant.             Г
 Г                                                                           Г
 Г     3) When a filename is specified in section 1, it is loaded and the    Г
 Г         first 250 segments can be referenced as "seg_a" to "seg_z" and    Г
 Г          "seg_aa" to "seg_az" through to the 250th segment "seg_io".      Г
 Г          These can be used anywhere a segment is required.  For example   Г
 Г          a location label can be defined as:                              Г
 Г                                                                           Г
 Г                        6234:0124  loc, Ext, C 2  temp_value_a             Г
 Г                  or:   seg_b:0124 loc, Ext, C 2  temp_value_a             Г
 Г                                                                           Г
 Г          The second entry will use the 2nd segment within the loaded file Г
 Г          An error will be generated if a segment is used beyond those     Г
 Г          specified by the file load (Consult manual for more information).Г
 Г                                                                           Г
 Г     4) Section 3 ignores blank lines or lines starting with a space in    Г
 Г          column 1, or the balance of a line where a semicolon occurs.     Г
 Г                                                                           Г
 Г     5) The following examples show acceptable forms for the same function,Г
 Г          a location entry as a external entry point with comment #2:      Г
 Г                                                                           Г
 Г          seg_a:0124 loc, Ext, C 2  temp_value_a  ; prefered format        Г
 Г          seg_a:0124 l, Ext, C 2  temp_value_a                             Г
 Г          seg_a:0124 l, E, C=2  temp_value_a      ; notes can follow       Г
 Г          seg_a:0124 l, External, C 2       temp_value_a                   Г
 Г          seg_a:124  Location, Ext, C 02   temp_value_a                    Г
 Г          seg_a:124  L, e, c 2 temp_value_a                                Г
 Г                                                                           Г
 Г     6) Upper and lower case will have no effect (except for analysis      Г
 Г          options), but is preserved for labels.                           Г
 РФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФй