Use this system macro to generate inline code that uses an entry control
block (ECB) virtual memory (EVM) segment and page tables to determine if an
EVM address is valid.
Format
- label
- A symbolic name can be assigned to the macro statement.
- ADDRESS
- This required parameter specifies the register containing the EVM address
to be validated.
- Rx
- Specifies a general purpose register, from R0 through R7.
- ERROR=label
- This required parameter specifies a program label, in the calling program,
where control is to be transferred in the event the specified EVM address is
not valid.
Entry Requirements
- The invoking routine must be executing in the SVM and be in supervisor
state.
- Register 9 must contain the SVM address of the target ECB.
- Register 11 must contain the standard TPF address value
(X'1000').
Return Conditions
- The register specified in the ADDRESS parameter is unchanged.
- The contents of registers R14 and R15 are unpredictable.
- When validation is successful, control is returned to the next sequential
instruction (NSI) following the macro. No address conversion was
performed.
- When validation is unsuccessful, processing continues at the address
specified by the ERROR parameter.
Programming Considerations
- This macro is for use in the control program (CP) only.
- The literals generated by this macro must be accessible to the generated
code.
- This macro uses general registers 14 and 15. They are not saved
prior to being used.
Examples
None.