3.6 AIFCONVADDR

	MPE documents
	Complete PDF
	Table of Contents
	Index
⇓ Page Bottom
Syntax
Parameters
Operation Notes

⇑ Page Top

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