1. EAGLE Commands User's Guide
  2. Debug Commands
  3. dbg-ddb

5.15 dbg-ddb

Use this command to display the checksum, statistics, and wild write audit (WWA) updates of dynamic database (DDB) table entries, audit a specific table, and reset the DDB statistics on the cards.

Parameters

action (mandatory)
The action taken by the command.
Range:
stats
display dynamic database statistics
aud
audit a specific table
disp
display a table entry
wwa
display any entries updated by WWA task
rststat
reset following DDB audit statistics:
  • Number of DDB updates
  • Number of consecutive DDB update in progress
  • Maximum DDB updates in 100 msec
  • Idle period
  • Maximum and minimum idle period
audtype (optional)
Audit type. This parameter specifies whether a unicast or multicast audit is performed.
Range:
mc
multicast
uc
unicast
Default:
mc
dpc (optional)
The destination point code value. The Route table entry corresponding to the DPC value is displayed.
Range:
p-, 000-255, *

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—p-

The asterisk value (*) is not valid for the ni subfield.

When chg-sid:pctype=ansi is specified, ni = 000 is not valid.

When chg-sid:pctype=ansi is specified, nc = 000 is not valid if ni = 001–005.

When chg-sid:pctype=ansi is specified, nc = 000 is valid if ni = 006–255.

The point code 000-000-000 is not a valid point code.

dpc/dpca/dpci/dpcn/dpcn24/dpcn16 (optional)
dpci (optional)
ITU international destination point code with subfields zone-area-id. The prefix subfield indicates a spare point code, private point code, or private and spare point code (prefix-zone-area-id).
Range:
s-, p-, ps-, 0-255, none

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—s-, p-, ps

zone—0-7

area—000-255

id—0-7

The point code 0-000-0 is not a valid point code.

Enter none to delete the point code.

dpcn (optional)
ITU national destination point code in the format of a 5-digit number (nnnnn); or 2, 3, or 4 numbers (members) separated by dashes (m1-m2-m3-m4) as defined by the chg-stpopts:npcfmti flexible point code option. A group code must be specified when the ITUDUPPC feature is turned on (nnnnn-gc, m1-m2-m3-m4-gc). The prefix subfield indicates a spare point code, private point code, or private and spare point code (prefix-nnnnn, prefix-nnnnn-gc, prefix-m1-m2-m3-m4, prefix-m1-m2-m3-m4-gc).
Range:
s-, p-, ps-, 0-16383, aa-zz

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—s-, p-, ps

nnnnn—0-16383

gc—aa-zz

m1-m2-m3-m4—0-14 for each member; values must sum to 14

dpcn24 (optional)
24-bit ITU national destination point code with subfields main signaling area-sub signaling area-signaling point (msa-ssa-sp). The prefix subfield indicates a private point code (prefix-msa-ssa-sp).
Range:
p-, 000-255

Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).

prefix—p

msa—000–255

ssa—000–255

sp—000–255

Default:
No change to current value.
dpcn16 (optional)
16-bit ITU national point code with subfields unit number sub number area main number area (un-sna-mna). The prefix subfield indicates a private point code (prefix-un-sna-mna).
Range:
p--, 000--127
Specify a valid value for each subfield of the point code, and separate the subfields with a dash (-).
prefix--p
un---000---127
sna---000---15
mna---000---31
Default:
No change to the current value.
link (optional)
The entry in the Link table that corresponds to the specified link value.
Range:
a, b, a1 -a31, b1 - b31
loc (optional)
The location of the MTP card that is being debugged.
Range:
1101 - 1108, 1111 - 1112, 1201 - 1208, 1211 - 1218, 1301 - 1308, 1311 - 1318, 2101 - 2108, 2111 - 2118, 2201 - 2208, 2211 - 2218, 2301 - 2308, 2311 - 2318, 3101 - 3108, 3111 - 3118, 3201 - 3208, 3211 - 3218, 3301 - 3308, 3311 - 3318, 4101 - 4108, 4111 - 4118, 4201 - 4208, 4211 - 4218, 4301 - 4308, 4311 - 4318, 5101 - 5108, 5111 - 5118, 5201 - 5208, 5211 - 5218, 5301 - 5308, 5311 - 5318, 6101 - 6108, 6111 - 6118
lsn (optional)
Linkset name. The entry in the Linkset table that corresponds to the specified linkset name. 
Range:
ayyyyyyyy
rloc (optional)
Reference card location. This parameter audits the table where the reference card is located.
Range:
1101 - 1108, 1111 - 1112, 1201 - 1208, 1211 - 1218, 1301 - 1308, 1311 - 1318, 2101 - 2108, 2111 - 2118, 2201 - 2208, 2211 - 2218, 2301 - 2308, 2311 - 2318, 3101 - 3108, 3111 - 3118, 3201 - 3208, 3211 - 3218, 3301 - 3308, 3311 - 3318, 4101 - 4108, 4111 - 4118, 4201 - 4208, 4211 - 4218, 4301 - 4308, 4311 - 4318, 5101 - 5108, 5111 - 5118, 5201 - 5208, 5211 - 5218, 5301 - 5308, 5311 - 5318, 6101 - 6108, 6111 - 6118
tbl (optional)
The table used as the source of the audit data.
Range:
lnk
Link table
ls
Linkset table
rte
Route table
tidx (optional)

Table index. This parameter displays the corresponding table entry.

Range:
0 - 16000
System Default:
0

Example

This command displays the 126th entry in the Link table.

dbg-ddb:loc=1105:tbl=lnk:action=disp:tidx=126

This command displays the entry in the Link table corresponding to link=a and rloc=1107.

dbg-ddb:loc=1105:tbl=lnk:action=disp:rloc=1107:link=a

This command audits the Link table in multicast mode.

dbg-ddb:loc=1105:tbl=lnk:action=aud:audtype=mc

This command audits the Link table in unicast mode.

dbg-ddb:loc=1105:tbl=lnk:action=aud:audtype=uc

This command audits the Link table at the card location 1105 using the reference card 1107.

dbg-ddb:loc=1105:tbl=lnk:action=aud:audtype=uc:rloc=1107

This command displays the statistics of a specified card.

dbg-ddb:loc=1201:action=stats

This command displays the WWA entries on a specified card.

dbg-ddb:action=wwa:loc=1201

This command resets the statistics of a specified card.

dbg-ddb:action=rststat:loc=2100

This command resets the statistics of all active MTP cards.

dbg-ddb:action=rststat

Dependencies

The dpc, tidx, lsn, and rloc parameters cannot be specified together in the command.

The dpc, tidx, lsn, and  link parameters cannot be specified together in the command.

The action=disp and tbl=rte parameters must be specified before the dpc parameter can be specified.

The action=disp and tbl=ls parameters must be specified before the lsn parameter can be specified.

The action=disp and tbl=lnk parameters must be specified before the link parameter can be specified.

The action=disp parameter must be specifed before the tidx parameter can be specified.

The action= aud  parameter must be specified before the audtype parameter can be specified.

The action=disp and tbl=lnk parameters or the action=aud and  audtype=uc  parameters must be specified before the rloc  parameter can be specified.

If the action parameter has a value of wwa, stats, or rststat, then the loc parameter is the only other parameter that can be specified.

2155 E2155 Cmd Rej: Invalid parameter combination specified

If the action=disp and tbl=lnk parameters are specified, then the rloc and link parameters must be specified together in the command.

4785 E4785 Cmd Rej: RLOC and LINK parameter combination must be specified

The card location specified by the loc or rloc parameter must be equipped.

2101 E2101 Cmd Rej: Card location is unequipped

The value specified for the loc or rloc parameter must indicate an MTP card.

2212 E2212 Cmd Rej: Invalid card type for this command

The status of the card at the location specified by the loc or rloc parameter must be active.

4259 E4259 Cmd Rej: Target card is not in Active state

The linkset specified by the lsn parameter must already exist in the Linkset table.

2303 E2303 Cmd Rej: Unknown LSN

The link specified by the link parameter must already be equipped.

2373 E2373 Cmd Rej: Link is unequipped in the database

The value specified for the dpc parameter must already exist in the Route table.

2417 E2417 Cmd Rej: Point code does not exist in the routing table

The Link table is corrupt or cannot be found.

2103 E2103 Cmd Rej: Failed reading the link table

The value specified for the dpc parameter must be a full point code, network point code, or a cluster point code.

2886 E2886 Cmd Rej: DSTN address must be a full, network or cluster PC

Values of 1113 - 1118 cannot be specified for the loc or rloc parameters.

2154 E2154 Cmd Rej: Card slot reserved by system

If the action parameter has a value of disp, aud, stats, or wwa, then the loc parameter must be specified.

If the action=aud parameter and the rloc parameter are specified, then the audtype parameter must be specified.

If the action parameter has a value of disp or aud, then the tbl parameter must be specified.

2379 E2379 Cmd Rej: Missing parameter

The J7 support feature must be enabled before the opcn16/dpcn16 parameters can be specified.

2691 E2691 Cmd Rej: J7 Support Feature must be enabled.

Notes

For a multicast audit, the card that receives the message sends the audit request to all other MTP cards simultaneously. For a unicast audit, the card that receives  the message sends the audit request to another MTP card, which sends the request to next MTP card, etc. This process continues until the last MTP card in the system receives the request.

A maximum of the last 10 entries of WWA updates are displayed.

Output

A maximum of 20 entries with mismatched card values can be displayed as necessary.

If mismatched card entries occur, the SeqNo field can be used to correlate the entries between two cards (e.g.SeqNo: 1 of card 1 can be compared against SeqNo: 1 of card 2.)

dbg-ddb:loc=1104:action=disp:tbl=ls:tidx=1 

    tekelecstp 09-10-15 12:37:37 EST  EAGLE5 41.1.0
    dbg-ddb:loc=1104:action=disp:tbl=ls:tidx=1
    Command entered at terminal #4. 
;

    tekelecstp 09-10-15 12:37:37 EST  EAGLE5 41.1.0
    User Message sent to location 1104. 
;

    tekelecstp 09-10-15 12:37:37 EST  EAGLE5 41.1.0
    [SeqNo: 0] [1104] [Linkset:1] Chksum h'1624 at h'28e84a (138 bytes)
    Assign:1 Avail:0 APC:   001-001-002 ITUNVar:0 
;
dbg-ddb:loc=1104:action=disp:tbl=lnk:tidx=1 

    tekelecstp 09-10-15 12:37:37 GMT  EAGLE5 41.1.0
    dbg-ddb:loc=1104:action=disp:tbl=lnk:tidx=1
    Command entered at terminal #4. 
;

    tekelecstp 09-10-15 12:37:37 GMT  EAGLE5 41.1.0
    User Message sent to location 1104. 
;

    tekelecstp 09-10-15 12:37:37 GMT  EAGLE5 41.1.0
    [SeqNo: 0] [1104] [Link:x1] Chksum h'da8d at h'2877ce (14 bytes)
    PortId:h'1e6 (Card:1104 Link h'0)
    Slc:0 Stat:h'2 LsId:h'0 Class:0
    Status:Fail 
;
dbg-ddb:loc=1104:action=aud:tbl=lnk:audtype=mc 

    tekelecstp 09-10-15 13:40:38 GMT  EAGLE5 41.1.0
    dbg-ddb:loc=1104:action=aud:tbl=lnk:audtype=mc
    Command entered at terminal #4. 
;

    tekelecstp 09-10-15 13:40:38 GMT  EAGLE5 41.1.0
    User Message sent to location 1104. 
;

    tekelecstp 09-10-15 13:40:38 GMT  EAGLE5 41.1.0
    [1104] Bcast:Card->Sys (Tbl 0) MTPCards:h'2 Reply:h'2 Mismatch:h'0 
;
dbg-ddb:loc=1104:action=aud:tbl=lnk:audtype=uc 

    tekelecstp 09-10-15 16:37:11 GMT  EAGLE5 41.1.0
    dbg-ddb:loc=1104:action=aud:tbl=lnk:audtype=uc
    Command entered at terminal #4. 
;

    tekelecstp 09-10-15 16:37:11 GMT  EAGLE5 41.1.0
    User Message sent to location 1104. 
;

    tekelecstp 09-10-15 16:37:11 GMT  EAGLE5 41.1.0
    [1104]Card->System (Tbl:0) Successful System Audit Completed 
;

This example shows the output when multiple mismatch entries occur between two cards:

dbg-ddb:loc=1205:rloc=1207:action=aud:tbl=rte:audtype=uc 

    tekelecstp 10-01-28 16:37:11 GMT  EAGLE5 42.0.0
    dbg-ddb:loc=1205:rloc=1207:action=aud:tbl=rte:audtype=uc
    Command entered at terminal #4. 
;   

    tekelecstp 10-01-28 16:37:11 GMT  EAGLE5 42.0.0
    User Message sent to location 1205. 
;

    tekelecstp 10-01-28 16:37:11 GMT  EAGLE5 42.0.0
    Card[1205]->card[1207] (Tbl:0) TblAuditDone:TotalMisses:h'2 FirstMiss:h'0 
;

    tekelecstp 10-01-28 16:37:11 GMT  EAGLE5 42.0.0
    [SeqNo: 1] [1205] [Route:h'0] Chksum h'320b at h'8fc3b0 (75 bytes)
    PC: 001-001-001 LstRt:0 CmbRt:6 Dyn:h'1 TFC:0
    Xlst:0 MOBR:0 NAdj:1 3 3 3 3 3 NmTFR:0 PrevSt:1 
;

    tekelecstp 10-01-28 16:37:11 GMT  EAGLE5 42.0.0
    [SeqNo: 1] [1205] nway: 0 cost_grp(0-5): c7 c6 c6 c6 c6 c6
    rte_used(0-5): c0 36 36 36 36 36
    curr_cost_grp: 0 prev_cost_grp 0
    SRT:h'88079c (28 bytes) AKT:h'8bb43c (12 bytes) 
;

    tekelecstp 10-01-28 16:37:11 GMT  EAGLE5 42.0.0
    [SeqNo: 2] [1205] [Route:h'1] Chksum h'c96e at h'8fc3fb (75 bytes)
    PC: 001-001-002 LstRt:0 CmbRt:6 Dyn:h'1 TFC:0
    Xlst:0 MOBR:0 NAdj:1 3 3 3 3 3 NmTFR:0 PrevSt:1 
;

    tekelecstp 10-01-28 16:37:11 GMT  EAGLE5 42.0.0
    [SeqNo: 2] [1205] nway: 0 cost_grp(0-5): c7 c6 c6 c6 c6 c6
    rte_used(0-5): c0 36 36 36 36 36
    curr_cost_grp: 0 prev_cost_grp 0
    SRT:h'8807b8 (28 bytes) AKT:h'8bb448 (12 bytes) 
;

    tekelecstp 10-01-28 16:37:11 GMT  EAGLE5 42.0.0
    [SeqNo: 1] [1207] [Route:h'0] Chksum h'cecc at h'9688ea0 (243 bytes)
    PC: 001-001-001 LstRt:0 CmbRt:6 Dyn:h'1 TFC:0
    Xlst:0 MOBR:0 NAdj:1 3 3 3 3 3 NmTFR:0 PrevSt:1 
;

    tekelecstp 10-01-28 16:37:11 GMT  EAGLE5 42.0.0
    [SeqNo: 1] [1207] nway: 0 cost_grp(0-5): c8 c6 c6 c6 c6 c6
    rte_used(0-5): c0 46 36 36 36 36
    curr_cost_grp: 0 prev_cost_grp 0
    SRT:h'95148e0 (28 bytes) AKT:h'9575980 (12 bytes) 
;

    tekelecstp 10-01-28 16:37:11 GMT  EAGLE5 42.0.0
    [SeqNo: 2] [1207] [Route:h'1] Chksum h'662f at h'9688f93 (243 bytes)
    PC: 001-001-002 LstRt:0 CmbRt:6 Dyn:h'1 TFC:0
    Xlst:0 MOBR:0 NAdj:1 3 3 3 3 3 NmTFR:0 PrevSt:1 
;
 
   tekelecstp 10-01-28 16:37:11 GMT  EAGLE5 42.0.0
    [SeqNo: 2] [1207] nway: 0 cost_grp(0-5): c8 c6 c6 c6 c6 c6
    rte_used(0-5): c0 46 36 36 36 36
    curr_cost_grp: 0 prev_cost_grp 0
    SRT:h'95148fc (28 bytes) AKT:h'957598c (12 bytes) 
;
dbg-ddb:action=wwa:loc=1301 

    tekelecstp 09-10-12 17:37:11 GMT  EAGLE5 41.1.0
    dbg-ddb:action=wwa:loc=1301
    Command entered at terminal #10. 
;

    tekelecstp 09-10-12 17:37:11 GMT  EAGLE5 41.1.0
    User Message sent to location 1301. 
;

    tekelecstp 09-10-12 17:37:11 GMT  EAGLE5 41.1.0
    DDB WWA REPORT (LOC = 1301)
            WILD WRITE AUDIT UPDATED (1) ENTRIES:
            TIME STAMP             TABLE      ENTRY_IDX  ORIG CHKSUM  UPD CHKSUM
        1.  09-10-12 17:35:02:586  RTE        0          H'41880000   H'00000000 
;
dbg-ddb:action=stats:loc=1201 

    tekelecstp 09-10-03 17:37:11 GMT  EAGLE5 41.1.0
    dbg-ddb:action=stats:loc=1201
    Command entered at terminal #10. 
;

    tekelecstp 09-10-03 17:37:11 GMT  EAGLE5 41.1.0
    User Message sent to location 1201. 
;

    tekelecstp 09-10-03 17:37:11 GMT  EAGLE5 41.1.0
    DDB STATISTICS
        LOC                                             : 1201
        CARD STATUS       (DDL)                         : [CROSSLOADED]
                          (DDB)                         : [INITIALIZED]
        IN UPDATE STATUS  (DDB CHECKSUM)                : [FALSE]
                          (TSRC)                        : [IDLE]
        SUCCESIVE TIMES CARD REPORTED (IN UPDATE)       : 0
        DDB UPDATES                                     : 2000
        MAXIMUM UPDATES PER 100ms                       : 900
        DDB IDLE PERIOD:                                : 03:12:30:20:50
        MAXIMUM IDLE PERIOD                        : 02:12:30:20:50
        MINIMUM IDLE PERIOD                        : 01:04:40:10:80 
        NUMBER OF WWA UPDATED ENTRIES                   : 4 
;
dbg-ddb:action=wwa:loc=1201 

    tekelecstp 09-10-21 17:37:11 GMT  EAGLE5 41.1.0
    dbg-ddb:action=wwa:loc=1201
    Command entered at terminal #10. 
;

    tekelecstp 09-10-21 17:37:11 GMT  EAGLE5 41.1.0
    User Message sent to location 1201. 
;

    tekelecstp 09-10-21 17:37:11 GMT  EAGLE5 41.1.0
    DDB WWA REPORT (LOC = 1201)
            WILD WRITE AUDIT UPDATED (NO) ENTRIES: 
;

Legend

  • WWA—Wild Write Audit
  • DDB—Dynamic Database
  • Time stamp—Card time stamp when the checksum was detected and updated by wild write audit. The time stamp is inYY-MM-DD hh:mm:ss:msec format.
  • TABLE—Table where the checksum is being performed
  • Entry Idx—Index of entry that is updated by wild write audit
  • Orig Chksum—Original Checksum
  • Upd Chksum—Checksum after update by wild write audit
  • Idle Period—Time elapsed, in milliseconds, since the last DDB update was received by this card. All idle periods are displayed indd:hh:mm:ss:msec format.
  • Number of WWA Updated Entries—Number of entries updated by the WWA

Related Topics