5.30 HAO (Hercules Automatic Operator)

5.30.1 Function

The Hercules Automatic operator (HAO) feature is a facility that allows to automatically issue console
commands in response to certain messages being issued. To use the HAO facility it is necessary to de-
fine a rule, consisting of a target and an associated command.

The Hercules Automatic Operator is only for those messages issued by Hercules to its console. It cannot
be used for messages issued from the guest operating system.

The current implementation limits the total number of defined rules to 64. There is currently no way to de-
fine a command whose arguments varies based on actual message text. All of the defined HAO rules are
checked for a match each time Hercules issues a message, there is no way at this time to stop the pro-
cessing of subsequent rules.

HAO supports several commands. However when HAO is used in the configuration file, not all of the pos-
sible HAO commands make sense. As an example, there is no reason to define a rule in the configuration
file and afterwards to delete it in one of the next statements. Therefore only those commands are listed
here, that are useful during Hercules startup. For a list of all possible HAO commands see the HAO panel
command.

5.30.2 Syntax

Descriptive

HAO command [operands]


where command

target

consolecmd

nn]

Diagram

Êʬ¬¬ HAO ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ


where command


target ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

consolecmd ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«

¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬«



nn

5.30.3 Parameter

TGT

This is the keyword to define a new rule (pattern).

target

Specifies the rule (pattern) to react on. The target is a regular expression pattern
which is matched against the text of the messages that Hercules issues.

CMD

This is the keyword to specify a command for a previously defined rule.

consolecmd

Specifies the command to be executed if a target rule matches. The associated
command must be a valid Hercules console command.

LIST

List all rules/commands or list only rule/command at index nn.

nn

Number of the index to be listed or deleted.

5.30.4 Examples

Example 1:

Define the following target rule and the related command to be issued:

Check for message HHC01600E ("Unknown Hercules command") and issue "?" command (List all valid
commands).

HAO TGT HHC01600E

HAO CMD HELP

Previous Page Next Page