4.599 rtrv-trbltx

Use this command to retrieve Alarm and UIM message information including MRN (message reference number), level (for Alarms), Output Group, and text.

The default report displays all Alarms (in numerical order) and then all UIMs.

The optional parameters can be used to:

  • Display a range of Alarms or UIMs (ranges spanning both Alarms and UIMs are not supported)
  • Search for Alarms, UIMs, or both message types matching a specific Output Group
  • Sort all entries by Output Group

Parameters

enum (optional)
The ending Message Reference Number (MRN) when specifying a range.
Range:
1 - 1999

1-999-UAMs

1000-1999 -UIMs

Default:

If snum is specified, the enum value defaults to the specified snum value.

If snum is not specified and type=all, type=uim, or type is not specified, the enum value defaults to 1999

If snum is not specified and type=alarm, the enum value defaults to 999.

outgrp (optional)
The Output Group to sort or filter the Alarm/UIMs on.
Range:
appserv
Application Server
appss
Application Subsystem
card
Card
clk
Clock
db
Database
dbg
Debug
gtt
GTT Maintenance
gws
GWS Maintenance
link
Link Maintenance
meas
Measurements Maintenance
mon
Monitoring (Sentinel or IMF) Maintenance
mps
MPS Maintenance
pu
Program Update
sa
System Administration
seas
SEAS (Sentinel or IMF)
sys
System Maintenance
traf
Traffic
all
Retrieve information for all Output Groups
Default:
No sorting or filtering is done on Output Groups.
snum (optional)
A single Message Reference Number (MRN), or the starting MRN when specifying a range.
Range:
1 - 1999

1-999 —UAMs

1000-1999—UIMs

Default:
All message entries for the specified type are displayed.

For type=all, type=alarm, or type not specified the snum value defaults to 1.

For type=uim, the snum value defaults to 1000.

type (optional)
The type of trouble text entry to display.
Range:
all
Both types are displayed
alarm
Only Alarm entries are displayed
uim
Only UIM entries are displayed
Default:
all

Example

rtrv-trbltx

rtrv-trbltx:type=alarm

rtrv-trbltx:outgrp=sys

rtrv-trbltx:type=alarm:outgrp=all

rtrv-trbltx:snum=1002

Dependencies

If the enum parameter is specified, then the snum parameter must be specified.

The value specified for the enum parameter must be greater than or equal to the value specified for the snum parameter.

The specified enum value must be in the same range as the specified snum value (1-999 for Alarms and 1000-1999 for UIMs). The range cannot span both types.

The values specified for the snum and enum parameters must be in the range of the specified type (1-999 for Alarms and 1000-1999 for UIMs).

If the outgrp parameter is specified, then the snum and enum parameters cannot be specified.

If the snum parameter is specified, the snum parameter specified is out of range.

If the enum parameter is specified, the enum parameter specified is out of range.

Notes

This command can be canceled using the F9 function key or the canc-cmd command. See canc-cmd for more information.

To display a single Alarm or UIM, enter the Alarm or UIM MRN as the value of the snum parameter. Either do not specify the enum parameter or specify the enum parameter with the same value as the snum value.

If an unused MRN is specified as an snum parameter value, the header information is displayed without any Output Group header or MRN information.

If an snum/enum range is specified, and there are unused MRNs within that range, only the used MRNs are displayed.

Output

This example shows the output when the command has no parameters. All entries are not shown; the list is long.

rtrv-trbltx

    ncralstp00001 03-07-16 10:15:29 EST  EAGLE 31.3.0

    Alarm Report
            MRN   LEVEL  OUTPUT GROUP    TEXT
       -------------------------------------------------------------------------
            0001   MAJR   SYS             Card has reset
            0002   MINR   SYS             Card is not running approved GPL
            0003   NONE   SYS             Alarm cleared for GPL
        .
        .
        .
            0912   NONE   SYS             Dynamic database is now consistent
    UIM Report
            MRN           OUTPUT GROUP    TEXT
       -------------------------------------------------------------------------
            1000          SYS             MTP rcvd UPU - user part is not SCCP
            1001          SYS             MTP rcvd Transfer Controlled (TFC)
            1002          SYS             MTP rcvd invalid TFC - status 0
        .
        .
        .
            1999          SYS             Invalid MRN detected

    END OF RTRV-TRBLTX REPORT. 
;

This example shows output with type=alarm. All entries are not shown.

rtrv-trbltx:type=alarm

    ncralstp00001 03-07-16 10:15:29 EST  EAGLE 31.3.0
    Alarm Report
            MRN    LEVEL  OUTPUT GROUP    TEXT
       ------------------------------------------------------------------------- 
            0001   MAJR   SYS             Card has reset
            0002   MINR   SYS             Card is not running approved GPL
            0003   NONE   SYS             Alarm cleared for GPL
        .
        .
        .
            0912   NONE   SYS             Dynamic database is now consistent
    END OF RTRV-TRBLTX REPORT. 
;

This example shows the output with type=uim. All entries are not shown.

rtrv-trbltx:type=uim

    ncralstp00001 03-07-16 10:15:29 EST  EAGLE 31.3.0

    UIM Report

            MRN           OUTPUT GROUP    TEXT
       -------------------------------------------------------------------------
            1000          SYS             MTP rcvd UPU - user part is not SCCP
            1001          SYS             MTP rcvd Transfer Controlled (TFC)
            1002          SYS             MTP rcvd invalid TFC - status 0
            .
            .
            .
            1999          SYS             Invalid MRN detected
    END OF RTRV-TRBLTX REPORT. 
;

This example shows the outptu with outgrp=all. All entries are not shown; examples from each type and several Output Groups are shown.

Note:

The output for outgrp=all:type=alarm includes all Output Groups in the Alarm Report only; the output for outgrp=all:type=uim includes all Output Groups in the UIM Report only.
rtrv-trbltx:outgrp=all

    rlghncxa03w 06-05-27  08:15:10 EST  EAGLE 35.0.0

    Alarm Report
            MRN    LEVEL  OUTPUT GROUP    TEXT

       ------------------------------------------------------------------------- 
        Output Group - SYS
            0001   MAJR   SYS             Card has reset
            0002   MINR   SYS             Card is not running approved GPL
        .
        .
        .
            0912   NONE   SYS             Dynamic database is now consistent
        .
        .
        .
        Output Group - LINK
                           :
            0479   NONE   LINK            Link not Monitored
        UIM Report
            MRN           OUTPUT GROUP    TEXT

       ------------------------------------------------------------------------- 
        Output Group - SYS
            1000          SYS             MTP rcvd UPU - user part is not SCCP
            1001          SYS             MTP rcvd Transfer Controlled (TFC)
        .
        .
        .
            1999          SYS             Invalid MRN detected
                
        .
        .
        .
        Output Group - LINK
            13nn          LINK            Example text

    END OF RTRV-TRBLTX REPORT. 
;

This example shows the output for outgrp=sys. All entries are not shown.

rtrv-trbltx:type=alarm:outgrp=sys

    ncralstp00001 03-07-16 10:15:29 EST  EAGLE 31.3.0
    Alarm Report
            MRN    LEVEL  OUTPUT GROUP    TEXT

       ------------------------------------------------------------------------- 
        Output Group - SYS
            0001   MAJR   SYS             Card has reset
            0002   MINR   SYS             Card is not running approved GPL
        .
        .
        .
            0912   NONE   SYS             Dynamic database is now consistent

    END OF RTRV-TRBLTX REPORT. 
;

This example shows the output for Alarm MRN 3:

rtrv-trbltx:snum=3

    ncralstp00001 03-07-16 10:15:29 EST  EAGLE 31.3.0
    
    Card 1113; SYS REL= 31.3.0; STP CLLI= ncralstp00001; Timezone= EST

    Alarm Report
            MRN    LEVEL  OUTPUT GROUP    TEXT

       ------------------------------------------------------------------------- 
            0003   NONE   SYS             Alarm cleared for GPL

    END OF RTRV-TRBLTX REPORT. 
;

This example shows the output for UIM MRN 1002:

rtrv-trbltx:snum=1002

    ncralstp00001 03-07-16 10:15:29 EST  EAGLE 31.3.0
    UIM Report
            MRN           OUTPUT GROUP    TEXT

       ------------------------------------------------------------------------- 
            1002          SYS             MTP rcvd invalid TFC - status 0

    END OF RTRV-TRBLTX REPORT. 
;