Contents

1. Installing Z/vm On Hercules
2. Installing Z Vm On Hercules Tv
3. Z/vse

Installation Procedure

Building from source - Windows

Installing Z/vm On Hercules Pokemon Leaf Green Randomizer Rom Download Step Up All In full movie, online Download Lagu Sayang Apa Kabar Denganmu Disini Ku Merindukanmu. You will leave the course with the knowledge to perform the steps to add Linux guest systems and other virtual machines to the z/VM system, to define and create saved segments, to apply service to the z/VM system, and to define a minimal TCP/IP configuration.

1. Download the distribution filehercules-3.13.zip
2. (optional) If you want your executable to support compressed DASD or the Hercules Automatic Operator (HAO), also download these packages:
   • zlib-1.2.5.zip for gzip compression
   • bzip2-1.0.6.zip for bzip2 compression
   • pcre-8.20.zip for regular expressions (required to support HAO)
3. Hercules for Windows is built using the Microsoft Visual C (MSVC) compiler.Refer to file README.WIN32 or README.WIN64 for details.

Building from source - Mac OS X

1. Install Xcode from theApp Store.
2. Install Homebrew using the procedure describedat http://brew.sh/
3. Use these commands to install pre-requisite software:
   brew install autoconf
brew install automake
brew install gnu-sed
automake --add-missing
4. Proceed with Building from source - Linux and Mac OS X below.

Building from source - Linux and Mac OS X

1. Download the distribution filehercules-3.13.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/bldlvlck

4. Generate the configure script:

   ./autogen.sh

5. 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

6. Build the executables:

   make

7. Install the programs: as root:

   make install

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

Installing pre-built binaries for Mac OS X:

Homebrew'>Homebrew may be used to installHercules on a Mac with an Intel processor and OS X 10.5 or above.

1. Homebrew requires Xcode which can be installed from theApp Store.
2. Install Homebrew using the procedure describedat http://brew.sh/
3. Enter these commands at a terminal prompt:
   brew help
brew doctor
brew install hercules

Installing pre-built binaries for Windows:

1. Download one of the following packages
   • http://downloads.hercules-390.eu/hercules-3.13-w32.msi Windows 32-bit Installer package
   • http://downloads.hercules-390.eu/hercules-3.13-w64.msi Windows 64-bit Installer package
   • http://downloads.hercules-390.eu/hercules-3.13-w32.zip Windows 32-bit binaries
   • http://downloads.hercules-390.eu/hercules-3.13-w64.zip Windows 64-bit binaries
2. You may also want to install Fish's Hercules GUI for Windows.You can get it from http://www.softdevlabs.com/Hercules/hercgui-index.html.

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.

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

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.

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.

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 <command name>' 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. 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.

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.

Installing Z/vm On Hercules

The 'Hercules Automatic Operator' (HAO) Facility

The Hercules Automatic Operator (HAO) feature is a facility which canautomatically issue panel commands in response to specific messagesappearing on the Hercules console.

To use the Hercules Automatic Operator facility, you first define a 'rule'consisting of a 'target' and an associated 'command'. The 'target' isa 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 only operates on messages issuedto the Hercules console. These messages may originate from Hercules itself,or from the guest operating system via the SCP SYSCONS interface or via theintegrated console printer-keyboard (3215-C or 1052-C). HAO cannot interceptmessages issued by the guest operating system to its own terminals.

Defining a Rule

To define a HAO rule, enter the command:

to define the rule's 'target' match patternfollowed by the command:

to define the rule's associated panel-command.

The target is a regular expression as defined by your host platform.When running on Linux, Hercules uses POSIX Extended Regular Expression syntax.On a Windows platform, regular expression support is provided byPerl Compatible Regular Expression (PCRE).The HAO facility can only be used if regular expression support was includedin Hercules at build time.

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

Substituting substrings in the command

The command may contain special variables $1, $2, etc, which will bereplaced by the values of 'capturing groups' in the match pattern.A capturing group is a part of the regular expression enclosed in parentheseswhich is matched with text in the target message. In this way, commands may beconstructed which contain substrings extracted from the message whichtriggered the command.

The following special variables are recognized:

• $1 to $9 - the text which matched the 1st to 9th capturing group in the target regular expression
• $` - the text preceding the regular expression match
• $' - the text following the regular expression match
• $$ - replaced by a single dollar sign

Note that substitution of a $n variable does not occur if there arefewer than n capturing groups in the regular expression.

As an example, the rule below issues the command 'i 001F' in response tothe message HHCTE014I 3270 device 001F client 127.0.0.1 connection reset:

Another example, shown below, illustrates how the dot matrix display of a3480 tape unit might be used to implement an automatic tape library:

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 bynnn (all rules are assigned numbers as they are defined and are thusidentified by their numeric value). Optionally, you can delete all defined orpartially defined rules by issuing the command 'hao clear'.

The current implementation limits the total number of defined rules to 64.This limit may be raised by increasing the value of the HAO_MAXRULEconstant in hao.c and rebuilding Hercules.

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.

Technical Support

For technical support, please see the Hercules Technical Support page.

Last updated $Date$ $Revision$

Contents

Installation Procedure

Building from source - Windows

1. Download the distribution filehercules-3.13.zip
2. (optional) If you want your executable to support compressed DASD or the Hercules Automatic Operator (HAO), also download these packages:
   • zlib-1.2.5.zip for gzip compression
   • bzip2-1.0.6.zip for bzip2 compression
   • pcre-8.20.zip for regular expressions (required to support HAO)
3. Hercules for Windows is built using the Microsoft Visual C (MSVC) compiler.Refer to file README.WIN32 or README.WIN64 for details.

Building from source - Mac OS X

1. Install Xcode from theApp Store.
2. Install Homebrew using the procedure describedat http://brew.sh/
3. Use these commands to install pre-requisite software:
   brew install autoconf
brew install automake
brew install gnu-sed
automake --add-missing
4. Proceed with Building from source - Linux and Mac OS X below.

Building from source - Linux and Mac OS X

1. Download the distribution filehercules-3.13.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/bldlvlck

4. Generate the configure script:

   ./autogen.sh

5. 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

6. Build the executables:

   make

7. Install the programs: as root:

   make install

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

Installing pre-built binaries for Mac OS X:

Homebrew'>Homebrew may be used to installHercules on a Mac with an Intel processor and OS X 10.5 or above.

1. Homebrew requires Xcode which can be installed from theApp Store.
2. Install Homebrew using the procedure describedat http://brew.sh/
3. Enter these commands at a terminal prompt:
   brew help
brew doctor
brew install hercules

Installing pre-built binaries for Windows:

1. Download one of the following packages
   • http://downloads.hercules-390.eu/hercules-3.13-w32.msi Windows 32-bit Installer package
   • http://downloads.hercules-390.eu/hercules-3.13-w64.msi Windows 64-bit Installer package
   • http://downloads.hercules-390.eu/hercules-3.13-w32.zip Windows 32-bit binaries
   • http://downloads.hercules-390.eu/hercules-3.13-w64.zip Windows 64-bit binaries
2. You may also want to install Fish's Hercules GUI for Windows.You can get it from http://www.softdevlabs.com/Hercules/hercgui-index.html.

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.

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

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.

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.

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 <command name>' 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. 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.

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 which canautomatically issue panel commands in response to specific messagesappearing on the Hercules console.

To use the Hercules Automatic Operator facility, you first define a 'rule'consisting of a 'target' and an associated 'command'. The 'target' isa 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 only operates on messages issuedto the Hercules console. These messages may originate from Hercules itself,or from the guest operating system via the SCP SYSCONS interface or via theintegrated console printer-keyboard (3215-C or 1052-C). HAO cannot interceptmessages issued by the guest operating system to its own terminals.

Defining a Rule

To define a HAO rule, enter the command:

to define the rule's 'target' match patternfollowed by the command:

to define the rule's associated panel-command.

The target is a regular expression as defined by your host platform.When running on Linux, Hercules uses POSIX Extended Regular Expression syntax.On a Windows platform, regular expression support is provided byPerl Compatible Regular Expression (PCRE).The HAO facility can only be used if regular expression support was includedin Hercules at build time.

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

Substituting substrings in the command

The command may contain special variables $1, $2, etc, which will bereplaced by the values of 'capturing groups' in the match pattern.A capturing group is a part of the regular expression enclosed in parentheseswhich is matched with text in the target message. In this way, commands may beconstructed which contain substrings extracted from the message whichtriggered the command.

The following special variables are recognized:

• $1 to $9 - the text which matched the 1st to 9th capturing group in the target regular expression
• $` - the text preceding the regular expression match
• $' - the text following the regular expression match
• $$ - replaced by a single dollar sign

Note that substitution of a $n variable does not occur if there arefewer than n capturing groups in the regular expression.

As an example, the rule below issues the command 'i 001F' in response tothe message HHCTE014I 3270 device 001F client 127.0.0.1 connection reset:

Another example, shown below, illustrates how the dot matrix display of a3480 tape unit might be used to implement an automatic tape library:

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 bynnn (all rules are assigned numbers as they are defined and are thusidentified by their numeric value). Optionally, you can delete all defined orpartially defined rules by issuing the command 'hao clear'.

The current implementation limits the total number of defined rules to 64.This limit may be raised by increasing the value of the HAO_MAXRULEconstant in hao.c and rebuilding Hercules.

Installing Z Vm On Hercules Tv

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.

Technical Support

For technical support, please see the Hercules Technical Support page.

Z/vse

Last updated $Date$ $Revision$