BSP - Beratung, Schulung, Projekte


Some Frequently Asked (and Answered) Questions

  1. I have downloaded Hercules. What now?
  2. When I try to run Hercules for Windows, the system complains about missing dlls. What is the problem?
  3. Why don't I see any output on my telnet or 3270 client?
  4. Why doesn't Hercules IPL my mainframe OS
  5. I have set ARCHMODE correctly, and still Hercules doesn't IPL my OS. Why not?
  6. Why can't I use more than 220 MB of mainsize on Hercules for Windows?
  7. Hercules doesn't start, because gcc.dll is missing. Where can I find it?
  8. Hercules refuses to start after issuing msg HHCF042E. What can I do?
  9. I tried everything, but still get msg HHCF042E. Why?

I have downloaded Hercules. What now?

Very simple. Place the hercules binaries (and any required modules and/or DLLs) into a directory on your computer's search path. Read all the Hercules documentation that you can find. Start at the Hercules Main Page, especially on how to build DASD images and configuration file(s) for Hercules. Then invoke the Hercules binary, and IPL your mainframe OS

back to top

When I try to run Hercules for Windows, the system complains about missing dlls. What is the problem?

Very simple. You have not downloaded everything that was needed. For running under Windows the Hercules executable files need support DLLs from CYGWIN. There is a pointer to a download location where you got the Hercules executables. For your convenience : Cygwin DLLs.

back to top

Why don't I see any output on my telnet or tn3270 screen?

The telnet clients usually use port 23 for their connection port. Hercules specifies the listening port in the Hercules configuration file with the CNSLPORT parameter. It is usually set to 3270. With other word, you must point your 3270 or telnet client to that port

back to top

Why doesn't Hercules IPL my mainframe OS? I tried with MVS turnkey system, and it worked, but with LINUX/390 or z/LINUX it doesn't.

You need to set the correct ARCHMODE in the Hercules configuration file. You can choose from

For running Linux/390 you need ARCHMODE ESA/390, while for MVS 3.8 you need ARCHMODE S/370

back to top

I have set ARCHMODE correctly, and still Hercules doesn't IPL my OS. Why not?

The Operating system you are trying to IPL might be licenced by IBM. IBM does not normally allow running their licensed OS under Hercules. Therefore the capability of running those operating systems (like OS/390, z/OS, and others) has been switched off in Hercules beginning with Version 2.16. After you have obtained a valid license for running the OS on Hercules, you can switch support back on again using the

PGMPRDOS LICENSED
configuration entry in the hercules configuration file

back to top

Why can't I use more than xxx MB of main storage with Hercules on Windows?

There are three solutions to this problem:

  1. Upgrade to Cygwin 1.3.13 or higher
    Note that the Windows task manager will report twice as much virtual memory consumption than actually used. This seems to be a Cygwin bug. You might want to read http://groups.yahoo.com/group/hercules-390/message/27812 and the follow-up messages
  2. This one involves modifying the Windows registry. If you don't feel comfortably doing so, you might consider the third alternative
    Hercules uses CYGWIN on the Windows platform. CYGWIN has a registry setting with which you can control the size of the memory that can be allocated to a CYGWIN application:
    Stop hercules and all CYGWIN applications (like CYGWIN terminal sessions etc).
    Use REGEDIT to locate the registry entry at
    HKEY_CURRENT_USER\Software\Cygnus Solutions\Cygwin\
    Create a new DWORD value there called heap_chunk_in_mb that contains the maximum amount of memory (in Mb) Hercules needs (watch the hex/decimal toggle). Exit and restart all cygwin applications.
    The memory allocation in Hercules 3.00 has dramatically changed. Therefore, if you run into a "memory exhausted" situation, the best advice now is to remove the heap_chunk_in_mb entry altogether
  3. Here is an alternative if you don't want to fiddle around with the registry. I haven't tried it, but take a look at http://sources.redhat.com/ml/cygwin/2000-08/msg00325.html
    This alternative is implemented in Cygwin 1.1.13 and higher

back to top

Hercules doesn't start, because gcc.dll is missing. Where can I find it?

Ah, you are using an older Version of Cygwin (and probably Hercules as well). You should upgrade to a newer version (then gcc.dll would no longer be needed). Take a look at the Distribution Archives

back to top

Hercules refuses to start after msgs HHCCF042E

This can happen with Hercules Version 3.00 or higher. The message

HHCCF042E Device type <devtype> not recognized
indicates that the loadable modules for device <devtype> could not be loacted. These modules are called hdt<devtype>.<suffix> (like in hdt3270.dll on Windows or hdt3270.so on Linux ) and are usually located in /usr/local/lib/hercules (for Linux) or c:\cygwin\usr\local\lib\hercules (for windows). At startup you will see a message telling where Hercules expects the loadable modules to be. If the modules are there, and Hercules still doesn't find them, there is a bug in Hercules (perhaps) and you need to report it to get a resolution.

If they are not in the specified directory, you did something non-standard during installation and managed to confuse poor little Hercules. Try to find into which directory you placed the modules. If you can't find them anywhere on your computer, something went seriously wrong during your Hercules install and you should uninstall Hercules, reboot, and re-install Hercules to fix things.

If, on the other hand, you do find the modules, then you could just move them to the place where Hercules expects them. This may or may not be a good idea - depending on how/why the modules wound up in a different subdirectory than intended. Should you re-install Hercules at same later point in time, the new modules would still go to the non-standard directory, and Hercules might pick up the old (now wrong) modules from the standard directory.

You do have alternatives, though. Assume that the modules are located in

Depending on the OS you are using you could now

If you choose one of those alternatives remember to undo them once you install Hercules loadable modules into the standard directory. Otherwise you might pick up the wrong modules .

back to top

I tried everything, but still get msg HHCF042E. Why?

I don't know. But perhaps hercules knows :). Assume that the message HHCF042E has been issued for device type 3270. The enter the following command on the Hercules console

 ldmod hdt3270.la               for Linux
 ldmod hdt3270.dll              for Windows
The error message should give an indication as to what went wrong (like file not found, version mismatch, missing or invalid dependencies, etc etc). Typing in
lsmod
gives information of what got loaded into hercules, and what didn't get loaded

back to top

If I managed to confuse you with these instructions, just drop me a line.

Enjoy your private Hercules mainframe




BSP Beratung, Schulung, Projekte GmbH