Example 2:

Set the amount of time to wait after an I/O interrupt is ready to be set pending to 500 microseconds and
suppress the warning message.

IODELAY 500 NOWARN

5.39 LDMOD (Additional dynamic load modules)

5.39.1 Function

LMOD provides the capability of defining additional modules that will be loaded by the Hercules Dynamic
Loader. The default search order is within the Hercules directory and in the default DLL search path. Most
systems also support absolute filenames (e.g. names starting with “/” or “.”) in which case the default
search path is not taken. Multiple LDMOD statements may be used.

5.39.2 Syntax

Descriptive

module [module [module ...]]

Diagram

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

module ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

5.39.3 Parameter

module

A list of modules that are to be loaded by the Hercules Dynamic Loader.

5.39.4 Examples

Example 1:

Instruct Hercules to load the additional module named S37X (S/370 Extension) from the Hercules
directory or the default DLL search path.

LDMOD S37X

Previous Page Next Page

Extracted Text (may have errors)

Example 2:

Set the amount of time to wait after an I/O interrupt is ready to be set pending to 500 microseconds and
suppress the warning message.

IODELAY 500 NOWARN

5.39 LDMOD (Additional dynamic load modules)

5.39.1 Function

5.39.2 Syntax

Descriptive

module [module [module ...]]

Diagram

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

module ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

5.39.3 Parameter

module

A list of modules that are to be loaded by the Hercules Dynamic Loader.

5.39.4 Examples

Example 1:

Instruct Hercules to load the additional module named S37X (S/370 Extension) from the Hercules
directory or the default DLL search path.

LDMOD S37X

Help

Destination page number Search scope Search Text

loading

5.37 INCLUDE (Include configuration file)

5.37.1 Function

An INCLUDE statement instructs the Hercules initialisation process to treat the contents of the file speci-
fied by filepath as if its contents had appeared in the configuration file at the point where the INCLUDE
statement appears.

The included file itself may contain yet another INCLUDE statement as long as the maximum nesting
depth of 8 is not exceeded.

5.37.2 Syntax

Descriptive

filepath

Diagram

filepath ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

5.37.3 Parameter

filepath

Specifies the path and the filename of the configuration file that is to be included.

5.37.4 Examples

Example 1:

Specify that Hercules should include the contents of the file "D:\S390\CONF\CONFIG2.CONF" into the
configuration.

INCLUDE D:\S390\CONF\CONFIG2.CONF

5.38 IODELAY (I/O interrupt wait time (LINUX))

5.38.1 Function

IODELAY sets the amount of time in microseconds to wait after an I/O interrupt is ready to be set pen-
ding. This value can also be set using the Hercules console. The purpose of this parameter is to circum-
vent a bug in the Linux/390 and z/Linux ‘dasd.c’ device driver. The bug is more likely to occur under
Hercules than on a real machine as Hercules may present an I/O interrupt sooner than a real machine.

NOTE: OSTAILOR L
INUX no longer sets IODELAY to 800 since the problem described above is no
longer present in recent versions of the Linux kernel.

5.38.2 Syntax

Descriptive

usecs

Diagram

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

¬¬¬ usecs ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

5.38.3 Parameter

usecs

Amount of time in microseconds to wait after an I/O interrupt is ready to be set pen-
ding.

NOWARN

If the IODELAY value is non-zero then a warning message will be issued unless
NOWARN is specified.

5.38.4 Examples

Example 1:

Set the amount of time to wait after an I/O interrupt is ready to be set pending to 1000 microseconds.

IODELAY 1000

Previous Page Next Page

Extracted Text (may have errors)

5.37 INCLUDE (Include configuration file)

5.37.1 Function

The included file itself may contain yet another INCLUDE statement as long as the maximum nesting
depth of 8 is not exceeded.

5.37.2 Syntax

Descriptive

filepath

Diagram

filepath ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

5.37.3 Parameter

filepath

Specifies the path and the filename of the configuration file that is to be included.

5.37.4 Examples

Example 1:

Specify that Hercules should include the contents of the file "D:\S390\CONF\CONFIG2.CONF" into the
configuration.

INCLUDE D:\S390\CONF\CONFIG2.CONF

5.38 IODELAY (I/O interrupt wait time (LINUX))

5.38.1 Function

NOTE: OSTAILOR L
INUX no longer sets IODELAY to 800 since the problem described above is no
longer present in recent versions of the Linux kernel.

5.38.2 Syntax

Descriptive

usecs

Diagram

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

¬¬¬ usecs ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

5.38.3 Parameter

usecs

Amount of time in microseconds to wait after an I/O interrupt is ready to be set pen-
ding.

NOWARN

If the IODELAY value is non-zero then a warning message will be issued unless
NOWARN is specified.

5.38.4 Examples

Example 1:

Set the amount of time to wait after an I/O interrupt is ready to be set pending to 1000 microseconds.

IODELAY 1000

5.40 LEGACYSENSEID (SENSE ID CCW (x'E4') feature)

5.40.1 Function

This option specifies whether the SENSE ID CCW (X'E4') will be honoured for the devices that originally
did not support that feature. This includes (but may not be limited to) 3410 and 3420 tape drives, 2311
and 2314 direct access storage devices and 2703 communication controllers. Because those legacy
devices didn't originally support this command, and for compatibility reasons, the default is OFF or
DISABLE.

Specify ON or ENABLE, if your guest operating system needs the Sense ID support to dynamically detect
those devices. Note that most current operating systems will not detect those devices even though Sense
ID is enabled because those devices never supported the Sense ID in the first place. This mainly applies
to custom built or modified versions of guest operating systems that are aware of this specific Hercules
capability.

5.40.2 Syntax

Descriptive

OFF

Diagram

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

¬¬¬«

5.40.3 Parameter

OFF

Specify OFF or DISABLE if your guest operating system does not need the Sense
ID support to dynamically detect devices that originally did not support that feature.
This is the default.

DISABLE

This is the same os ‘OFF’.

Specify ON or ENABLE if your guest operating system needs the Sense ID support
to dynamically detect devices that originally did not support that feature.

ENABLE

This is the same as ‘ON’.

5.40.4 Examples

Example 1:

Specify that the SENSE ID CCW will be honoured for devices that originally did not support that feature.

LEGACYSENSEID ENABLE

Previous Page Next Page

Extracted Text (may have errors)

5.40 LEGACYSENSEID (SENSE ID CCW (x'E4') feature)

5.40.1 Function

5.40.2 Syntax

Descriptive

OFF

Diagram

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

¬¬¬«

5.40.3 Parameter

OFF

Specify OFF or DISABLE if your guest operating system does not need the Sense
ID support to dynamically detect devices that originally did not support that feature.
This is the default.

DISABLE

This is the same os ‘OFF’.

Specify ON or ENABLE if your guest operating system needs the Sense ID support
to dynamically detect devices that originally did not support that feature.

ENABLE

This is the same as ‘ON’.

5.40.4 Examples

Example 1:

Specify that the SENSE ID CCW will be honoured for devices that originally did not support that feature.

LEGACYSENSEID ENABLE

5.39 LDMOD (Additional dynamic load modules)

5.39.1 Function

5.39.2 Syntax

5.39.3 Parameter

5.39.4 Examples

Page 211. Preface click to expand contents

Page 242. Related Publications click to expand contents

Page 253. Summary of changes click to expand contents

Page 284. Hercules Configuration File click to expand contents

Page 405. System Parameter Descriptions click to expand contents

Page 1706. Device Definition Descriptions click to expand contents

Page 2327. Hercules Console click to expand contents

Page 2598. Console Command Descriptions click to expand contents