DF4X4C-convert a file address
Product-sensitive programming interface
The following documents product-sensitive programming interface information.
Use this macro to do the following
- Convert a 4-byte file address to an 8-byte file address in 4x4 format.
- Convert an 8-byte file address in 4x4 format to a 4-byte file address.
Format
- label
- Specifies a symbolic name assigned to the macro statement.
- ACTION
- Specifies the type of file address conversion to perform.
- 4TO8
- Indicates that the FA4 parameter contains a 4-byte file address, which is used as input to the file address conversion. The corresponding 8-byte file address in 4x4 format is returned in the location represented by the FA8 parameter.
- 8TO4
- Indicates that the FA8 parameter contains an 8-byte file address in 4x4 format, which is used as input to the file address conversion. The corresponding 4-byte file address is returned in the location represented by the FA4 parameter.
- FA4=(reg)|label1
- The label or general register (R1-R7, R14, R15) containing the location of a 4-byte file address.
- FA8=(reg)|label2
- The label or general register (R1-R7, R14, R15) containing the location of an 8-byte file address.
Entry requirements
None.
Normal return
Control is returned to the next sequential instruction (NSI).
Error return
None.
Programming considerations
- Register values are preserved across this macro call.
- This macro does not perform any error checking. If error checking is required, use TPF macro FA4X4C.
- This macro can be run on any I-stream.
Examples
The following example converts a 4-byte file address to an 8-byte file address in 4x4 format.
DF4X4C ACTION=4TO8,FA4=STDFWD,FA8=ISTD8_FCH
