gtpo1m1bOperations

ZAREC-Alter a Fixed File or Pool Record

Use this command to change as many as 32 bytes of a fixed file record or pool record starting at a specific relative starting address. You can specify the record type as a hexadecimal number, SYSEQ label, or pool type.

Requirements and Restrictions

None.

Format




rectype
is a 1- to 4-digit hexadecimal record type (for FACE).

Llabel
is a 1- to 8-character SYSEQ label (for FACS).
Note:
The number sign (#) that precedes the SYSEQ label is optional unless it is needed to distinguish between 2 labels; for example, #RECA and RECA.

Ppool
is a pool record, where pool is one of the following pool record types:

SLT
Small, long-term

SST
Small, short-term

SDP
Small, long-term duplicate

LLT
Large, long-term

LST
Large, short-term

LDP
Large, long-term duplicate

4LT
4-KB, long-term

4ST
4-KB, short-term

4DP
4-KB, long-term duplicate

4D6
4-KB, long-term FARF6 duplicate.

ordnum
is a 1- to 16-digit hexadecimal ordinal number.

rsa
is a 1- to 3-digit hexadecimal relative starting address (offset) in the record.

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

Valdata-olddata
verifies that olddata matches the data that is 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 64 digits (32 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.

Type
specifies which copy of the record to retrieve:

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

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

D
retrieves and displays the duplicate copy of the record and then changes both the prime and duplicate copies.

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

Cpuid-id
is the 1-character alphanumeric CPU ID of the processor.

Ssu-user
is a subsystem user.

Additional Information

Examples

In the following example, data in the specified fixed file record is changed.

+--------------------------------------------------------------------------------+
|User:   ZAREC 023.000009 10C D1C6D2                                             |
|                                                                                |
|System: AREC0011I 10.48.44 DISPLAY OF FILE ADDRESS 000000001180004F             |
|         0000010C- D3C1E7A8 18210000 00000000 00000000 LAXy.... ........        |
|         0000011C- FE1443C2 D3C1E76A 18A10000 00000000 ...BLAX. .s......        |
|        ALTERED TO-                                                             |
|         0000010C- D1C6D2A8 18210000 00000000 00000000 JFKy.... ........        |
|         0000011C- FE1443C2 D3C1E76A 18A10000 00000000 ...BLAX. .s......        |
|        END OF DISPLAY - ZEROED LINES NOT DISPLAYED                             |
+--------------------------------------------------------------------------------+

In the following example, the data that is changed is verified before it is replaced by the new data.

+--------------------------------------------------------------------------------+
|User:   ZAREC LRV1RI.4 192 D5C5E3C2 VALDATA-40404040                            |
|                                                                                |
|System: AREC0011I 10.48.44 DISPLAY OF FILE ADDRESS 0000000042000027             |
|         00000190- 00004040 40404040 4040C3C9 C3E2E7C2 ..         CICSXB        |
|         000001A0- 40400000 80000000 00000000 00000000   ...... ........        |
|        ALTERED TO-                                                             |
|         00000190- 0000D5C5 E3C24040 4040C3C9 C3E2E7C2 ..NETB     CICSXB        |
|         000001A0- 40400000 80000000 00000000 00000000   ...... ........        |
|        END OF DISPLAY - ZEROED LINES NOT DISPLAYED                             |
+--------------------------------------------------------------------------------+

A pool record is changed in the following example.

+--------------------------------------------------------------------------------+
|User:   ZAREC PLST.40 10 D1C6D2A8                                               |
|                                                                                |
|System: AREC0011I 13.34.52 DISPLAY OF FILE ADDRESS 0000000000040101             |
|         00000010- 00000000 00000000 00000000 00000000 ........ ........        |
|         00000020- 00000000 00000000 00000000 00000000 ........ ........        |
|        ALTERED TO-                                                             |
|         00000010- D1C6D2A8 00000000 00000000 00000000 JFKy.... ........        |
|         00000020- 00000000 00000000 00000000 00000000 ........ ........        |
|        END OF DISPLAY - ZEROED LINES NOT DISPLAYED                             |
+--------------------------------------------------------------------------------+

Related Information

See TPF Concepts and Structures for more information about fixed file records and pool records.