home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / zsys / znode-12 / a / basdocs.lbr / BASCOM2.DQC / BASCOM2.DOC
Encoding:
Text File  |  1993-06-12  |  5.9 KB  |  141 lines
  1. ******************************************************************************
  2. *                                                                            *
  3. * >>>>>>>>>>>>>>>>>>>>     HINT'S  FOR USING BASCOM    <<<<<<<<<<<<<<<<<<<<< *
  4. *                                                                            *
  5. ******************************************************************************
  6. *                                                                            *
  7. *                    CONTRIBUTED TO BY: WILLIAM L. MABEE, CRNA               *
  8. *                                                                            *
  9. ******************************************************************************
  10.  
  11. A GOOD PLACE TO START IF YOU ARE UNFAMILIAR WITH BASCOM IS A BOOK BY MURRAY L.
  12. LESSER CALLED "USING MICROSOFT COMPILED BASIC". PUBLISHED BY MCGRAW HILL. THE
  13.         PRIMARY THRUST OF THIS BOOK IS AN INTRODUCTION TO STRUCTURED 
  14.                             'BASIC PROGRAMING'.
  15.  
  16. THE BOOK ALSO DESCRIBES PROGRAMMING IN BASIC WITHOUT THE USE OF LINE NUMBERS,
  17. IF THE SOURCE CODE IS TO BE COMPILED WITH BASCOM. A GOOD DEAL OF TIME IS ALSO
  18. SPENT DESCRIBING ASSEMBLY LANGAUGE SUBROUTINES CALLED FROM BASCOM PROGRAMS.
  19.  
  20. HIGHLIGTS OF THE SWITCHES AVAILABLE FOR 'BASCOM.COM' AND 'L80.COM' AVAILABLE 
  21. FROM THE BOOK ARE AVAILABLE BELOW.
  22.  
  23. ##############################################################################
  24.  
  25. SWITCHES TO USE WITH BASCOM.COM:
  26.  
  27. /C SWITCH - TELLS BASCOM NOT TO WORRY ABOUT LINE NUMBERS
  28.             ( /C AND /4 MAY NOT BE USED TOGETHER )
  29.  
  30. /D SWITCH - WILL PROVIDE RUN-TIME ERROR MESSAGES ABOUT ARRAY SUBSCRIPTS OUT 
  31.             OF RANGE. (HOWEVER YOU GET A LARGER, SLOWER '.COM' FILE.)
  32.  
  33. /E SWITCH - USE IF RESUME (LINE-NUMBER) IS USED
  34.             GENERATES LESS CODE AND EXECUTES FASTER THAN /X
  35.  
  36. /L SWITCH - WILL FURNISH A DETAILED .PRN FILE
  37.  
  38. /N SWITCH - DOES NOT LIST GENERATED OBJECT CODE
  39.  
  40. /O SWITCH - IT IS POSSIBLE TO COMPILE WITHOUT BCLOAD AN BRUN.COM. ADD THE 'O/'             SWITCH TO DO SO. THIS ADDS OBSLIB.REL TO THE COMMAND LINE.
  41.             BCLOAB AND BRUN ARE RUN TIME PACKAGES
  42.             OBSLIB CONTAINS ITS OWN RUN TIME OPS
  43.             
  44. /S SWITCH - WILL WRITE QUOTED STRINGS OF MORE THAN FOUR CHARACTERS, AS THEY
  45.             ARE ENCOUNTERED.
  46.  
  47. /X SWITCH - USE IF RESUME NEXT OR RESUME WITHOUT LINE NUMBER IS USED. THIS IS
  48.             SLOWER THAN THE 'E/' SWITCH AND GENERATES MORE OBJECT CODE. BUT IT             IS REQUIRED FOR ANY FORM OF RESUME OTHER THAN RESUME (LINE NUMBER).
  49. /Z SWITCH - ALLOWS BASCOM TO MAXIMIZE EFFICIENCY IF YOU ARE USING A Z-80 BASED             SYSTEM. (DON'T USE IF YOU HAVE AN 8080 OR 8085)
  50.  
  51. /4 SWITCH - RECOGNIZE MICROSOFT 4.51 INT. VERSION CONVENTIONS
  52.  
  53. ##############################################################################
  54.  
  55. SWITCHES TO USE WITH L80.COM
  56.  
  57. /G SWITCH - WILL CAUSE IMMEDIATE EXECUTION WHEN LINK-80 IS FINISHED. (NO '.COM'            PROGRAM IS FILED.
  58.  
  59. /R SWITCH - IS USED FOR ASSEMBLING CALLED SUBROUTINES
  60.  
  61. /Y SWITCH - WILL WRITE A '.SYM' FILE FOR ZSID OR SID
  62.  
  63. ##############################################################################
  64.  
  65. A TYPICAL COMMAND LINE FOR BASCOM IS: BASCOM =PROGNAME.BAS/Z/C/O
  66.  
  67. A TYPICAL COMMAND LINE FOR L80 IS:    L80 PROG/E,PROG/N
  68. IF NOT ON THE DEFAULT DRIVE      :    L80 B:PROG/E,B:PROG/N
  69.  
  70. ##############################################################################
  71.  
  72. OTHER TIPS:
  73. -----------
  74.  
  75. 1.) DECLARE AS MANY NUMERIC VARIABLES AS POSSIBLE AS INTIGERS RATHER THAN REAL
  76.  
  77. 2.) BE SURE TO DECLARE INDEX VARIABLES IN FOR-NEXT LOOPS AS INTEGERS.
  78.     (USING THE DEFAULT SINGLE PRECISION SLOWS EXECUTION)
  79.  
  80. 3.) LINE NUMBERS ARE UNNECCESSARY IN BASCOM
  81.  
  82. 4.) ARRAYS MUST BE DIMENSIONED WITH INTEGER CONSTANTS NOT VARIABLS.
  83.  
  84. 5.) DEF FN ARE CODED AT COMPILE TIME AND EVALUATED AT RUN TIME
  85.  
  86. 6.) FOR SAFETY "CLEAR" SHOULD NEVER BE USED.
  87.  
  88. 7.) IF COMMON IS USED:
  89.     THE COMMON STATEMENT MUST APPEAR BEFORE ANY EXECUTABLE STATEMENT
  90.     BUT AFTER ANY TYPE DECLARATION OR ARRAY DIM STATEMENTS
  91.  
  92. 8.) BCLOAD AND BRUN MUST BE ON THE SAME DRIVE AS THE SOURCE CODE AT
  93.     COMPILATION TIME IF THE O/ SWITCH IS NOT SELECTED
  94.     (I'M STILL HAVING TROUBLE WITH THIS ANYONE HAVE THE ANSWER ?)
  95.  
  96. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>><<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
  97.  
  98. :BASIC Compiler Error Messages
  99. Compile-Time Fatal Errors
  100.  
  101.      SN   Syntax error             OM   Out of memory
  102.      SQ   Sequence error           TM   Type mismatch
  103.      TC   Too complex              BS   Bad subscript
  104.      LL   Line too long            UC   Unrecognizable command
  105.      OV   Math overflow            /0   Division by zero
  106.  
  107.      DD   Array already dim'ed     FN   FOR/NEXT error
  108.      FD   Function already def     UF   Function not defined
  109.      WE   WHILE/WEND error         /E   Missing /E switch
  110.                                    /X   Missing /X switch
  111.  
  112. Compile-Time Warning Errors
  113.  
  114.      ND   Array not dimensioned    SI   Statement ignored
  115.  
  116. Run-Time Error Messages
  117.  
  118.       2   Syntax error             52   Bad file number
  119.       3   RETURN without GOSUB     53   File not found
  120.       4   Out of data              54   Bad file mode
  121.       5   Illegal function call    55   File already open
  122.       6   Floating/Integer ovfl    57   Disk I/O error
  123.  
  124.       9   Subscript out of range   58   File already exists
  125.      11   Division by zero         61   Disk full
  126.      14   Out of string space      62   Input past end
  127.      20   RESUME without error     63   Bad record number
  128.      21   Unprintable error        64   Bad filename
  129.  
  130.      50   Field overflow           67   Too many files
  131.      51   Internal error
  132. ________________________________________________________________________
  133.  
  134. THIS SHOULD HELP YOU GET STARTED WITH BASCOM. FURTHER QUESTIONS CAN BE
  135. ANSWERED IN YOUR USER'S MANUAL OR THE BOOK MENTIONED ABOVE.
  136.  
  137.                  /X   Missing /X switch
  138.  
  139. Compile-Time Warning Errors
  140.  
  141.      ND   Arr