home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / emulate / systems / pc370 / doc / intro.doc < prev    next >
Text File  |  1988-01-06  |  8KB  |  160 lines
  1.  
  2. INTRO.DOC Introduction to PC/370
  3.  
  4. Copyright 1988 Donald S. Higgins
  5.  
  6. Don Higgins
  7. 6365 - 32 Avenue North
  8. St. Petersburg, Florida 33710
  9.  
  10. E-MAIL via CompuServe 73047,1113
  11.  
  12. The PC/370 package is a PC shareware package which supports the
  13. assembly, link edit, and execution of IBM 370 assembler programs
  14. on a PC with 256k and MS-DOS release 2.0+.  See READ.ME file in
  15. root directory for registration information.
  16.  
  17. The PC/370 package consists of four main programs:
  18.  
  19.   1.  M370.COM macro preprocessor which reads macro assembler file
  20.       and produces expanded basic assembler source code.
  21.  
  22.   2.  A370.EXE is an IBM 370 cross assembler which reads 370 source
  23.       code file and produces object code file plus optional listing
  24.       file.
  25.  
  26.   3.  L370.EXE is an IBM 370 cross linkage editor which reads object
  27.       code and produces a directly executable 370 native machine code
  28.       file plus optional CSECT listing file.
  29.  
  30.   4.  E370R42.EXE is an IBM 370 machine code emulator which is
  31.       dynamically invoked at execution time to support execution of
  32.       370 native machine code including the standard problem state
  33.       instruction set plus packed decimal and floating point
  34.       instructions.  Direct execution of E370 makes it resident to
  35.       eliminate the time required to dynamically load it at each 370
  36.       program execution time, and to also support calls to 370
  37.       subroutines from Micro Focus COBOL/2 programs running under
  38.       the default real MS-DOS mode on any 80x86 machine or the
  39.       extendedmemory XM protected mode on 80286 or 80386 machines.
  40.  
  41. The package also comes with several 370 assembler language utilities
  42. including:
  43.  
  44.   1.  SEE.COM      -  full screen text editor with PFS:Write and
  45.                       Wordstar keystroke compatibility.
  46.   2.  PRINTDOC.COM -  format utility to print documentation with
  47.                       page numbers.
  48.   3.  T370.COM     -  object code translator to allow uploading 370
  49.                       object code files for direct OS/VS linkage
  50.                       editing on 370 mainframe without reassembly.
  51.  
  52. The PC/370 package consists of the following component directories:
  53.  
  54.   1.  R42  - root directory containing all PC/370 executable code.
  55.   2.  DOC  - documentation ASCII text files.
  56.   3.  BAT  - demo command procedures plus install procedure.
  57.   4.  LIB  - 370 source code for L370.LIB system subroutine library.
  58.   5.  CPY  - 370 source code for copy members.
  59.   6.  MAC  - 370 source code for macros.
  60.   7.  CBL  - 370 source code for COBOL 370 subroutine demo.
  61.   8.  DEMO - 370 source code for demo programs.
  62.   9.  UTIL - 370 source code for utilities SEE, PRINTDOC, and T370.
  63.  
  64. On 3.5" diskette, all of the above directories are on single disk.
  65. On 5.25" diskettes, 3 volumes are required starting with the
  66. R42 volume which contains BAT\INSTALL.BAT command file.
  67.  
  68. The PC/370 documentation consists for the following machine readable
  69. files which can be printed via the utility PRINTDOC.COM:
  70.  
  71.   1.  INTRO.DOC    - overview of product.
  72.   2.  HELP.DOC     - common questions and answers
  73.   3.  USER.DOC     - program options required to use all of the PC/370
  74.                      facilities at the application programmer level.
  75.   4.  SYSTEM.DOC   - program options available for use by system
  76.                      programmers.
  77.   5.  MACRO.DOC    - macro preprocessor options plus included macros.
  78.   6.  UTILITY.DOC  - utility program options.
  79.   7.  HISTORY.DOC  - history of PC/370 releases and features
  80.   8.  PTF.DOC      - private temporary fixes for previous releases.
  81.  
  82. The PC/370 command procedures in the \BAT directory are as follows:
  83.  
  84.   1.  INSTALL - copy all PC/370 directories to hard disk with R42
  85.                 as root and all others as sub-directories.
  86.   2.  RUNDEMO - run all the demo programs in the \DEMO directory.
  87.                 This will verify installation and illustrate the
  88.                 PC/370 facilities.  Note last section of demo
  89.                 requires 80x87 math co-processor for floating point
  90.                 demo.  This section can be skipped if no co-processor
  91.                 is installed.
  92.   3.  RUNUTIL - run demo of the SEE text editor, PRINTDOC print
  93.                 utility, and T370 object code format utility.
  94.   4.  RUNMAC  - run demo of macro pre-processor facility.
  95.   5.  RUNCBL  - run demo of Micro Focus VS COBOL 370 subroutine.
  96.   6.  BLDLIB  - rebuild L370.LIB system relocatable subroutine
  97.                 library from source code in \LIB.
  98.   7.  BLDUTIL - rebuild utilities from source code in \UTIL.
  99.  
  100.  
  101. All of the above commands are designed assuming that the current
  102. directory is R42 and that all of the other 8 directories are defined
  103. in the R42 directory.  No parameters are required.
  104.  
  105. To code and execute a simple sample program, type the following after
  106. running the installation procedure file INSTALL.BAT and setting the
  107. current directory to \R42:
  108.  
  109.   STEP     COMMAND                  COMMENTS
  110.  
  111.     1      SEE DEMO                 invoke full screen editor to
  112.                                     create DEMO.ALC 370 assembler
  113.                                     source file.
  114.     2      DEMO CSECT               first line - define section
  115.     3           USING *,15          second     - define base register
  116.     4           LA    2,=C'HELLO$'  third      - address of msg. text
  117.     5           SVC   209           fourth     - request console msg.
  118.     6           BR    14            fifth      - exit to MS-DOS
  119.     7           END                 sixth      - end of program
  120.  
  121.     8      <esc>                    enter escape key to save DEMO.ALC
  122.                                     and exit to MS-DOS
  123.     9      A370 DEMO/LX             assemble DEMO.ALC and create
  124.                                     DEMO.OBJ object code file and
  125.                                     DEMO.PRN listing with symbol
  126.                                     cross reference.
  127.    10      L370 DEMO/LX             link DEMO.OBJ object file and
  128.                                     create DEMO.COM executable file
  129.                                     and DEMO.LST CSECT listing file.
  130.    11      DEMO.COM                 execute DEMO.COM which will load
  131.                                     E370R42.EXE to execute 370 machine
  132.                                     code in DEMO.COM and print "HELLO"
  133.                                     on the console.
  134.    12      DEMO.COM T               execute DEMO.COM again with test
  135.                                     parameter which invokes debug
  136.                                     facility.
  137.    13.     T                        At debug prompt, enter T to trace
  138.                                     each instruction while executing
  139.                                     the demo program.
  140.  
  141.    14.     TYPE DEMO.PRN            print assembly listing.
  142.  
  143.    15.     TYPE DEMO.LST            print link edit listing.
  144.  
  145. I hope you find the PC/370 package useful.  Please send feedback on
  146. your usage of the product and suggestions you may have.  Please
  147. register if you want assistance with the current product and want
  148. to support future development and enhancements.
  149.  
  150. If you are not familiar with IBM 370 assembler language, I recommend
  151. you obtain the text, "IBM 370 Assembler Language with ASSIST,
  152. Structured Concepts, and Advanced Topics", by Charles J. Kacmar at
  153. Texas A&M University, and published by Prentice Hall in September
  154. 1987, ISBN 0-13-455742-5.
  155.  
  156. ____________
  157.  
  158. IBM      - trademark of International Business Machines
  159. MS-DOS   - trademark of Microsoft
  160. VS COBOL - trademark of Micro Focus Inc.