VIRTAD (Virtual Address Return) Macro

The macro returns, in register 0, the virtual address corresponding to a specified real address.

Format

Read syntax diagramSkip visual syntax diagramnameVIRTADaddress(1)

Requirements for the caller

AMODE:
24 or 31
RMODE:
24 or ANY
ASC Mode:
Primary

Parameters

address | (1)
Is the real storage address to be converted. It can be given as a symbol or in register notation.

The AMODE/RMODE of the caller can be 24 or 31 bit. When called in 24-bit mode, the address is treated as a 3-byte address; when called in 31-bit mode, the address is treated as a 4-byte address.

Register 0 returns the virtual address only if the specified real address points to a page frame that contains a PFIXed page. Otherwise, register 0 contains 0. Thus, the macro can be used to test if a page is PFIXed.
Note: The pages of a program that runs in real mode are considered to be fixed.