Memory Display (9.2)

The Memory Display screen (9.2) allows you to display and update all tables and storage areas in CICS. It also can be used to access and update any address in the CICS region.

• Data can be modified in either hexadecimal or character format.
• Invalid hexadecimal input data is highlighted. To restore the original data, press Erase EOF, then Enter.
• You access program storage when a table or area is not specified and a PROGRAM name is present.

The screen can display critical areas to the operation and protection of the CICS region. You can update all accessed tables and areas interactively. The integrity of CICS control areas is the responsibility of the XPSP user.

To access this screen, type the number 2 on the System-Facilities-Menu-9, or type =9.2 in the COMMAND field of any screen.

Memory Display Screen (9.2)

Data Display Area

The data area consists of six groups of fields. The first and second fields on the left of the screen cannot be changed. The third and fourth fields in the middle and the right can be changed; they consist of actual data in normal dump format. The fifth field on the far right cannot be changed. The fields are described from left to right as follows:

1 Eight-position field displays the hexadecimal offset from the address displayed in the ADDRESS field.

2 Three-position field displays the hexadecimal offset relative to zero for the data on this screen.

3 Four sets of eight hexadecimal digits of four bytes each. Modify any data by overtyping it with valid hexadecimal digits (0 through 9 and A through F). If invalid data is entered, the field is highlighted and an error message is displayed. Press Erase EOF and Enter to restore the original data. Data is not changed if the input is invalid.

4 16-position field of the character representation of the hexadecimal data displayed in the third field. Overtype data in this field.

5 Eight-position field of the actual address of the data displayed on each line.

6 Identification of the CICS dynamic storage area (DSA) in which the displayed address resides.

Input Fields

TABLE/AREA

Enter the table, area, register, or label to be accessed as follows. The items are searched for in the order shown:

1. A label that has been assigned to an entry in the select address table.
2. Labels defined on the Define-User-Labels-1-9 screen.
3. If the current program is Assembler and it is at a breakpoint or abend, any label (31 characters or less) defined in the program can be used. The current base register and offset are used to calculate the address to be displayed.
4. Labels that have been defined on the Define-System-Labels-9-9 screen.
5. Any of the following names:
   • CLOT: CICS life of task block (Db2 only)
   • COMM: Command-level COMMAREA
   • CSA: Common system area
   • CURRCOMM: Current COMMAREA
   • CWA: Common work area
   • DCT: Destination control table
   • DSA: Local Storage for High-Level Language programs
   • EIB: Execute interface block
   • EIS: Execution interface structure
   • EIUS: Execute interface user structure
   • FCT: File control table
   • INITCOMM: Initial COMMAREA
   • MQDATA: IBM MQ for z/OS data area
   • MQMD: IBM MQ for z/OS Message Descriptor
   • OFL: Optional features list
   • PGM: Program storage for the current program
   • PLIST: Parameter list (Db2 only)
   • PSW: Program status word
   • SIT: System initialization table
   • SQLCA: SQL communication area (Db2 only)
   • SQLDA: SQL descriptor area (Db2 only)
   • STCA: System task control area
   • TCA: Task control area
   • TCT: Terminal control table
   • TD: Most recent Transient Data retrieved by EXEC CICS READQ TD command
   • TDD: Most recent Transient Data retrieved by EXEC CICS READQ TD command
   • TGT: Task Global Table, for High-Level Languages
   • TIOA: Terminal I/O area
   • TS: Most recent Temporary Storage data retrieved by EXEC CICS RETRIEVE command (data passed by EXEC CICS START command) or retrieved by EXEC CICS READQ TS command
   • TSD: Most recent Temporary Storage data retrieved by EXEC CICS RETRIEVE command (data passed by EXEC CICS START command) or retrieved by EXEC CICS READQ TS command
   • TUA: Terminal user area
   • TWA: Task work area.

TABLE ENTRY ID

Entry to access in the table or area. Type the table entry name in the TABLE ENTRY ID field for direct retrieval of the requested area. When an entry is not specified, the display starts at the beginning of the table.

ADDRESS

Address to be accessed. When the data requested is returned to the screen, the address of the data appears in the ADDRESS field. When scrolling through the data, the HEX OFFSET field changes to indicate the relative offset of the display from the beginning of the area. To display the data at the specified address and offset, type over either the ADDRESS or the HEX OFFSET field and press Enter.

If ?? is entered in this field, Code Debug CICS uses the last value calculated by the CALC primary command as the address to be accessed. See CALC (??).

HEX OFFSET

Adds an offset to the address field. Specify a hexadecimal offset value, a standard CICS label, or a label defined in an Assembler program. Code Debug CICS replaces the symbolic label with the appropriate hex offset value.

If ?? is entered in this field, Code Debug CICS uses the last value calculated by the CALC primary command as a hexadecimal offset. See CALC (??).

USE CONTENTS

Allows you to view the data at an address that is contained in the body of the displayed data. Enter the address location offset in the ADD OFFSET field, type any character in the USE CONTENTS field, and press Enter. Code Debug CICS displays a screen of the data located at the address identified from the previous display. This is similar to using the SELECT primary command with the cursor positioned on the address.

ADD OFFSET

Adds another offset to the address field. Code Debug CICS can calculate the data offset. The left side of the screen always contains the offset from the first position on the screen. Determine the screen offset of the address to be used and enter it in this field. Code Debug CICS automatically adds it to the contents of the HEX OFFSET field on the screen.

CCSID TYPE

Allows you to specify ASCII as the CCSID Type to be used on the character data portion (right side) of the screen when your data is in ASCII. When ASCII is specified, the characters portion of the screen is translated with a table that causes ASCII values to display corresponding EBCDIC characters and entries into the characters portion of the screen will be converted from EBCDIC into ASCII.

When ASCII translation is specified, users see a blank where data contains an x’20’, and the uppercase letters A through O where data contains x’41’ through x’4F’ (instead of the mostly periods that display when EBCDIC is specified).

The default is EBCDIC. The CCSID Type reverts to EBCDIC upon exiting the screen.