gtpo1m13Operations

ZAFIL-Alter File

Use this command to change as many as 32 bytes of a file record.

Requirements and Restrictions

Format




fileaddr
is an 8- or 16-digit hexadecimal file address.
Note:
If you specify the file address using the FARF addressing format, the duplicate copy of the file is also updated.

mmmmcccchhhhrr
is a 14-digit extended MCHR file address, where:

mmmm
is the 4-digit hexadecimal symbolic module number.

cccc
is the 4-digit hexadecimal cylinder number.

hhhh
is the 4-digit hexadecimal head number.

rr
is the 2-digit hexadecimal record number.

mmgggggq
is an 8-digit general file (GF) pseudo module number and relative record number, where:

mm
is the 2-digit hexadecimal symbolic GF module number.

ggggg
represents bits 8-27 of a GF relative record number as a binary counter.

q
is a single hexadecimal digit that represents the low-order 4 bits of the GF relative record number as follows:

Bit
Description

 28 
Unit position of the relative record number.

 29 
Must be 1 to indicate a relative record number.

 30 
Must be 0.

 31 
The number 1 to indicate a large record, or the value 0 to indicate a small record.

rsa
is a 1- to 3-digit hexadecimal relative starting address (offset).
Note:
If the relative starting address is not on a fullword boundary, it is automatically adjusted to the next lower fullword boundary.

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 being changed. If there is a discrepancy, no data is changed. The variable olddata must be an even number of hexadecimal digits and cannot exceed 64 digits (32bytes). 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 file copy of the record to change:

R
retrieves and displays 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.

G
changes the 4-byte pseudo module number and relative record number copy.

Note:
The P and D options are valid only for FARF format addresses.

Additional Information

Examples

A file record is verified before it is changed in the following example. Notice that the data is displayed before and after it is changed.

+--------------------------------------------------------------------------------+
|User:   ZAFIL 0000000038880007 3 20 VALDATA-80                                  |
|                                                                                |
|System: AFIL0011I 07.10.02 DISPLAY OF FILE ADDRESS 0000000038880007             |
|         00000000- C1D60080 C3C7E3F2 00000514 00000515 AO..CGT2 ........        |
|         00000010- 00020FE8 0000432C 00004EB4 000023D0 ...Y.... ........        |
|        ALTERED TO-                                                             |
|         00000000- C1D60020 C3C7E3F2 00000514 00000515 AO..CGT2 ........        |
|         00000010- 00020FE8 0000432C 00004EB4 000023D0 ...Y.... ........        |
|        END OF DISPLAY - ZEROED LINES NOT DISPLAYED                             |
+--------------------------------------------------------------------------------+

A general file record is changed in the following example.

+--------------------------------------------------------------------------------+
|User:   ZAFIL 0D000005 8 01 T-G                                                 |
|                                                                                |
|System: AFIL0011I 07.42.23 DISPLAY OF FILE ADDRESS 000000000D000005             |
|         00000008- 00000000 00404040 0D000085 0D00033D .....    ...e....        |
|         00000018- 0D0005F5 00000000 00000000 004E0000 ...5.... ........        |
|        ALTERED TO-                                                             |
|         00000008- 01000000 00404040 0D000085 0D00033D .....    ...e....        |
|         00000018- 0D0005F5 00000000 00000000 004E0000 ...5.... ........        |
|        END OF DISPLAY - ZEROED LINES NOT DISPLAYED                             |
+--------------------------------------------------------------------------------+

Related Information

See TPF Main Supervisor Reference for more information about changing file records.