77.6.3 DEF: Creating Memory Definitions

Users can create physical and logical memory definitions. The main difference is that for logical memory definitions an array structure must also be defined in addition to the storage address.
Physical memory definitions are used as descriptive symbols for storage addresses, and are intended for repeated use. They are assigned a Dummy Array structure (index range 0 to 0, element length 65535 Bytes), and are entered in the AMO administration area.
Logical memory definitions are used for addressing a storage location as an array, and accessing individual elements.
A created logical memory address can be stored in the AMO work area (available only during AMO execution), or in the save area of the resident task, or in a hard disk save area. Created physical memory addresses can only be stored in the AMO work area.
Command Syntax
•
Defining the Address by specifying the Selector and Offset
DEF,ADR,name,ADR,selector-offset;
The selector and offset must be entered as hexadecimals.
•
Defining the Address by specifying the Memory Location
DEF,ADR,name,TBL,table name,index,offset;
The "pointer offset" is the position of the read pointer relative to the beginning of the array element.
•
Defining the Array Structure and the Storage Locations
DEF,LOGNAME,name,area,element length,minimalindex&&maximalindex;
The following entries are permitted for the storage locations: AMO, HD and RES
Examples
The user wants to create an address symbol for the initial entry in the trace buffer of the message tracer. In accordance with the structure of the entries in the trace buffer, the address of the second entry can be found four bytes further on.
Input:
*def,adr,entry1,adr,3cf0-099c;
Output:
DISPLAYER-INPUT IN A1 PLEASE:
Input:
*def,adr,entry2,tbl,entry1,0,4;
Output:
DISPLAYER-INPUT IN A1 PLEASE:
The following command creates a logical memory definitions from an address symbol. In the example an array structure has been assigned to the trace buffer of the message tracer from the second entry on, with the range of elements numbered from 1 to 25. One element is 30 Bytes long (=length of a standard entry for OS messages).
Input:
*def,logname,entry2,amo,30,1&&25;
Output:
DISPLAYER-INPUT IN A1 PLEASE:
${DocTitle}, ID: ${DocID}
 © 02/2025 Mitel Networks Corporation. -  All rights reserved.
 Mitel and the Mitel logo are trademarks of Mitel Networks Corporation. Unify and associated marks are trademarks of Unify Software and Solutions GmbH&Co. KG.
 All other trademarks herein are the property of their respective owners.