home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / MFKASM.ZIP / README.DOC < prev    next >
Text File  |  1992-08-04  |  4KB  |  77 lines
  1. Morton F. Kaplon CIS:73457,437
  2. 1047 Johnston Drive
  3. Bethlehem PA 18017
  4. (215)758-9686
  5. Tue  08-04-1992
  6.  
  7. The files included here represent my effort in utilizing Assembler for
  8. programming in OS/2 2.0 .
  9.  
  10. I use MASM 6.0 as the Assembler and I can highly recommend it. It has
  11. some very useful constructs which make programming in Assembler almost
  12. as easy as using "C", I think. Perhaps in some cases even easier since
  13. I believe the use of Pointers in Assembler is much clearer than in
  14. C, especially if they are several levels deep.
  15.  
  16. The files included are listed below, each with a brief explanation
  17.  
  18. 286_dos.mac    Macros used for ASM files using OS2286.LIB
  19. 386_dos.mac    Macros used for ASM files using OS2386.LIB and DOS... calls
  20. 386_win.mac    Macros used for ASM files using OS2386.LIB and WIN... calls
  21. ccl-w386.cmd   Cmd file used for assembling and linking for PM programs
  22. cdl-w386.cmd   Cmd file used for creating a DLL for PM programs
  23. equates.inc    Equates required for 16 bit programs.
  24. equs386.inc    Equates required for 32 bit programs.
  25. get-cmd.asm    32 bit program demonstrating accessing Command Line
  26. get-cmd.exe    Executable for above
  27. gethotky.asm   32 bit program getting info on Session Manager Hot Keys
  28. gethotky.exe   Executable for above
  29. kb-rate.asm    32 bit program to set Keyboard rates
  30. kb-rate.exe    Executable for above
  31. mlc-l286.cmd   Command file for assembling-linking 16 bit programs
  32. mlc-l386.cmd   Command file for assembling-linking 32 bit VIO programs
  33. mlc-w386.cmd   Command file for assembling-linking 32 bit PM programs
  34. mlcal286.cmd   As mlc-l286.cmd but with MAP and LINE options on
  35. mlp-l386.cmd   Command file for assembling-linking 32 bit PM programs
  36. pm-tmplt.asm   32 bit program illustrating PM and setting HOOK into dll
  37. pm-tmplt.exe   Executable for above
  38. readme.doc     This document
  39. shutdown.asm   16 bit program to shutdown system from command line
  40. shutdown.exe   Executable for above
  41. tsr_hook.asm   32 code for creating a dll for use with pm-tmplt
  42. tsr_hook.def   definition file for above
  43. tsr_hook.dll   dll created for;!! above must be in \os2\dll
  44.  
  45. The *.cmd files are intended to make assembling and linking easy. They
  46. are created in consonance with my set-up which has my ASM source files
  47. on my D: drive  in a directory \os2_asm
  48.  
  49. One uses the appropriate CMD file with the source file as its target
  50. without any extension.
  51.  
  52. Crucial to the effort are the *.mac files which contain a variety of MACROS.
  53. All MACROS begin with a "$" and when calling a  system function use the same
  54. name. In addition to MACROS for the various system calls, they contain also
  55. some macros called  $PRINTF which are intended to be "sort of like" the
  56. printf function in "C". Their use is documented in the files.
  57.  
  58. The macros contain some ASCII <--> Numerical conversion routines for
  59. unsigned integers.
  60.  
  61. I have added to the Library (and made changes in its concept ) as I required
  62. additional calls to OS/2 functions. Thus they are far from complete and
  63. there may also be ( Iam sure ) some inconsistencies in format.
  64.  
  65. Since I started with OS/2  1.3  and MASM (which had a 1.3 DOS library)
  66. I had to make changes in  moving to OS/2 2.0.
  67.  
  68. Note in particular that the MACROS calling functions using the 286
  69. library are quite different than those using the 386 library. The former
  70. uses the PASCAL convention and the latter the C convention which are
  71. required for the libraries IBM supplied.
  72.  
  73. I would appreciate any comment and/or feedback.
  74.  
  75. Morton F. Kaplon
  76.  
  77.