/usr/share/hercules/hercfaq.html

<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3.0//EN" "html.dtd">
<HTML>
<HEAD>
<TITLE>
    Hercules Version 3: Frequently-Asked Questions
</TITLE>
<LINK REL=STYLESHEET TYPE="text/css" HREF="hercules.css">
</HEAD>
<BODY TEXT="#000000" LINK="#0000A0" VLINK="#008040" BGCOLOR="#ffffcc"
    ALINK="#000000">
<H1>
    Hercules Version 3: Frequently-Asked Questions
</H1>
<P>
<HR>
</P>
<TABLE>
<TR><TD><A HREF="#1.01">1.01</A></TD><TD>What is Hercules?</TD></TR>
<TR><TD><A HREF="#1.02">1.02</A></TD><TD>So what exactly does that mean?</TD></TR>
<TR><TD><A HREF="#1.03">1.03</A></TD><TD>Is it functional enough to run production work?</TD></TR>
<TR><TD><A HREF="#1.04">1.04</A></TD><TD>What are the licensing restrictions for Hercules?</TD></TR>
<TR><TD>&nbsp;</TD></TR>
<TR><TD><A HREF="#2.01">2.01</A></TD><TD>Can it run z/OS, z/VM, z/VSE?</TD></TR>
<TR><TD><A HREF="#2.02">2.02</A></TD><TD>What operating systems can I run legally?</TD></TR>
<TR><TD><A HREF="#2.03">2.03</A></TD><TD>What other programs will run under Hercules?</TD></TR>
<TR><TD><A HREF="#2.04">2.04</A></TD><TD>Where can I obtain OS/360 ?</TD></TR>
<TR><TD><A HREF="#2.05">2.05</A></TD><TD>Where can I obtain MVS ?</TD></TR>
<TR><TD><A HREF="#2.06">2.06</A></TD><TD>Where can I obtain VM/370 ?</TD></TR>
<TR><TD><A HREF="#2.07">2.07</A></TD><TD>Where can I obtain DOS/VS ?</TD></TR>
<TR><TD><A HREF="#2.08">2.08</A></TD><TD>Where can I obtain Linux/390 ?</TD></TR>
<TR><TD><A HREF="#2.09">2.09</A></TD><TD>Where can I find documentation?</TD></TR>
<TR><TD>&nbsp;</TD></TR>
<TR><TD><A HREF="#3.01">3.01</A></TD><TD>What PC hardware do I need to run Hercules?</TD></TR>
<TR><TD><A HREF="#3.02">3.02</A></TD><TD>What sort of MIPS rate can I expect?</TD></TR>
<TR><TD><A HREF="#3.03">3.03</A></TD><TD>What PC software do I need to run Hercules?</TD></TR>
<TR><TD><A HREF="#3.04">3.04</A></TD><TD>What software do I need to build Hercules on Linux and Unix?</TD></TR>
<TR><TD><A HREF="#3.05">3.05</A></TD><TD>What software do I need to build Hercules on Windows?</TD></TR>
<TR><TD><A HREF="#3.06">3.06</A></TD><TD>Can Hercules be ported to run on other platforms?</TD></TR>
<TR><TD>&nbsp;</TD></TR>
<TR><TD><A HREF="#4.01">4.01</A></TD><TD>How can I create a virtual DASD volume?</TD></TR>
<TR><TD><A HREF="#4.02">4.02</A></TD><TD>Can I read a tape which was created on a mainframe?</TD></TR>
<TR><TD><A HREF="#4.03">4.03</A></TD><TD>Can I attach a PC tape drive to Hercules?</TD></TR>
<TR><TD><A HREF="#4.04">4.04</A></TD><TD>Can I process mainframe tapes with Hercules?</TD></TR>
<TR><TD><A HREF="#4.05">4.05</A></TD><TD>Can I create Assembler programs without a mainframe?</TD></TR>
<TR><TD>&nbsp;</TD></TR>
<TR><TD><A HREF="#5.01">5.01</A></TD><TD>What architectural features are implemented?</TD></TR>
<TR><TD>&nbsp;</TD></TR>
<TR><TD><A HREF="#6.01">6.01</A></TD><TD>Who are the Herculeans?</TD></TR>
<TR><TD>&nbsp;</TD></TR>
<TR><TD><A HREF="#7.01">7.01</A></TD><TD>Where can I obtain technical support?</TD></TR>
</TABLE>
<P>
<HR>
</P>
<H4><A NAME="1.01">1.01</A>
    What is Hercules?
</H4>
<P>
    Hercules is a software implementation of the System/370, ESA/390 and
    z/Architecture mainframe architectures. Hercules runs under Windows
    and Linux, as well as under various other Unix or Unix-like systems
    on Intel Pentium and other hardware platforms including Alpha,
    Sparc, and Mac.
</P>
<H4><A NAME="1.02">1.02</A>
    So what exactly does that mean?
</H4>
<P>
    It means that your PC can execute programs designed to run on an IBM
    mainframe.
</P>
<P>
    Hercules executes S/370, ESA/390, and z/Architecture instructions
    and channel programs.  It emulates mainframe I/O devices by using
    PC devices.  For example, 3390 DASD devices are emulated by large
    files on your hard disk, and local 3270 screens are emulated by tn3270
    sessions.
</P>
<P>
    Hercules implements only the raw S/370, ESA/390, and z/Architecture
    instruction set; it does not provide any operating system facilities.
    This means that you need to provide an operating system or standalone
    program which Hercules can load from an emulated disk or tape device.
    You will have to write the operating system or standalone program
    yourself, unless you can manage to obtain a license from IBM to run
    one of their operating systems on your PC, or use IBM programs and
    operating systems which are effectively in the public domain.
</P>
<H4><A NAME="1.03">1.03</A>
    Is it functional enough to run production work?
</H4>
<P>
    Hercules has never claimed to be a production-capable system.
    It was always meant to be a system programmer's toy. Having said
    that, it's now become good enough to run a wide range of software
    without problems, and there are reports that it has been used to
    run production work in some parts of the world.
</P>
<H4><A NAME="1.04">1.04</A>
    What are the licensing restrictions for Hercules?
</H4>
<P>
    Hercules is a copyright work which has been made generally
    available, subject to the terms of the
<A HREF="herclic.html">Q Public License</A>.
    In essence this allows free use and distribution of the program for
    personal and commercial use.  You may not distribute modified copies
    of the program, but you may distribute your own patches along with
    the program, provided that you also grant the maintainer permission
    to include those patches in future versions of the program.  You may
    not copy any portion of the source code for use in any other program.
</p>
<P>
<HR>
</P>
<H4><A NAME="2.01">2.01</A>
    Can it run z/OS, z/VM, z/VSE?
</H4>
<P>
    Yes. Hercules is a software implementation of z/Architecture, and so
    it is capable of running z/OS, z/VM, and z/VSE.  Hercules also
    implements ESA/390 (including SIE) and so it can run OS/390, VM/ESA,
    and VSE/ESA, as well as older versions of these operating systems
    such as MVS/ESA, MVS/XA, MVS/SP, MVS/SE, VM/SP, VSE/SP, and DOS/VSE.
    <p>
    <b>But</b> (and this is a big but), these operating systems are all
    IBM Licensed Program Products, whose conditions of use generally
    restrict their usage to specific IBM machine serial numbers. So you
    cannot just copy these systems from work and run them on your PC, as
    this would almost certainly be a violation of your company's licensing
    agreement with IBM.
</P>
<H4><A NAME="2.02">2.02</A>
    What operating systems can I run legally?
</H4>
<P>
    Operating systems which may legally be run on Hercules include:
    <UL>
    <LI>
    Older IBM operating systems including OS/360, DOS/360, DOS/VS,
    MVS 3.8, VM/370, and TSS/370 which are widely believed to be
    either public domain or
    "copyrighted software provided without charge."
    </LI>
    <LI>
    The open source operating system "Linux on System z".
    Several distributors provide 64-bit z/Architecture versions of
    Linux, and some also provide ESA/390-compatible versions.
    Mainframe Linux distributions include SUSE Linux Enterprise
    Server, Red Hat Enterprise Linux, Fedora, and Debian.
    Many developers use Hercules to help port their software to
    the mainframe with Linux on System z.
    </LI>
    <LI>
    The open source operating system "OpenSolaris for System z".
    Sine Nomine Associates brought OpenSolaris to System z, relying on
    features provided by z/VM. Emulation of those specific z/VM
    features for OpenSolaris is included in Hercules starting with
    version 3.07.
    </LI>
    <LI>
    The Michigan Terminal System (MTS) version D6.0A, which is a
    pre-built version of MTS for use with Hercules
    (see <a href="http://archive.michigan-terminal-system.org">
    http://archive.michigan-terminal-system.org</a>).
    </LI>
    <LI>
    The MUSIC/SP operating system may be available for educational and
    demonstration purposes upon request to its copyright holder,
    McGill University. Some of MUSIC/SP's features, notably
    networking, require z/VM (and thus an IBM license).
    </LI>
    </UL>
</P>
<H4><A NAME="2.03">2.03</A>
    What other programs will run under Hercules?
</H4>
<P>
    Any program which uses the S/370, ESA/390, or z/Architecture instruction
    set, as implemented in Hercules. Some special utilities in the form of
    standalone programs are known to run well. A good example is
    Jan Jaeger's excellent standalone editor (ZZSA) which is included in the
    Hercules distribution, or it can be downloaded from
<A HREF="http://www.cbttape.org/~jjaeger">http://www.cbttape.org/~jjaeger</A>;
    ZZSA allows you to examine and edit MVS datasets without the need to load
    an operating system. Note: ZZSA runs in ESA/390 mode.
    See Jan Jaeger's website for more information and special logon procedures.
</P>
<H4><A NAME="2.04">2.04</A>
    Where can I obtain OS/360 ?
</H4>
<!-- Following links no longer exist
<P>
       Rick Fochtman's OS/360 archive CD is obtainable by download from
<UL>
<LI>
<A HREF="http://www.jaymoseley.com/hercules/install.htm">http://www.jaymoseley.com/hercules/install.htm</A>
</LI>
<LI>
<A HREF="http://www.cyberdynesys.com/os360.tgz">http://www.cyberdynesys.com/os360.tgz</A>
</LI>
<LI>
<A HREF="ftp://ftp.ox.ac.uk/pub/linux/hercos360/os360.tar.gz">ftp://ftp.ox.ac.uk/pub/linux/hercos360/os360.tar.gz</A>
</LI>
<LI>
<A HREF="ftp://source.rfc822.org/pub/mirror/hercules/hercos360/os360.tar.gz">ftp://source.rfc822.org/pub/mirror/hercules/hercos360/os360.tar.gz</A>
</LI>
<LI>
<A HREF="http://open360.copyleft.de/OS360/Download.html">http://open360.copyleft.de/OS360/Download.html</A>
</LI>
</UL>
     end of non-existent links -->
</P>
<P>
       Jay Maynard's "IBM Public Domain Software Collection"
       at <a href="http://www.ibiblio.org/jmaynard/">http://www.ibiblio.org/jmaynard/</a>
       contains copies of the OS/360 Release 21.8 distribution tapes.
<H4><A NAME="2.05">2.05</A>
    Where can I obtain MVS 3.8 ?
</H4>
<P>
The MVS 3.8J Turnkey System built by Volker Bandke can be obtained from
<A HREF="http://www.bsp-gmbh.com/">http://www.bsp-gmbh.com/</A>
</P>
<P>
For news about updates to the MVS 3.8J Turnkey System,
subscribe to the H390-MVS forum at
<A HREF="http://tech.groups.yahoo.com/group/H390-MVS/">
http://tech.groups.yahoo.com/group/H390-MVS/</A>
</P>
<P>
Juergen Winkelmann has made available an updated MVS Turnkey System
which can be downloaded from
<a href="http://wotho.ethz.ch/tk4-/">
http://wotho.ethz.ch/tk4-/</a>
</P>
<P>
Paul Edwards created a distribution consisting of a modified version
of Hercules together with operating system modifications which allow
applications to break the 24-bit addressing barrier inherent in S/370.
The distribution is called MVS/380 and it can be downloaded from
<a href="http://mvs380.sourceforge.net/">
http://mvs380.sourceforge.net/</a>
</P>

<!-- Following links no longer exist
<P>
    The Original MVS 3.8 distribution as it was first used came from
</P>
<UL><LI>
<A HREF="ftp://ftp.cbttape.org/pub/cbttape/mvs38/">ftp://ftp.cbttape.org/pub/cbttape/mvs38/</A>
</LI></UL>
<P>
    who advise using the mirrors at
</P>
<UL>
<LI><A HREF="ftp://ftp.ox.ac.uk/pub/linux/mvs38j/">ftp://ftp.ox.ac.uk/pub/linux/mvs38j/</A></LI>
<LI><A HREF="http://source.rfc822.org/pub/mirror/hercules/mvs38j/">http://source.rfc822.org/pub/mirror/hercules/mvs38j/</A></LI>
<LI><A HREF="ftp://source.rfc822.org/pub/mirror/hercules/mvs38j/">ftp://source.rfc822.org/pub/mirror/hercules/mvs38j/</A></LI>
</UL>
<P>
    Several people have generated a functional MVS system from this archive :
</P>
<UL>
<LI><A HREF="http://www.jaymoseley.com/">Jay Moseley, CCP</A></LI>
<LI><A HREF="http://www.bsp-gmbh.com/hercules/">Volker Bandke from BSP GmbH</A></LI>
<LI><A HREF="http://www.schaefernet.de/hercules/">Wolfgang Sch&auml;fer from Sch&auml;fernet</A></LI>
</UL>
     end of non-existent links -->
<H4><A NAME="2.06">2.05</A>
    Where can I obtain VM/370 ?
</H4>
<!-- archaelogic.com is no longer accessible
<P>
    Bob Abeles started a VM/370 web site at:
</P>
<UL><LI>
<A HREF="http://www.archaelogic.com/vm370/">http://www.archaelogic.com/vm370</A>
</LI></UL>
     end of non-existent link -->
<P>
The VM/370 page at <a href="http://www.cbttape.org/vm6.htm">
http://www.cbttape.org/vm6.htm</a>
contains download links for the Andy Norrie VM 4-pack system and
the Bob Abeles VM/370 R6 distribution.
</P>
<P>
Dave Wade's VM/370 Downloads page at
<a href="http://www.smrcc.org.uk/members/g4ugm/VM370.htm">
http://www.smrcc.org.uk/members/g4ugm/VM370.htm</a>
contains links to the most recent VM/370 distributions.
</P>
<P>
You may also wish to subscribe to the H390-VM forum at
<A HREF="http://tech.groups.yahoo.com/group/H390-VM/">
http://tech.groups.yahoo.com/group/H390-VM/</A>
</P>

<H4><A NAME="2.07">2.07</A>
    Where can I obtain DOS/VS ?
</H4>
<!-- Following links no longer exist
<P>
    I've put the DOS/VS r34 install tape on my site. It'll expand to a 21
    MB AWSTAPE file, dosrel34.aws. You need the <EM>Coverletter</EM> to
    install it. Read the relevant postings of the Hercules mailing list
    first, as the install process is quite obscure.
</P>
<P>
    You can grab those files at :
</P>
<UL>
<LI><A HREF="http://www.hercules-390.org/dosrel34.zip">http://www.hercules-390.org/dosrel34.zip</A></LI>
<LI><A HREF="http://www.hercules-390.org/dosrel34coverletter.pdf">http://www.hercules-390.org/dosrel34coverletter.pdf</A></LI>
<LI><A HREF="http://open360.copyleft.de/DOS34/Installation.html">http://open360.copyleft.de/DOS34/Installation.html</A></LI>
</UL>
     end of non-existent links -->
<P>
George Shedlock's DOS/VS 5-pack system can be obtained from
<a href="https://docs.google.com/open?id=0B7scZ2voEa--Zm50U09xYy15ejg">
https://docs.google.com/open?id=0B7scZ2voEa--Zm50U09xYy15ejg</a>
</P>
<P>
Other useful files may be downloaded from the H390-DOSVS forum at
<A HREF="http://tech.groups.yahoo.com/group/H390-DOSVS/files/">
http://tech.groups.yahoo.com/group/H390-DOSVS/files/</A>
</P>
<H4><A NAME="2.08">2.08</A>
    Where can I obtain Linux/390 ?
</H4>
<P>
The best starting point for information about Linux for S/390 and Linux for zSeries
is <A HREF="http://www.linuxvm.org/">http://www.linuxvm.org/</A>
</P>
<!-- The following seems to be very out of date
<P>
    The process of downloading and installing Linux/390 is best
    described by the
<A HREF="http://linas.org/linux/i370-howto.html">Getting Started with Linux/390</A>
    document. Take a look at,
<A HREF="http://www.cozx.com/~dpitts/gcc.html">David Pitts' GCC/EGCS Compiler Page</A>
    if you need GCC and GNU utils for OS/390 to bootstrap Linux from source.
</P>
-->
<H4><A NAME="2.09">2.09</A>
    Where can I find documentation?
</H4>
<P>
There are several sites containing introductory documentation for MVS 3.8
with Hercules, including:
</P>
<ul>
<li><a href="http://www.jaymoseley.com/hercules">http://www.jaymoseley.com/hercules</a>
    <br>Jay Moseley's Hercules site - lots of Hercules and MVS information
<li><a href="http://www.tommysprinkle.com/mvs">http://www.tommysprinkle.com/mvs</a>
    <br>Tommy Sprinkle's MVS 3.8 documentation
<li><a href="http://hansen-family.com/mvs">http://hansen-family.com/mvs</a>
    <br>Bob Hansen's MVS 3.8 documentation
<li><a href="http://timpinkawa.net/hercules/">http://timpinkawa.net/hercules/</a>
    <br>Tim Pinkawa's Hercules Page
</ul>
<P>
Much of the original IBM documentation for the 360 and 370 series is preserved at
the bitsavers.org website. A good starting point is:
<ul>
<li><a href="http://bitsavers.trailing-edge.com/pdf/ibm/360/">
    http://bitsavers.trailing-edge.com/pdf/ibm/360/</a>
<li><a href="http://bitsavers.trailing-edge.com/pdf/ibm/370/">
    http://bitsavers.trailing-edge.com/pdf/ibm/370/</a>
</ul>
</P>
<P>
    Jay Maynard produced a document describing how to build an OS/360 system
    on Hercules, called "OS/360 on Hercules". It can be found at
</P>
<UL><LI>
<A HREF="http://web.archive.org/web/20120202010657/http://www.conmicro.com/hercos360/">
http://web.archive.org/web/20120202010657/http://www.conmicro.com/hercos360/</A>.
</LI></UL>
<P>
    This will build an MVT system without TCAM/TSO, but with two 3270
    consoles. You will need Malcolm Beattie's "Guide to Using 3270
    Consoles and Terminals for Hercules" with this MVT version.
</P>
<UL><LI>
<A HREF="http://www.clueful.co.uk/mbeattie/hercules/3270.html">http://www.clueful.co.uk/mbeattie/hercules/3270.html</A>
</LI></UL>
<!-- Following links no longer exist
<P>
    The N.U.D.E guides can be found at :
</P>
<UL><LI>
    <a href="http://www.kiyoinc.com/hercdoc.html">http://www.kiyoinc.com/hercdoc.html</A>.
</LI></UL>
<P>
    IBM provides only current documentation, ...<br/>
    but many things haven't changed since 1964 :
</P>
<UL><LI>
<a href="http://www.s390.ibm.com/bookmgr-cgi/bookmgr.cmd/LIBRARY">IBM BookManager(r) BookServer Library</a>
</LI></UL>
     end of non-existent links -->
<HR>
</P>
<H4><A NAME="3.01">3.01</A>
    What PC hardware do I need to run Hercules?
</H4>
<P>
    Classic IBM operating systems (OS/360, MVS 3.8, VM/370) are very light by
    today's standards and will run satisfactorily on a 300Mhz Pentium with as
    little as 32MB RAM.
</P>
<P>
    Anything more up-to-date, such as Linux/390 or OS/390, requires much more
    processing power. Hercules is CPU intensive, so you will want to use the
    fastest processor you can get. A 2GHz Pentium, preferably with hyperthreading,
    will probably provide acceptable performance for a light workload. Recent
    64-bit multiprocessor systems will provide better performance. Hercules
    makes extensive use of multi-threading to overlap I/O with CPU activity,
    and to dispatch multiple emulated CPU's in parallel.
</P>
<P>
    For the latest 64-bit operating systems such as zLinux and z/OS, be aware
    that there is a performance penalty when Hercules emulates z/Architecture
    on a 32-bit processor such as the Pentium. If you are serious about running
    64-bit then you will probably want to build Hercules for a 64-bit processor
    such as Alpha (DEC/Compaq/HP), AMD64 (AMD Opteron, Athlon-64, Turion 64),
    IA64 (Intel Itanium 2), together with a 64-bit version of Linux,
    or PPC (Power Mac G5) with OS X.
</P>
<P>
    Hercules does not depend on the x86 architecture. It has been built and
    run successfully on 500 MHz Alpha 21164, SPARC, and S/390 Linux.
    One guy has even run OS/360 under Hercules under Linux/390 under Hercules
    under Linux/390 under VM/ESA!
    The prize for the world's smallest mainframe probably goes to Ivan Warren,
    who claims to have run VM/370 under Hercules on an iPAQ 5450 handheld PDA.
</P>
<P>
    You should provide enough RAM to accommodate your S/390 real storage
    (main storage plus expanded storage) in addition to the normal
    requirements of your PC's operating system.  For maximum throughput, you
    should set your main and expanded storage sizes high enough to eliminate
    S/390 paging. S/390 storage is allocated out of your PC's virtual storage.
</P>
<P>
    You also need enough hard disk space to accommodate the emulated DASD. A
    virtual "3330 model 1" disk drive will need about 100 megabytes of space
    for emulation (a 3330-11 will need about 200 megabytes). A 3380 "single
    density" model will need about 650MB, a 3390 model 2 needs about 2GB, and
    a 3390 model 3 needs about 3GB.
    If you use the
<a href="cckddasd.html">compressed CKD DASD feature</a>,
    these sizes will shrink dramatically, usually to about 20 to 30 percent
    of the original size.
</P>
<H4><A NAME="3.02">3.02</A>
    What sort of MIPS rate can I expect?
</H4>
<P>
    Thanks to the cumulative work of many individuals, including
    Valery Pogonchenko, Juergen Dobrinski, Albert Louw,
    Gabor Hoffer, Jan Jaeger, Paul Leisy, Clem Clarke,
    and Greg Smith,
    the performance of Hercules today is vastly better than it was
    5 years ago.
</P>
<P>
    Even on a Celeron 300 you should see an execution speed of 1 to 2 MIPS,
    which is enough to run OS/360 (MFT or MVT) or MVS 3.8 with a response
    time better than that of a 3033 from the 1970's. It's also fast enough to
    run VSE/ESA with an acceptable response time. On a more recent system with
    a 2GHz Pentium processor, you may see the system peak at around 30 MIPS
    which is enough to run Linux/390 or z/OS with a light workload.
</P>
<P>
    Performance on server class machines is now fairly respectable.  For
    example, on a dual-core Intel Xeon with hyperthreading (4 CPUs) running
    at 3.46GHz, you might expect to see a sustained MIPS rate of 40 to 60
    MIPS. A dual-processor quad-core Mac Pro (8 cores, 3 GHz) will sustain
    over 150 MIPS.  For anyone who is prepared to spend a considerable
    amount of money on their Hercules system, there are reports that a
    sustained 300+ MIPS has been achieved on an Intel Core i7 processor
    running at 3.75GHz using all four cores plus hyperthreading (8 CPUs).
</P>
<P>
    Typical I/O rates of around 50 EXCP/second are reported on average
    hardware, with rates over 500/second achievable with hardware RAID.
</P>
<H4><A NAME="3.03">3.03</A>
    What PC software do I need to run Hercules?
</H4>
<P>
    The following software platforms are supported:
    <li>Linux (kernel 2.4 or later)
    <li>Windows XP, Windows Vista, or Windows 7
    <li>Mac OS X 10.3 or later
    <li>Solaris 2.9 or later (Sparc or Intel)
    <li>FreeBSD
</P>
<P>
    You will also need tn3270 client software for the virtual 3270
    console.  The tn3270 client can run on the same machine as Hercules, or
    on any Unix or Windows box with a TCP/IP connection to the Hercules
    machine.
</P>
<P>
    The supported and recommended tn3270 clients for Hercules are:
<dl>
<dt>
<B>
    x3270 for Unix
</B>
<dd>
    x3270 is included with most Linux distributions, or you can
    download it from
<a HREF="http://x3270.bgp.nu/">http://x3270.bgp.nu/</A>
<dt>
<B>
    Vista tn3270 for Windows
</B>
<dd>
    Vista tn3270 can be obtained from
<a HREF="http://www.tombrennansoftware.com">www.tombrennansoftware.com</a>.
    The very modest license fee charged for this excellent 3270 emulator
    helps to support an independent software developer.
<dt>
<B>
    Brown University tn3270 for Macintosh
</B>
<dd>
    Brown University tn3270 is freely available. You can download it from <a
    href="http://www.brown.edu/cis/tn3270/">http://www.brown.edu/cis/tn3270/</a>.
    There is one setting that must be changed to use this program with some
    operating systems, especially MVS 3.8: Open a connection to Hercules,
    but before IPLing the system, go to the Session->Features menu and set
    "Change embedded nulls to blanks" to "No". Click on "OK". Now, click on
    File->Save default settings... to make the setting permanent.
</dl>
<P>
    Other tn3270 clients, such as QWS3270, IBM Personal Communications,
    Attachmate Extra, or Dynacomm Elite should also work in most cases, but
    be aware that some tn3270 clients have bugs which make them unusable
    as OS/360 or MVS consoles.
</P>
<H4><A NAME="3.04">3.04</A>
    What software do I need to build Hercules on Linux and Unix?
</H4>
<P>
    To build Hercules for Linux
    and other Unix-like environments
    you need to use the <a href="http://gcc.gnu.org">gcc</a> compiler,
    version 3.x or above.
    You will also need a full set of GNU development tools, including recent versions
    of autoconf, automake, libiconv, make, perl, sed, and m4.
    Refer to the util/bldlvlck file in the Hercules distribution for details.
</P>
<H4><A NAME="3.05">3.05</A>
    What software do I need to build Hercules on Windows?
</H4>
<P>
    To build Hercules for the Windows environment
    you need to use the Microsoft C/C++ compiler (MSVC)
    version 14.x or later.
    The 32-bit compiler and SDK are packaged as
    Microsoft Visual C++ 2010 Express (Version 16.x)
    available for download from Microsoft.
</P>
<P>
    Although no longer available for download,
    Microsoft Visual C++ 2005 Express (Version 14.x)
    or
    Microsoft Visual C++ 2008 Express (Version 15.x)
    may also be used.
    Alternatively, Microsoft Visual Studio 8.0, 9.0, or 10.0 may be used.
    For further information, see the README.WIN32 file.
</P>
<P>
    To build Hercules for 64-bit Windows platforms you will need
    either Microsoft Visual C++ 2010 Express and the Microsoft Windows SDK 7.1, or
    Microsoft Visual Studio 9.0 or 10.0 Professional.
    For further information, see the README.WIN64 file.
</P>
<H4><A NAME="3.06">3.06</A>
    Can Hercules be ported to run on other platforms?
</H4>
<P>
    With the introduction of autotools, we do make efforts to ensure Hercules
    builds and run on several different operating system platforms (mostly
    Linux, Windows, MAC, Solaris, and FreeBSD right now),
    but we of course simply cannot
    guarantee that it will run on every operating system platform out there.
</P>
<P>
    The Hercules code is not intended to be specific to Intel hardware, so if
    you find any issues or faults related to running on other hardware (SPARC,
    Alpha, PPC, ...) under Linux, feel free to report it to the Hercules forum
    (see the <a href="hercsupp.html">Hercules Technical Support</a> page).
</P>
<P>
<HR>
</P>
<H4><A NAME="4.01">4.01</A>
    How can I create a virtual DASD volume?
</H4>
<P>
    The
<A HREF="hercload.html">
    Creating Hercules DASD
</A>
    document describes
    various methods of creating and loading virtual DASD volumes.
</P>
<H4><A NAME="4.02">4.02</A>
    Can I read a tape which was created on a mainframe?
</H4>
<P>
    Yes, indirectly. The mainframe tape must be converted to AWSTAPE format
    and then downloaded to your PC. The
<B><I>tapeconv.jcl</I></B>
    file in the
    Hercules directory contains a sample program which you can run under OS/390
    on your mainframe system. It reads a file from tape and converts it to
    AWSTAPE format. Download the AWSTAPE file to your PC (making sure to choose
<EM>binary</EM>
    format for the download), and then add the downloaded
    filename to the Hercules configuration file as a virtual tape device. You
    will then be able to read the tape file from the virtual tape drive located
    on your PC.
</P>
<P>
<EM>
    Note: the "tapeconv" program will not correctly process input tapes
    whose block size exceeds 32760!
</EM>
    One symptom of this may be the message "
<CODE>ADRY011E I/O ERROR - DEVICE NOT ATTACHED.0000,NA,00...00,0000"</CODE>
    when attempting to restore from tape originally created using the default
    DF/DSS block size. The solution is to recreate the dump tape with
    DCB=BLKSIZE=32760.
</P>
<H4><A NAME="4.03">4.03</A>
    Can I attach a PC tape drive to Hercules?
</H4>
<P>
    Yes. Hercules can read and write tapes on SCSI drives. I have tested this
    with 4mm DAT, QIC-1000, and 9-track drives.
</P>
<H4><A NAME="4.04">4.04</A>
    Can I process mainframe tapes with Hercules?
</H4>
<P>
    Yes.  It is possible to obtain 9-track open reel drives and 3480-type
    cartridge drives which attach to the SCSI bus.  Hercules makes these
    appear to the operating system as channel-attached 3420 or 3480 devices,
    making it possible to read and write real mainframe tapes.
</P>
<H4><A NAME="4.05">4.05</A>
    Can I create Assembler programs without a mainframe?
</H4>
<P>
    Yes. If you want to write Assembler (BAL) programs to run on Hercules,
    but you don't have access to a mainframe, then there are two interesting
    products which you can run on your PC to assemble programs:
</P>
<DL>
<DT>
    The "Tachyon 390 Cross Assembler" (
<A HREF="http://www.tachyonsoft.com/tachyon">http://www.tachyonsoft.com/tachyon</A>
    )
</DT>
<DD>
    With this assembler you can produce S/390-compatible object decks using
    your Linux or Windows PC. A high degree of HLASM compatibility, coupled with
    the ability to perform complex assemblies at lightning speed, make this a
    product which is well worth looking at. I have tried this assembler and it
    is truly amazing.
</DD>
<DT>
    The "Dignus Systems/C Compiler" (
<A HREF="http://www.dignus.com/">http://www.dignus.com</A>
    )
</DT>
<DD>
    This is a C compiler which runs under Windows or Linux and generates
    mainframe assembler code which you can then assemble using the Tachyon
    assembler.
</DD>
</DL>
<P>
    Sam Golob wrote a fascinating review of these two products in the
    September 1999 issue of <A HREF="http://www.naspa.com">NaSPA</a>
    Technical Support magazine.
</P>
<P>
<HR>
</P>
<H4><A NAME="5.01">5.01</A>
    What architectural features are implemented?
</H4>
<P>The following standard features of ESA/390 have been implemented: </P>
<UL>
<LI>Address-Limit Checking </LI>
<LI>Commercial Instruction Set </LI>
<LI>Decimal Instructions </LI>
<LI>Hexadecimal Floating-Point Instructions </LI>
<LI>24-bit and 31-bit addressing </LI>
<LI>Key-Controlled Protection </LI>
<LI>Page Protection </LI>
<LI>Low-Address Protection </LI>
<LI>Dynamic Address Translation </LI>
<LI>370-XA Channel Subsystem </LI>
<LI>Channel Indirect Data Addressing </LI>
<LI>Program Controlled Interruption (PCI) </LI>
<LI>Channel Program Suspend/Resume </LI>
<LI>Dual Address Space </LI>
<LI>Access Register Mode </LI>
<LI>Home Space Mode </LI>
<LI>Branch and Save </LI>
<LI>Conditional Swapping </LI>
<LI>TOD Clock, Clock Comparator, and CPU Timer </LI>
<LI>MVCS/MVCP/MVCK/MVCSK/MVCDK instructions </LI>
<LI>TB/TPROT instructions </LI>
<LI>LURA/STURA instructions </LI>
<LI>BAKR/PC/PR/PT instructions </LI>
<LI>Linkage Stack </LI>
<LI>Compare and Form Codeword and Update Tree instructions </LI>
</UL>

<P>The following optional features of ESA/390 have been implemented: </P>

<UL>
<LI>Access-List-Controlled Protection </LI>
<LI>Binary Floating-Point instructions </LI>
<LI>Branch and Set Authority </LI>
<LI>Broadcasted Purging </LI>
<LI>Checksum instruction </LI>
<LI>Compare and Move Extended instructions </LI>
<LI>Dynamic Reconfiguration </LI>
<LI>Expanded Storage </LI>
<LI>Fast Synchronous Data Mover Facility</LI>
<LI>Floating-Point-Support Extensions </LI>
<LI>Halfword-Immediate instructions </LI>
<LI>Branch-Relative instructions </LI>
<LI>Incorrect-Length-Indication Suppression </LI>
<li>Interpretive Execution (SIE) </li>
<LI>Move Inverse </LI>
<LI>Move Page (Facility 2) </LI>
<LI>MVS assists </LI>
<LI>Operational Extensions: Console Integration </LI>
<LI>Private Space </LI>
<LI>Set Address Space Control Fast </LI>
<li>Service-call-logical-processor (SCLP) facility </li>
<li>Square Root</li>
<LI>Storage-Protection Override </LI>
<li>Storage Key assist</li>
<LI>String instructions </LI>
<LI>Subspace Group </LI>
<LI>Compare Until Substring Equal </LI>
<LI>Concurrent Sense </LI>
<LI>Suppression on Protection with Virtual-Address enhancement </LI>
<LI>Extended TOD clock </LI>
<li>Compression</li>
<LI>Perform Locked Operation </LI>
<li>Vector Facility</li>
<li>Multiple Controlled Data Space (VM dataspaces) </li>
<LI>Extended Translation </LI>
<li>Extended Translation Facility 2</li>
<LI>Store System Information </LI>
<LI>Cancel I/O Facility</LI>
<li>Program Event Recording</li>
<li>Guest PER enhancement</li>
</UL>

<P>The following optional features of z/Architecture have been implemented: </P>

<UL>
<li>HFP Multiply-and-Add/Subtract Facility</li>
<li>Message Security Assist</li>
<li>Long-Displacement Facility</li>
<li>DAT-Enhancement Facility</li>
<li>Extended-Translation Facility 3</li>
<li>ASN-and-LX-Reuse Facility</li>
<li>List-Directed Initial Program Load</li>
<li>Modified CCW Indirect Data Addressing (MIDAW) Facility</li>
<li>Extended-Immediate Facility</li>
<li>Message-Security-Assist Extension 1</li>
<li>Message-Security-Assist Extension 2</li>
<li>DAT-Enhancement Facility 2</li>
<li>Store-Clock-Fast Facility</li>
<li>Store-Facility-List-Extended Facility</li>
<li>ETF2-Enhancement Facility</li>
<li>ETF3-Enhancement Facility</li>
<li>PER-3 Facility</li>
<li>TOD-Clock-Steering Facility</li>
<li>Conditional-Emergency-Signal and Sense-Running-Status Facility</li>
<li>Multiple Logical Channel Subsystems Facility</li>
<li>Floating-Point-Support Enhancement Facilities
(FPR-GR-Loading, FPS-Sign-Handling, and DFP-Rounding)</li>
<li>Decimal Floating Point Facility</li>
<li>IEEE-Exception-Simulation Facility</li>
<li>Extract-CPU-Time Facility</li>
<li>Conditional-SSKE Facility</li>
<li>Compare-and-Swap-and-Store Facility</li>
<li>Execute-Extensions Facility</li>
<li>General-Instructions-Extension Facility
<li>Move-with-Optional-Specifications Facility</li>
<li>Parsing-Enhancement Facility
<li>Compare-and-Swap-and-Store Facility 2
<li>Integrated 3270 (SYSG) Console
<li>Configuration-Topology Facility
<li>HFP-Unnormalized-Extensions Facility
<li>CMPSC-Enhancement Facility
<li>High-Word Facility
<li>Interlocked-Access Facility
<li>Load/Store-on-Condition Facility
<li>Distinct-Operands Facility
<li>Population-Count Facility
<li>Message-Security-Assist Extension 3
<li>Message-Security-Assist Extension 4
<li>Fast-BCR-Serialization Facility
<li>Enhanced-Monitor Facility
<li>Reset-Reference-Bits-Multiple Facility
<li>Access-Exception-Fetch/Store-Indication Facility
<li>Load-Program-Parameter Facility
<li>IPTE-Range Facility
<li>Enhanced-DAT Facility
<li>Decimal Floating Point Zoned-Conversion Facility
<li>Execution-Hint Facility
<li>Load-and-Trap Facility
<li>Miscellaneous-Instruction-Extensions Facility
<li>Floating-Point-Extension Facility
</ul>

<P>The following optional features of z/Architecture have not yet been implemented:</P>
<ul>
<li>PFPO Facility
<li>Restore-Subchannel Facility
<li>Integrated ASCII (SYSA) Console
<li>CPU-Measurement Counter Facility
<li>CPU-Measurement Sampling Facility
<li>Nonquiescing Key-Setting Facility
<li>Enhanced-DAT Facility 2
<li>Interlocked-Access Facility 2
<li>Local-TLB-Clearing Facility
<li>PER Zero-Address-Detection Facility
<li>Processor-Assist Facility
<li>Transactional-Execution Facility
<li>Warning-Track-Interruption Facility
</ul>

<P>The following standard feature has not yet been implemented: </P>
<UL>
<LI>Clear I/O (full functionality for S/370) </LI></ul>
<P>The following optional features have been partially implemented: </P>
<UL>
<LI>Channel-Subsystem Call </LI>
<LI>VM/370 assists </LI>
</UL>
<P>The following features are not yet implemented, either due to lack
of documentation, limited host system capability, or lack of
supporting hardware: </P>
<UL>
<LI>Asynchronous Data Mover Facility </LI>
<LI>Asynchronous Pageout Facility </LI>
<LI>Coupling Links </LI>
<LI>ESCON </LI>
<LI>FICON </LI>
<LI>MIF (Multiple Image Facility) </LI>
<LI>Extended Sorting </LI>
<LI>External Time Reference (Sysplex Timer) </LI>
<LI>ICRF (Cryptography) </LI>
<LI>Operational Extensions: Automatic Reconfiguration, Storage
Reconfiguration, SCP-initiated Reset, Processor Availability </LI>
<LI>PR/SM </LI>
<LI>Program-Controlled re-IPL </LI>
</UL>
<p>Hercules is compliant with IBM's ALS-1, ALS-2 and ALS-3
architectural level sets to the degree necessary to run all OS/390
versions through 2.10 and known versions of z/OS in both ARCHLVL 1
and ARCHLVL 2 mode, and Linux and z/VM in both ESA/390 and
z/Architecture mode.</p>
<P>
<HR>
</P>
<H4><A NAME="6.01">6.01</A>
    Who are the Herculeans?
</H4>
<P>The following people are among those who have contributed to this
project, either as coders or as testers or both:</P>
<P></P>
<sl>
<li><A HREF="http://www.rogerbowler.fr/hercules.htm">Roger Bowler</A>
(original author)
<li><A HREF="http://en.wikipedia.org/wiki/Jay_Maynard">Jay Maynard</A>
<li><A HREF="http://www.cbttape.org/~jjaeger">Jan Jaeger</A>
<li>Butch Anton
<li><A HREF="http://www.bsp-gmbh.com/">Volker Bandke</A>
<li>David Barth
<li><a href="http://mvsddt.altervista.org/">Shelby Beach</a>
<li><A HREF="http://www.clueful.co.uk/mbeattie/">Malcolm Beattie</A>
<li>Mario Bezzi
<li>Florian Bilek
<li>Gordon Bonorchis
<li>Gert Caers
<li>Mike Cairns
<li>Bill Carlborg
<li>Chris Cheney
<li><a href="https://www.linkedin.com/in/marcincieslak/">Marcin Cieslak</a>
<li><a href="http://au.linkedin.com/in/clementclarke">Clem Clarke</a>
<li>Peter Coghlan
<li><a href="https://www.linkedin.com/in/viccross/">Vic Cross</a>
<li><a href="http://www.mvsdasd.org/about.html">Jacob Dekel</a>
<li>Guy Desbiens
<li>Jacques Dilbert
<li>Juergen Dobrinski
<li>Fritz Elfert
<li>Neale Ferguson
<li>Tomas Fott
<li>Mike Frysinger
<li>Martin Gasparovic
<li>Mark Gaubatz
<li>Steve Gay
<li>Paolo Giacobbis
<li>Peter Glanzmann
<li>Roland Goetschi
<li>Graham Goodwin
<li>Paul Gorlinsky
<li>Harold Grovesteen
<li>John P. Hartmann
<li>Glen Herrmannsfeldt
<li>Brandon Hill
<li>Laddie Hanus
<li>Robert Hodge
<li>Gabor Hoffer
<li>Dan Horak
<li>Peter J. Jansen
<li>Soren Jorvang
<li><a href="http://konynenberg.com/">Willem Konynenberg</a>
<li>John Kozak
<li>Nobumichi Kozawa
<li>Peter Kuschnerus
<li>Paul Leisy
<li>Kevin Leonard
<li>Albert Louw
<li>Peter Macdonald
<li>Lutz Mader
<li>Tomas Masek
<li>Rick McKelvy
<li>John McKown
<li>Dave Morton
<li>Christophe Nillon
<li>Mike Noel
<li>Andy Norrie
<li>Dutch Owen
<li><a href="http://www.lightlink.com/mhp/3705/">Max H. Parke</a>
<li>Gerd Petermann
<li>Reed H. Petty
<li>Jim Pierson
<li>Richard Pinion
<li><a href="http://www.timpinkawa.net/hercules">Tim Pinkawa</a>
<li>Pasi Pirhonen
<li>Valery Pogonchenko
<li>Andy Polyakov
<li><a href="http://www.debian.org/News/2010/20100831">Frans Pop</a>
<li><a href="http://www.xing.com/profile/Wolfhard_Reimer">Wolfhard Reimer</a>
<li>Emerson Santos
<li><a href="http://blogs.oracle.com/jsavit/">Jeff Savit</a>
<li><a href="http://de.linkedin.com/pub/axel-schwarzer/2/739/655">Axel Schwarzer</a>
<li>Paul Scott
<li>Daniel Seagraves
<li>Victor Shkamerda
<li>Ian Shorter
<li><a href="http://www.linuxvm.org/community/gsmith.html">Greg Smith</a>
<li>Enrico Sorichetti
<li>John Summerfield
<li><a href="http://www.edelweb.fr/EdelStuff/Prospectus/sylvester.html">Peter Sylvester</a>
<li>Mark Szlaga
<li>Adam Thornton
<li>Adrian Trenkwalder
<li><A HREF="http://www.softdevlabs.com/">"Fish" (David B. Trout)</A>
<li>Ronen Tzur
<li>Bernard van der Helm
<li>Ard van der Leeuw
<li>Kris Van Hees
<li>Adam Vandenberg
<li>Christophe Varlet
<li>Kees Verruijt
<li><a href="http://www.vitillaro.org/">Giuseppe Vitillaro</a>
<li>Dave Wade
<li>Ivan Warren
<li>Juergen Winkelmann
<li>Ian Worthington
<li>Rod Zazubek
<li>Bjoern A. Zeeb
<li>Matt Zimmerman
</sl></p>
<P>And thanks for support and encouragement from:</P>
<P></P>
<sl>
<li>Tim Alpaerts
<li>Bertus Bekker
<li>Giorgio de Nunzio
<li><a href="http://articles.petoskeynews.com/2012-07-27/memorial-service_32894245">Rick Fochtman</a>
<li>Alex Friis
<li>Sam Golob
<li>Achim Haag
<li><a href="http://www.legacy.com/obituaries/washingtonpost/obituary.aspx?pid=143636886">Cory Hamasaki</a>
<li>Tony Harminc
<li><a href="http://www.linuxvm.org/community/rhigson.html">Richard Higson</a>
<li><a href="http://groups.yahoo.com/group/hercules-390/message/50662">Jim Keohane</a>
<li>Sam Knutson
<li><a href="http://www.corestore.org/">Mike Ross</a>
<li>Daniel Rudin
<li><a href="http://www.linuxvm.org/community/rsmrcina.html">Rich Smrcina</a>
<li>Henk Stegeman
<li>Mark S. Waterbury
</sl></P>
<P>If anyone feels they have been unfairly omitted from either of these
lists, please let the maintainer (maintainer&nbsp;@&nbsp;hercules-390.eu) know.</P>
<P>
<HR>
</P>

<H4><A NAME="7.01">7.01</A>
    Where can I obtain technical support?
</H4>

<P>
Please see the <a href="hercsupp.html">Hercules Technical Support</a> page.
</P>

<p><center><hr width=15% noshade>
<a href="index.html"><img src="images/back.gif" border=0 alt="back"></a>
</center>
<p class="lastupd">Last updated $Date$ $Revision$</p>
</BODY>
</HTML>
hercules 3.13-1 / usr / share / hercules / hercfaq.html
