Use this command to change as many as 32 bytes of a file record.
Requirements and Restrictions
- For file records that also reside in VFA, you must specify a file address
reference format (FARF) address when it is necessary to change both the VFA
copy and the file copy. If you specify an MCHR address, only the file
copy of the record is changed. The VFA copy is deleted from VFA before
the change is made.
- You cannot use this command to change general dataset records.
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
- Online help information is available for this command. To display
the help information, enter one of the following:
ZAFIL HELP
ZAFIL ?
- Enter the ZCSON command to convert MCHR addresses to FARF3, FARF4, FARF5,
and FARF6 format depending on the system migration stage and dispense
mode.
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.