Core and the Map Options

This chapter describes the valid commands in the DISPLAY-ALTER processor of Option 2 (Core) and the valid commands of Option 4 (Map).

This section contains the following topics:

Core Memory Display and Alter (Option 2: Core)

Region Map Display (Option 4: Map)

Core Memory Display and Alter (Option 2: Core)

Core, Option 2 on the Primary Option Menu displays memory for your TSO user region. Use it during a test to display the program in memory. You can also enter core from any Intercept panel using the CORE command.

Memory is displayed in hexadecimal and character formats, and you can change memory that is not modify-protected by keying over the data where it appears on the display. Fetch protected memory cannot be displayed or modified.

Locate data in memory by using the scroll keys, the FIND commands, the DISPLAY command, or by keying in a specific address over the primary address field, as follows:

The FIND commands search for a specified character or hexadecimal string.
The DISPLAY command locates a specified address.
You can type an address over the primary address field, or an offset from the primary address can be typed over the primary offset field. The primary offset fields will be updated and the display scrolled to that part of memory.

The Display-Alter virtual memory panel is shown next:

----------------- CA InterTest Batch DISPLAY - ALTER MEMORY -------------------
COMMAND ===>                                          SCROLL ===> 00000100
HIGH-HALF ===> 00000000     
ADDRESS   OFFSET     0--------4--------8--------C-----------0---4---8---C---   
00006000  00000000 : 00000000 00000000 00000000 00000000  | ................ | 
00006010  00000010 : 00000000 00000000 00000000 00000000  | ................ | 
00006020  00000020 : 00000000 00000000 00000000 00000000  | ................ | 
00006030  00000030 : 00000000 00000000 00000000 00000000  | ................ | 
00006040  00000040 : 00000000 00000000 00000000 00000000  | ................ | 
00006050  00000050 : 00000000 00000000 00000000 00000000  | ................ | 
00006060  00000060 : 00000000 00000000 00000000 00000000  | ................ | 
00006070  00000070 : 00000000 00000000 00000000 00000000  | ................ | 
00006080  00000080 : 00000000 00000000 00000000 00000000  | ................ | 
00006090  00000090 : 00000000 00000000 00000000 00000000  | ................ | 
000060A0  000000A0 : 00000000 00000000 00000000 00000000  | ................ | 
000060B0  000000B0 : 00000000 00000000 00000000 00000000  | ................ | 
000060C0  000000C0 : 00000000 00000000 00000000 00000000  | ................ | 
000060D0  000000D0 : 00000000 00000000 00000000 00000000  | ................ | 
000060E0  000000E0 : 00000000 00000000 00000000 00000000  | ................ | 
000060F0  000000F0 : 00000000 00000000 00000000 00000000  | ................ | 
00006100  00000100 : 00000000 00000000 00000000 00000000  | ................ | 
00006110  00000110 : 00000000 00000000 00000000 00000000  | ................ | 
00006120  00000120 : 00000000 00000000 00000000 00000000  | ................ |

Note: If you enter the CORE command from an Intercept screen, the following panel displays:

----------------- CA InterTest Batch DISPLAY - ALTER MEMORY -------------------
COMMAND ===>                                          SCROLL ===> 00000100     
EXPR ===> +00000000001B0E48         HIGH-HALF ===> 00000000 ALET ===> 00000000 ADDRESS   OFSSET     0--------4--------8--------C-----------0---4---8---C---   
001B0E48  00000000 : 801B1000 00000000 00000000 00000000  | ................ | 
001B0E58  00000010 : 00000000 00000000 00000000 00000000  | ................ | 
001B0E68  00000020 : 00000000 00000000 00000000 00000000  | ................ | 
001B0E78  00000030 : 00000000 00000000 00000000 00000000  | ................ | 
001B0E88  00000040 : 00000000 00000000 00000000 00000000  | ................ | 
001B0E98  00000050 : 00000000 00000000 00000000 00000000  | ................ | 
001B0EA8  00000060 : 00000000 00000000 00000000 00000000  | ................ | 
001B0EB8  00000070 : 00000000 00000000 00000000 00000000  | ................ | 
001B0EC8  00000080 : 00000000 00000000 00000000 00000000  | ................ | 
001B0ED8  00000090 : 00000000 00000000 00000000 00000000  | ................ | 
001B0EE8  000000A0 : 00000000 00000000 00000000 00000000  | ................ | 
001B0EF8  000000B0 : 00000000 00000000 00000000 00000000  | ................ | 
001B0F08  000000C0 : 00000000 00000000 00000000 00000000  | ................ | 
001B0F18  000000D0 : 00000000 00000000 00000000 00000000  | ................ | 
001B0F28  000000E0 : 00000000 00000000 00000000 00000000  | ................ | 
001B0F38  000000F0 : 00000000 00000000 00000000 00000000  | ................ | 
001B0F48  00000100 : 00000000 00000000 00000000 00000000  | ................ | 
001B0F58  00000110 : 00000000 00000000 00000000 00000000  | ................ | 
001B0F68  00000120 : 00000000 00000000 00000000 00000000  | ................ |

The EXPR field is updateable. It contains a register expression or the address currently displaying. Commands that modify the displayed address also modify this field.

You can use all scroll keys in this display. Scroll amounts must be specified in hexadecimal. The scroll amounts apply to PF keys 7 and 8. PF keys 10 and 11 have different functions as follows:

PF Key	Description
PF10	Restore the address that was previously displayed.
PF11	Move the cursor to an address on the display and press the PF11 key. The address indicated by the cursor appears in the primary address field and the display is scrollable to that part of memory.

DISPLAY Command

The DISPLAY command sets the primary address field to the specified address. The primary address field is updated to the indicated address in virtual storage. The primary offset field is set to zero.

Syntax

Use the following syntax for DISPLAY:

DISPLAY address

Note: Data for variables are case-sensitive.

Variables

Use the following variables with the .label command:

Address: Displays the address in virtual storage. It may be a one to eight digit hexadecimal number.

FIND Command

The FIND command searches memory until the string operand is matched.

Syntax

Use the following syntax for FIND:

FIND string <NEXT|FIRST|LAST|PREV>

You can enter this command in its abbreviated form: F

Variables

Use the following variables with the .label command:

String	The search argument on the data area. String can be alphabetic, numeric, and special characters. If string contains imbedded blanks or quotes, you must enclose it in either single or double quotation marks.
NEXT	Causes a search for the next occurrence of string starting at the beginning of the first address displayed
FIRST	Causes a scroll to location zero followed by a FIND NEXT operation
LAST	Starts the scan at address 16,777,215 (that is, X'FFFFFF') and moves backwards to find the last occurrence of string
PREV	Starts the scan at the current address and moves backward to find the previous occurrence of the string

FX Command (Find Hex Data)

The FX command searches memory until the hexadecimal string is matched.

Syntax

Use the following syntax for FX:

FX string   <NEXT|FIRST|LAST|PREV>

Variables

Use the following variables with the FX command:

String	The search argument on the data area. String must be one to eight hexadecimal characters.
NEXT	Causes a search for the next occurrence of string starting at the beginning of the first address displayed. Next is the default.
FIRST	Causes a scroll to location zero followed by a FIND NEXT operation
LAST	Starts the scan at address X'FFFFFF' (that is, 16,777,215) and moves backwards to find the last occurrence of string
PREV	Starts the scan at the current address and moves backwards to find the previous occurrence of string

Usage Notes

In order to find the next occurrence of the string X'040C', enter the following command:

FX 040C

POP Command

The POP command restores from the stack the address most recently pushed onto the stack. The address becomes the primary address on the display. The primary offset field is set to zero.

Syntax

Use the following syntax for POP:

POP

Note: If the stack is empty, the following message appears:

EMPTY STACK

PUSH Command

The PUSH command places on the stack the current primary address.

Syntax

Use the following syntax for PUSH:

PUSH

Region Map Display (Option 4: Map)

Use the Map, Option 4 on the Primary Option Menu to display the task control blocks (TCBs) for your TSO session, including the program being tested. The commands to select the various control block displays are always shown at the top of the display area on the Region Map Display panel.

To display a list of all TCBs for your TSO session, use the command:

ALLTCB

Use your scroll keys to view and select the TCB number of the program you are testing from the list of ID numbers on the Control Block Display panel.

To set the TCB number for your program, enter the command ID with your task number. A sample Region Map Display follows:

-------------- CA InterTest Batch REGION MAP DISPLAY -------------------------- COMMAND ===> SCROLL ===> PAGE ID - Set Current TCB SAVE - Save area Map TCB - Task Status CDE - Pgms in Storage ALLOC- Allocations RB - Active RB'S FILE - Open Files ALLTCB - All TCB's TCB: 007FE0A8 TIOT : 00C71FE8 ASCB: 00F65580 ID#: 00000001 ASID: 018C --TCB -- -ID- ----------LEVEL------------- -PROGRAM- STATUS ---NDISP---- ------------------------------------------------------------------------------- 007E5060 0009 . . . . . . . .8. . . . . . ISPTASK ACTIVE 040000000000 0079BBD8 0010 . . . . . . . . .9. . . . . CALL ACTIVE 040000000000 0079B908 0011 . . . . . . . . . .0. . . . INTBATCH ACTIVE 040000000000 007CD6E8 0012 . . . . . . . . . . .1. . . GRANOLA ACTIVE 040000000000 007CD550 0013 . . . . . . . . . . . .2. . CAMRPSSC ACTIVE 040000000000 007CD3B8 0014 . . . . . . . . . . . . .3. CAMRPSWC ACTIVE 040000000000 0079B160 0015 . . . . . . . . . . . . . .4XDMAP ACTIVE 000000000000 0079B390 0016 . . . . . . . . . . . . . .4PCONTROL ACTIVE 040000000000 0079A088 0017 . . . . . . . . . . .1. . . IXCP ACTIVE 040000000000 0079A3E0 0018 . . . . . . . . . . .1. . . INTUTIL ACTIVE 040000000000 007FFE88 0019 .1. . . . . . . . . . . . . IEAVTSDT ACTIVE 040000000000 -------------------------------END OF TCB CHAIN--------------------------------

By using the appropriate commands, the Control Block Display panels display as shown in the following table:

Command	Control Block Display Contents
CDE	The programs in storage for the current TCB ID number
SAVE	The save area map for the current TCB ID number
ALLOC	The current allocations by ddname
FILE	Information on open files related to the current TCB ID number
TCB	The status of the user's TCBs (not task related)
RB	The active request blocks (RB) for the current TCB ID number

The option ALLOC is similar to the TSO LISTALC command. Unlike the TSO LISTALC command, ALLOC displays the ddname. You can also scroll the display.

Note: For command FILE, no IMS database files appear on this display, because the application program does not own databases. IMS modules own them. They are displayed with the command ALLOC.

This panel supports valid scroll functions.