Inter-Tel GMX-48 INSTALLATION & MAINTENANCE Manual

							PROGRAMMING 
Issue 2, May 1990 INTER-TEL PRACTICES 
GMX-48 INSTALLATION & MAINTENANCE 
19. ON-LINE MONITOR 
19.1 The on-line monitor program is used to display 
and change the system memory. Because it requires a 
knowledge of hexidecimal and binary mathematics, it 
is intended only for use by an advanced installer or 
engineer for debugging and maintaining the system. 
It is not intended for untrained personnel. 
19.2 The on-line monitor menu is accessed by en- 
tering E from the applications program menu 
prompt. It includes the following: 
ON-LINE MONITOR 
A. [A] CPU ON-LINE MONITOR 
19.3 The 
on-line monitor program follows the for- 
mat described below. When you first select [A] the 
following warning appears: 
WARNING: THE 
ON-LINE MONITOR 
SHOULD BE USED ONLY BY TRAINED PER- 
SONNEL. CHANGING VALUES COULD RE- 
SULT IN A MAJOR SYSTEM FAILURE. 
19.4 A summary of the commands available can be 
viewed using the HELP directory. The help directory 
is displayed any time the user enters either a question 
mark (?) or HELP in response the command level 
prompt -(MEM >). The 
Advanced and Intermediate 
software help directories show the following com- 
mands. The 
Basic software help directory appears in 
the same format, but does not include all of the com- 
mands shown here.  [A] CPU ON-LINE MONITOR 
[B] CPU ACTIVITY MONITOR 
? DISPLAY MENU 
. EXIT 
[MONITOR]: 
ON-LINE MONITOR HELP FACILITY 
C 
CHANGE MEMORY  NS 
FIND NEXT MATCHING STRING 
c+ ADD TO MEMORY START address PE 
PEEK INTO MEMORY < B, W, L > 
ERRH TOGGLE ERROR HALT BIT PO 
POKE INTO MEMORY  
ERRP TOGGLE ERROR PRINT BIT POST 
POST A MESSAGE TO A TASK 
EXIT EXIT THE ROUTINE 
SDOF DISABLE SYSTEM DIAGNOSTICS 
EXT CONVERT EXTENSION TO TYPE/NUM SDON ENABLE SYSTEM DIAGNOSTICS 
F FIND MEMORY c B, W, L > 
SEND SEND A MESSAGE 
DNRT TOGGLE CPU/APP MESSAGE ENABLE STR 
FIND STRING IN MEMORY 
FRZ FREEZE RTl- POLLING UDOF DISABLE USER DIAGNOSTICS 
HELP 
PRINT HELP DIRECTORY 
UDON ENABLE USER DIAGNOSTICS 
I INITIALIZE MEMORY < B, W, L > 
UFRZ UN-FREEZE RIT POLLING 
M 
MEMORY DUMP 
< B, W, L > * 
MULTIPLY W/ACCUMULATOR 
UPRT TOGGLE RTI- MESSAGE ENABLE + 
ADDITION W/ACCUMULATOR 
MV 
MOVE MEMORY BLOCK  
. EXIT THE ROUTINE 
M+ 
ADD TO MEMORY START address ? PRINT HELP DIRECTORY 
Page 
5-320  
						

							INTER-TEL PRACTICES 
GMX-48 INSTALLATION & MAINTENANCE PROGRAMMING Issue 2, May 1990 
19.5 
After the help menu has been displayed, the terminal sends the message TYPE A PERIOD TO TERMI- 
NATE HELP, ANY OTHER TO CONTINUE. If you continue, the following menu appears. 
r 
CFCB 
COCB 
DCBD 
DCBS 
DDBF 
ICCB FORMATTED CONTROL BLC 
:KS 
PRINT DYNAMIC CNF-CCB KCBD PRINT DYNAMIC KEYSET CB 
PRINT DYNAMIC CO-CCB KCBS PRINT STATIC KEYSET CB 
PRINT DYNAMIC DSS CB LCBD PRINT DYNAMIC CO-LCB 
PRINT STATIC DSS CB 
LCBS PRINT STATIC CO-LCB 
PRINT DIALED DIGIT BUFFER 
SCBD PRINT DYNAMIC SL-CB 
PRINT DYNAMIC IC-CCB 
SCBS PRINT STATIC SL-CB 
1 
19.6 The terminal sends the message TYPE A PERIOD TO TERMINATE HELP, ANY OTHER TO CON- 
TINUE. If you continue, the following menus appear. 
NES 
DTMF BIT LIST AND MAP 
IC CALL CONTROL BLOCK QUE 
SMDR WAIT QUEUE 
__ 
- 
TONE BIT LIST AND MAP 
1 
DIALED-DIGIT BUFFER QUEUE 
TOGGLE CP DIAGNOSTICS BIT vc VOICE CHANNEL BIT LIST 
ICVC IC VOICE CHANNEL COUNTER 
ADDITIONAL ROUTINES 
BELL RING BELL ON ERROR MESSAGES 
CPMH CP MESSAGE HISTORY QUEUE 
CPFR FREEZE CP MESSAGE QUEUE CPUF UNFREEZE CP MESSAGE QUEUE 
RHST DUMP RESET HISTORY 
CPF? CP MESSAGE QUEUE FROZEN? 
CPDS CP HIST FROM CURRENT MSG 
CPDH DUMP CP MESSAGE HISTORY 
CODS CO HISTORY FROM CURRENT MSG 
CODH DUMP CO MESSAGE HISTORY 
AUX DUMP X AUX INFO RECORDS 
AUXD DUMP AUXILIARY HISTORY 
PC PC PEEK < B,W,L > PCM PC DUMP MEMORY 
PCDH DUMP CP MESSAGE HISTORY PCDA PC DUMP AUX HISTORY 
PORT ORIGINATING FWDS IDENTIFICATION 
UDDG UP/DOWN DIAG TOGGLE 
19.7 To exit the on-line monitor program and return to the [MONITOR]: prompt, enter EXIT QUIT or a pe- 
riod (.) at any command level prompt. 
19.8 The first group of commands shown in the HELP menu are used to find, change, and initialize the system 
memory blocks, as described on the following pages. 
Page 5-121  
						

							PROGRAMMING INTER-TEL PRACTICES 
Issue 2, May 1990 GMX-48 INSTALLATION & MAINTENANCE 
Find Memory 
19.9 The 
find (F) function allows the user to locate 
all instances of a specified KEY (ANDed with the op- 
tional mask) in a given range of memory. The com- 
mand is in the following format: 
F[B/W/L] START STOP KEY [MASK] 
19.10 The following parameters can be specified: 
The memory range can be specified as START and 
STOP address, or as a START address followed by 
the number of locations to be searched. 
The number of locations to be searched depend 
on the mode (byte, word, or longword). 
The substring must start on a word boundary. 
Values taken from memory are ANDed with the 
mask value before they are compared to the input 
value for the KEY. When only the first three pa- 
rameters are input, the default value of the mask 
is $FFFFFFFF, specifying an exact match be- 
tween the memory values and the KEY. 
19.11 For example, the command FL COO0 30 FE00 
locates the next $30 (hex) longwords beginning at lo- 
cation $COOO for the longword value $OOOOFEOO. 
19.12 When a match is found, the entire line (or 
lines) containing the matched substring is displayed 
and the memory repeat address is set to the base of 
the line. When multiple locations match the input 
KEY, the entire line is printed and the system contin- 
ues to display matching information until a full page 
has been displayed on the screen. The system then 
waits for either a period (.) to terminate the find com- 
mand, or any other character to continue searching 
until the range has been exhausted or another full 
page has been displayed (in which case the system 
waits again). 
Find String in Memory 
19.13 The 
find string (SIR) command allows the 
programmer to search through an area of memory for 
the given literal string. The command uses the follow- 
ing format: 
SIR STAFF STOP literal string 
19.14 Three parameters are required for the STR 
command: 
The START address of the search. 
Either the STOP address or the range of words 
that are to be searched. 
The final parameter that specifies the literal 
string to find. The string and the memory are con- 
verted to upper case letters before the compari- 
sons are made. 
19.15 If a match is not found, a message&displayed. 
Or, when a match is found, the lines that contain the 
substring are displayed and the memory repeat mode 
is enabled for the next line. When the command 
prompt displays, either inspect the memory that fol- 
lows the string by pressing the carriage return 
 key, or search for another instance of the 
string by typing NS at the MEM> prompt. The 
search is picked up from the point where it left off and 
searches the remainder of the requested range. 
Memory Dump 
19.16 The 
memory dump (M) command allows the 
programmer to display an area of memory in one of 
three formats. Word format (default value) is dis- 
played when an M or MW is followed by the optional 
START and STOP parameters. Byte format is re- 
quested by entering MB. Longword format is used 
when ML is entered. 
19.17 The memory dump (M) command uses the 
following format: 
M[B/W/L] [[START] [STOP]] 
Page 5-122  
						

							INTER-TEL PRACTICES PROGRAMMING 
GMX-48 INSTALLATION & MAINTENANCE Issue 2, May 1990 
19.18 The 
START and STOP addresses follow the 
format command to determine the beginning and end 
of the selected memory block. For example: 
ML COOO, 4 or ML COO0 4 - A new START 
address is specified for the START parameter, 
followed by the number (interpreted as a 
hexidecimal value) of memory longwords to dis- 
play. 
ML ,4 - Use the current value for the memory 
START address and display the next 4 longwords 
of memory. When no starting address is specified, 
the current value of the memory dump START 
variable is used. (‘To add to the START address for 
the memory dump processor, use the M+ com- 
mand.) 
M - Sixteen lines of word-formatted memory are 
displayed using the current value for START as 
the START address. 
NOTE: Either a comma (,) or space can be used to 
separate the parameters. 
19.19 The memory dump pauses between pages. 
Enter one of the following characters: 
An “at” sign (@) - The current value for the 
memory START variable is set to the base address 
of the top of the current page. This allows the pro- 
grammer to read a large area of memory and mark 
an area for the default START address to begin 
the next use of the memory dump command. 
A comma (,) - The current screen of data is re- 
displayed. This allows the programmer to observe 
data as it is changed by some other task. 
A period (.) 2 The memory dump command is 
terminated. The memory START variable is unaf- 
fected. 
A circumflex (“) or asterisk (*) - The previous 
screen of data is displayed. This allows the pro- 
grammer to back up. The back-up can extend be- 
yond the memory START address. o Any other character - The next screen of data is 
displayed. Pages of memory are displayed until 
this mode is terminated with either a period (.) or 
@, or the end of the range is reached. 
19.20 After an area of memory is displayed, succes- 
sive lines of memory can be viewed by pressing the 
carriage return < CR > in response to the command 
prompt (MEM >). 
Change Memory 
1931 The 
change memory (C)command allows the 
programmer to change a byte, word, or longword in 
memory. The command is entered in the following 
format: 
C[B/WIL] [START] 
19.22 The START address for the change command 
is optional; one of the following can be used: Use 
word format (default value) by entering C or CW 
(with or without a starting address), specify byte for- 
mat by entering CB, or select longword format using 
CL. 
1923 To terminate the change mode, enter one of 
the following characters followed by a carriage return 
. 
An “at” sign (@) - The START address can be 
changed at any time by simply entering a new 
START address when the change command is en- 
tered or by using the @ terminator while in 
change mode. When the @ terminator is used, the 
change mode START parameter is set to the ad- 
dress currently displayed on the terminal. 
A comma (,) - The same line is re-displayed on 
the terminal. 
A period (.) - Return to the command prompt for 
the on-line monitor. 
A circumflex (“) or asterisk (*) - The previous 
line of memory is displayed at the terminal. 
A < CR > - Continue to the next line of mem- 
orY- 
Page 5-123  
						

							INTER-TEL PRACTICES PROGRAMMING 
GMX-48 INSTALLATION & MAINTENANCE Issue 2, May 1990 
Send A Message 
19.38 
Entering the SEND command allows the 
programmer to send messages (entered from the 
keyboard). After each message is sent, the message 
processor prompts the user for another message. This 
mode can be terminated by entering a period (.) in re- 
sponse to the prompt MESSAGE:. 
19.43 All inputs are interpreted as hexidecimal val- 
ues. The unary operators + and - are allowed: 
Addition With Accumulator 
19.44 The 
add command ( + ) requires uses the fol- 
lowing format: 
+ [Pl], P2 
CAUTION 
Message validity is NOT verified before being 
sent. It is therefore the responsibility of the user 
to send proper messages. 
19.39 Entering the POST command allows the pro- 
grammer to post messages (entered from the key- 
board). 
Freeze RTT Polling 
19.40 The 
FRZKJFRZ commands are used to en- 
able and disable the keyset polling. The FRZ com- 
mand causes the CPU to stop polling the keysets for 
data. In this mode, the rest of the system continues to 
function as normal. The UFRZ command re-enables 
the polling function so that the entire system func- 
tions normally. 
Multiply With Accumulator 
19.41 The 
multiply command (*) uses the following 
format: 
* [Pl], P2 
19.42 It requires up to two parameters. The first pa- 
rameter represents the accumulator value and is op- 
tional for this command. If missing, the multiplicand 
is the value for the accumulator. For example, *,12 is 
interpreted correctly as 12 times the accumulator 
value. However, * 12 is interpreted as 12 times the 
constant value. It requires up to two parameters. The first parameter 
represents the primary addend and is optional for this 
command. If missing, the primary addend is taken 
from the accumulator for the add instruction. Thisal- 
lows results to accumulate over several additions. 
The second parameter specifies the secondary ad- 
dend and is also optional. If the secondary addend is 
omitted, the constant value is used in its place. 
NOTE: When the primary addend is missing, the user 
must precede the second parameter with a comma or 
it is taken as a new value for the accumulator. For ex- 
ample, 
+ ,12 is interpreted correctly as the accumula- 
tor plus 12. However, + 12 is interpreted as 12 plus 
the constant value. 
19.45 All inputs are interpreted as hexidecimal val- 
ues. The unary operators + and - are allowed. 
. 
Memory Read/Write Commands . 
19.46 The 
PE/PO commands allow the program- 
mer to inspect or change a byte, word, or longword in 
memory. They use the following format: B 
PE [B/W/L] [START] or PO [B/W/L] [START] 
19.47 The START address for the peek and poke 
commands are optional and default to the last START 
address specified for the command. The default size 
of the commands is word. Choose one of the follow- 
ing, if desired: Enter POB or PEB for byte, enter 
POW or PEW for word, or enter POL or PEL for 
longword. 
19.48 The terminators are the same for the memory 
change (M) command. 
Page 5-125  
						

							PROGRAMMING INTER-TEL PRACTICES 
Issue 2, May 1990 GMX-48 INSTALLATION & MAINTENANCE 
Convert Extension Number to Qpe and Logical 
Number 
19.49 The 
EXT command allows the programmer 
to enter the extension (intercom) number of a station. 
The terminal then displays the type of station instru- 
ment and the hex value of the control block associ- 
ated with the extension number. Enter the command 
in the following format: 
EXT EXXX (extension number) 
Formatted Control Blocks 
19.50 The 
formatted control block commands can 
be used to display the blocks of system data. The con- 
trol blocks are displayed with the data on the right 
half of the screen and a brief description on the left 
half of the screen. The fields are separated by a colon. 
19.51 The base address of the control block is out- 
put as a 32-bit hexidecimal value on the first line of the display. The remaining fields of the control block 
are output using hexidecimal, binary, A!SCII, or 
DTMF binary-coded decimal (DTMF BCD) values. 
19.52 The hexidecimal values begin with a dollar 
sign ($) and can be represented as byte, word, 3-byte, 
or longword fields. Individual fields that contain 
more than one value are separated by blank spaces 
and as many fields as possible are put on the same 
line. A new line for the same field starts with a colon 
in the middle of the page or screen. 
19.53 All binary fields are broken into byte quanti- 
ties and begin with a percent sign (%). As 
many values 
as will fit in the right half of the page/screen are out- 
put with blank spaces inserted to separate the fields. 
19.54 ASCII fields are displayed without spaces. As 
many characters as will fit on a line are output before 
a new line is started. 
19.55 DTMF BCD values are represented accord- 
ing to the following table. These valuesare printed as 
a single field with no intervening spaces. 
I 
DTMFBCD 1 2 3 4 5 6 7 8 9 A B C D E F 
INTERPRETATION 
DISPLAY VALUE 1 2 3 4 5 6 7 8 9 0 # * s M L 
Resource Manager Routines 
19.56 The commands listed under resource man- 
ager routines in the HELP menu are used to specify 
the resource list to be inspected. After the source is 
specified, the programmer can view and/or change (using the change memory command) the contents of 
the resource displayed. 
NOTE: The resource manager routines can change 
values that can cause a major system failure. 
Page 5-126