Memory Expression Builder

Use the Memory Expression Builder dialog to build expressions to fetch memory.

Memory Expression Builder Dialog

The Memory Expression Builder dialog lets you select keywords and build expressions to be posted and displayed in the Watch Data and Session Data views. You can access the Memory Expression Builder dialog either from the Watch Data and Session Data views, or from within the Memory Dump dialog.

To open the Memory Expression Builder dialog from the Memory Dump dialog, select the Expression option, and then click Build Expression.

Some of the fields in this dialog are applicable only to CICS and others are applicable to both batch and CICS. For a batch session, the Memory Expression Builder displays only the Expression and Keyword Areas fields. The table following displays the fields on the Memory Expression Builder dialog:

Selection	Applicable to	Description
Expression	Both	Lets you enter any expression as the value.
System Areas	CICS	Displays a drop-down list of CICS System Area keywords. Select a keyword you want to use.
Task Areas	CICS	Displays a drop-down list of CICS Task Area keywords. Select a keyword you want to use and enter the task number.
Keyword Areas	Both	Displays a drop-down list of Breakpoint keywords. Select a keyword you want to use and enter the parameter value.
Programs	CICS	Displays a drop-down list of program-related keywords. Select a keyword you want to use and enter the program name.
Assembler Areas	Both	Displays parameters for ASM programs. Enter values in the Base, Label, Register, Register Symbol, and Argument fields as required.
Options	Both	Lets you use special modifiers for expressions.

Memory Expression Builder - Options section

The options section in the Memory Expression Builder dialog lets you specify modifiers for the keyword or other expression that you want to create.

The Options section displays the following fields:

Offset
Use this field to append an offset to the keyword you have selected, or the expression you have entered in the Memory Expression field. The offset value may be preceded by a sign or indirection character. If no value is provided, a plus sign is assumed. If you want to express the offset value in decimal rather than hexadecimal, you must use the number with a suffix, T.
Valid indirection symbols are as follows:

Char	Batch	CICS	Description
@	No	Yes	Indirection below the 16MB line
%	Yes	Yes	Indirection 24 bit mode (batch), above the 16MB line (CICS)
?	Yes	No	Indirection 31 bit mode
!	Yes	No	Indirection 64 bit mode

WHERE
Lets you specify a WHERE condition to your expression. Check the WHERE box to add a WHERE condition to your expression.
Program/Layout name
Allows you to specify the mapping of your expression to a particular layout within a program. Select a program from the list before using this option. This action automatically populates the Layout field with all the variables in the program that match the filter. Click OK. The current Memory Dump dialog will be mapped to the selected layout.

Note: The list of programs includes both monitored and unmonitored programs in your current project.