Return to site

Installing Z Vm On Hercules

broken image


Contents

Installation Procedure

  1. Z/VM: Installation Guide.
  2. Hercules is a computer emulator allowing software written for IBM mainframe computers (System/370, System/390, and zSeries/System z) and for plug compatible mainframes (such as Amdahl machines) to run on other types of computer hardware, notably on low-cost personal computers.Development started in 1999 by Roger Bowler, a mainframe systems programmer.

Building from source - Windows (without Cygwin)

For building the MSVC version of Hercules on Windows (a version ofHercules that does not require Cygwin), Fish has instructions on his'MSVC Hercules Build Instructions' web page athttp://www.softdevlabs.com/Hercules/hercules-msvc-build.html.

Building from source - Windows with Cygwin

VM/S (or Voie Marine/Seaway) HERCULES was built in 1962 at Marine Industries of Sorel, Quebec, and the self propelled 200' floating heavy lift crane barge is the only St. Lawrence Seaway owned heavy lift crane specifically designed to lift their lock's large 500 tonne gates. How often she was called upon to complete such a task is unknown with.

Installing Z Vm On Hercules

For building the Cygwin version of Hercules on Windows, Volker Bandkehas instructions on his 'Building Hercules for Windows' web page athttp://www.bsp-gmbh.com/hercules/herc_w32_2.html.

Building from source - Linux and Mac OS X

  1. Download the distribution filehercules-3.07.tar.gz
    Note: By downloading this file you agree to the terms of the Q Public Licence.
  2. Use these commands to unzip the distribution file:
  3. Verify you have all of the correct versions of all of therequired packages installed:

    ./util/cvslvlck

  4. Configure Hercules for your system:

    ./configure

    By default, the configure script will attempt to guess appropriate compiler optimization flags for your system. If its guesses turn out to be wrong, you can disable all optimization by passing the --disable-optimization option to configure, or specify your own optimization flags with --enable-optimization=FLAGS

    For additional configuration options, run: ./configure --help

  5. Build the executables:

    make

  6. Install the programs: as root:

    make install

Important:You must use at least version 2.95 of the gcc compiler and the glibc2 library.Refer to the Hercules Frequently-Asked Questions page for requiredcompiler and other software levels.

Installing prebuilt RPMs:

  1. Download the RPM file you want:
    • hercules-3.07-1.i686.rpm: 32-bit Intel
    • hercules-3.07-1.x86_64.rpm: 64-bit Intel
  2. Install the RPM:
    rpm -UvhRPMfile

Installing Z Vm On Hercules Download

This will leave the Hercules executables in /usr/bin and the dynamiclibraries in /usr/lib and /usr/lib/hercules, where you can run themfrom anywhere. Sample configuration files will be placed in /etc/hercules,and the IPLable card deck for the ZZSA standalone utility will be placed in/var/share/hercules.

Installing Debian packages:

Debian packages are available for 'woody' and later releases.

  • Using apt: apt-get install hercules
  • Manually with dpkg:
    1. Download a .deb package
    2. dpkg -iDEB

Installing on Gentoo Linux:

Installing Z Vm On Hercules Mulligan

Hercules is installed like any other Gentoo package: do emerge--sync if you haven't done it lately, then emergehercules.

Hercules

Do not try to override the optimization flags automatically selected byconfigure. Hercules stresses the gcc optimizer, and will breakin subtle ways if the wrong optimization settings are used.

Installing on Mac OS X:

  1. Download the compressed disk image: hercules-3.07-tiger.dmg,hercules-3.07-leopard.dmg,or hercules-3.07-snowleopard.dmg.This package is a universal binary and requires the OS X version in thename, either 10.4 (Tiger), 10.5 (Leopard), 10.6 (Snow Leopard) or later. TheLeopard and Snow Leopard versions include native 64-bit host support, whilethe Tiger version does not. The Tiger and Leopard versions will run on Intelor PowerPC Macs, while the Snow Leopard version will only run on Intel, aswith Snow Leopard itself.
  2. Mount the image by double-clicking on it in the Finder.Your web browser may have done that for you already.
  3. Installation and use instructions are in thefile OS X ReadMe.rtf.
  4. If you want to use CTC networking on your Hercules system, you will needto install the supplied Tunnel driver.

Installing on Windows (without Cygwin):

  1. Download the Windows 32-bitInstaller package or the Windows 64-bitInstaller package.
  2. Use the Windows Installer to install Hercules. The Windows Installer isincluded in Windows XP. It may already be on your older Windows system,depending on what other software you've installed. If it is, double-clickingon the Hercules package file will install Hercules. If not, you can downloadthe Windows Installer for Windows NT and 2000 by followingthislink, or the Windows Installer for Windows 98 and ME by followingthislink.
  3. You will probably also want to install Fish's Hercules GUI for Windows.You can get it from http://www.softdevlabs.com/Hercules/hercgui-index.html.

Installing on Windows with Cygwin:

  1. Hercules 3.07 is now supplied as prebuilt binaries only in a native Windowsversion. This version will work perfectly well under Cygwin, as well asnative Windows, and does not require any specific version of the Cygwinlibraries. Follow the instructions above to install the native Windowsversion.

Configuration Procedure

You will need to amend the configuration filehercules.cnf to reflect your device layout and intendedmode of operation (S/370, ESA/390, or z/Architecture).See the Hercules Configuration File page fora complete description.

Installing Z Vm On Hercules Tv

Creating DASD volumes

The Creating Hercules DASD pagedescribes various methods of creating and loading virtual DASDvolumes. The compressed CKD DASD support is described in this page.

Operating Procedure

Note: If you intend to run any licensed software on your PCusing Hercules, it is your responsibility to ensure that you do notviolate the software vendor's licensing terms.

Starting Hercules

Z/vse

To start Hercules enter this command at the Unix or Windows command prompt:

where:

filename
is the name of the configuration file. The default, if none is specified, is hercules.cnf. The default may be overridden via the HERCULES_CNF environment variable.
-d
specifies that Hercules is to be run in 'daemon' mode, wherein it runs invisibly with no attached console.
dyndir
is the directory from which dynamic modules are to be loaded. The default depends on the host platform on which Hercules is being run. This option overrides the default.
dynmod
is the name of an additional dynamic module to be loaded at startup. More than one additional module may be specified, although each must be preceded with the -l option specifier.
logfile
is an optional log file which will receive a copy of all messages displayed on the control panel
Hercules

Next connect a tn3270 client to the console port (normally port 3270).The client will be connected to the first 3270 device address specifiedin the configuration file (this should be the master console address).If your master console is a 1052 or 3215, connect a telnet clientinstead of a tn3270 client.

Now you can enter an ipl command from the control panel.


Using the keyboard

The main Hercules screen contains a scrollable list of messages with a commandinput area and system status line at the bottom of the screen.

Full

To scroll through the messages, use either the Page Up or Page Down keys,the Ctrl + Up Arrow or Ctrl + Down Arrow keys, or the Home or End and/orthe Ctrl + Home or Ctrl + End keys.

Important messages are highlighted in a different color (usually red) and areprevented from being scrolled off the screen for two minutes. If Extended Cursorhandling is available then important messages currently at the top of the screencan be removed early by moving the cursor to the line containing the messageand then pressing enter.

Use the Insert key to switch between insert and overlay mode when typing inthe command input area. Use the Home and End keys to move to the first orlast character of the command you are typing, or the use the left/right arrow keysto move to a specific character. Use the Escape key to erase the input area.

Pressing Escape when the command input area is already empty causes the screento switch to the semi-graphical 'New Panel' display mode, which shows the overallstatus of the system and devices.

When in the semi-graphical 'New Panel' display mode there is no command inputarea. Instead, single character 'hot keys' are used to issue some of the morecommon functions such as starting or stopping the CPU. The hot-keys are thosewhich are highlighted. Pressing the '?' key displays brief help informationon how to use the semi-graphical panel.

Windows 10 or mac os for desktop users reviewed. Microsoft Windows 10 Windows 10 delivers a refined, vastly improved vision for the future of computing with an operating system that's equally at home on tablets and traditional PCs - and it's a. Windows 10 is now the most popular desktop OS in the world, with over 800m users. Its biggest rival, macOS, lags far behind in terms of market share, and while Apple is usually coy about releasing. Mac's version is a bit more systemwide, with some older Windows dialogs still not darkened. The Windows 10 May 2019 Update adds a Custom option, which lets you decide whether you want dark.

Normal cursor handling
KeyAction
Esc Erases the contents of the command input area. If the command input area is already empty, switches to semi-graphical New Panel.
Del Deletes the character at the cursor position.
Backspace Erases the previous character.
Insert Toggles between insert mode and overlay mode.
Tab Attempts to complete the partial file name at the cursor position in the command input area. If more than one possible file exists, a list of matching file names is displayed.
Home Moves the cursor to the start of the input in the command input area. If the command input area is empty, scrolls the message area to the top.
End Moves the cursor to the end of the input in the command input area. If the command input area is empty, scrolls the message area to the bottom.
Page Up Scrolls the message area up one screen.
Page Down Scrolls the message area down one screen.
Up arrow Recalls previous command into the input area.
Down arrow Recalls next command into the input area.
Right arrow Moves cursor to next character of input area.
Left arrow Moves cursor to previous character of input area.
Ctrl + Up arrow Scrolls the message area up one line.
Ctrl + Down arrow Scrolls the message area down one line.
Ctrl + Home Scrolls the message area to the top.
Ctrl + End Scrolls the message area to the bottom.

The following additional keyboard functions are effective when theHercules Extended Cursor Handling feature (OPTION_EXTCURS) is activatedat compile time.At present, this feature is activated on the Windows platform only.

Extended cursor handling
KeyAction
Alt + Up arrow Moves cursor up one row.
Alt + Down arrow Moves cursor down one row.
Alt + Right arrow Moves cursor right one column.
Alt + Left arrow Moves cursor left one column.
Tab If cursor is outside the command input area, moves cursor to the start of the input in the command input area. Otherwise behaves as described in previous table.
Home If cursor is outside the command input area, moves cursor to the start of the input in the command input area. Otherwise behaves as described in previous table.
End If cursor is outside the command input area, moves cursor to the end of the input in the command input area. Otherwise behaves as described in previous table.

Panel commands

The following is what is displayed on the Hercules harware console (HMC)in response to the '?' command being entered. Please note that it may notbe completely accurate or up-to-date. Please enter the '?' command foryourself for a more complete, accurate and up-to-date list of supportedpanel commands.

Hercules

For building the Cygwin version of Hercules on Windows, Volker Bandkehas instructions on his 'Building Hercules for Windows' web page athttp://www.bsp-gmbh.com/hercules/herc_w32_2.html.

Building from source - Linux and Mac OS X

  1. Download the distribution filehercules-3.07.tar.gz
    Note: By downloading this file you agree to the terms of the Q Public Licence.
  2. Use these commands to unzip the distribution file:
  3. Verify you have all of the correct versions of all of therequired packages installed:

    ./util/cvslvlck

  4. Configure Hercules for your system:

    ./configure

    By default, the configure script will attempt to guess appropriate compiler optimization flags for your system. If its guesses turn out to be wrong, you can disable all optimization by passing the --disable-optimization option to configure, or specify your own optimization flags with --enable-optimization=FLAGS

    For additional configuration options, run: ./configure --help

  5. Build the executables:

    make

  6. Install the programs: as root:

    make install

Important:You must use at least version 2.95 of the gcc compiler and the glibc2 library.Refer to the Hercules Frequently-Asked Questions page for requiredcompiler and other software levels.

Installing prebuilt RPMs:

  1. Download the RPM file you want:
    • hercules-3.07-1.i686.rpm: 32-bit Intel
    • hercules-3.07-1.x86_64.rpm: 64-bit Intel
  2. Install the RPM:
    rpm -UvhRPMfile

Installing Z Vm On Hercules Download

This will leave the Hercules executables in /usr/bin and the dynamiclibraries in /usr/lib and /usr/lib/hercules, where you can run themfrom anywhere. Sample configuration files will be placed in /etc/hercules,and the IPLable card deck for the ZZSA standalone utility will be placed in/var/share/hercules.

Installing Debian packages:

Debian packages are available for 'woody' and later releases.

  • Using apt: apt-get install hercules
  • Manually with dpkg:
    1. Download a .deb package
    2. dpkg -iDEB

Installing on Gentoo Linux:

Installing Z Vm On Hercules Mulligan

Hercules is installed like any other Gentoo package: do emerge--sync if you haven't done it lately, then emergehercules.

Do not try to override the optimization flags automatically selected byconfigure. Hercules stresses the gcc optimizer, and will breakin subtle ways if the wrong optimization settings are used.

Installing on Mac OS X:

  1. Download the compressed disk image: hercules-3.07-tiger.dmg,hercules-3.07-leopard.dmg,or hercules-3.07-snowleopard.dmg.This package is a universal binary and requires the OS X version in thename, either 10.4 (Tiger), 10.5 (Leopard), 10.6 (Snow Leopard) or later. TheLeopard and Snow Leopard versions include native 64-bit host support, whilethe Tiger version does not. The Tiger and Leopard versions will run on Intelor PowerPC Macs, while the Snow Leopard version will only run on Intel, aswith Snow Leopard itself.
  2. Mount the image by double-clicking on it in the Finder.Your web browser may have done that for you already.
  3. Installation and use instructions are in thefile OS X ReadMe.rtf.
  4. If you want to use CTC networking on your Hercules system, you will needto install the supplied Tunnel driver.

Installing on Windows (without Cygwin):

  1. Download the Windows 32-bitInstaller package or the Windows 64-bitInstaller package.
  2. Use the Windows Installer to install Hercules. The Windows Installer isincluded in Windows XP. It may already be on your older Windows system,depending on what other software you've installed. If it is, double-clickingon the Hercules package file will install Hercules. If not, you can downloadthe Windows Installer for Windows NT and 2000 by followingthislink, or the Windows Installer for Windows 98 and ME by followingthislink.
  3. You will probably also want to install Fish's Hercules GUI for Windows.You can get it from http://www.softdevlabs.com/Hercules/hercgui-index.html.

Installing on Windows with Cygwin:

  1. Hercules 3.07 is now supplied as prebuilt binaries only in a native Windowsversion. This version will work perfectly well under Cygwin, as well asnative Windows, and does not require any specific version of the Cygwinlibraries. Follow the instructions above to install the native Windowsversion.

Configuration Procedure

You will need to amend the configuration filehercules.cnf to reflect your device layout and intendedmode of operation (S/370, ESA/390, or z/Architecture).See the Hercules Configuration File page fora complete description.

Installing Z Vm On Hercules Tv

Creating DASD volumes

The Creating Hercules DASD pagedescribes various methods of creating and loading virtual DASDvolumes. The compressed CKD DASD support is described in this page.

Operating Procedure

Note: If you intend to run any licensed software on your PCusing Hercules, it is your responsibility to ensure that you do notviolate the software vendor's licensing terms.

Starting Hercules

Z/vse

To start Hercules enter this command at the Unix or Windows command prompt:

where:

filename
is the name of the configuration file. The default, if none is specified, is hercules.cnf. The default may be overridden via the HERCULES_CNF environment variable.
-d
specifies that Hercules is to be run in 'daemon' mode, wherein it runs invisibly with no attached console.
dyndir
is the directory from which dynamic modules are to be loaded. The default depends on the host platform on which Hercules is being run. This option overrides the default.
dynmod
is the name of an additional dynamic module to be loaded at startup. More than one additional module may be specified, although each must be preceded with the -l option specifier.
logfile
is an optional log file which will receive a copy of all messages displayed on the control panel

Next connect a tn3270 client to the console port (normally port 3270).The client will be connected to the first 3270 device address specifiedin the configuration file (this should be the master console address).If your master console is a 1052 or 3215, connect a telnet clientinstead of a tn3270 client.

Now you can enter an ipl command from the control panel.


Using the keyboard

The main Hercules screen contains a scrollable list of messages with a commandinput area and system status line at the bottom of the screen.

To scroll through the messages, use either the Page Up or Page Down keys,the Ctrl + Up Arrow or Ctrl + Down Arrow keys, or the Home or End and/orthe Ctrl + Home or Ctrl + End keys.

Important messages are highlighted in a different color (usually red) and areprevented from being scrolled off the screen for two minutes. If Extended Cursorhandling is available then important messages currently at the top of the screencan be removed early by moving the cursor to the line containing the messageand then pressing enter.

Use the Insert key to switch between insert and overlay mode when typing inthe command input area. Use the Home and End keys to move to the first orlast character of the command you are typing, or the use the left/right arrow keysto move to a specific character. Use the Escape key to erase the input area.

Pressing Escape when the command input area is already empty causes the screento switch to the semi-graphical 'New Panel' display mode, which shows the overallstatus of the system and devices.

When in the semi-graphical 'New Panel' display mode there is no command inputarea. Instead, single character 'hot keys' are used to issue some of the morecommon functions such as starting or stopping the CPU. The hot-keys are thosewhich are highlighted. Pressing the '?' key displays brief help informationon how to use the semi-graphical panel.

Windows 10 or mac os for desktop users reviewed. Microsoft Windows 10 Windows 10 delivers a refined, vastly improved vision for the future of computing with an operating system that's equally at home on tablets and traditional PCs - and it's a. Windows 10 is now the most popular desktop OS in the world, with over 800m users. Its biggest rival, macOS, lags far behind in terms of market share, and while Apple is usually coy about releasing. Mac's version is a bit more systemwide, with some older Windows dialogs still not darkened. The Windows 10 May 2019 Update adds a Custom option, which lets you decide whether you want dark.

Normal cursor handling
KeyAction
Esc Erases the contents of the command input area. If the command input area is already empty, switches to semi-graphical New Panel.
Del Deletes the character at the cursor position.
Backspace Erases the previous character.
Insert Toggles between insert mode and overlay mode.
Tab Attempts to complete the partial file name at the cursor position in the command input area. If more than one possible file exists, a list of matching file names is displayed.
Home Moves the cursor to the start of the input in the command input area. If the command input area is empty, scrolls the message area to the top.
End Moves the cursor to the end of the input in the command input area. If the command input area is empty, scrolls the message area to the bottom.
Page Up Scrolls the message area up one screen.
Page Down Scrolls the message area down one screen.
Up arrow Recalls previous command into the input area.
Down arrow Recalls next command into the input area.
Right arrow Moves cursor to next character of input area.
Left arrow Moves cursor to previous character of input area.
Ctrl + Up arrow Scrolls the message area up one line.
Ctrl + Down arrow Scrolls the message area down one line.
Ctrl + Home Scrolls the message area to the top.
Ctrl + End Scrolls the message area to the bottom.

The following additional keyboard functions are effective when theHercules Extended Cursor Handling feature (OPTION_EXTCURS) is activatedat compile time.At present, this feature is activated on the Windows platform only.

Extended cursor handling
KeyAction
Alt + Up arrow Moves cursor up one row.
Alt + Down arrow Moves cursor down one row.
Alt + Right arrow Moves cursor right one column.
Alt + Left arrow Moves cursor left one column.
Tab If cursor is outside the command input area, moves cursor to the start of the input in the command input area. Otherwise behaves as described in previous table.
Home If cursor is outside the command input area, moves cursor to the start of the input in the command input area. Otherwise behaves as described in previous table.
End If cursor is outside the command input area, moves cursor to the end of the input in the command input area. Otherwise behaves as described in previous table.

Panel commands

The following is what is displayed on the Hercules harware console (HMC)in response to the '?' command being entered. Please note that it may notbe completely accurate or up-to-date. Please enter the '?' command foryourself for a more complete, accurate and up-to-date list of supportedpanel commands.

The ipl command may also be used to perform a load from cdrom orserver. For example if a standard SuSE S/390 Linux distribution CD is loadedand mounted on /cdrom for example, this cdrom may then be ipl-ed by:ipl /cdrom/suse.ins

The attach and detach commands are used to dynamicallyadd or remove devices from the configuration,and the define command can be used to alter the device numberof an existing device.

The devinit command can be used to reopen an existing device.The args (if specified) override the argumentsspecified in the configuration file for this device.The device type cannot be changed and must not be specified.This command can be used to rewind a tape, to mount a new tape ordisk image file on an existing device, to load a new card deckinto a reader, or to close and reopen a printer or punch device.

In single-step mode, pressing the enter key will advance to thenext instruction.

There is also an alternate semi-graphical control panel. Press Esc toswitch between the command line format and the semi-graphical format.Press ? to obtain help in either control panel.

Some commands also offer additional help information regarding their syntax,etc. Enter 'help ' to displaythis additional help information. (Note: not every command supports help)

When a command is prefixed with '-', the the command will not be redisplayed atthe console. Keepvid youtube downloader mp3. This can be used in scripts and is also used internally when commandsare to be invoked without being redisplayed at the panel.

The hercules.rc (run-commands) file

Hercules also supports the ability to automatically execute panel commandsupon startup via the 'run-commands' file. If the run-commands fileis found to exist when Hercules starts, each line contained within it isread and interpreted as a panel command exactly as if the command wereentered from the HMC system console.

The default filename for the run-commands file is 'hercules.rc', but may beoverridden by setting the 'HERCULES_RC' environment variable to thedesired filename.

Cummins insite pro download free. Except for the 'pause' command (see paragraph further below), each commandread from the run-commands file is logged to the console preceded by a '> '(greater-than sign) character so you can easily distinguish between panelcommands entered from the keyboard from those entered via the .rc file.

Lines starting with '#' are treated as 'silent comments' and arethus not logged to the console. Line starting with '*' however aretreated as 'loud comments' and will be logged.

In addition to being able to execute any valid panel command (including the'sh' shell command) via the run-commands file, an additional'pause nnn' command is supported in order to introducea brief delay before reading and processing the next line in the file. Thevalue nnn can be any number from 1 to 999 and specifies thenumber of seconds to delay before reading the next line. Creative use of therun-commands file can completely automate Hercules startup.

The 'Hercules Automatic Operator' (HAO) Facility

The Hercules Automatic Operator (HAO) feature is a facility that allows oneto automatically issue panel commands in response to certain messages beingissued.

To use the Hercules Automatic Operator facility, one first defines a 'rule'consisting of a 'target' and an associated 'command'. The 'target' is justa regular expression pattern used to match against the text of the variousmessages that Hercules issues as it runs. Whenever a match is found, therule 'fires' and its associated command is automatically issued.

The Hercules Automatic Operator facility is only for those messagesissued by Hercules to its HMC (hardware console). It cannotbe used for whatever messages the guest operating system may issue to anyof its terminals. It is only a Hercules automatic operator andnot a 'VSE', 'MVS', 'VM', etc, automatic operator.

Defining a Rule

Installing Z Vm On Hercules Poirot

To define a HAO rule, enter the command:

to define the rule's 'target' match pattern (a simple regular expression),followed by the command:

to define the rule's associated panel-command.

The target pattern is a simple regular expression value as defined bywhatever regular expression facility your host build platform happensto support. For Windows it must be a Perl Compatible Regular Expression (PCRE).For other supported build platforms it might be some other supported regularexpression syntax. Check your host platform's programming documentation forfurther details.

The associated command is whatever valid Hercules panel command youwish to issue in response to a message being issued that matches the givenpattern target.

Installing Z Vm On Hercules Full

Other commands and limitations

To delete a fully or partially defined HAO rule, first use the 'hao list'command to list all of the defined (or partially defined) rules, and then usethe 'hao del nnn' command to delete the specific rule identified by nnn.(All rules are assigned numbers as they are defined and are thus identifiedby their numeric value). Optionally, one may delete ALL defined or partiallydefined rules by issuing the command 'hao clear'.

The current implementation limits the total number of defined rules to 64. Ifyou need to define more than 64 rules you will either have to build Herculesfor yourself (increasing the value of the HAO_MAXRULE constant in hao.c) orelse beg one of the Hercules developers to please do it for you.

Note that there is currently no way to define a command whose arguments varybased on actual message text. That is to say, there is currently no way to say

'Reply with the command 'devinit cuu filename' in response to message text 'HHCXXnnnI Device cuu intervention required.' where cuu is whatever cuu was identified in the message.'

The HAO is not that sophisticated (yet). Only simple plain-text commands maybe defined and issued. No automatic substitution is done based on message text(although normal 'DEFSYM' symbol substitution is supported however, as thatis a normal panel-command feature supported separately from the HAO). This maypossibly change in the future however, depending on user need/demand.

All defined rules are checked for a match each time Hercules issues a message.There is no way to specify 'stop processing subsequent rules'. If a message isissued that matches two or more rules, each associated command is then issuedin sequence. Thus the advice to choose your rules' target patterns carefullyvery much applies here.

Technical Support

Installing Z Vm On Hercules Dvd

For technical support, please see our Technical Support web page.

Last updated $Date: 2010-03-09 09:14:00 -0600 (Tue, 09 Mar 2010) $ $Revision: 5661 $





broken image