Skip to Content

IMS storage display and ZAP

You can use DELTA IMS VIRTUAL TERMINAL to display main storage in the IMS control region address space. Portions of main storage in the IMS control region address space display on the TSO screen in a dump format. The dump format shows in 16-byte increments the virtual storage address of the data, its offset relative to the beginning of the area, its hexadecimal representation, and an EBCDIC character display. Zaps are recorded in the DELTA Log but are never reapplied by DELTA IMS VIRTUAL TERMINAL during restarts.

To display storage, select option 3 from the Utilities panel. The IMS Storage Display panel shown in IMS Storage Display Panel is displayed, prompting you for specification of dump parameters.

Once you have supplied storage display parameters, DELTA IMS VIRTUAL TERMINAL attempts to obtain the requested storage from the IMS address space. A message indicating that the request was transmitted to the IMS control region appears. After several seconds, the requested storage displays.

The entire block of storage is copied from the IMS address space to your address space, which may not necessarily be on the same CPU. The amount of storage obtained and displayed depends on whether DELTA IMS VIRTUAL TERMINAL can determine a length for the storage block. A length can be determined for known control blocks and modules if the address is not complex. If the address is explicit or complex, DELTA IMS VIRTUAL TERMINAL defaults the length to 256 bytes unless overridden by the length field on the panel. If the length of a module exceeds 10,000 bytes, DELTA IMS VIRTUAL TERMINAL returns only the first 10,000 bytes unless you type 9999 in the Length field. When you type 9999, the entire module is returned regardless of its length, as shown in the following figure.

Error
Warning

Use this option with care because very large load modules (such as DFSVNUC0) can exceed the virtual storage available in the TSO user’s address space and cause an S80A abend of the DELTA IMS VIRTUAL TERMINAL session.

Once the storage is displayed, you can make modifications in either the hexadecimal or the EBCDIC character display fields. When the ZAP command is issued after these online modifications have been made, the IMS control region is updated.

Zapping storage can be dangerous on a production system. For this reason, the ability to zap storage is disabled by default; you can enable it for the authorized user when necessary. Refer to the installation guide for information on enabling the storage display and zap features and adding user access authorization for these features.

IMS Storage Display Panel

 ZP                   DELTA IMS DB/DC - IMS Storage Display
 Command ===> ________________________________________________ Scroll ===> PAGE

 IMSID  . . . EAW3
 Dump Address MOD(DLA#EAW3)____________________________________
 Length . . . 9999
 Comment  . . TEST__________________________
                                                              Line 0001 of 0036
                  0...2... 4...6... 8...A... C...E...                 More:   +
 000090C0  0000                     00000238 00000004            * ........ *
 000090D0  0008   C9D4E2E5 E24BD9F3 F1D44BD9 C5E2D3C9    * IMSVS.R31M.RESLI *
 000090E0  0018   C2404040 40404040 40404040 40404040    * B                *
 000090F0  0028   40404040 40404040 40404040 C4C5D3E3    *             DELT *
 00009100  0038   C1C9D4E2 C4C5D3E3 C1C9D4E2 C1C7D5C4    * AIMSDELTAIMSAGND *
 00009110  0048   C5D3E3C1 5C5CE3E2 D6C2D4D7 F3F1F0C5    * ELTA**TSOBMP310E *
 00009120  0058   C1E6F340 40404000 40404040 40404040    * AW3    .         *
 00009130  0068   40404040 40404040 40404040 40404040    *                  *
 00009140  0078   40404040 40404040 40404040 17025073    *             ..&. *
 00009150  0088   0092122F C5C1E64B C4C5D3E3 C1C9D4E2    * .k..EAW.DELTAIMS *
 00009160  0098   4BD3D6C7 F1404040 40404040 40404040    * .LOG1            *
 00009170  00A8   40404040 40404040 40404040 40404040    *                  *
 00009180  00B8   C5C1E64B C4C5D3E3 C1C9D4E2 4BD3D6C7    * EAW.DELTAIMS.LOG *
 00009190  00C8   F2404040 40404040 40404040 40404040    * 2                *
 000091A0  00D8   40404040 40404040 40404040 D5E84040    *             NY   *

The following fields are available on this panel:

Command

The commands available with this panel are described below.

Up and DOWN

Use the UP and DOWN commands to scroll through the storage displayed on the IMS Storage Display panel.

FIND

Use the FIND command to locate character and hexadecimal strings in the block of storage. A character string is a string of characters, and a hexadecimal string is an even number of hexadecimal digits or a quoted hexadecimal string.

Use the format FIND ‘sss...ss’ for character strings, where sss...ss is the character string; use the format FIND X'ddd...dd' for hexadecimal strings, where ddd...dd is the hexadecimal string.

Subsequent finds for the same string may omit the prior strings found. The FIND command positions the line of storage that contains the string on the top line in the display area and issues a message indicating the offset into the area where the string was found.

ZAP

To alter IMS storage you display the storage to zap, make the desired change on the panel, provide a comment to document the change, and issue the ZAP command.

When storage has been displayed, you can change it. The alterations are zapped into the IMS address space. A zap is defined as one or more characters of changed data in the area.

Error
Warning

The maximum length of a zap is 32 bytes from the first byte changed to the last byte changed. This maximum length includes any unchanged bytes that occur between the first and last bytes that are changed.

The data in the display can be changed in either the hexadecimal or the character area. If both the hexadecimal and character areas are changed at the same time, the change in the character area overrides the change in the hexadecimal area. In the character area, the period is considered a null character and is never used to replace data. You can restore original contents of a word by pressing Erase EOF to clear a word of the hexadecimal display.

Warning

Note

Before applying a zap, DELTA IMS VIRTUAL TERMINAL checks the current contents of the storage to ensure that no change has occurred while you were viewing it. If the current contents match the contents at the time DELTA IMS VIRTUAL TERMINAL copied the storage and the zap is applied. If there is a mismatch, DELTA IMS VIRTUAL TERMINAL issues an error message indicating that the verification failed and that the zap was not performed.

The ZAP command causes the zap to be applied to the IMS address space. If the zap is successful, the changed data in the display is considered permanent and is used as a base for additional displays and zaps.

All zaps made by DELTA IMS VIRTUAL TERMINAL to the IMS control region are recorded in the DELTA Log and remain there until the next restart. After the next restart, they remain as inactive log entries until removed by a log purge. If you reformat the DELTA Logs, all active and inactive entries are erased. DELTA IMS VIRTUAL TERMINAL never attempts to reapply the zaps during IMS restart; it records the zaps only for historical and reporting purposes.

RESET

Once data has been changed in the display, DELTA IMS VIRTUAL TERMINAL will not allow you to exit the storage display facility until the ZAP or RESET command is issued or a new display is requested. The RESET command restores the display to its original unaltered contents. Entering a new display address or length also cancels any pending changes.

IMSID

The name of the IMS control region to display.

Dump Address

Specify which portion of virtual storage you want to display. Use an explicit, implicit, or complex address.

Warning

Note

When the panel is first displayed, it contains the explicit, implicit, or complex storage address of the last storage display. To display the same area again, you must rekey one character in the Dump address field.

Explicit Address – An explicit address is a hexadecimal number of one to eight digits that identifies the virtual storage address of the storage to be displayed.

Implicit Address – An implicit address is the type and name of a particular control block or load module name, for example, CNT(MASTER). Only a limited subset of IMS control blocks may be referenced this way. Refer to the following table.

Supported Implicit Addresses

Implicit Type

Description

DB/DC

VT

DBCTL

SCD

System contents directory

•

•

•

CLB(l-p 1)

Communications line block

•

•

 

CTB(l-p 1 )

Communications terminal block

•

•

 

CIB(l-p 1 )

Communications interface block

•

•

 

CNT(p 2)

Communications name table

•

•

 

SPQB(p 2)

Subpool queue block

•

•

 

DNT(p 2)

Destination name table

 

•

 

VDNT(p 2)

Virtual terminal destination name table

 

•

 

PDIR(p 2)

Program directory (APPLCTN)

•

•

•

DDIR(p 2)

Data base directory (DATABASE)

•

•

•

SMB(p 2)

Schedular message block (TRANSACT)

•

•

 

MOD(p 2)

Locate an existing module

•

•

•

LOAD(p 2)

Load a new module into IMS storage (using standard IMS IMODULE LOAD

•

•

•

PST (p 2)

Partition Specification Table (PST)

•

•

 

1 The name of a VTAM node or BTAM line and PTERM is required. The format of the line and PTERM name is 1-p. For example, the CLB for line 3 PTERM 10 would be specified as CLB(3-10).

2 The name of a particular element is required.

Complex Address

A complex address is an explicit or implicit address followed by a positive or negative value and/or indirect operators. An offset value is either added to or subtracted from (as indicated by the sign) the current address calculation. The indirect operators % and ? indicate that the contents of the word starting at the address calculated thus far are to be used as the address for any subsequent calculation operations. A % indicates that the low-order 24 bits of the word are to be used as the address. A ? indicates that the low-order 31 bits of the word are to be used as the address. The complex address is delimited by the first blank.

Indirect Address

Once a block of storage has been displayed and one of the words displayed contains an address, the block of storage at that address may be displayed by typing over the first character of the word with an indirect operator ( % or ?). The content of the Dump Address field is ignored for this display, but it is retained. Thus, you can display the previous block again by typing over a character in the Dump field. You can update the Length field at the same time the indirect operator is entered to control the length of the new block; updating the Length field later causes the block indicated in the Dump Address field to be displayed again.

Length

Specifies the amount of storage, in bytes, to display.

Comment

When a zap is made to storage, DELTA IMS VIRTUAL TERMINAL requires the specification of a comment. The most recently-used comment is the default value for the Comment field. A blank or one character comment is unacceptable. The comment appears in log reports to document the zap.

unlabeled columns

The following columns display the main storage in dump format:

  • address – The virtual storage address from the IMS address space.
  • offset – The offset relative to the beginning of the area.
  • hexadecimal format – Each line contains four words (16 bytes) of data displayed in hexadecimal format. These fields are modifiable in case a zap is to be made.
  • character format – The 16 bytes of data are also displayed in character format. In this field, a period represents a character that cannot be displayed. This field is modifiable. You can use upper and lowercase characters to alter original field contents. Input from this field overrides input from corresponding hexadecimal fields.

You can also use DELTA IMS VIRTUAL TERMINAL to display main storage in the IMS DLI/SAS region address space. When displaying main storage, you can complete the following tasks under the DLI TCB:

  • dump all CDEs
  • display storage
  • zap storage
  • display an individual CDE

The following figure provides an example of dumping all CDEs under the DLI TCB.

 File  Dump  Zap  Options  Help                                               
-------------------------------------------------------------------------------
DELTA IMS                      IMS Storage Display           Row 1 to 11 of 111
                                                                              
IMSID . . . . . . D10P                               2011.265 14:16:57.11      
Dump Address  . . CDE(ALLCDE):DLI     (:DLI must be specified after the dump address
Length  . . . . . 1776                                                         
Comment . . . . . DUMP/ZAP function to be switched to DLI TCB)                                                        
Address  Offset +0       +4       +8       +C         Character                
00000000 0000   C6D4E360 6E40C3C4 D5C1D4C5 61C3C4C5 *FMT-> CDNAME/CDE*        
00000010 0010   D5E3D7E3 61C3C4E4 E2C561C3 C4E2D740 *NTPT/CDUSE/CDSP *        
00000020 0020   C3E2E2D8 F2C5C3C2 35C1D000 0001E700 *CSSQ2ECB.A}...X.*        
00000030 0030   C4C6E2C1 C2D5C4F0 BF111000 0001FA00 *DFSABND0........*        
00000040 0040   C4C6E2C1 C3C2C9D6 0007B000 0001FB00 *DFSACBIO........*        
00000050 0050   C4C6E2C1 E6C5C5F1 39D81AD8 0001E700 *DFSAWEE1.Q.Q..X.*        
00000060 0060   C4C6E2C2 C6E2D7D7 3F3EA000 0001FB00 *DFSBFSPP........*        
00000070 0070   C4C6E2C3 D7E8F0F0 B00AF1E0 0001E700 *DFSCPY00..1/..X.*        
00000080 0080   C4C6E2C3 E2E2E6D2 000339C0 0001FA00 *DFSCSSWK...{....*        
00000090 0090   C4C6E2C3 E2E2F0F0 BF17F000 0001FA00 *DFSCSS00..0.....*        
000000A0 00A0   C4C6E2C4 C2C1E4F0 00067000 0001FA00 *DFSDBAU0........*  
******************************* Bottom of data ********************************
 F1=Help      F3=Exit      F4=Prompt    F5=RFnd      F6=Zap       F7=Up        
 F8=Down     F10=Previous F11=Next     F12=Cancel

The following figure provides an example of displaying storage under the DLI TCB.

 File  Dump  Zap  Options  Help                                               
-------------------------------------------------------------------------------
DELTA IMS                     IMS Storage Display           Row 1 to 11 of 111
                                                                             
IMSID . . . . . . D10P                               2011.265 14:19:47.76     
Dump Address  . . 3F405000:DLI        (:DLI must be specified after dump address)
Length  . . . . . 1776                                                        
Comment . . . . . DUMP/ZAP function to be switched to DLI TCB)                                                        
Address  Offset +0       +4       +8       +C         Character               
3F405000 0000   0000000A 00001788 D7E2C240 C4C6E2E2 *.......hPSB DFSS*       
3F405010 0010   C1D4F0F2 2DA2B040 00000B20 00000000 *AM02.s. ........*       
3F405020 0020   00000000 00000000 D1C3C240 00000000 *........JCB ....*       
3F405030 0030   00000000 00000000 00000000 00000000 *................*       
3F405040 0040   00000000 00000000 00000000 00000000 *................*       
3F405050 0050   00000000 00000000 00000000 3F4057DC *............. ..*       
3F405060 0060   3F40502C C9D5C4C5 E7D7C3C2 00000000 *. &.INDEXPCB....*       
3F405070 0070   00000000 3F40502C 40404040 40404040 *..... &.        *       
3F405080 0080   00000004 00000000 00000000 00000000 *................*       
3F405090 0090   00000000 00000000 00000000 00000000 *................*       
3F4050A0 00A0   00000000 00000000 00000000 00000000 *................*
******************************* Bottom of data ********************************
 F1=Help      F3=Exit      F4=Prompt    F5=RFnd      F6=Zap       F7=Up        
 F8=Down     F10=Previous F11=Next     F12=Cancel

The following figure provides an example of zapping storage under the DLI TCB.

 File  Dump  Zap  Options  Help                                               
-------------------------------------------------------------------------------
DELTA IMS                      IMS Storage Display              Storage altered
                                                                              
IMSID . . . . . . D10P                               2011.265 15:02:10.64      
Dump Address  . . 3F405000:DLI                                           +     
Length  . . . . . 1776                                                         
Comment . . . . . :DLI    (DLI must be specified under Comment if zapping storage)                                             
Address  Offset +0       +4       +8       +C         Character                
3F405000 0000   0000000A 00001788 C7D3D140 C4C6E2E2 *.......hGLJ DFSS*      
3F405010 0010   C1D4F0F2 2DA2B040 00000B20 00000000 *AM02.s. ........*        
3F405020 0020   00000000 00000000 D1C3C240 00000000 *........JCB ....*        
3F405030 0030   00000000 00000000 00000000 00000000 *................*        
3F405040 0040   00000000 00000000 00000000 00000000 *................*        
3F405050 0050   00000000 00000000 00000000 3F4057DC *............. ..*        
3F405060 0060   3F40502C C9D5C4C5 E7D7C3C2 00000000 *. &.INDEXPCB....*        
3F405070 0070   00000000 3F40502C 40404040 40404040 *..... &.        *        
3F405080 0080   00000004 00000000 00000000 00000000 *................*        
3F405090 0090   00000000 00000000 00000000 00000000 *................*        
3F4050A0 00A0   00000000 00000000 00000000 00000000 *................*  
******************************* Bottom of data ********************************
 F1=Help      F3=Exit      F4=Prompt    F5=RFnd      F6=Zap       F7=Up        
 F8=Down     F10=Previous F11=Next     F12=Cancel

The following figure provides an example of displaying an individual CDE under the DLI TCB. This examples uses a CDE for DFSPSEL0.

Displaying an Individual CDE

 File  Dump  Zap  Options  Help                                               
-------------------------------------------------------------------------------
DELTA IMS                      IMS Storage Display              Row 1 to 2 of 2
                                                                              
IMSID . . . . . . D10P                               2011.265 15:08:08.64      
Dump Address  . . CDE(DFSPSEL0):DLI           (:DLI must be specified after dump address)
Length  . . . . . 32                                                           
Comment . . . . .
Address  Offset +0       +4       +8       +C         Character                
006B40F0 0000   006E2970 00000000 C4C6E2D7 E2C5D3F0 *.>......DFSPSEL0*        
006B4100 0010   BF3FF2F0 006B40E0 000100FC 31220000 *..20., /........*     
******************************* Bottom of data ********************************
 F1=Help      F3=Exit      F4=Prompt    F5=RFnd      F6=Zap       F7=Up        
 F8=Down     F10=Previous F11=Next     F12=Cancel


Related topic

Diagnostic-tools



 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

DELTA IMS products 6.9