home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / fortran / library / fatdos / fatd0.doc < prev    next >
Text File  |  1988-04-15  |  11KB  |  363 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.                                   FAT-DOS 1.0
  25.  
  26.                         Fortran Accessory Tools for DOS
  27.  
  28.  
  29.                           Analytic Software Associates
  30.                         Copyright (c) 1987 Marc A. Norton
  31.                               All Rights Reserved.
  32.  
  33.  
  34.  
  35.                                 FAT-DOS 1.0
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.                                 Table of Contents
  43.                                 -----------------
  44.  
  45.         Description                                             Page
  46.         -----------                                             ----
  47.  
  48.         Table of Functions                                      i
  49.  
  50.         About Shareware                                         iii
  51.  
  52.         Introduction                                            iv
  53.  
  54.         Memory Management                     A-1
  55.  
  56.     File Management                     B-1
  57.  
  58.     Keyboard Input                         C-1
  59.  
  60.     Screen Output                         D-1
  61.  
  62.     Disk Control                        E-1
  63.  
  64.     Directory Control                    F-1
  65.  
  66.     General                            G-1
  67.  
  68.     Date & Time                        H-1
  69.  
  70.     Other Device I/O                    I-1
  71.  
  72.     Ctrl-C/Break Trapping                    J-1
  73.  
  74.         Copyright (c) 1987 Marc A. Norton  All Rights Reserved.
  75.  
  76.  
  77.         DEC 1987                FAT-DOS 1.0                   Page i
  78.  
  79.  
  80.  
  81.  
  82.                 Table of Functions - DOS Library
  83.                 ----------------------------------
  84.  
  85.         No.     Function                                        Page
  86.         ---     --------                                        ----
  87.         1       ALLMEM(NPAR,SEG,MAXPAR)                A-1
  88.         2       FREMEM(SEG,IERR)                A-1
  89.         3       MODMEM(NPAR,SEG,MAXSEG,IER)            A-2
  90.         4       PEEKB(OFF,SEG,VALUE)                A-2
  91.     5    PEEKW(OFF,SEG,VALUE)                A-3
  92.     6    PEEKL(OFF,SEG,VALUE)                A-3
  93.     7    POKEB(OFF,SEG,VALUE)                A-4
  94.     8    POKEW(OFF,SEG,VALUE)                A-4
  95.     9    POKEL(OFF,SEG,VALUE)                A-5
  96.     10    OPFILX(FILE,MODE,HANDLE,IER)            B-1
  97.     11    CRFILX(FILE,ATTRIB,HANDLE,IER)            B-1
  98.     12    CLFILX(HANDLE,IER)                B-2
  99.     13    DLFILX(FILE,IER)                B-2
  100.     14    RNFILX(OLDFILE,NEWFILE,IER)            B-2
  101.     15    SCHFIL(SFILE,FFILE,ATTRIB,RATT,RTIME,RDATE,    B-3
  102.             RSIZE,IER)    
  103.     16    SCHFL2(FFILE,RATT,RTIME,RDATE,RSIZE,IER)    B-3
  104.     17    CRTEMP(PATH,ATTRIB,HANDLE,IE            B-4
  105.         18    DUPHND(OLDHANDLE,NEWHANDLE,IER)            B-4
  106.     19    GETFDT(HANDLE,DATE,TIME,IER)            B-5
  107.     20    SETFDT(HANDLE,DATE,TIME,IER)            B-5
  108.     21    INTDAT(DATE,YR,MO,DAY)                B-6
  109.     22    INTTIM(TIME,HRS,MIN,SEC)            B-6
  110.     23    GETFA(FILE,ATTRIB,IER)                B-6
  111.     24    SETFA(FILE,ATTRIB,IER)                B-7
  112.     25    MOVPTR(HANDLE,METHOD,OFFSET,IER)        B-7
  113.     26    RDFILX(BUFFER,NBYTES,HANDLE,IER)        B-8
  114.     27    WTFILX(BUFFER,NBYTES,HANDLE,IER)        B-8
  115.     28    CHINP(KEY)                    C-1
  116.     29    UCHINP(KEY)                    C-1
  117.     30    CHINWE(KEY)                    C-1
  118.     31    KBDIS(STATUS)                    C-2
  119.     32    CLRCON()                    C-2
  120.     33    GETSTR(STRING,NBYTES,IER)            C-2
  121.     34    CHOUT(KEY)                    D-1
  122.     35    PUTSTR(STRING,NBYTES,IER)            D-1
  123.     36    DSKRST()                    E-1
  124.     37    SETDD(DRIVE,NUMDRIVES)                E-1
  125.     38    GETDD(DRIVE)                    E-1
  126.     39    GETAID(DRIVE,SPC,FATIB,SOS,NC)            E-2
  127.     40    SETVF(VALUE)                    E-2
  128.  
  129.  
  130.         Copyright (c) 1987 Marc A. Norton   All Rights Reserved.
  131.  
  132.         DEC 1987                FAT-DOS 1.0                   Page ii
  133.  
  134.  
  135.  
  136.  
  137.                 Table of Functions - DOS Library
  138.                 ----------------------------------
  139.  
  140.         No.     Function                                        Page
  141.         ---     --------                                        ----
  142.     41    GETVF(VALUE)                    E-2
  143.     42    GETFDS(DRIVE,SPC,NAC,BPS,CPD,IER)        E-3
  144.     43    SETDTA(LDTA)                    E-3
  145.     44    GETDTA(LDTA)                    E-3
  146.     45    MKDIR(DIRNAME,IER)                F-1
  147.     46    RMDIR(DIRNAME,IER)                F-1
  148.     47    SETDIR(DIRNAME,IER)                F-1
  149.     48    GETDIR(DRIVE,DIRNAME,IER)            F-2
  150.     49    COMLIN(STRING)                    G-1
  151.     50    GETDOS(MAJOR,MINOR)                G-1
  152.     51    BEEP()                        G-1
  153.     52    GETPSP(SEGMENT)                    G-1
  154.     53    SETNUL(STRING)                    G-2
  155.     54    GETTIM(HRS,MIN,SEC,HSEC)            H-1
  156.     55    SETTIM(HRS,MIN,SEC,HSEC)            H-1
  157.     56    GETDAT(YR,MO,DAY)                H-1
  158.     57    SETDAT(YR,MO,DAY)                H-2
  159.     58    AUXINP(VALUE)                    I-1
  160.     59    AUXOUT(VALUE)                    I-1
  161.     60    PRNOUT(VALUE)                    I-1
  162.     61    INPB(PORT,VALUE)                I-2
  163.     62    INPW(PORT,VALUE)                I-2
  164.     63    OUTPB(PORT,VALUE)                I-2
  165.     64    OUTPW(PORT,VALUE)                I-2
  166.     65    GETCBF(FLAG)                    J-1
  167.     66    SETCBF(FLAG)                    J-1
  168.     67    TRAPCC(FLAG)                    J-2
  169.     68    TRAPCB(FLAG)                    J-2
  170.  
  171.         Copyright (c) 1987 Marc A. Norton   All Rights Reserved.
  172.  
  173.  
  174.  
  175.         DEC 1987                FAT-DOS 1.0                   Page iii
  176.  
  177.  
  178.  
  179.                                 About Shareware
  180.                                 ---------------
  181.  
  182.  
  183.  
  184.            The FAT-DOS software is sold as shareware via user groups,
  185.         "Public Domain Software Entities", and directly from me. This
  186.         does not mean the software is free, it is not.
  187.  
  188.            The software is distributed with a nominal charge, so you
  189.         may try the software out first, and be assured it works
  190.         with your system, and that you wish to use it. Once you are
  191.         satisfied it's adequate and meets your needs, I the developer
  192.         expect you to register with me and pay the registration fee.
  193.  
  194.            The entire shareware concept relies on the faith of software
  195.         developers, and the honesty of users. If you abuse the privilege
  196.         of shareware software, you  risk not having any shareware, so make
  197.         your choices carefully regarding your need to register for this
  198.         or any other shareware product.
  199.  
  200.            The FAT-DOS shareware package may be freely distributed by
  201.         anyone, so long as not more than $12 is charged for duplicating
  202.         the disk and/or manual(the manual is on the disk). In fact this
  203.         is the best advertising I could have, so I encourage you to
  204.         make a copy and give it to a friend, or your user group, or
  205.         anyone else. Make sure you give them an unaltered version, with
  206.         the manual on the disk.
  207.  
  208.            The registered users of the FAT-DOS package will be notified
  209.         of specific errors, corrections and updates by mail. There is also
  210.         telephone support for registered users. 
  211.  
  212.         Shareware Disk             $ 12.00    Manual on disk
  213.         Registration & Disk        $ 35.00    Manual on disk
  214.     If you bought your share disk from me, I'll register you for $25.00.
  215.         Printed Manual             $ 15.00
  216.         Assembly source, DOS.lib   $ 35.00    Requires A86 assembler.
  217.         Upgrade Disk               $ 12.00    Manual on disk
  218.  
  219.     Maryland residents add 5% sales tax.
  220.  
  221.           For Info call 301-441-9235
  222.           To order, send check or mony order, and state items desired, to:
  223.                 Analytic Software Associates
  224.                 P.O. Box 425
  225.                 Greenbelt MD  20770
  226.  
  227.  
  228.         Copyright (c) 1987 Marc A. Norton   All Rights Reserved.
  229.  
  230.  
  231.         DEC 1987                FAT-DOS 1.0                   Page iv
  232.  
  233.  
  234.  
  235.                                 Introduction
  236.                                 ------------
  237.  
  238.            The Fortran Accessory Tools for DOS(FAT-DOS) software
  239.         package offers the Fortran programmer access to the low level
  240.         DOS functions.  FAT-DOS requires DOS 2.0 or above, and a compatible 
  241.     ROM-BIOS (most are today).
  242.  
  243.            The FAT-DOS library supports the MS-Fortran compilers versions
  244.     3.0 thru 4.01. Each function can be called as is from MS-Fortran.
  245.  
  246.            The FAT-DOS package supports the Lahey-F77L compiler. The DOS 
  247.     library functions may be called from Lahey Fortran. You must declare 
  248.     each DOS.lib function using the MSEXTERNAL keyword, and do so in each 
  249.     routine using the DOS.lib functions. 
  250.  
  251.            The assembly source code for the FAT-DOS library functions is
  252.         available to anyone interested in modifying them, as a separate
  253.         disk for $35.00 . They are copyrighted and are not to be distributed. 
  254.  
  255.        You may modify and use them for personal purposes only. The assembly
  256.         source requires the A86 assembler written by Eric Isaacson, and is also
  257.         available as shareware. I recommend it over all other assemblers, its 
  258.     very inexpensive compared to all others, and far superior as well. It 
  259.     is also, for the novice, easier to use than any of the others I've seen.
  260.  
  261.            The FAT-DOS package will be modified and improved as needed.
  262.         If you have any suggestions please write them down and send them in. 
  263.     Also if you have any problems, write or call. If you write, send a 
  264.     sample of the code you have trouble with .
  265.  
  266.            The registered users of FAT-DOS will be notified of upgrades
  267.         to the package by mail. Upgraded versions of FAT-DOS will be
  268.         available on disk for about the same charge as the current shareware
  269.         disk. The registered users will also receive telephone support for
  270.         problems and questions related to FAT-DOS. 
  271.  
  272.            The FAT-DOS package is currently being adapted for several
  273.         other compilers. If you have a vested interest in another compiler
  274.      please write and let me know, and I will attempt to release the most 
  275.     popular versions first.
  276.  
  277.  
  278.         Copyright (c) 1987 Marc A. Norton  All Rights Reserved.
  279.  
  280.  
  281.         DEC 1987                FAT-DOS 1.0                   Page v
  282.  
  283.  
  284.  
  285.  
  286.  
  287.         Order Information:
  288.         ------------------
  289.  
  290.         Shareware Disk             $ 12.00 Manual on disk
  291.         Registration & Disk        $ 35.00 Manual on disk
  292.     If you bought your share disk from me, I'll register you for $25.00.
  293.         Printed Manual             $ 15.00
  294.         Assembly source, DOS.lib $   35.00 Requires A86 assembler
  295.         Upgrade Disk               $ 12.00 Manual on Disk
  296.  
  297.     Maryland residents add 5% sales tax.
  298.  
  299.           For information call 301-441-9235
  300.  
  301.           To order, send check or money order, and state items desired to:
  302.  
  303.                 Analytic Software Associates
  304.                 P.O. Box 425
  305.                 Greenbelt, MD  20770
  306.  
  307.  
  308.         Copyright (c) 1987 Marc A. Norton   All Rights Reserved.
  309.  
  310.  
  311.  
  312.  
  313.         DEC 1987                FAT-DOS 1.0                   Page vi
  314.  
  315.  
  316.  
  317.         Using Lahey Fortran with FAT-DOS:
  318.         -----------------------------------
  319.  
  320.            The Lahey compiler simply requires that the DOS library
  321.         functions be declared as MSEXTERNAL as follows, and then called
  322.         normally.
  323.         integer*2    Ier
  324.                 character*60 string
  325.                 msexternal setdir,getdir,...etc
  326.                 call getdir(Int2(0),string,Ier)
  327.                 call setdir('MyDir'//char(0),Ier)
  328.  
  329.  
  330.     DEFINITION OF AN ASCIIZ STRING:
  331.     -------------------------------
  332.        Any character string which is terminated with the Null
  333.     character. In Fortran this is done as follows:
  334.  
  335.         character*30 FileName
  336.         FileName = 'MyFile.Dat'//char(0)
  337.  
  338.  
  339.         Note: I recommend the A86 assembler for any assembly language
  340.               work, novice or pro.  Below is Eric's address & phone number.
  341.  
  342.         Eric Isaacson
  343.         416 E. University Street
  344.         Bloomington, IN 47401
  345.         (812)-339-1811
  346.  
  347.  
  348.  
  349.  
  350.         Useful References:
  351.         ------------------
  352.  
  353.         1) The Peter Norton Programmer's Guide to the IBM PC
  354.            by Peter Norton
  355.  
  356.         2) Advanced MS-DOS
  357.            by Ray Duncan
  358.  
  359.  
  360.  
  361.         Copyright (c) 1987 Marc A. Norton  All Rights Reserved.
  362.  
  363.