home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / emulate / systems / pc370 / read.me < prev    next >
Text File  |  1988-01-07  |  8KB  |  170 lines
  1.  
  2. READ.ME PC/370 Release 4.2 Installation Guide
  3.  
  4. Copyright 1988 Donald S. Higgins
  5.  
  6.                                   Don Higgins
  7.                                   6365 - 32 Avenue North
  8.                                   St. Petersburg, Florida 33710
  9.                                   January 5, 1988
  10.  
  11. PC/370 users:
  12.  
  13. Welcome to release 4.2 of the PC/370 cross assembler and emulator
  14. package!  You are encouraged to copy and share this package with other
  15. users on the condition that the package is not distributed in modified
  16. form, and that no fee is charged.  If you find the PC/370 product
  17. useful, send 45 dollars to the address above to register as a user and
  18. to support continued shareware maintenance and enhancements.
  19. Registered users will receive notices of future releases.  The product
  20. is distributed on an as is basis with no implied warranties.  However,
  21. requests for fixes and enhancements from registered users are given
  22. priority for inclusion in future releases.  Currently planned future
  23. enhancements are as follows:
  24.  
  25.   1.  Assembler H support with integrated macros.
  26.  
  27.   2.  Expanded memory support using protected mode on 80286/80386
  28.       running under native OS/2.
  29.  
  30.   3.  Improved 370 emulation performance using additional math co-
  31.       processor assists for packed decimal and native 80386 32 bit
  32.       instructions.  (Note the current speed of the PC/370 emulator on
  33.       a 16 MHZ 80386 is in the range of 25,000 IBM 370 instructions
  34.       per second or 0.025 MIP's.)
  35.  
  36. The major features included since PC/370 release 3.2 are as follows:
  37.  
  38.   1.  Micro Focus COBOL/2 Extended Memory (XM) protected mode calls to
  39.       PC/370 assembler subroutines are supported on 80286 and 80386
  40.       systems.  XM supports up to 16MB of real memory usable by COBOL
  41.       and PC/370 assembler subroutines.  See USER.DOC for more
  42.       information.  This facility requires use of new resident option
  43.       of emulator, and option B of linker to create BIN type module.
  44.  
  45.   2.  The following PC/370 supervisor calls have been added:
  46.  
  47.       a.  Svc 36 reloads program into specified area of memory.
  48.       b.  Svc 37 defines user exits for supervisor calls.
  49.  
  50.   3.  The SPIE svc 14 has been enhanced to create program
  51.       interruption element control block and to pass sufficient
  52.       information to support transparent program check recovery.
  53.  
  54.   4.  At entry to main programs, register 1 now points to standard
  55.       MVS parameter list address, which in turn points to half
  56.       word parm length followed by EBCDIC parameters passed from
  57.       MS-DOS command line.
  58.  
  59.   5.  An optional hardware assist for the CVB and CVD instructions
  60.       is included which requires the 80x87 math co-processor and
  61.       can speed up the instructions by up to a factor of 4 for
  62.       large numbers.  The floating point option P controls whether
  63.       the assist is activated when 80x87 is installed.
  64.  
  65.   6.  The L370 linkage editor now supports option U to allow
  66.       unresolved references.
  67.  
  68.   7.  The emulator debug facility now has option to restore all
  69.       trace points at any point during execution by repeated use
  70.       of K command.  An optional version of emulator is also included
  71.       with the name E370P42.EXE which does not include interactive
  72.       debug or ASSIST facilities.  This version saves space, but
  73.       should only be used with fully tested production programs.
  74.       To use this version, make it resident by executing it.
  75.  
  76.   8.  The PC/370 emulator E370R42.EXE can now be made resident by
  77.       simply executing it directly.  This eliminates the time required
  78.       to load the emulator for each execution of a PC/370 assembler
  79.       program.  In addition, a common system queue area (SQA) memory
  80.       can be allocated in the resident emulator address space to be
  81.       shared by assembler subroutines called from COBOL.  The size of
  82.       the SQA is specified in hex paragraphs as the only parm.  The
  83.       default is 10 hex or 256 byte SQA.  Assembler subroutines called
  84.       from COBOL can now perform file I/O and dynamic memory
  85.       management using the common SQA memory.
  86.  
  87.   9.  The 370 cross assembler A370.EXE now supports the COPY statement
  88.       to include commonly used DSECT's, EQU's, or code.  Common copy
  89.       files such as IHADCB.CPY for a DSECT of a DCB, EQUREGS.CPY for
  90.       R0-R15, and EQUSVCS.CPY for equates for all of the PC/370
  91.       supervisor calls are included.
  92.  
  93.  10.  The following fixes have been included:
  94.  
  95.       a.  CVB error when input field contained negative 0.
  96.       b.  SRP error when second field contained more than 6 bit #.
  97.       c.  Program check on executed instruction did not store
  98.           correct address of next instruction following execute.
  99.       d.  EBCDIC to ASCII translate table did not correctly handle > {
  100.           and [ characters.
  101.       e.  Text file with LRECL=1 caused incorrect record move.
  102.       f.  Operand of ORG statement can now be CSECT or DSECT as
  103.           well as relative symbol within CSECT or DSECT.
  104.       g.  File open svc 1 now takes error exit for file not found and
  105.           reg 0 and 1 now contain error code at entry to error exit
  106.           (See LIB\SYNERROR.ALC for subroutine to decode errors).
  107.  
  108. For brief description of changes in previous releases since 1981,
  109. see DOC\HISTORY.DOC.  Thanks to Jacques Roy, a macro preprocessor
  110. M370.COM (written in 370 assembler) has been included since PC/370
  111. release 3.2 along with a set of MVS compatible macros including DCB,
  112. OPEN, CLOSE, GET, PUT, READ, WRITE, WTO, WTOR, LINK, LOAD, GETMAIN,
  113. etc.  If you use the macro preprocessor, register as a macro user and
  114. support future enhancements, by sending a registration fee of $20. to:
  115.  
  116.         Jacques Roy
  117.         XL Software Inc.
  118.         1000 St-Jean Baptiste #120
  119.         Quebec, Canada G2E-5G5
  120.  
  121. To install the PC/370 system on a hard disk and run the demo programs,
  122. copy the file BAT\INSTALL.BAT to separate hard disk directory and
  123. execute it.  INSTALL requires two parameters, the first is the drive
  124. containing the distributed floppy disk and the second is the hard disk
  125. drive.  Command C>INSTALL B C will install the system on hard disk C
  126. reading files from drive B with prompts for each volume if more than
  127. one.  The install file defines a root directory \R42 which contains
  128. all of the executable programs and system files required by the PC/370
  129. facilities.  The following sub-directories are also created:
  130.  
  131.   1.  \BAT  - contains batch files which can be executed without
  132.               any parameters after setting current directory to
  133.               R42.
  134.  
  135.   2.  \LIB  - contains ALC source code for PC/370 system
  136.               subroutines.
  137.  
  138.   3.  \CPY  - contains CPY source code for ALC source COPY
  139.               includes.
  140.  
  141.   4.  \MAC  - contains MAC and MLC source code for macro pre-
  142.               processor.
  143.  
  144.   5.  \CBL  - contains CBL Micro Focus VS COBOL demo program source
  145.               code along with demo PC/370 assembler subroutine
  146.               source code.
  147.  
  148.   6.  \DOC  - contains machine readable PC/370 documentation.  Read
  149.               DOC\INTRO.DOC for PC/370 overview and more
  150.               information on the other component of the package.
  151.  
  152.   7.  \DEMO - contains demo program ALC source code.
  153.  
  154.   8.  \UTIL - contains utility program ALC source code.
  155.  
  156.  
  157. Hope you enjoy PC/370!  Feedback on your usage and/or
  158. evaluation of the product is highly encouraged.
  159.  
  160. Sincerely,
  161.  
  162.  
  163.  
  164. Don Higgins, CCP, CDP
  165.  
  166. ___________
  167.  
  168. IBM          - trademark of International Business Machines
  169. COBOL/2, XM  - trademarks of Micro Focus Inc.
  170. MS-DOS       - trademark of Microsoft