113.2.2
INPUT-HIDMP
Notes
The verb INPUT-HIDMP is called up automatically (hidden instruction) once the AMO has been started using EXEC-HIDMP. The next command is to be input after the asterisk (’*’). The AMO is in interactive mode. After execution of a command, the system again issues the input request:
PLEASE HIDUMP INPUT FOR <processor name>:
*
This AMO message also indicates that the previous command has been properly processed. If it is accompanied by an error message, the command has not been executed.
Note
Again, the asterisk (’*’) is used as a user prompt. In our example it precedes the actual user input.
The following commands are defined:
CMD=
P,MDL=<param>;
This command enables HIDUMP control segments that associated with other
hardware modules to be processed in interactive mode, i.e. without having
to exit the AMO. Following this command, the newly selected control data
can be processed.
The parameter MDL is used to select the HW module.
Example
Changeover to processing of HIDUMP control data for LTG.
Input:
*P,LTG;
Output:
PLEASE HIDUMP INPUT FOR LTG:
*
CMD=
DEF,NUMBER=<param>,COND=<string>,ACTION=<string>;
This command defines the control data and stores it in the control segment.
A maximum of 1 kbyte of control data can be defined. The control data is stored in single control
strings (each of it has been created by a DEF command) in the ascending order of their numbers.
A control string consits of a identification number (it defines the processing sequence by the
HIDUMP, that means the control string with the lowest number will be processed first), some
conditions and the associated actions.
The parameter COND defines the conditions.
The parameter ACTION determines the actions that are carried out when the conditions are met
After input the control string is deactive, its execution counter is zero (0).
The ON command is used to activate it and to enter an execution counter.
Note regarding the parameter COND:
The parameter COND comprises at least one term. Each term consists of three parts:
1.
Variable to be compared;
C ... Call code
E ... Exception code
I ... Interrupt no.
N ... NMI no.
O ... OS sev.
2.
Mathematical operator;
= ... equal to
> ... greater than
>= ... greater than or equal to
< ... less than
<= ... less than or equal to
/= ... not equal to
3.
Reference value;
(hexadecimal, up to four characters in length)
Example of terms: I<=9 , N=10 , C/=A7D;
It is possible to link several of these terms by means of logical operators (OR, AND) or to make use of parentheses. Terms or parenthesized expressions are negated by a preceding NOT.
The parameter COND must be delimited, i.e. preceded and succeded, by the character ’"’.
Note
The condition NOT C=5000 initiates execution of the specfied actions for any fault except C=5000 (even for NMI, aso. ...). If a dump is required only for each call code ( C) that is not equal to 5000, the condition needs to be formulated as follows:
a.
C>=0 AND NOT C=5000 AND C<FFFF
or
b.
C/=5000
The first variant offers the additional possibility to define an upper limit and a lower limit.
Note regarding the parameter ACTION:
Only the following actions and syntax interpretation will be accepted.
a)
DUMP_BCA( <len> )
b)
DUMP_MEM_LOG( <offset> : <base> / <len> )
c)
DUMP_MEM_LOG(<selector>:<offset>/<len> )
In the case of DUMP_MEM_LOG, base / selector and offset must be separated by a colon ’:’. Each of the two values may be up to four characters in length.
d)
DUMP_MEM_PHYS( <phys.addr.> / <len> )
In the case of DUMP_MEM_PHYS, the physical address may be up to 6 characters in length.
e)
DUMP_DPR( <value for DPR> / <len> )
In the case of DUMP_DPR, a code for the Dual Port Ram (DPR) to be dumped must be specified for the first parameter. The following codes are permitted:
0 for IP-DPR, 1 for MIP-DPR, 2 for CCH-DPR, 3 for MBU_1-DPR, 4 for MBU_2-DPR, 5 for MBU_3-DPR, 6 for MBU_4-DPR, 7 for IOCG-DPR, 8 for DCL-DPR .
f)
DUMP_STACK( <len> )
g)
DUMP_RNGT
h)
DUMP_001
i)
DUMP_002
j)
DUMP_003
k)
DUMP_004
l)
DEBUG_001
m)
DEBUG_002
n)
DEBUG_003
o)
DEBUG_004
p)
DEBUG_005
q)
DEBUG_006
r)
DEBUG_007
s)
DEBUG_008
In all cases, the parameter <len> may be up to 4 characters in length. It is treated as a hecadecimal value.
If several actions are specified, these must be separated by means of ’&’. If the actions used include a parameter, the parameter must be enclosed in parentheses and must immediately follow the action itself. If several parameters are specified, they must be separated by a slash ’/’.
The parameter ACTION must be delimited, i.e. preceded and succeded, by the character ’"’.
Examples
1.
If exception code >= 3A and exception code <= 50, AND NOT call code = 17 OR interrupt = 18, the actions DEBUG_005 DUMP-BCA(200) DUMP_DPR(MBU-DPR,30) are to be carried out. The control string number is 4.
Input:
*DEF,4,"( E=>3A AND E<=50) AND NOT C=17 OR I=18","DEBUG_005&
DUMP_BCA(200)&DUMP_DPR(2/30)";
Output:
PLEASE HIDUMP INPUT FOR LTG:
*
2.
If exception code 123 or call code 240 turn out to be the cause of a restart, the actions DUMP_MEM_LOG with the logical address (base = 39A8 / selector = 39A8, offset = 14F), length = 75 and DUMP_MEM_PHYS with the physical address 1C863E , length = 140 are to be executed. The control string number is 174.
Input:
*DEF,174," E=123 OR C=240","DUMP_MEM_LOG(14F:39A8/75)&
DUMP_MEM_PHYS(1C863E/140)";
*DEF,174," E=123 OR C=240","DUMP_MEM_LOG(39A8:14F/75)&
DUMP_MEM_PHYS(1C863E/140)";
Output:
PLEASE HIDUMP INPUT FOR LTG:
*
CMD=
ON,TYPE=NO,NUMBER=<param>,CNT=<param>;
ON,TYPE=ALL,CNT=<param>;
This command is used to set defined control strings to ACTIVE, i.e. the control string will
be identified as being active, and processed by HIDUMP (resident) in the case of a restart.
It is possible to activate either all (TYPE=ALL) or only a certain (TYPE=NO) control string.
The parameter CNT determines how many times a control string may be executed by HIDUMP.
Activation is independent of the status previously held.
Examples
1.
All defined control strings are to be activated and processed 5 times by HIDUMP.
Input:
*ON,ALL,5;
Output:
PLEASE HIDUMP INPUT FOR LTG:
*
2.
Control string no. 38 is to be activated and processed once by HIDUMP.
Input:
*ON,NO,38,1;
Output:
PLEASE HIDUMP INPUT FOR LTG:
*
CMD=
OFF,TYEP=NO,NUMBER=<param>;
OFF,TYPE=ALL;
This command is used to DEACTIVATE defined control strings, which means that the control
string will not be processed by HIDUMP in the case of a restart.
It is possible to deactivate either all (TYPE=ALL) or a particular (TYPE=NO) control string.
Deactivation is independent of the status previously held.
Examples
1.
All defined control strings are to be deactivated.
Input:
*OFF,ALL;
Output :
PLEASE HIDUMP INPUT FOR LTG:
*
2.
Control string no. 2 is to be deactivated.
Input:
*OFF,NO,2;
Output:
PLEASE HIDUMP INPUT FOR LTG:
*
CMD=
LST,TYPE=NO,NUMBER=<param>,[CNT=<param>],[ACTION=<string>];
LST,TYPE=ALL,[CNT=<param>],[ACTION=<string>];
LST,TYPE=ACT,[CNT=<param>],[ACTION=<string>];
LST,TYPE=DEACT,[CNT=<param>],[ACTION=<string>];
This command is used to output control data information. It is possible to specify several
selection criteria. Parameter TYPE (mandatory) determines whether a particular, all, all active,
or all deactivate control strings are to be processed for output. The parameters CNT (optional)
and ACTION (optional) can be used to make a selection for output processing.
NOTE
As the processing of parameter ACTION is not implemented in this version of AMO HIDMP, the parameter will simply be ignored by the AMO.
Examples
1.
All active control strings are to be output.
Input:
*LST,ACT;
Output: :
------------------------------------------------------------------------------
DUMP NO: 3 CNT: 3 STATUS: ACT
N<66D OR NOT( O=4))
DUMP_MEM_LOG(E435:1B48/1000)
DUMP_MEM_LOG(1B48:E435/1000)
DUMP NO: 9 CNT: 1 STATUS: ACT
N/=FFF2
DUMP_STACK(160)
DUMP NO: 40 CNT: 3 STATUS: ACT
(( C=7F2 AND ( O/=55E AND I<EE2)) OR C>A3)
DUMP_MEM_PHYS(28FAC1/50)
DUMP NO: 61 CNT: 4 STATUS: ACT
( E>442A OR NOT( I=5))
DEBUG_001, DUMP_DPR(8/20)
DUMP NO:204 CNT: 3 STATUS: ACT
( I<A41 OR C=1000)
DEBUG_005, DUMP_BCA
------------------------------------------------------------------------------
PLEASE HIDUMP INPUT FOR LTG:
*
2.
All control strings with CNT = 3 are to be output.
Input:
*LST,ALL,3;
Output:
------------------------------------------------------------------------------
DUMP NO: 3 CNT: 3 STATUS: ACT
( N<66D OR NOT( O=4))
DUMP_MEM_LOG(E435:1B48/1000)
DUMP_MEM_LOG(1B48:E435/1000)
DUMP NO: 7 CNT: 3 STATUS: DEACT
C>=3F
DUMP_DPR(6/200), DUMP_RNGT, DUMP_003
DUMP NO: 10 CNT: 3 STATUS: DEACT
NOT( C=EE3 AND O<6)
DEBUG_007, DUMP_STACK(70), DUMP_001
DUMP NO: 40 CNT: 3 STATUS: ACT
(( C=7F2 AND ( O/=55E AND I<EE2)) OR C>A3)
DUMP_MEM_PHYS(28FAC1/50)
DUMP NO:119 CNT: 3 STATUS: DEACT
N=2
DUMP_004
DUMP NO:204 CNT: 3 STATUS: ACT
( I<A41 OR C=1000)
DEBUG_005, DUMP_BCA
------------------------------------------------------------------------------
PLEASE HIDUMP INPUT FOR LTG:
*
Input:
*LST,NO,40;
Output:
------------------------------------------------------------------------------
DUMP NO: 40 CNT: 3 STATUS: ACT
(( C=7F2 AND ( O/=55E AND I<EE2)) OR C>A3)
DUMP_MEM_PHYS(28FAC1/50)
------------------------------------------------------------------------------
PLEASE HIDUMP INPUT FOR LTG:
*
CMD=
CMD= DEL,TYPE=NO,NUMBER=<param>;
DEL,TYPE=ALL;
This command is used to delete control data (control strings). The parameter TYPE
specifies whether all control strings (TYPE=ALL) or whether one particular control string
(TYPE=NO) is to be deleted-
Examples
1.
All control strings are to be deleted.
Input:
*DEL,ALL;
Output: :
PLEASE HIDUMP INPUT FOR LTG:
*
2.
Control string no. 2 is to be deleted.
Input:
*DEL,NO,2;
Output::
PLEASE HIDUMP INPUT FOR LTG:
*
CMD=
END;
This command terminates the AMO.
${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.