gtpo1m12Operations

ZADCA-Alter Dump Label

Use this command to change as many as 16 bytes of storage by specifying the address of a dump label.

Requirements and Restrictions

You must specify the IS parameter in a tightly coupled system when prefixing applies; for example, when you change storage in page 0 of an I-stream, or when you change the I-stream unique global areas.

Format




dumplabel
is a 3-character alphanumeric dump label.

rsa
is a 1- to 8-digit hexadecimal relative starting address (offset) from the dump label.

newdata
is the new data that replaces the old data. The new data must be an even number of hexadecimal digits and cannot exceed 32 digits (16 bytes).

Valdata-olddata
verifies that olddata matches the data being changed. If there is a discrepancy, no data is changed. The olddata variable must be an even number of hexadecimal digits and cannot exceed 32 digits (16 bytes). The length of olddata can be different from the length of newdata.
Note:
If you do not specify this parameter, the data is changed without any verification.

Is-xx
specifies the I-stream that this change affects where, xx is a decimal number from 1 to 16.

Additional Information

Examples

In the following example, 4 bytes of data beginning at the CLV dump label are changed on I-stream 1.

+--------------------------------------------------------------------------------+
|User:   ZADCA CLV 0 41EE0001                                                    |
|                                                                                |
|System: ADCA0010I 13.18.35 BEGIN DISPLAY                                        |
|         00000BBC- 0096012C 0096012C 00000000 00000000 .o...o.. ........        |
|         00000BCC- 00000000 00000000 00000000 00000000 ........ ........        |
|        ALTERED TO- _                                                           |
|         00000BBC- 41EE0001 0096012C 00000000 00000000 .....o.. ........        |
|         00000BCC- 00000000 00000000 00000000 00000000 ........ ........        |
|        END OF DISPLAY - ZEROED LINES NOT DISPLAYED                             |
+--------------------------------------------------------------------------------+

In the following example, 1 byte of data beginning at an offset of X'22' bytes from the CLV dump label is changed on I-stream 2.

+--------------------------------------------------------------------------------+
|User:   ZADCA CLV 22 FF I-2                                                     |
|                                                                                |
|System: ADCA0010I 13.18.35 BEGIN DISPLAY                                        |
|         00000BBC- 00000010 00000194 91004140 40008400 .......m j.....d.        |
|         00000BCC- 00000010 00000194 91004140 40008400 .......m j.....d.        |
|        ALTERED TO- _                                                           |
|         00000BBC- 0000FF10 00000194 91004140 40008400 .......m j.....d.        |
|         00000BCC- 00000010 00000194 91004140 40008400 .......m j.....d.        |
|        END OF DISPLAY - ZEROED LINES NOT DISPLAYED                             |
+--------------------------------------------------------------------------------+

Related Information

See TPF Main Supervisor Reference for more information about changing storage using a dump label.