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

Read syntax diagramSkip visual syntax diagramlabelDF4X4CACTION=4T088T04,FA4=(reg)label1 ,FA8= (reg)label2
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