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
- 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.
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.
;