mirror of
https://github.com/moshix/mvs.git
synced 2026-02-04 23:14:55 +00:00
170 lines
7.6 KiB
Plaintext
170 lines
7.6 KiB
Plaintext
|
||
READ.ME PC/370 Release 4.2 Installation Guide
|
||
|
||
Copyright 1988 Donald S. Higgins
|
||
|
||
Don Higgins
|
||
6365 - 32 Avenue North
|
||
St. Petersburg, Florida 33710
|
||
January 5, 1988
|
||
|
||
PC/370 users:
|
||
|
||
Welcome to release 4.2 of the PC/370 cross assembler and emulator
|
||
package! You are encouraged to copy and share this package with other
|
||
users on the condition that the package is not distributed in modified
|
||
form, and that no fee is charged. If you find the PC/370 product
|
||
useful, send 45 dollars to the address above to register as a user and
|
||
to support continued shareware maintenance and enhancements.
|
||
Registered users will receive notices of future releases. The product
|
||
is distributed on an as is basis with no implied warranties. However,
|
||
requests for fixes and enhancements from registered users are given
|
||
priority for inclusion in future releases. Currently planned future
|
||
enhancements are as follows:
|
||
|
||
1. Assembler H support with integrated macros.
|
||
|
||
2. Expanded memory support using protected mode on 80286/80386
|
||
running under native OS/2.
|
||
|
||
3. Improved 370 emulation performance using additional math co-
|
||
processor assists for packed decimal and native 80386 32 bit
|
||
instructions. (Note the current speed of the PC/370 emulator on
|
||
a 16 MHZ 80386 is in the range of 25,000 IBM 370 instructions
|
||
per second or 0.025 MIP's.)
|
||
|
||
The major features included since PC/370 release 3.2 are as follows:
|
||
|
||
1. Micro Focus COBOL/2 Extended Memory (XM) protected mode calls to
|
||
PC/370 assembler subroutines are supported on 80286 and 80386
|
||
systems. XM supports up to 16MB of real memory usable by COBOL
|
||
and PC/370 assembler subroutines. See USER.DOC for more
|
||
information. This facility requires use of new resident option
|
||
of emulator, and option B of linker to create BIN type module.
|
||
|
||
2. The following PC/370 supervisor calls have been added:
|
||
|
||
a. Svc 36 reloads program into specified area of memory.
|
||
b. Svc 37 defines user exits for supervisor calls.
|
||
|
||
3. The SPIE svc 14 has been enhanced to create program
|
||
interruption element control block and to pass sufficient
|
||
information to support transparent program check recovery.
|
||
|
||
4. At entry to main programs, register 1 now points to standard
|
||
MVS parameter list address, which in turn points to half
|
||
word parm length followed by EBCDIC parameters passed from
|
||
MS-DOS command line.
|
||
|
||
5. An optional hardware assist for the CVB and CVD instructions
|
||
is included which requires the 80x87 math co-processor and
|
||
can speed up the instructions by up to a factor of 4 for
|
||
large numbers. The floating point option P controls whether
|
||
the assist is activated when 80x87 is installed.
|
||
|
||
6. The L370 linkage editor now supports option U to allow
|
||
unresolved references.
|
||
|
||
7. The emulator debug facility now has option to restore all
|
||
trace points at any point during execution by repeated use
|
||
of K command. An optional version of emulator is also included
|
||
with the name E370P42.EXE which does not include interactive
|
||
debug or ASSIST facilities. This version saves space, but
|
||
should only be used with fully tested production programs.
|
||
To use this version, make it resident by executing it.
|
||
|
||
8. The PC/370 emulator E370R42.EXE can now be made resident by
|
||
simply executing it directly. This eliminates the time required
|
||
to load the emulator for each execution of a PC/370 assembler
|
||
program. In addition, a common system queue area (SQA) memory
|
||
can be allocated in the resident emulator address space to be
|
||
shared by assembler subroutines called from COBOL. The size of
|
||
the SQA is specified in hex paragraphs as the only parm. The
|
||
default is 10 hex or 256 byte SQA. Assembler subroutines called
|
||
from COBOL can now perform file I/O and dynamic memory
|
||
management using the common SQA memory.
|
||
|
||
9. The 370 cross assembler A370.EXE now supports the COPY statement
|
||
to include commonly used DSECT's, EQU's, or code. Common copy
|
||
files such as IHADCB.CPY for a DSECT of a DCB, EQUREGS.CPY for
|
||
R0-R15, and EQUSVCS.CPY for equates for all of the PC/370
|
||
supervisor calls are included.
|
||
|
||
10. The following fixes have been included:
|
||
|
||
a. CVB error when input field contained negative 0.
|
||
b. SRP error when second field contained more than 6 bit #.
|
||
c. Program check on executed instruction did not store
|
||
correct address of next instruction following execute.
|
||
d. EBCDIC to ASCII translate table did not correctly handle > {
|
||
and [ characters.
|
||
e. Text file with LRECL=1 caused incorrect record move.
|
||
f. Operand of ORG statement can now be CSECT or DSECT as
|
||
well as relative symbol within CSECT or DSECT.
|
||
g. File open svc 1 now takes error exit for file not found and
|
||
reg 0 and 1 now contain error code at entry to error exit
|
||
(See LIB\SYNERROR.ALC for subroutine to decode errors).
|
||
|
||
For brief description of changes in previous releases since 1981,
|
||
see DOC\HISTORY.DOC. Thanks to Jacques Roy, a macro preprocessor
|
||
M370.COM (written in 370 assembler) has been included since PC/370
|
||
release 3.2 along with a set of MVS compatible macros including DCB,
|
||
OPEN, CLOSE, GET, PUT, READ, WRITE, WTO, WTOR, LINK, LOAD, GETMAIN,
|
||
etc. If you use the macro preprocessor, register as a macro user and
|
||
support future enhancements, by sending a registration fee of $20. to:
|
||
|
||
Jacques Roy
|
||
XL Software Inc.
|
||
1000 St-Jean Baptiste #120
|
||
Quebec, Canada G2E-5G5
|
||
|
||
To install the PC/370 system on a hard disk and run the demo programs,
|
||
copy the file BAT\INSTALL.BAT to separate hard disk directory and
|
||
execute it. INSTALL requires two parameters, the first is the drive
|
||
containing the distributed floppy disk and the second is the hard disk
|
||
drive. Command C>INSTALL B C will install the system on hard disk C
|
||
reading files from drive B with prompts for each volume if more than
|
||
one. The install file defines a root directory \R42 which contains
|
||
all of the executable programs and system files required by the PC/370
|
||
facilities. The following sub-directories are also created:
|
||
|
||
1. \BAT - contains batch files which can be executed without
|
||
any parameters after setting current directory to
|
||
R42.
|
||
|
||
2. \LIB - contains ALC source code for PC/370 system
|
||
subroutines.
|
||
|
||
3. \CPY - contains CPY source code for ALC source COPY
|
||
includes.
|
||
|
||
4. \MAC - contains MAC and MLC source code for macro pre-
|
||
processor.
|
||
|
||
5. \CBL - contains CBL Micro Focus VS COBOL demo program source
|
||
code along with demo PC/370 assembler subroutine
|
||
source code.
|
||
|
||
6. \DOC - contains machine readable PC/370 documentation. Read
|
||
DOC\INTRO.DOC for PC/370 overview and more
|
||
information on the other component of the package.
|
||
|
||
7. \DEMO - contains demo program ALC source code.
|
||
|
||
8. \UTIL - contains utility program ALC source code.
|
||
|
||
|
||
Hope you enjoy PC/370! Feedback on your usage and/or
|
||
evaluation of the product is highly encouraged.
|
||
|
||
Sincerely,
|
||
|
||
|
||
|
||
Don Higgins, CCP, CDP
|
||
|
||
___________
|
||
|
||
IBM - trademark of International Business Machines
|
||
COBOL/2, XM - trademarks of Micro Focus Inc.
|
||
MS-DOS - trademark of Microsoft |