11. Starting the Hercules Emulator

11.1 Starting Hercules in Native Mode

Hercules can be manually started from a Windows Command Prompt or can be started by calling a batch
file (the preferred way). In both cases the syntax is the same.

11.1.1 Syntax

Descriptive

-f configfile
-- configfile

-r rcfile

-- rcfile

-b logofile

-- logofile

-d

--

-p dyndir

-- dyndir

-l dynmod [...] --dynmod

-s
[...] --

- --

-h

--

[>logfile]

Diagram

¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê

-f configfile ¬¬¬¬¬«

--configfile

Ê¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê

-r rcfile ¬¬¬¬¬¬«

--rcfile

Ê¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê

-b logofile -d ¬¬¬¬¬¬
«

--logofile --

Ê¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬Ê

-p dyndir

--dyndir -l
dynmod

-- dynmod

Ê¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬Ê

~¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬®

- ¬¬¬¬¬¬«

¬¬¬¬¬§¬¬¬¬¬¬ -s ¬¬¬¬¬¬§¬¬--

-- ¬¬¬

Ê¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

-h
¬¬¬¬¬« logfile

--help

11.1.2 Parameter

-f configfile
--config=configfile

This is the name of the configuration file. If the filename is not speci-
fied the default is HERCULES.CNF. The name of the default configu-
ration file may be overridden by the 'HERCULES_CNF' environment
variable.

-r rcfile
--rcfile=rcfile

This specifies the name of the Hercules run-commands file. The run-
commands file automatically executes panelcommands upon startup.

-b logofile
--herclogo=logofile

Specifies the name of a customized logo text file in the current Her-
cules directory (for details on how to customize a logofile see chapter

10 ).

-d
--daemon

Specifies that Hercules is to be run in “daemon” mode, wherein it
runs invisibly with no attached console.

-p dyndir
--modpath=dyndir

This is the directory from which dynamic modules are to be loaded.
The general search order is the following:

1. -p from startup argument. 2. HERCULES_LIB environment variable. 3. MODULESDIR compile time definition 4. The path where Hercules was found and if this is not re-
solved, then "hercules" is used as pathname.

-l dynmod
--ldmod=dynmod

This is the name of an additional dynamic load module to be loaded
at startup. More than one additional module may be specified, al-
though each must be preceded with the “-l” option.

-s sym=val
--defsym=symbol=value

Specifies a symbol definition where sym is the name of the symbol
and val is the value that is assigned to the symbol. This option has
the same effect as a DEFSYM statement in the configuration file.

If there is a DEFSYM statement in the configuration file that has the
same name for the symbol as a symbol defined in the startup com-
mand then the configuration DEFSYM statement takes precedence.