8.4 $TEST (Custom test command)
8.4.1 Function
The $TEST command is used for invoking a custom test command. It performs whatever function the
user specifically coded it to do.
WARNING: Do not use this command unless you specifically coded the function that this command
invokes. Unless you wrote this command you probably don’t know what it is actually doing. It could
perform any function, up to crashing Hercules!
8.4.2 Syntax
Descriptive
req_parms [opt_parms]
Diagram
req_parms ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ
opt_parms
8.4.3 Parameter
req_parms
Any required parameter(s) for the specific implementation of the $TEST command.
opt_parms
Any optional parameter(s) for the specific implementation of the $TEST command.
8.4.4 Examples
Example 1:
Invoke the Hercules test command. This implementation of $TEST does not require any parameter.
HHC00013I Herc command: '$test'
*** $test command: creating threads...
*** $test thread 00002590: sleeping for 2 seconds...
*** $test thread 00002594: sleeping for 4 seconds...
*** $test thread 000036BC: sleeping for 5 seconds...
*** $test thread 0000223C: sleeping for 1 seconds...
*** $test thread 000010C4: sleeping for 3 seconds...
*** $test thread 00002590: 2 second sleep done; rc=0
*** $test thread 00003070: sleeping for 3 seconds...