THE Q PUBLIC LICENSE version 1.0


Copyright (C) 1999 Trolltech AS, Norway.
Everyone is permitted to copy and
distribute this license document.

The intent of this license is to establish freedom to share and change the software regulated by this license under the open source model.

This license applies omplete description.


Creating DASD volumes

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


Operating Procedure

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

Loading a standalone program or operating system

To start Hercules enter this command at the Unix shell prompt:

    hercules  [ -f filename ]
              [ -d ]
              [ -p dyndir ]  [[-l dynmod ] ... ]
              [ > logfile ]

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 specified in the configuration file (this should be the master console address). If your master console is a 1052 or 3215, connect a telnet client instead of a tn3270 client.

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



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 not be completely accurate or up-to-date. Please enter the '?' command for yourself for a more complete, accurate and up-to-date list of supported panel commands.


    Command      Description...
    -------      -----------------------------------------------
    ?            list all commands
    help         command specific help

    *            (log comment to syslog)

    hst          history of commands
    log          direct log output
    logopt       change log options 
    version      display version information

    quit         terminate the emulator
    exit         (synonym for 'quit')

    cpu          define target cpu for panel display and commands

    start        start CPU (or printer device if argument given)
    stop         stop CPU (or printer device if argument given)

    startall     start all CPU's
    stopall      stop all CPU's

    cf           configure current CPU online or offline
    cfall        configure all CPU's online or offline

    .reply       scp command
    !message     scp priority messsage
    ssd          Signal Shutdown

    ptt          display pthread trace

    i            generate I/O attention interrupt for device
    ext          generate external interrupt
    restart      generate restart interrupt
    archmode     set architecture mode
    loadparm     set IPL parameter

    ipl          IPL Normal from device xxxx
    iplc         IPL Clear from device xxxx
    sysreset     Issue SYSTEM Reset manual operation
    sysclear     Issue SYSTEM Clear Reset manual operation
    store        store CPU status at absolute zero

    psw          display p