8.2 # (Silent comment)

8.2.1 Function

The hash ("#") provides a convenient way of entering comments into the Hercules log file only with no
other effect (“silent” comment). The comment is not processed in any way other than to echo it in the log
file.

8.2.2 Syntax

Descriptive

#
anytext

Diagram

Êʬ¬¬ # ¬¬¬ anytext ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

8.2.3 Parameter

anytext

This is the text that has to be written only to the Hercules log file (“silent” comment).

8.2.4 Examples

Example 1:

Write a text string to the log file only (“silent” comment).

# A comment that is written to the Hercules log file only

Figure 9: Silent comment

8.3 $LOCATE (Display and verify Hercules control blocks)

8.3.1 Function

The $LOCATE command displays and verifies various Hercules control blocks. The specified control
block is displayed in a hex dump format.

8.3.2 Syntax

Descriptive

controlblock

Diagram

Êʬ¬¬ ¬¬¬ controlblock ¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

8.3.3 Parameter

controlblock

This specifies the control block to be verified and displayed. Currently the following
control blocks are supported through the LOCATE command:

8.3.4 Examples

Example 1:

Locate the Hercules sysblk control block. Please note that not all hex columns can be displayed in the
figure below. Missing columns have been marked with “”’.

HHC00013I Herc command: '$locate sysblk'

HHC90000D DBG: SYSBLK @ 0x002333C0 - Verified

HHC90004.00 .....#3.

..

M.|..xtvM8|..