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...

*** $test thread 0000223C: 1 second sleep done; rc=0

*** $test thread 00002AD8: sleeping for 6 seconds...

*** $test thread 00002594: 4 second sleep done; rc=0

*** $test thread 000028EC: sleeping for 4 seconds...

*** $test thread 000010C4: 3 second sleep done; rc=0

*** $test thread 00002F2C: sleeping for 2 seconds...

*** $test thread 00002494: sleeping for 1 seconds...

*** $test thread 00003070: 3 second sleep done; rc=0

*** $test command: waiting for threads to exit...

*** $test thread 00002494: 1 second sleep done; rc=0

*** $test thread 000036BC: 5 second sleep done; rc=0

*** $test thread 00002F2C: 2 second sleep done; rc=0

*** $test thread 000028EC: 4 second sleep done; rc=0

*** $test thread 00002AD8: 6 second sleep done; rc=0

*** $test command: test complete.

Figure 13: $TEST command

Previous Page Next Page