gtpo1m1aOperations

ZAPGM-Alter Program

Use this command to change as many as 16 bytes of a program starting at a specified program listing address. You can change real-time programs (both file resident and core resident), control programs, and core image restart area programs (FCTB, ACPL, ICDF, IPLB, SIGT, RIAT, and IPAT in the core resident program area).

Requirements and Restrictions

Format




progname
is a 4- to 6-character alphanumeric program name.

version
is a 2-character alphanumeric program version code. This parameter can be specified only for real-time programs.

rsa
is a 1- to 6-digit hexadecimal relative starting address (offset) in the program listing.

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.

Notes:

  1. If you do not specify this parameter, the data is changed without any verification.

  2. If you specify this parameter when you specify the B option for the COPY parameter, an error will occur if olddata is not the same in both the file copy and the core copy.

Loadset
specifies the loadset that contains the program you want to change.

lsname
is the 5- to 8-character alphanumeric name of a loadset.

BASE
indicates that you want to change the base version of the program. You can specify this parameter only for real-time programs.

Copy
specifies which copy of the program to change:

F
changes the file copy.

C
changes the core (main storage) copy.

B
changes both the core and the file copy.

Type
specifies which file copy of the program to change:

R
retrieves and displays either the prime or duplicate copy of the program and then changes both the prime and duplicate copies.

P
retrieves and displays the prime copy of the program and then changes both the prime and duplicate copies.

D
retrieves and displays the duplicate copy of the program and then changes both the prime and duplicate copies.
Note:
This parameter is ignored if you specify the C option for the COPY parameter.

Additional Information

Examples

The file copy of a real-time program is changed in the following example.

+--------------------------------------------------------------------------------+
|User:   ZAPGM CVAI 8 00404040                                                   |
|                                                                                |
|System: APGM0010I 10.48.54 BEGIN DISPLAY OF FILE COPY FOR                       |
|                           CVAI.40 ACTIVE IN LOADSET BASE                       |
|         00000008- 00000011 000001AC 91004140 40008400 ........ j..  .d.        |
|         00000018- C5C3C2D3 4DE0B204 0000D104 00000000 ECBL(... ..J.....        |
|        ALTERED TO-                                                             |
|         00000008- 00404040 000001AC 91004140 40008400 .    .... j..  .d.       |
|         00000018- C5C3C2D3 4DE0B204 0000D104 00000000 ECBL(... ..J.....        |
|        END OF DISPLAY - ZEROED LINES NOT DISPLAYED                             |
+--------------------------------------------------------------------------------+

Both the file and core copy of a control program are changed in the following example.

+--------------------------------------------------------------------------------+
|User:   ZAPGM CC3705 10 FFFF VALDATA-00 COPY-B                                  |
|                                                                                |
|System: APGM0010I 15.50.37 BEGIN DISPLAY OF FILE COPY FOR                       |
|                         CC3705 VERSION IY IN IMAGE IMAGEABC                    |
|         00000010- 00000000 00000000 001A0000 00C00000 ........ ........        |
|         00000020- 00000000 00000000 00020010 1B4458A0 ........ ........        |
|        ALTERED TO-                                                             |
|         00000010- FFFF0000 00000000 001A0000 00C00000 ........ ........        |
|         00000020- 00000000 00000000 00020010 1B4458A0 ........ ........        |
|                         BEGIN DISPLAY OF CORE COPY FOR                         |
|                         CC3705 VERSION IY                                      |
|         00000010- 00000000 00000000 001A0000 00C00000 ........ ........        |
|         00000020- 00000000 00000000 00020010 1B4458A0 ........ ........        |
|        ALTERED TO-                                                             |
|         00000010- FFFF0000 00000000 001A0000 00C00000 ........ ........        |
|         00000020- 00000000 00000000 00020010 1B4458A0 ........ ........        |
|        END OF DISPLAY - ZEROED LINES NOT DISPLAYED                             |
+--------------------------------------------------------------------------------+

Related Information

See TPF Main Supervisor Reference for more information about changing program data.