Memory Display (2.2)

The Memory Display screen (2.2) is used to display tables and storage areas in CICS and update certain storage areas. It can be used to update user and terminal class storage, TWA, TUA, and program storage areas. The following screen functions are available:

• Updating is allowed for certain tables and areas. 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.
• Program storage is accessed when a table or area is not specified and a PROGRAM name is present.

Access this screen by typing the number 2 on the Debugging Facilities Menu, entering the MEMORY command from any screen, or as described in Transferring Between Screens.

The PPT, PCT, and RCT keywords are no longer valid in the TABLE/AREA field. If any of these keywords is entered, Code Debug CICS automatically transfers to the CICS Resources screen (2.R) and displays the attributes for the particular program, transaction, or Db2 resources.

Memory Display Screen (2.2)

The screen can display areas that are critical to the operation and protection of the CICS region, and are protected from update. XPED and XPRT users can only update user and terminal class storage, the TWA, TUA, and program storage areas. XPSP users can use the Memory Display screen (9.2) to update other areas.

Data Area

Above figure shows the data fields numbered for explanation only. The numbers 1 through 5 do not appear on the screen.

The data area consists of five 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 user 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 with 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.

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 screen (1.9).
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 screen (9.9).
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 for direct retrieval of the requested area. When no entry is specified, the display starts with the beginning of the table.

ADDRESS

Address to access. When the requested data is displayed, the address of the data appears in the ADDRESS field. As the user scrolls through the data, the HEX OFFSET field changes to indicate the relative offset of the display from the beginning of the area. Typing over either the ADDRESS or the HEX OFFSET field and pressing Enter produces a display of the data at the specified address and offset.

If ?? is entered, the last value calculated by the CALC primary command is used as the address to access. See CALC (??).

HEX OFFSET

Adds an offset to the ADDRESS field. Enter a hexadecimal offset value, a standard CICS label, or a label from a current Assembler program. Code Debug CICS replaces the symbolic label with the appropriate hexadecimal offset value.

If ?? is entered, the last value calculated by the CALC primary command is used as a hexadecimal offset. See CALC (??).

USE CONTENTS

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

ADD OFFSET

Adds an additional 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.

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.