HPlogo 900 Series HP 3000 Computer Systems: MPE/iX Architected Interface Facility: Operating System Reference Manual > Chapter 3 Architected Interface Descriptions

AIFCONVADDR

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

Converts compatibility mode relative addresses to the corresponding native mode virtual addresses.

Syntax

                   REC           I32A         RECA

 AIFCONVADDR (overall_status, mode_array, inaddress_array,

                     @64A             I32A          I32

              outaddress_array, convstatus_array, user_id);

Parameters

overall_status

record by reference (required)

Returns the overall status of the call. A zero indicates a successful call. A negative value indicates an error in the overall call. A positive value indicates a warning. Refer to appendix A for meanings of status values.

Record type: status_type (Refer to appendix B.)

mode_array

32-bit signed integer array by reference (required)

Passes an array of integers where each element contains a value indicating the addressing mode of the compatibility mode address located in the corresponding element in inaddress_array. If n addresses are being converted, element n + 1 must be a zero to indicate the end of the element list.

Values and their meanings are as follows:

1

DB relative byte address (stack or XDS)

2

DB relative word address (stack or XDS)

3

Stack DB relative byte address (stack only)

4

Stack DB relative word address (stack only)

5

Bank 0 relative word address

inaddress_array

record array by reference (required)

An array where each element is an unsigned 16-bit CM address to be converted. The addressing mode of the CM address is defined in the corresponding element in mode_array.

Array type: bit16 (Refer to appendix B.)

outaddress_array

64-bit address array by reference (required)

An array where each element returns a 64-bit address that is the result of the conversion performed on a CM address located in the corresponding element in inaddress_array.

Array type: globalanyptr

convstatus_array

record array by reference (required)

An array where each element returns the status of the conversion operation performed in the corresponding element in inaddress_array. A zero indicates a successful operation. A negative value indicates an error condition. A positive value indicates a warning. Refer to appendix A for meanings of status values.

Array type: status_type (Refer to appendix B.)

user_id

32-bit signed integer by value (optional)

The user ID assigned to a vendor at the time of purchase of the Architected Interface Facility: Operating System product. If it is not passed, the caller must have previously called AIFACCESSON.

Default: 0

Operation Notes

None.

Feedback to webmaster